From 9ed8a41a6f4bc6a63fbfea9709089d3bf7333ee1 Mon Sep 17 00:00:00 2001 From: "gcf-owl-bot[bot]" <78513119+gcf-owl-bot[bot]@users.noreply.github.com> Date: Fri, 27 Sep 2024 11:43:30 -0700 Subject: [PATCH] docs: cleanup of Parallelstore API descriptions (#7703) feat: add UPGRADING state to Parallelstore state PiperOrigin-RevId: 678758858 Source-Link: https://github.com/googleapis/googleapis/commit/6125b3deffdaf8d23af5a99a853b2a9a13b407d2 Source-Link: https://github.com/googleapis/googleapis-gen/commit/8f63dd4523066a23d77be22802232a20a20f6281 Copy-Tag: eyJwIjoiUGFyYWxsZWxzdG9yZS8uT3dsQm90LnlhbWwiLCJoIjoiOGY2M2RkNDUyMzA2NmEyM2Q3N2JlMjI4MDIyMzJhMjBhMjBmNjI4MSJ9 --- .../metadata/V1Beta/Parallelstore.php | Bin 8590 -> 8605 bytes .../ParallelstoreClient/create_instance.php | 10 +- .../ParallelstoreClient/delete_instance.php | 2 +- .../ParallelstoreClient/export_data.php | 2 +- .../ParallelstoreClient/get_instance.php | 2 +- .../ParallelstoreClient/import_data.php | 2 +- .../ParallelstoreClient/list_instances.php | 9 +- .../ParallelstoreClient/update_instance.php | 7 +- .../src/V1beta/Client/ParallelstoreClient.php | 12 +- .../src/V1beta/CreateInstanceRequest.php | 28 +- .../src/V1beta/DeleteInstanceRequest.php | 2 +- .../src/V1beta/DestinationGcsBucket.php | 22 +- .../src/V1beta/DestinationParallelstore.php | 10 +- .../src/V1beta/DirectoryStripeLevel.php | 2 +- .../src/V1beta/ExportDataMetadata.php | 10 +- .../src/V1beta/ExportDataRequest.php | 31 +- .../src/V1beta/ExportDataResponse.php | 2 +- Parallelstore/src/V1beta/FileStripeLevel.php | 2 +- .../src/V1beta/GetInstanceRequest.php | 2 +- .../src/V1beta/ImportDataMetadata.php | 10 +- .../src/V1beta/ImportDataRequest.php | 45 +-- .../src/V1beta/ImportDataResponse.php | 2 +- Parallelstore/src/V1beta/Instance.php | 268 ++++++++---------- Parallelstore/src/V1beta/Instance/State.php | 9 +- .../src/V1beta/ListInstancesRequest.php | 57 ++-- .../src/V1beta/ListInstancesResponse.php | 11 +- .../src/V1beta/OperationMetadata.php | 2 +- Parallelstore/src/V1beta/SourceGcsBucket.php | 22 +- .../src/V1beta/SourceParallelstore.php | 10 +- .../src/V1beta/TransferOperationMetadata.php | 10 +- .../src/V1beta/UpdateInstanceRequest.php | 22 +- 31 files changed, 306 insertions(+), 319 deletions(-) diff --git a/Parallelstore/metadata/V1Beta/Parallelstore.php b/Parallelstore/metadata/V1Beta/Parallelstore.php index bf2fe0612c45f0efe0acb203ccd9637202c68e75..3bbcca5e213de9b06378c3daef9cf8438a1b6c85 100644 GIT binary patch delta 47 zcmeBkp6k5fKQrUmO)SBTjEgphusSm{CQhEg5yUUV%f%TQ;2z}Y;_2ruz`FSr#}Wwu Db=MAX delta 31 ncmbR1+~>UEKQrULO)SBTjFUHqusSm{22Gy95w!Uy#}WwuylV?v diff --git a/Parallelstore/samples/V1beta/ParallelstoreClient/create_instance.php b/Parallelstore/samples/V1beta/ParallelstoreClient/create_instance.php index 1743a200f3dc..a167a3c68518 100644 --- a/Parallelstore/samples/V1beta/ParallelstoreClient/create_instance.php +++ b/Parallelstore/samples/V1beta/ParallelstoreClient/create_instance.php @@ -35,18 +35,18 @@ * * @param string $formattedParent The instance's project and location, in the format * `projects/{project}/locations/{location}`. - * Locations map to Google Cloud zones, for example **us-west1-b**. Please see + * Locations map to Google Cloud zones; for example, `us-west1-b`. Please see * {@see ParallelstoreClient::locationName()} for help formatting this field. - * @param string $instanceId The logical name of the Parallelstore instance in the user - * project with the following restrictions: + * @param string $instanceId The name of the Parallelstore instance. * * * Must contain only lowercase letters, numbers, and hyphens. * * Must start with a letter. * * Must be between 1-63 characters. * * Must end with a number or a letter. * * Must be unique within the customer project / location - * @param int $instanceCapacityGib Immutable. Storage capacity of Parallelstore instance in - * Gibibytes (GiB). + * @param int $instanceCapacityGib Immutable. The instance's storage capacity in Gibibytes (GiB). + * Allowed values are between 12000 and 100000, in multiples of 4000; e.g., + * 12000, 16000, 20000, ... */ function create_instance_sample( string $formattedParent, diff --git a/Parallelstore/samples/V1beta/ParallelstoreClient/delete_instance.php b/Parallelstore/samples/V1beta/ParallelstoreClient/delete_instance.php index ca20c9af872d..bc9e448eef16 100644 --- a/Parallelstore/samples/V1beta/ParallelstoreClient/delete_instance.php +++ b/Parallelstore/samples/V1beta/ParallelstoreClient/delete_instance.php @@ -30,7 +30,7 @@ use Google\Rpc\Status; /** - * Deletes a single Instance. + * Deletes a single instance. * * @param string $formattedName Name of the resource * Please see {@see ParallelstoreClient::instanceName()} for help formatting this field. diff --git a/Parallelstore/samples/V1beta/ParallelstoreClient/export_data.php b/Parallelstore/samples/V1beta/ParallelstoreClient/export_data.php index 7c1c9ebc6da0..7ff721f7a80e 100644 --- a/Parallelstore/samples/V1beta/ParallelstoreClient/export_data.php +++ b/Parallelstore/samples/V1beta/ParallelstoreClient/export_data.php @@ -31,7 +31,7 @@ use Google\Rpc\Status; /** - * ExportData copies data from Parallelstore to Cloud Storage + * Copies data from Parallelstore to Cloud Storage. * * @param string $formattedName Name of the resource. Please see * {@see ParallelstoreClient::instanceName()} for help formatting this field. diff --git a/Parallelstore/samples/V1beta/ParallelstoreClient/get_instance.php b/Parallelstore/samples/V1beta/ParallelstoreClient/get_instance.php index 73c9e889638b..4ac319b07fce 100644 --- a/Parallelstore/samples/V1beta/ParallelstoreClient/get_instance.php +++ b/Parallelstore/samples/V1beta/ParallelstoreClient/get_instance.php @@ -29,7 +29,7 @@ use Google\Cloud\Parallelstore\V1beta\Instance; /** - * Gets details of a single Instance. + * Gets details of a single instance. * * @param string $formattedName The instance resource name, in the format * `projects/{project_id}/locations/{location}/instances/{instance_id}`. Please see diff --git a/Parallelstore/samples/V1beta/ParallelstoreClient/import_data.php b/Parallelstore/samples/V1beta/ParallelstoreClient/import_data.php index 06e718eeeb0c..2bed07a1b4ba 100644 --- a/Parallelstore/samples/V1beta/ParallelstoreClient/import_data.php +++ b/Parallelstore/samples/V1beta/ParallelstoreClient/import_data.php @@ -31,7 +31,7 @@ use Google\Rpc\Status; /** - * ImportData copies data from Cloud Storage to Parallelstore. + * Copies data from Cloud Storage to Parallelstore. * * @param string $formattedName Name of the resource. Please see * {@see ParallelstoreClient::instanceName()} for help formatting this field. diff --git a/Parallelstore/samples/V1beta/ParallelstoreClient/list_instances.php b/Parallelstore/samples/V1beta/ParallelstoreClient/list_instances.php index 90d32ef5bce3..3c500ce1f285 100644 --- a/Parallelstore/samples/V1beta/ParallelstoreClient/list_instances.php +++ b/Parallelstore/samples/V1beta/ParallelstoreClient/list_instances.php @@ -30,14 +30,13 @@ use Google\Cloud\Parallelstore\V1beta\ListInstancesRequest; /** - * Lists Instances in a given project and location. + * Lists all instances in a given project and location. * * @param string $formattedParent The project and location for which to retrieve instance * information, in the format `projects/{project_id}/locations/{location}`. - * For Parallelstore locations map to Google Cloud zones, for example - * **us-central1-a**. - * To retrieve instance information for all locations, use "-" for the - * `{location}` value. Please see + * + * To retrieve instance information for all locations, use "-" as the value of + * `{location}`. Please see * {@see ParallelstoreClient::locationName()} for help formatting this field. */ function list_instances_sample(string $formattedParent): void diff --git a/Parallelstore/samples/V1beta/ParallelstoreClient/update_instance.php b/Parallelstore/samples/V1beta/ParallelstoreClient/update_instance.php index 282523177b0d..6d1a4798aee8 100644 --- a/Parallelstore/samples/V1beta/ParallelstoreClient/update_instance.php +++ b/Parallelstore/samples/V1beta/ParallelstoreClient/update_instance.php @@ -32,10 +32,11 @@ use Google\Rpc\Status; /** - * Updates the parameters of a single Instance. + * Updates the parameters of a single instance. * - * @param int $instanceCapacityGib Immutable. Storage capacity of Parallelstore instance in - * Gibibytes (GiB). + * @param int $instanceCapacityGib Immutable. The instance's storage capacity in Gibibytes (GiB). + * Allowed values are between 12000 and 100000, in multiples of 4000; e.g., + * 12000, 16000, 20000, ... */ function update_instance_sample(int $instanceCapacityGib): void { diff --git a/Parallelstore/src/V1beta/Client/ParallelstoreClient.php b/Parallelstore/src/V1beta/Client/ParallelstoreClient.php index c70323d176a6..e6270a5e31fc 100644 --- a/Parallelstore/src/V1beta/Client/ParallelstoreClient.php +++ b/Parallelstore/src/V1beta/Client/ParallelstoreClient.php @@ -422,7 +422,7 @@ public function createInstance(CreateInstanceRequest $request, array $callOption } /** - * Deletes a single Instance. + * Deletes a single instance. * * The async variant is {@see ParallelstoreClient::deleteInstanceAsync()} . * @@ -450,7 +450,7 @@ public function deleteInstance(DeleteInstanceRequest $request, array $callOption } /** - * ExportData copies data from Parallelstore to Cloud Storage + * Copies data from Parallelstore to Cloud Storage. * * The async variant is {@see ParallelstoreClient::exportDataAsync()} . * @@ -478,7 +478,7 @@ public function exportData(ExportDataRequest $request, array $callOptions = []): } /** - * Gets details of a single Instance. + * Gets details of a single instance. * * The async variant is {@see ParallelstoreClient::getInstanceAsync()} . * @@ -506,7 +506,7 @@ public function getInstance(GetInstanceRequest $request, array $callOptions = [] } /** - * ImportData copies data from Cloud Storage to Parallelstore. + * Copies data from Cloud Storage to Parallelstore. * * The async variant is {@see ParallelstoreClient::importDataAsync()} . * @@ -534,7 +534,7 @@ public function importData(ImportDataRequest $request, array $callOptions = []): } /** - * Lists Instances in a given project and location. + * Lists all instances in a given project and location. * * The async variant is {@see ParallelstoreClient::listInstancesAsync()} . * @@ -562,7 +562,7 @@ public function listInstances(ListInstancesRequest $request, array $callOptions } /** - * Updates the parameters of a single Instance. + * Updates the parameters of a single instance. * * The async variant is {@see ParallelstoreClient::updateInstanceAsync()} . * diff --git a/Parallelstore/src/V1beta/CreateInstanceRequest.php b/Parallelstore/src/V1beta/CreateInstanceRequest.php index 8ed8fcdc2d92..fe29cbe5c787 100644 --- a/Parallelstore/src/V1beta/CreateInstanceRequest.php +++ b/Parallelstore/src/V1beta/CreateInstanceRequest.php @@ -9,8 +9,7 @@ use Google\Protobuf\Internal\GPBUtil; /** - * Request for - * [CreateInstance][google.cloud.parallelstore.v1beta.Parallelstore.CreateInstance] + * Create a new Parallelstore instance. * * Generated from protobuf message google.cloud.parallelstore.v1beta.CreateInstanceRequest */ @@ -19,14 +18,13 @@ class CreateInstanceRequest extends \Google\Protobuf\Internal\Message /** * Required. The instance's project and location, in the format * `projects/{project}/locations/{location}`. - * Locations map to Google Cloud zones, for example **us-west1-b**. + * Locations map to Google Cloud zones; for example, `us-west1-b`. * * Generated from protobuf field string parent = 1 [(.google.api.field_behavior) = REQUIRED, (.google.api.resource_reference) = { */ protected $parent = ''; /** - * Required. The logical name of the Parallelstore instance in the user - * project with the following restrictions: + * Required. The name of the Parallelstore instance. * * Must contain only lowercase letters, numbers, and hyphens. * * Must start with a letter. * * Must be between 1-63 characters. @@ -62,11 +60,10 @@ class CreateInstanceRequest extends \Google\Protobuf\Internal\Message /** * @param string $parent Required. The instance's project and location, in the format * `projects/{project}/locations/{location}`. - * Locations map to Google Cloud zones, for example **us-west1-b**. Please see + * Locations map to Google Cloud zones; for example, `us-west1-b`. Please see * {@see ParallelstoreClient::locationName()} for help formatting this field. * @param \Google\Cloud\Parallelstore\V1beta\Instance $instance Required. The instance to create. - * @param string $instanceId Required. The logical name of the Parallelstore instance in the user - * project with the following restrictions: + * @param string $instanceId Required. The name of the Parallelstore instance. * * * Must contain only lowercase letters, numbers, and hyphens. * * Must start with a letter. @@ -95,10 +92,9 @@ public static function build(string $parent, \Google\Cloud\Parallelstore\V1beta\ * @type string $parent * Required. The instance's project and location, in the format * `projects/{project}/locations/{location}`. - * Locations map to Google Cloud zones, for example **us-west1-b**. + * Locations map to Google Cloud zones; for example, `us-west1-b`. * @type string $instance_id - * Required. The logical name of the Parallelstore instance in the user - * project with the following restrictions: + * Required. The name of the Parallelstore instance. * * Must contain only lowercase letters, numbers, and hyphens. * * Must start with a letter. * * Must be between 1-63 characters. @@ -128,7 +124,7 @@ public function __construct($data = NULL) { /** * Required. The instance's project and location, in the format * `projects/{project}/locations/{location}`. - * Locations map to Google Cloud zones, for example **us-west1-b**. + * Locations map to Google Cloud zones; for example, `us-west1-b`. * * Generated from protobuf field string parent = 1 [(.google.api.field_behavior) = REQUIRED, (.google.api.resource_reference) = { * @return string @@ -141,7 +137,7 @@ public function getParent() /** * Required. The instance's project and location, in the format * `projects/{project}/locations/{location}`. - * Locations map to Google Cloud zones, for example **us-west1-b**. + * Locations map to Google Cloud zones; for example, `us-west1-b`. * * Generated from protobuf field string parent = 1 [(.google.api.field_behavior) = REQUIRED, (.google.api.resource_reference) = { * @param string $var @@ -156,8 +152,7 @@ public function setParent($var) } /** - * Required. The logical name of the Parallelstore instance in the user - * project with the following restrictions: + * Required. The name of the Parallelstore instance. * * Must contain only lowercase letters, numbers, and hyphens. * * Must start with a letter. * * Must be between 1-63 characters. @@ -173,8 +168,7 @@ public function getInstanceId() } /** - * Required. The logical name of the Parallelstore instance in the user - * project with the following restrictions: + * Required. The name of the Parallelstore instance. * * Must contain only lowercase letters, numbers, and hyphens. * * Must start with a letter. * * Must be between 1-63 characters. diff --git a/Parallelstore/src/V1beta/DeleteInstanceRequest.php b/Parallelstore/src/V1beta/DeleteInstanceRequest.php index 815e5d0d9e72..a4a8255bf2da 100644 --- a/Parallelstore/src/V1beta/DeleteInstanceRequest.php +++ b/Parallelstore/src/V1beta/DeleteInstanceRequest.php @@ -9,7 +9,7 @@ use Google\Protobuf\Internal\GPBUtil; /** - * Message for deleting a Instance + * Delete an instance. * * Generated from protobuf message google.cloud.parallelstore.v1beta.DeleteInstanceRequest */ diff --git a/Parallelstore/src/V1beta/DestinationGcsBucket.php b/Parallelstore/src/V1beta/DestinationGcsBucket.php index dc255709e726..8e7de4c6a1ef 100644 --- a/Parallelstore/src/V1beta/DestinationGcsBucket.php +++ b/Parallelstore/src/V1beta/DestinationGcsBucket.php @@ -9,15 +9,16 @@ use Google\Protobuf\Internal\GPBUtil; /** - * Google Cloud Storage as a destination. + * Cloud Storage as the destination of a data transfer. * * Generated from protobuf message google.cloud.parallelstore.v1beta.DestinationGcsBucket */ class DestinationGcsBucket extends \Google\Protobuf\Internal\Message { /** - * Required. URI to a Cloud Storage object in format: - * 'gs:///'. + * Required. URI to a Cloud Storage bucket in the format: + * `gs:///`. The path inside the bucket is + * optional. * * Generated from protobuf field string uri = 1 [(.google.api.field_behavior) = REQUIRED]; */ @@ -30,8 +31,9 @@ class DestinationGcsBucket extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type string $uri - * Required. URI to a Cloud Storage object in format: - * 'gs:///'. + * Required. URI to a Cloud Storage bucket in the format: + * `gs:///`. The path inside the bucket is + * optional. * } */ public function __construct($data = NULL) { @@ -40,8 +42,9 @@ public function __construct($data = NULL) { } /** - * Required. URI to a Cloud Storage object in format: - * 'gs:///'. + * Required. URI to a Cloud Storage bucket in the format: + * `gs:///`. The path inside the bucket is + * optional. * * Generated from protobuf field string uri = 1 [(.google.api.field_behavior) = REQUIRED]; * @return string @@ -52,8 +55,9 @@ public function getUri() } /** - * Required. URI to a Cloud Storage object in format: - * 'gs:///'. + * Required. URI to a Cloud Storage bucket in the format: + * `gs:///`. The path inside the bucket is + * optional. * * Generated from protobuf field string uri = 1 [(.google.api.field_behavior) = REQUIRED]; * @param string $var diff --git a/Parallelstore/src/V1beta/DestinationParallelstore.php b/Parallelstore/src/V1beta/DestinationParallelstore.php index aa269c4cff8f..8c0d829fa41e 100644 --- a/Parallelstore/src/V1beta/DestinationParallelstore.php +++ b/Parallelstore/src/V1beta/DestinationParallelstore.php @@ -9,7 +9,7 @@ use Google\Protobuf\Internal\GPBUtil; /** - * Parallelstore as a destination. + * Parallelstore as the destination of a data transfer. * * Generated from protobuf message google.cloud.parallelstore.v1beta.DestinationParallelstore */ @@ -17,7 +17,7 @@ class DestinationParallelstore extends \Google\Protobuf\Internal\Message { /** * Optional. Root directory path to the Paralellstore filesystem, starting - * with '/'. Defaults to '/' if unset. + * with `/`. Defaults to `/` if unset. * * Generated from protobuf field string path = 1 [(.google.api.field_behavior) = OPTIONAL]; */ @@ -31,7 +31,7 @@ class DestinationParallelstore extends \Google\Protobuf\Internal\Message * * @type string $path * Optional. Root directory path to the Paralellstore filesystem, starting - * with '/'. Defaults to '/' if unset. + * with `/`. Defaults to `/` if unset. * } */ public function __construct($data = NULL) { @@ -41,7 +41,7 @@ public function __construct($data = NULL) { /** * Optional. Root directory path to the Paralellstore filesystem, starting - * with '/'. Defaults to '/' if unset. + * with `/`. Defaults to `/` if unset. * * Generated from protobuf field string path = 1 [(.google.api.field_behavior) = OPTIONAL]; * @return string @@ -53,7 +53,7 @@ public function getPath() /** * Optional. Root directory path to the Paralellstore filesystem, starting - * with '/'. Defaults to '/' if unset. + * with `/`. Defaults to `/` if unset. * * Generated from protobuf field string path = 1 [(.google.api.field_behavior) = OPTIONAL]; * @param string $var diff --git a/Parallelstore/src/V1beta/DirectoryStripeLevel.php b/Parallelstore/src/V1beta/DirectoryStripeLevel.php index aa9b9b5ab8f6..335a8d65009b 100644 --- a/Parallelstore/src/V1beta/DirectoryStripeLevel.php +++ b/Parallelstore/src/V1beta/DirectoryStripeLevel.php @@ -14,7 +14,7 @@ class DirectoryStripeLevel { /** - * Default directory striping + * If not set, DirectoryStripeLevel will default to DIRECTORY_STRIPE_LEVEL_MAX * * Generated from protobuf enum DIRECTORY_STRIPE_LEVEL_UNSPECIFIED = 0; */ diff --git a/Parallelstore/src/V1beta/ExportDataMetadata.php b/Parallelstore/src/V1beta/ExportDataMetadata.php index 69a26dd796d3..22a6f8b50cf3 100644 --- a/Parallelstore/src/V1beta/ExportDataMetadata.php +++ b/Parallelstore/src/V1beta/ExportDataMetadata.php @@ -9,14 +9,14 @@ use Google\Protobuf\Internal\GPBUtil; /** - * ExportDataMetadata contains export data operation metadata + * Metadata related to the data export operation. * * Generated from protobuf message google.cloud.parallelstore.v1beta.ExportDataMetadata */ class ExportDataMetadata extends \Google\Protobuf\Internal\Message { /** - * Contains the data transfer operation metadata. + * Data transfer operation metadata. * * Generated from protobuf field .google.cloud.parallelstore.v1beta.TransferOperationMetadata operation_metadata = 1; */ @@ -75,7 +75,7 @@ class ExportDataMetadata extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type \Google\Cloud\Parallelstore\V1beta\TransferOperationMetadata $operation_metadata - * Contains the data transfer operation metadata. + * Data transfer operation metadata. * @type \Google\Protobuf\Timestamp $create_time * Output only. The time the operation was created. * @type \Google\Protobuf\Timestamp $end_time @@ -102,7 +102,7 @@ public function __construct($data = NULL) { } /** - * Contains the data transfer operation metadata. + * Data transfer operation metadata. * * Generated from protobuf field .google.cloud.parallelstore.v1beta.TransferOperationMetadata operation_metadata = 1; * @return \Google\Cloud\Parallelstore\V1beta\TransferOperationMetadata|null @@ -123,7 +123,7 @@ public function clearOperationMetadata() } /** - * Contains the data transfer operation metadata. + * Data transfer operation metadata. * * Generated from protobuf field .google.cloud.parallelstore.v1beta.TransferOperationMetadata operation_metadata = 1; * @param \Google\Cloud\Parallelstore\V1beta\TransferOperationMetadata $var diff --git a/Parallelstore/src/V1beta/ExportDataRequest.php b/Parallelstore/src/V1beta/ExportDataRequest.php index 9046b63a8de1..2bb95ee6c34f 100644 --- a/Parallelstore/src/V1beta/ExportDataRequest.php +++ b/Parallelstore/src/V1beta/ExportDataRequest.php @@ -9,8 +9,7 @@ use Google\Protobuf\Internal\GPBUtil; /** - * Message representing the request exporting data from Cloud Storage to - * parallelstore. + * Export data from Parallelstore to Cloud Storage. * * Generated from protobuf message google.cloud.parallelstore.v1beta.ExportDataRequest */ @@ -41,9 +40,12 @@ class ExportDataRequest extends \Google\Protobuf\Internal\Message /** * Optional. User-specified Service Account (SA) credentials to be used when * performing the transfer. - * Format: `projects/{project_id}/serviceAccounts/{service_account}` + * Use one of the following formats: + * * {EMAIL_ADDRESS_OR_UNIQUE_ID} + * * `projects/{PROJECT_ID_OR_NUMBER}/serviceAccounts/{EMAIL_ADDRESS_OR_UNIQUE_ID}` + * * `projects/-/serviceAccounts/{EMAIL_ADDRESS_OR_UNIQUE_ID} * If unspecified, the Parallelstore service agent is used: - * service-@gcp-sa-parallelstore.iam.gserviceaccount.com) + * `service-@gcp-sa-parallelstore.iam.gserviceaccount.com` * * Generated from protobuf field string service_account = 5 [(.google.api.field_behavior) = OPTIONAL, (.google.api.resource_reference) = { */ @@ -78,9 +80,12 @@ class ExportDataRequest extends \Google\Protobuf\Internal\Message * @type string $service_account * Optional. User-specified Service Account (SA) credentials to be used when * performing the transfer. - * Format: `projects/{project_id}/serviceAccounts/{service_account}` + * Use one of the following formats: + * * {EMAIL_ADDRESS_OR_UNIQUE_ID} + * * `projects/{PROJECT_ID_OR_NUMBER}/serviceAccounts/{EMAIL_ADDRESS_OR_UNIQUE_ID}` + * * `projects/-/serviceAccounts/{EMAIL_ADDRESS_OR_UNIQUE_ID} * If unspecified, the Parallelstore service agent is used: - * service-@gcp-sa-parallelstore.iam.gserviceaccount.com) + * `service-@gcp-sa-parallelstore.iam.gserviceaccount.com` * } */ public function __construct($data = NULL) { @@ -225,9 +230,12 @@ public function setRequestId($var) /** * Optional. User-specified Service Account (SA) credentials to be used when * performing the transfer. - * Format: `projects/{project_id}/serviceAccounts/{service_account}` + * Use one of the following formats: + * * {EMAIL_ADDRESS_OR_UNIQUE_ID} + * * `projects/{PROJECT_ID_OR_NUMBER}/serviceAccounts/{EMAIL_ADDRESS_OR_UNIQUE_ID}` + * * `projects/-/serviceAccounts/{EMAIL_ADDRESS_OR_UNIQUE_ID} * If unspecified, the Parallelstore service agent is used: - * service-@gcp-sa-parallelstore.iam.gserviceaccount.com) + * `service-@gcp-sa-parallelstore.iam.gserviceaccount.com` * * Generated from protobuf field string service_account = 5 [(.google.api.field_behavior) = OPTIONAL, (.google.api.resource_reference) = { * @return string @@ -240,9 +248,12 @@ public function getServiceAccount() /** * Optional. User-specified Service Account (SA) credentials to be used when * performing the transfer. - * Format: `projects/{project_id}/serviceAccounts/{service_account}` + * Use one of the following formats: + * * {EMAIL_ADDRESS_OR_UNIQUE_ID} + * * `projects/{PROJECT_ID_OR_NUMBER}/serviceAccounts/{EMAIL_ADDRESS_OR_UNIQUE_ID}` + * * `projects/-/serviceAccounts/{EMAIL_ADDRESS_OR_UNIQUE_ID} * If unspecified, the Parallelstore service agent is used: - * service-@gcp-sa-parallelstore.iam.gserviceaccount.com) + * `service-@gcp-sa-parallelstore.iam.gserviceaccount.com` * * Generated from protobuf field string service_account = 5 [(.google.api.field_behavior) = OPTIONAL, (.google.api.resource_reference) = { * @param string $var diff --git a/Parallelstore/src/V1beta/ExportDataResponse.php b/Parallelstore/src/V1beta/ExportDataResponse.php index 84a49b91541e..53ef6c9be2dc 100644 --- a/Parallelstore/src/V1beta/ExportDataResponse.php +++ b/Parallelstore/src/V1beta/ExportDataResponse.php @@ -9,7 +9,7 @@ use Google\Protobuf\Internal\GPBUtil; /** - * ExportDataResponse is the response returned from ExportData rpc + * The response to a request to export data from Parallelstore. * * Generated from protobuf message google.cloud.parallelstore.v1beta.ExportDataResponse */ diff --git a/Parallelstore/src/V1beta/FileStripeLevel.php b/Parallelstore/src/V1beta/FileStripeLevel.php index 0256998e6532..9b2e95057541 100644 --- a/Parallelstore/src/V1beta/FileStripeLevel.php +++ b/Parallelstore/src/V1beta/FileStripeLevel.php @@ -14,7 +14,7 @@ class FileStripeLevel { /** - * Default file striping + * If not set, FileStripeLevel will default to FILE_STRIPE_LEVEL_BALANCED * * Generated from protobuf enum FILE_STRIPE_LEVEL_UNSPECIFIED = 0; */ diff --git a/Parallelstore/src/V1beta/GetInstanceRequest.php b/Parallelstore/src/V1beta/GetInstanceRequest.php index aa5fd99562a2..fd795fcc0f6b 100644 --- a/Parallelstore/src/V1beta/GetInstanceRequest.php +++ b/Parallelstore/src/V1beta/GetInstanceRequest.php @@ -9,7 +9,7 @@ use Google\Protobuf\Internal\GPBUtil; /** - * Request to get an instance's details. + * Get an instance's details. * * Generated from protobuf message google.cloud.parallelstore.v1beta.GetInstanceRequest */ diff --git a/Parallelstore/src/V1beta/ImportDataMetadata.php b/Parallelstore/src/V1beta/ImportDataMetadata.php index 69156774b164..3c3cfac406bb 100644 --- a/Parallelstore/src/V1beta/ImportDataMetadata.php +++ b/Parallelstore/src/V1beta/ImportDataMetadata.php @@ -9,14 +9,14 @@ use Google\Protobuf\Internal\GPBUtil; /** - * ImportDataMetadata contains import data operation metadata + * Metadata related to the data import operation. * * Generated from protobuf message google.cloud.parallelstore.v1beta.ImportDataMetadata */ class ImportDataMetadata extends \Google\Protobuf\Internal\Message { /** - * Contains the data transfer operation metadata. + * Data transfer operation metadata. * * Generated from protobuf field .google.cloud.parallelstore.v1beta.TransferOperationMetadata operation_metadata = 1; */ @@ -75,7 +75,7 @@ class ImportDataMetadata extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type \Google\Cloud\Parallelstore\V1beta\TransferOperationMetadata $operation_metadata - * Contains the data transfer operation metadata. + * Data transfer operation metadata. * @type \Google\Protobuf\Timestamp $create_time * Output only. The time the operation was created. * @type \Google\Protobuf\Timestamp $end_time @@ -102,7 +102,7 @@ public function __construct($data = NULL) { } /** - * Contains the data transfer operation metadata. + * Data transfer operation metadata. * * Generated from protobuf field .google.cloud.parallelstore.v1beta.TransferOperationMetadata operation_metadata = 1; * @return \Google\Cloud\Parallelstore\V1beta\TransferOperationMetadata|null @@ -123,7 +123,7 @@ public function clearOperationMetadata() } /** - * Contains the data transfer operation metadata. + * Data transfer operation metadata. * * Generated from protobuf field .google.cloud.parallelstore.v1beta.TransferOperationMetadata operation_metadata = 1; * @param \Google\Cloud\Parallelstore\V1beta\TransferOperationMetadata $var diff --git a/Parallelstore/src/V1beta/ImportDataRequest.php b/Parallelstore/src/V1beta/ImportDataRequest.php index 0de94fda9013..8adf8e031c1e 100644 --- a/Parallelstore/src/V1beta/ImportDataRequest.php +++ b/Parallelstore/src/V1beta/ImportDataRequest.php @@ -9,8 +9,7 @@ use Google\Protobuf\Internal\GPBUtil; /** - * Message representing the request importing data from parallelstore to Cloud - * Storage. + * Import data from Cloud Storage into a Parallelstore instance. * * Generated from protobuf message google.cloud.parallelstore.v1beta.ImportDataRequest */ @@ -39,11 +38,14 @@ class ImportDataRequest extends \Google\Protobuf\Internal\Message */ protected $request_id = ''; /** - * Optional. User-specified Service Account (SA) credentials to be used when + * Optional. User-specified service account credentials to be used when * performing the transfer. - * Format: `projects/{project_id}/serviceAccounts/{service_account}` + * Use one of the following formats: + * * {EMAIL_ADDRESS_OR_UNIQUE_ID} + * * `projects/{PROJECT_ID_OR_NUMBER}/serviceAccounts/{EMAIL_ADDRESS_OR_UNIQUE_ID}` + * * `projects/-/serviceAccounts/{EMAIL_ADDRESS_OR_UNIQUE_ID} * If unspecified, the Parallelstore service agent is used: - * service-@gcp-sa-parallelstore.iam.gserviceaccount.com) + * `service-@gcp-sa-parallelstore.iam.gserviceaccount.com` * * Generated from protobuf field string service_account = 5 [(.google.api.field_behavior) = OPTIONAL, (.google.api.resource_reference) = { */ @@ -58,7 +60,7 @@ class ImportDataRequest extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type \Google\Cloud\Parallelstore\V1beta\SourceGcsBucket $source_gcs_bucket - * Cloud Storage source. + * The Cloud Storage source bucket and, optionally, path inside the bucket. * @type \Google\Cloud\Parallelstore\V1beta\DestinationParallelstore $destination_parallelstore * Parallelstore destination. * @type string $name @@ -76,11 +78,14 @@ class ImportDataRequest extends \Google\Protobuf\Internal\Message * 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_account - * Optional. User-specified Service Account (SA) credentials to be used when + * Optional. User-specified service account credentials to be used when * performing the transfer. - * Format: `projects/{project_id}/serviceAccounts/{service_account}` + * Use one of the following formats: + * * {EMAIL_ADDRESS_OR_UNIQUE_ID} + * * `projects/{PROJECT_ID_OR_NUMBER}/serviceAccounts/{EMAIL_ADDRESS_OR_UNIQUE_ID}` + * * `projects/-/serviceAccounts/{EMAIL_ADDRESS_OR_UNIQUE_ID} * If unspecified, the Parallelstore service agent is used: - * service-@gcp-sa-parallelstore.iam.gserviceaccount.com) + * `service-@gcp-sa-parallelstore.iam.gserviceaccount.com` * } */ public function __construct($data = NULL) { @@ -89,7 +94,7 @@ public function __construct($data = NULL) { } /** - * Cloud Storage source. + * The Cloud Storage source bucket and, optionally, path inside the bucket. * * Generated from protobuf field .google.cloud.parallelstore.v1beta.SourceGcsBucket source_gcs_bucket = 2; * @return \Google\Cloud\Parallelstore\V1beta\SourceGcsBucket|null @@ -105,7 +110,7 @@ public function hasSourceGcsBucket() } /** - * Cloud Storage source. + * The Cloud Storage source bucket and, optionally, path inside the bucket. * * Generated from protobuf field .google.cloud.parallelstore.v1beta.SourceGcsBucket source_gcs_bucket = 2; * @param \Google\Cloud\Parallelstore\V1beta\SourceGcsBucket $var @@ -223,11 +228,14 @@ public function setRequestId($var) } /** - * Optional. User-specified Service Account (SA) credentials to be used when + * Optional. User-specified service account credentials to be used when * performing the transfer. - * Format: `projects/{project_id}/serviceAccounts/{service_account}` + * Use one of the following formats: + * * {EMAIL_ADDRESS_OR_UNIQUE_ID} + * * `projects/{PROJECT_ID_OR_NUMBER}/serviceAccounts/{EMAIL_ADDRESS_OR_UNIQUE_ID}` + * * `projects/-/serviceAccounts/{EMAIL_ADDRESS_OR_UNIQUE_ID} * If unspecified, the Parallelstore service agent is used: - * service-@gcp-sa-parallelstore.iam.gserviceaccount.com) + * `service-@gcp-sa-parallelstore.iam.gserviceaccount.com` * * Generated from protobuf field string service_account = 5 [(.google.api.field_behavior) = OPTIONAL, (.google.api.resource_reference) = { * @return string @@ -238,11 +246,14 @@ public function getServiceAccount() } /** - * Optional. User-specified Service Account (SA) credentials to be used when + * Optional. User-specified service account credentials to be used when * performing the transfer. - * Format: `projects/{project_id}/serviceAccounts/{service_account}` + * Use one of the following formats: + * * {EMAIL_ADDRESS_OR_UNIQUE_ID} + * * `projects/{PROJECT_ID_OR_NUMBER}/serviceAccounts/{EMAIL_ADDRESS_OR_UNIQUE_ID}` + * * `projects/-/serviceAccounts/{EMAIL_ADDRESS_OR_UNIQUE_ID} * If unspecified, the Parallelstore service agent is used: - * service-@gcp-sa-parallelstore.iam.gserviceaccount.com) + * `service-@gcp-sa-parallelstore.iam.gserviceaccount.com` * * Generated from protobuf field string service_account = 5 [(.google.api.field_behavior) = OPTIONAL, (.google.api.resource_reference) = { * @param string $var diff --git a/Parallelstore/src/V1beta/ImportDataResponse.php b/Parallelstore/src/V1beta/ImportDataResponse.php index fd575fa1fb1c..9eb5207960b1 100644 --- a/Parallelstore/src/V1beta/ImportDataResponse.php +++ b/Parallelstore/src/V1beta/ImportDataResponse.php @@ -9,7 +9,7 @@ use Google\Protobuf\Internal\GPBUtil; /** - * ImportDataResponse is the response returned from ImportData rpc. + * The response to a request to import data to Parallelstore. * * Generated from protobuf message google.cloud.parallelstore.v1beta.ImportDataResponse */ diff --git a/Parallelstore/src/V1beta/Instance.php b/Parallelstore/src/V1beta/Instance.php index 910236b64b20..7e849d93d3d1 100644 --- a/Parallelstore/src/V1beta/Instance.php +++ b/Parallelstore/src/V1beta/Instance.php @@ -17,7 +17,7 @@ class Instance extends \Google\Protobuf\Internal\Message { /** * Identifier. The resource name of the instance, in the format - * `projects/{project}/locations/{location}/instances/{instance_id}` + * `projects/{project}/locations/{location}/instances/{instance_id}`. * * Generated from protobuf field string name = 1 [(.google.api.field_behavior) = IDENTIFIER]; */ @@ -49,48 +49,34 @@ class Instance extends \Google\Protobuf\Internal\Message /** * Optional. Cloud Labels are a flexible and lightweight mechanism for * organizing cloud resources into groups that reflect a customer's - * organizational needs and deployment strategies. Cloud Labels can be used to - * filter collections of resources. They can be used to control how resource - * metrics are aggregated. And they can be used as arguments to policy - * management rules (e.g. route, firewall, load balancing, etc.). - * * Label keys must be between 1 and 63 characters long and must conform to - * the following regular expression: `[a-z][a-z0-9_-]{0,62}`. - * * Label values must be between 0 and 63 characters long and must conform - * to the regular expression `[a-z0-9_-]{0,63}`. - * * No more than 64 labels can be associated with a given resource. - * See https://goo.gl/xmQnxf for more information on and examples of labels. - * If you plan to use labels in your own code, please note that additional - * characters may be allowed in the future. Therefore, you are advised to use - * an internal label representation, such as JSON, which doesn't rely upon - * specific characters being disallowed. For example, representing labels - * as the string: name + "_" + value would prove problematic if we were to - * allow "_" in a future release. + * organizational needs and deployment strategies. See + * https://cloud.google.com/resource-manager/docs/labels-overview for details. * * Generated from protobuf field map labels = 6 [(.google.api.field_behavior) = OPTIONAL]; */ private $labels; /** - * Required. Immutable. Storage capacity of Parallelstore instance in - * Gibibytes (GiB). + * Required. Immutable. The instance's storage capacity in Gibibytes (GiB). + * Allowed values are between 12000 and 100000, in multiples of 4000; e.g., + * 12000, 16000, 20000, ... * * Generated from protobuf field int64 capacity_gib = 8 [(.google.api.field_behavior) = IMMUTABLE, (.google.api.field_behavior) = REQUIRED]; */ protected $capacity_gib = 0; /** - * Output only. The version of DAOS software running in the instance + * Output only. The version of DAOS software running in the instance. * * Generated from protobuf field string daos_version = 9 [(.google.api.field_behavior) = OUTPUT_ONLY]; */ protected $daos_version = ''; /** - * Output only. List of access_points. - * Contains a list of IPv4 addresses used for client side configuration. + * Output only. A list of IPv4 addresses used for client side configuration. * * Generated from protobuf field repeated string access_points = 10 [(.google.api.field_behavior) = OUTPUT_ONLY]; */ private $access_points; /** - * Optional. Immutable. The name of the Google Compute Engine + * Optional. Immutable. The name of the Compute Engine * [VPC network](https://cloud.google.com/vpc/docs/vpc) to which the * instance is connected. * @@ -98,36 +84,41 @@ class Instance extends \Google\Protobuf\Internal\Message */ protected $network = ''; /** - * Optional. Immutable. Contains the id of the allocated IP address range - * associated with the private service access connection for example, - * "test-default" associated with IP range 10.0.0.0/29. If no range id is - * provided all ranges will be considered. + * Optional. Immutable. The ID of the IP address range being used by the + * instance's VPC network. See [Configure a VPC + * network](https://cloud.google.com/parallelstore/docs/vpc#create_and_configure_the_vpc). + * If no ID is provided, all ranges are considered. * * Generated from protobuf field string reserved_ip_range = 12 [(.google.api.field_behavior) = IMMUTABLE, (.google.api.field_behavior) = OPTIONAL, (.google.api.resource_reference) = { */ protected $reserved_ip_range = ''; /** - * Output only. Immutable. Contains the id of the allocated IP address range - * associated with the private service access connection for example, - * "test-default" associated with IP range 10.0.0.0/29. This field is - * populated by the service and and contains the value currently used by the - * service. + * Output only. Immutable. The ID of the IP address range being used by the + * instance's VPC network. This field is populated by the service and contains + * the value currently used by the service. * * Generated from protobuf field string effective_reserved_ip_range = 14 [(.google.api.field_behavior) = IMMUTABLE, (.google.api.field_behavior) = OUTPUT_ONLY, (.google.api.resource_reference) = { */ protected $effective_reserved_ip_range = ''; /** - * Optional. Stripe level for files. - * MIN better suited for small size files. - * MAX higher throughput performance for larger files. + * Optional. Stripe level for files. Allowed values are: + * * `FILE_STRIPE_LEVEL_MIN`: offers the best performance for small size + * files. + * * `FILE_STRIPE_LEVEL_BALANCED`: balances performance for workloads + * involving a mix of small and large files. + * * `FILE_STRIPE_LEVEL_MAX`: higher throughput performance for larger files. * * Generated from protobuf field .google.cloud.parallelstore.v1beta.FileStripeLevel file_stripe_level = 15 [(.google.api.field_behavior) = OPTIONAL]; */ protected $file_stripe_level = 0; /** - * Optional. Stripe level for directories. - * MIN when directory has a small number of files. - * MAX when directory has a large number of files. + * Optional. Stripe level for directories. Allowed values are: + * * `DIRECTORY_STRIPE_LEVEL_MIN`: recommended when directories contain a + * small number of files. + * * `DIRECTORY_STRIPE_LEVEL_BALANCED`: balances performance for workloads + * involving a mix of small and large directories. + * * `DIRECTORY_STRIPE_LEVEL_MAX`: recommended for directories with a large + * number of files. * * Generated from protobuf field .google.cloud.parallelstore.v1beta.DirectoryStripeLevel directory_stripe_level = 16 [(.google.api.field_behavior) = OPTIONAL]; */ @@ -141,7 +132,7 @@ class Instance extends \Google\Protobuf\Internal\Message * * @type string $name * Identifier. The resource name of the instance, in the format - * `projects/{project}/locations/{location}/instances/{instance_id}` + * `projects/{project}/locations/{location}/instances/{instance_id}`. * @type string $description * Optional. The description of the instance. 2048 characters or less. * @type int $state @@ -153,53 +144,44 @@ class Instance extends \Google\Protobuf\Internal\Message * @type array|\Google\Protobuf\Internal\MapField $labels * Optional. Cloud Labels are a flexible and lightweight mechanism for * organizing cloud resources into groups that reflect a customer's - * organizational needs and deployment strategies. Cloud Labels can be used to - * filter collections of resources. They can be used to control how resource - * metrics are aggregated. And they can be used as arguments to policy - * management rules (e.g. route, firewall, load balancing, etc.). - * * Label keys must be between 1 and 63 characters long and must conform to - * the following regular expression: `[a-z][a-z0-9_-]{0,62}`. - * * Label values must be between 0 and 63 characters long and must conform - * to the regular expression `[a-z0-9_-]{0,63}`. - * * No more than 64 labels can be associated with a given resource. - * See https://goo.gl/xmQnxf for more information on and examples of labels. - * If you plan to use labels in your own code, please note that additional - * characters may be allowed in the future. Therefore, you are advised to use - * an internal label representation, such as JSON, which doesn't rely upon - * specific characters being disallowed. For example, representing labels - * as the string: name + "_" + value would prove problematic if we were to - * allow "_" in a future release. + * organizational needs and deployment strategies. See + * https://cloud.google.com/resource-manager/docs/labels-overview for details. * @type int|string $capacity_gib - * Required. Immutable. Storage capacity of Parallelstore instance in - * Gibibytes (GiB). + * Required. Immutable. The instance's storage capacity in Gibibytes (GiB). + * Allowed values are between 12000 and 100000, in multiples of 4000; e.g., + * 12000, 16000, 20000, ... * @type string $daos_version - * Output only. The version of DAOS software running in the instance + * Output only. The version of DAOS software running in the instance. * @type array|\Google\Protobuf\Internal\RepeatedField $access_points - * Output only. List of access_points. - * Contains a list of IPv4 addresses used for client side configuration. + * Output only. A list of IPv4 addresses used for client side configuration. * @type string $network - * Optional. Immutable. The name of the Google Compute Engine + * Optional. Immutable. The name of the Compute Engine * [VPC network](https://cloud.google.com/vpc/docs/vpc) to which the * instance is connected. * @type string $reserved_ip_range - * Optional. Immutable. Contains the id of the allocated IP address range - * associated with the private service access connection for example, - * "test-default" associated with IP range 10.0.0.0/29. If no range id is - * provided all ranges will be considered. + * Optional. Immutable. The ID of the IP address range being used by the + * instance's VPC network. See [Configure a VPC + * network](https://cloud.google.com/parallelstore/docs/vpc#create_and_configure_the_vpc). + * If no ID is provided, all ranges are considered. * @type string $effective_reserved_ip_range - * Output only. Immutable. Contains the id of the allocated IP address range - * associated with the private service access connection for example, - * "test-default" associated with IP range 10.0.0.0/29. This field is - * populated by the service and and contains the value currently used by the - * service. + * Output only. Immutable. The ID of the IP address range being used by the + * instance's VPC network. This field is populated by the service and contains + * the value currently used by the service. * @type int $file_stripe_level - * Optional. Stripe level for files. - * MIN better suited for small size files. - * MAX higher throughput performance for larger files. + * Optional. Stripe level for files. Allowed values are: + * * `FILE_STRIPE_LEVEL_MIN`: offers the best performance for small size + * files. + * * `FILE_STRIPE_LEVEL_BALANCED`: balances performance for workloads + * involving a mix of small and large files. + * * `FILE_STRIPE_LEVEL_MAX`: higher throughput performance for larger files. * @type int $directory_stripe_level - * Optional. Stripe level for directories. - * MIN when directory has a small number of files. - * MAX when directory has a large number of files. + * Optional. Stripe level for directories. Allowed values are: + * * `DIRECTORY_STRIPE_LEVEL_MIN`: recommended when directories contain a + * small number of files. + * * `DIRECTORY_STRIPE_LEVEL_BALANCED`: balances performance for workloads + * involving a mix of small and large directories. + * * `DIRECTORY_STRIPE_LEVEL_MAX`: recommended for directories with a large + * number of files. * } */ public function __construct($data = NULL) { @@ -209,7 +191,7 @@ public function __construct($data = NULL) { /** * Identifier. The resource name of the instance, in the format - * `projects/{project}/locations/{location}/instances/{instance_id}` + * `projects/{project}/locations/{location}/instances/{instance_id}`. * * Generated from protobuf field string name = 1 [(.google.api.field_behavior) = IDENTIFIER]; * @return string @@ -221,7 +203,7 @@ public function getName() /** * Identifier. The resource name of the instance, in the format - * `projects/{project}/locations/{location}/instances/{instance_id}` + * `projects/{project}/locations/{location}/instances/{instance_id}`. * * Generated from protobuf field string name = 1 [(.google.api.field_behavior) = IDENTIFIER]; * @param string $var @@ -362,22 +344,8 @@ public function setUpdateTime($var) /** * Optional. Cloud Labels are a flexible and lightweight mechanism for * organizing cloud resources into groups that reflect a customer's - * organizational needs and deployment strategies. Cloud Labels can be used to - * filter collections of resources. They can be used to control how resource - * metrics are aggregated. And they can be used as arguments to policy - * management rules (e.g. route, firewall, load balancing, etc.). - * * Label keys must be between 1 and 63 characters long and must conform to - * the following regular expression: `[a-z][a-z0-9_-]{0,62}`. - * * Label values must be between 0 and 63 characters long and must conform - * to the regular expression `[a-z0-9_-]{0,63}`. - * * No more than 64 labels can be associated with a given resource. - * See https://goo.gl/xmQnxf for more information on and examples of labels. - * If you plan to use labels in your own code, please note that additional - * characters may be allowed in the future. Therefore, you are advised to use - * an internal label representation, such as JSON, which doesn't rely upon - * specific characters being disallowed. For example, representing labels - * as the string: name + "_" + value would prove problematic if we were to - * allow "_" in a future release. + * organizational needs and deployment strategies. See + * https://cloud.google.com/resource-manager/docs/labels-overview for details. * * Generated from protobuf field map labels = 6 [(.google.api.field_behavior) = OPTIONAL]; * @return \Google\Protobuf\Internal\MapField @@ -390,22 +358,8 @@ public function getLabels() /** * Optional. Cloud Labels are a flexible and lightweight mechanism for * organizing cloud resources into groups that reflect a customer's - * organizational needs and deployment strategies. Cloud Labels can be used to - * filter collections of resources. They can be used to control how resource - * metrics are aggregated. And they can be used as arguments to policy - * management rules (e.g. route, firewall, load balancing, etc.). - * * Label keys must be between 1 and 63 characters long and must conform to - * the following regular expression: `[a-z][a-z0-9_-]{0,62}`. - * * Label values must be between 0 and 63 characters long and must conform - * to the regular expression `[a-z0-9_-]{0,63}`. - * * No more than 64 labels can be associated with a given resource. - * See https://goo.gl/xmQnxf for more information on and examples of labels. - * If you plan to use labels in your own code, please note that additional - * characters may be allowed in the future. Therefore, you are advised to use - * an internal label representation, such as JSON, which doesn't rely upon - * specific characters being disallowed. For example, representing labels - * as the string: name + "_" + value would prove problematic if we were to - * allow "_" in a future release. + * organizational needs and deployment strategies. See + * https://cloud.google.com/resource-manager/docs/labels-overview for details. * * Generated from protobuf field map labels = 6 [(.google.api.field_behavior) = OPTIONAL]; * @param array|\Google\Protobuf\Internal\MapField $var @@ -420,8 +374,9 @@ public function setLabels($var) } /** - * Required. Immutable. Storage capacity of Parallelstore instance in - * Gibibytes (GiB). + * Required. Immutable. The instance's storage capacity in Gibibytes (GiB). + * Allowed values are between 12000 and 100000, in multiples of 4000; e.g., + * 12000, 16000, 20000, ... * * Generated from protobuf field int64 capacity_gib = 8 [(.google.api.field_behavior) = IMMUTABLE, (.google.api.field_behavior) = REQUIRED]; * @return int|string @@ -432,8 +387,9 @@ public function getCapacityGib() } /** - * Required. Immutable. Storage capacity of Parallelstore instance in - * Gibibytes (GiB). + * Required. Immutable. The instance's storage capacity in Gibibytes (GiB). + * Allowed values are between 12000 and 100000, in multiples of 4000; e.g., + * 12000, 16000, 20000, ... * * Generated from protobuf field int64 capacity_gib = 8 [(.google.api.field_behavior) = IMMUTABLE, (.google.api.field_behavior) = REQUIRED]; * @param int|string $var @@ -448,7 +404,7 @@ public function setCapacityGib($var) } /** - * Output only. The version of DAOS software running in the instance + * Output only. The version of DAOS software running in the instance. * * Generated from protobuf field string daos_version = 9 [(.google.api.field_behavior) = OUTPUT_ONLY]; * @return string @@ -459,7 +415,7 @@ public function getDaosVersion() } /** - * Output only. The version of DAOS software running in the instance + * Output only. The version of DAOS software running in the instance. * * Generated from protobuf field string daos_version = 9 [(.google.api.field_behavior) = OUTPUT_ONLY]; * @param string $var @@ -474,8 +430,7 @@ public function setDaosVersion($var) } /** - * Output only. List of access_points. - * Contains a list of IPv4 addresses used for client side configuration. + * Output only. A list of IPv4 addresses used for client side configuration. * * Generated from protobuf field repeated string access_points = 10 [(.google.api.field_behavior) = OUTPUT_ONLY]; * @return \Google\Protobuf\Internal\RepeatedField @@ -486,8 +441,7 @@ public function getAccessPoints() } /** - * Output only. List of access_points. - * Contains a list of IPv4 addresses used for client side configuration. + * Output only. A list of IPv4 addresses used for client side configuration. * * Generated from protobuf field repeated string access_points = 10 [(.google.api.field_behavior) = OUTPUT_ONLY]; * @param array|\Google\Protobuf\Internal\RepeatedField $var @@ -502,7 +456,7 @@ public function setAccessPoints($var) } /** - * Optional. Immutable. The name of the Google Compute Engine + * Optional. Immutable. The name of the Compute Engine * [VPC network](https://cloud.google.com/vpc/docs/vpc) to which the * instance is connected. * @@ -515,7 +469,7 @@ public function getNetwork() } /** - * Optional. Immutable. The name of the Google Compute Engine + * Optional. Immutable. The name of the Compute Engine * [VPC network](https://cloud.google.com/vpc/docs/vpc) to which the * instance is connected. * @@ -532,10 +486,10 @@ public function setNetwork($var) } /** - * Optional. Immutable. Contains the id of the allocated IP address range - * associated with the private service access connection for example, - * "test-default" associated with IP range 10.0.0.0/29. If no range id is - * provided all ranges will be considered. + * Optional. Immutable. The ID of the IP address range being used by the + * instance's VPC network. See [Configure a VPC + * network](https://cloud.google.com/parallelstore/docs/vpc#create_and_configure_the_vpc). + * If no ID is provided, all ranges are considered. * * Generated from protobuf field string reserved_ip_range = 12 [(.google.api.field_behavior) = IMMUTABLE, (.google.api.field_behavior) = OPTIONAL, (.google.api.resource_reference) = { * @return string @@ -546,10 +500,10 @@ public function getReservedIpRange() } /** - * Optional. Immutable. Contains the id of the allocated IP address range - * associated with the private service access connection for example, - * "test-default" associated with IP range 10.0.0.0/29. If no range id is - * provided all ranges will be considered. + * Optional. Immutable. The ID of the IP address range being used by the + * instance's VPC network. See [Configure a VPC + * network](https://cloud.google.com/parallelstore/docs/vpc#create_and_configure_the_vpc). + * If no ID is provided, all ranges are considered. * * Generated from protobuf field string reserved_ip_range = 12 [(.google.api.field_behavior) = IMMUTABLE, (.google.api.field_behavior) = OPTIONAL, (.google.api.resource_reference) = { * @param string $var @@ -564,11 +518,9 @@ public function setReservedIpRange($var) } /** - * Output only. Immutable. Contains the id of the allocated IP address range - * associated with the private service access connection for example, - * "test-default" associated with IP range 10.0.0.0/29. This field is - * populated by the service and and contains the value currently used by the - * service. + * Output only. Immutable. The ID of the IP address range being used by the + * instance's VPC network. This field is populated by the service and contains + * the value currently used by the service. * * Generated from protobuf field string effective_reserved_ip_range = 14 [(.google.api.field_behavior) = IMMUTABLE, (.google.api.field_behavior) = OUTPUT_ONLY, (.google.api.resource_reference) = { * @return string @@ -579,11 +531,9 @@ public function getEffectiveReservedIpRange() } /** - * Output only. Immutable. Contains the id of the allocated IP address range - * associated with the private service access connection for example, - * "test-default" associated with IP range 10.0.0.0/29. This field is - * populated by the service and and contains the value currently used by the - * service. + * Output only. Immutable. The ID of the IP address range being used by the + * instance's VPC network. This field is populated by the service and contains + * the value currently used by the service. * * Generated from protobuf field string effective_reserved_ip_range = 14 [(.google.api.field_behavior) = IMMUTABLE, (.google.api.field_behavior) = OUTPUT_ONLY, (.google.api.resource_reference) = { * @param string $var @@ -598,9 +548,12 @@ public function setEffectiveReservedIpRange($var) } /** - * Optional. Stripe level for files. - * MIN better suited for small size files. - * MAX higher throughput performance for larger files. + * Optional. Stripe level for files. Allowed values are: + * * `FILE_STRIPE_LEVEL_MIN`: offers the best performance for small size + * files. + * * `FILE_STRIPE_LEVEL_BALANCED`: balances performance for workloads + * involving a mix of small and large files. + * * `FILE_STRIPE_LEVEL_MAX`: higher throughput performance for larger files. * * Generated from protobuf field .google.cloud.parallelstore.v1beta.FileStripeLevel file_stripe_level = 15 [(.google.api.field_behavior) = OPTIONAL]; * @return int @@ -611,9 +564,12 @@ public function getFileStripeLevel() } /** - * Optional. Stripe level for files. - * MIN better suited for small size files. - * MAX higher throughput performance for larger files. + * Optional. Stripe level for files. Allowed values are: + * * `FILE_STRIPE_LEVEL_MIN`: offers the best performance for small size + * files. + * * `FILE_STRIPE_LEVEL_BALANCED`: balances performance for workloads + * involving a mix of small and large files. + * * `FILE_STRIPE_LEVEL_MAX`: higher throughput performance for larger files. * * Generated from protobuf field .google.cloud.parallelstore.v1beta.FileStripeLevel file_stripe_level = 15 [(.google.api.field_behavior) = OPTIONAL]; * @param int $var @@ -628,9 +584,13 @@ public function setFileStripeLevel($var) } /** - * Optional. Stripe level for directories. - * MIN when directory has a small number of files. - * MAX when directory has a large number of files. + * Optional. Stripe level for directories. Allowed values are: + * * `DIRECTORY_STRIPE_LEVEL_MIN`: recommended when directories contain a + * small number of files. + * * `DIRECTORY_STRIPE_LEVEL_BALANCED`: balances performance for workloads + * involving a mix of small and large directories. + * * `DIRECTORY_STRIPE_LEVEL_MAX`: recommended for directories with a large + * number of files. * * Generated from protobuf field .google.cloud.parallelstore.v1beta.DirectoryStripeLevel directory_stripe_level = 16 [(.google.api.field_behavior) = OPTIONAL]; * @return int @@ -641,9 +601,13 @@ public function getDirectoryStripeLevel() } /** - * Optional. Stripe level for directories. - * MIN when directory has a small number of files. - * MAX when directory has a large number of files. + * Optional. Stripe level for directories. Allowed values are: + * * `DIRECTORY_STRIPE_LEVEL_MIN`: recommended when directories contain a + * small number of files. + * * `DIRECTORY_STRIPE_LEVEL_BALANCED`: balances performance for workloads + * involving a mix of small and large directories. + * * `DIRECTORY_STRIPE_LEVEL_MAX`: recommended for directories with a large + * number of files. * * Generated from protobuf field .google.cloud.parallelstore.v1beta.DirectoryStripeLevel directory_stripe_level = 16 [(.google.api.field_behavior) = OPTIONAL]; * @param int $var diff --git a/Parallelstore/src/V1beta/Instance/State.php b/Parallelstore/src/V1beta/Instance/State.php index f329c415819d..dcb59b8bc071 100644 --- a/Parallelstore/src/V1beta/Instance/State.php +++ b/Parallelstore/src/V1beta/Instance/State.php @@ -7,7 +7,7 @@ use UnexpectedValueException; /** - * Represents the different states of a Parallelstore instance. + * The possible states of a Parallelstore instance. * * Protobuf type google.cloud.parallelstore.v1beta.Instance.State */ @@ -43,6 +43,12 @@ class State * Generated from protobuf enum FAILED = 4; */ const FAILED = 4; + /** + * The instance is being upgraded. + * + * Generated from protobuf enum UPGRADING = 5; + */ + const UPGRADING = 5; private static $valueToName = [ self::STATE_UNSPECIFIED => 'STATE_UNSPECIFIED', @@ -50,6 +56,7 @@ class State self::ACTIVE => 'ACTIVE', self::DELETING => 'DELETING', self::FAILED => 'FAILED', + self::UPGRADING => 'UPGRADING', ]; public static function name($value) diff --git a/Parallelstore/src/V1beta/ListInstancesRequest.php b/Parallelstore/src/V1beta/ListInstancesRequest.php index 4b68c82bf645..7a8b21e383d0 100644 --- a/Parallelstore/src/V1beta/ListInstancesRequest.php +++ b/Parallelstore/src/V1beta/ListInstancesRequest.php @@ -9,7 +9,7 @@ use Google\Protobuf\Internal\GPBUtil; /** - * Message for requesting list of Instances + * List instances request. * * Generated from protobuf message google.cloud.parallelstore.v1beta.ListInstancesRequest */ @@ -18,17 +18,15 @@ class ListInstancesRequest extends \Google\Protobuf\Internal\Message /** * Required. The project and location for which to retrieve instance * information, in the format `projects/{project_id}/locations/{location}`. - * For Parallelstore locations map to Google Cloud zones, for example - * **us-central1-a**. - * To retrieve instance information for all locations, use "-" for the - * `{location}` value. + * To retrieve instance information for all locations, use "-" as the value of + * `{location}`. * * Generated from protobuf field string parent = 1 [(.google.api.field_behavior) = REQUIRED, (.google.api.resource_reference) = { */ protected $parent = ''; /** * Optional. Requested page size. Server may return fewer items than - * requested. If unspecified, server will pick an appropriate default. + * requested. If unspecified, the server will pick an appropriate default. * * Generated from protobuf field int32 page_size = 2 [(.google.api.field_behavior) = OPTIONAL]; */ @@ -40,13 +38,13 @@ class ListInstancesRequest extends \Google\Protobuf\Internal\Message */ protected $page_token = ''; /** - * Optional. Filtering results + * Optional. Filtering results. * * Generated from protobuf field string filter = 4 [(.google.api.field_behavior) = OPTIONAL]; */ protected $filter = ''; /** - * Optional. Hint for how to order the results + * Optional. Hint for how to order the results. * * Generated from protobuf field string order_by = 5 [(.google.api.field_behavior) = OPTIONAL]; */ @@ -55,10 +53,9 @@ class ListInstancesRequest extends \Google\Protobuf\Internal\Message /** * @param string $parent Required. The project and location for which to retrieve instance * information, in the format `projects/{project_id}/locations/{location}`. - * For Parallelstore locations map to Google Cloud zones, for example - * **us-central1-a**. - * To retrieve instance information for all locations, use "-" for the - * `{location}` value. Please see + * + * To retrieve instance information for all locations, use "-" as the value of + * `{location}`. Please see * {@see ParallelstoreClient::locationName()} for help formatting this field. * * @return \Google\Cloud\Parallelstore\V1beta\ListInstancesRequest @@ -80,19 +77,17 @@ public static function build(string $parent): self * @type string $parent * Required. The project and location for which to retrieve instance * information, in the format `projects/{project_id}/locations/{location}`. - * For Parallelstore locations map to Google Cloud zones, for example - * **us-central1-a**. - * To retrieve instance information for all locations, use "-" for the - * `{location}` value. + * To retrieve instance information for all locations, use "-" as the value of + * `{location}`. * @type int $page_size * Optional. Requested page size. Server may return fewer items than - * requested. If unspecified, server will pick an appropriate default. + * requested. If unspecified, the server will pick an appropriate default. * @type string $page_token * Optional. A token identifying a page of results the server should return. * @type string $filter - * Optional. Filtering results + * Optional. Filtering results. * @type string $order_by - * Optional. Hint for how to order the results + * Optional. Hint for how to order the results. * } */ public function __construct($data = NULL) { @@ -103,10 +98,8 @@ public function __construct($data = NULL) { /** * Required. The project and location for which to retrieve instance * information, in the format `projects/{project_id}/locations/{location}`. - * For Parallelstore locations map to Google Cloud zones, for example - * **us-central1-a**. - * To retrieve instance information for all locations, use "-" for the - * `{location}` value. + * To retrieve instance information for all locations, use "-" as the value of + * `{location}`. * * Generated from protobuf field string parent = 1 [(.google.api.field_behavior) = REQUIRED, (.google.api.resource_reference) = { * @return string @@ -119,10 +112,8 @@ public function getParent() /** * Required. The project and location for which to retrieve instance * information, in the format `projects/{project_id}/locations/{location}`. - * For Parallelstore locations map to Google Cloud zones, for example - * **us-central1-a**. - * To retrieve instance information for all locations, use "-" for the - * `{location}` value. + * To retrieve instance information for all locations, use "-" as the value of + * `{location}`. * * Generated from protobuf field string parent = 1 [(.google.api.field_behavior) = REQUIRED, (.google.api.resource_reference) = { * @param string $var @@ -138,7 +129,7 @@ public function setParent($var) /** * Optional. Requested page size. Server may return fewer items than - * requested. If unspecified, server will pick an appropriate default. + * requested. If unspecified, the server will pick an appropriate default. * * Generated from protobuf field int32 page_size = 2 [(.google.api.field_behavior) = OPTIONAL]; * @return int @@ -150,7 +141,7 @@ public function getPageSize() /** * Optional. Requested page size. Server may return fewer items than - * requested. If unspecified, server will pick an appropriate default. + * requested. If unspecified, the server will pick an appropriate default. * * Generated from protobuf field int32 page_size = 2 [(.google.api.field_behavior) = OPTIONAL]; * @param int $var @@ -191,7 +182,7 @@ public function setPageToken($var) } /** - * Optional. Filtering results + * Optional. Filtering results. * * Generated from protobuf field string filter = 4 [(.google.api.field_behavior) = OPTIONAL]; * @return string @@ -202,7 +193,7 @@ public function getFilter() } /** - * Optional. Filtering results + * Optional. Filtering results. * * Generated from protobuf field string filter = 4 [(.google.api.field_behavior) = OPTIONAL]; * @param string $var @@ -217,7 +208,7 @@ public function setFilter($var) } /** - * Optional. Hint for how to order the results + * Optional. Hint for how to order the results. * * Generated from protobuf field string order_by = 5 [(.google.api.field_behavior) = OPTIONAL]; * @return string @@ -228,7 +219,7 @@ public function getOrderBy() } /** - * Optional. Hint for how to order the results + * Optional. Hint for how to order the results. * * Generated from protobuf field string order_by = 5 [(.google.api.field_behavior) = OPTIONAL]; * @param string $var diff --git a/Parallelstore/src/V1beta/ListInstancesResponse.php b/Parallelstore/src/V1beta/ListInstancesResponse.php index f99433f0263c..771809f64967 100644 --- a/Parallelstore/src/V1beta/ListInstancesResponse.php +++ b/Parallelstore/src/V1beta/ListInstancesResponse.php @@ -9,14 +9,15 @@ use Google\Protobuf\Internal\GPBUtil; /** - * Message for response to listing Instances + * Response from + * [ListInstances][google.cloud.parallelstore.v1beta.Parallelstore.ListInstances]. * * Generated from protobuf message google.cloud.parallelstore.v1beta.ListInstancesResponse */ class ListInstancesResponse extends \Google\Protobuf\Internal\Message { /** - * The list of Parallelstore Instances + * The list of Parallelstore instances. * * Generated from protobuf field repeated .google.cloud.parallelstore.v1beta.Instance instances = 1; */ @@ -41,7 +42,7 @@ class ListInstancesResponse extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type array<\Google\Cloud\Parallelstore\V1beta\Instance>|\Google\Protobuf\Internal\RepeatedField $instances - * The list of Parallelstore Instances + * The list of Parallelstore instances. * @type string $next_page_token * A token identifying a page of results the server should return. * @type array|\Google\Protobuf\Internal\RepeatedField $unreachable @@ -54,7 +55,7 @@ public function __construct($data = NULL) { } /** - * The list of Parallelstore Instances + * The list of Parallelstore instances. * * Generated from protobuf field repeated .google.cloud.parallelstore.v1beta.Instance instances = 1; * @return \Google\Protobuf\Internal\RepeatedField @@ -65,7 +66,7 @@ public function getInstances() } /** - * The list of Parallelstore Instances + * The list of Parallelstore instances. * * Generated from protobuf field repeated .google.cloud.parallelstore.v1beta.Instance instances = 1; * @param array<\Google\Cloud\Parallelstore\V1beta\Instance>|\Google\Protobuf\Internal\RepeatedField $var diff --git a/Parallelstore/src/V1beta/OperationMetadata.php b/Parallelstore/src/V1beta/OperationMetadata.php index 962f3ff16a25..4c18d216563a 100644 --- a/Parallelstore/src/V1beta/OperationMetadata.php +++ b/Parallelstore/src/V1beta/OperationMetadata.php @@ -9,7 +9,7 @@ use Google\Protobuf\Internal\GPBUtil; /** - * Represents the metadata of the long-running operation. + * Long-running operation metadata. * * Generated from protobuf message google.cloud.parallelstore.v1beta.OperationMetadata */ diff --git a/Parallelstore/src/V1beta/SourceGcsBucket.php b/Parallelstore/src/V1beta/SourceGcsBucket.php index 600704436b92..d75c59be5ee4 100644 --- a/Parallelstore/src/V1beta/SourceGcsBucket.php +++ b/Parallelstore/src/V1beta/SourceGcsBucket.php @@ -9,15 +9,16 @@ use Google\Protobuf\Internal\GPBUtil; /** - * Google Cloud Storage as a source. + * Cloud Storage as the source of a data transfer. * * Generated from protobuf message google.cloud.parallelstore.v1beta.SourceGcsBucket */ class SourceGcsBucket extends \Google\Protobuf\Internal\Message { /** - * Required. URI to a Cloud Storage object in format: - * 'gs:///'. + * Required. URI to a Cloud Storage bucket in the format: + * `gs:///`. The path inside the bucket is + * optional. * * Generated from protobuf field string uri = 1 [(.google.api.field_behavior) = REQUIRED]; */ @@ -30,8 +31,9 @@ class SourceGcsBucket extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type string $uri - * Required. URI to a Cloud Storage object in format: - * 'gs:///'. + * Required. URI to a Cloud Storage bucket in the format: + * `gs:///`. The path inside the bucket is + * optional. * } */ public function __construct($data = NULL) { @@ -40,8 +42,9 @@ public function __construct($data = NULL) { } /** - * Required. URI to a Cloud Storage object in format: - * 'gs:///'. + * Required. URI to a Cloud Storage bucket in the format: + * `gs:///`. The path inside the bucket is + * optional. * * Generated from protobuf field string uri = 1 [(.google.api.field_behavior) = REQUIRED]; * @return string @@ -52,8 +55,9 @@ public function getUri() } /** - * Required. URI to a Cloud Storage object in format: - * 'gs:///'. + * Required. URI to a Cloud Storage bucket in the format: + * `gs:///`. The path inside the bucket is + * optional. * * Generated from protobuf field string uri = 1 [(.google.api.field_behavior) = REQUIRED]; * @param string $var diff --git a/Parallelstore/src/V1beta/SourceParallelstore.php b/Parallelstore/src/V1beta/SourceParallelstore.php index b3711c983c9a..9d009c92d2a9 100644 --- a/Parallelstore/src/V1beta/SourceParallelstore.php +++ b/Parallelstore/src/V1beta/SourceParallelstore.php @@ -9,7 +9,7 @@ use Google\Protobuf\Internal\GPBUtil; /** - * Pa as a source. + * Parallelstore as the source of a data transfer. * * Generated from protobuf message google.cloud.parallelstore.v1beta.SourceParallelstore */ @@ -17,7 +17,7 @@ class SourceParallelstore extends \Google\Protobuf\Internal\Message { /** * Optional. Root directory path to the Paralellstore filesystem, starting - * with '/'. Defaults to '/' if unset. + * with `/`. Defaults to `/` if unset. * * Generated from protobuf field string path = 1 [(.google.api.field_behavior) = OPTIONAL]; */ @@ -31,7 +31,7 @@ class SourceParallelstore extends \Google\Protobuf\Internal\Message * * @type string $path * Optional. Root directory path to the Paralellstore filesystem, starting - * with '/'. Defaults to '/' if unset. + * with `/`. Defaults to `/` if unset. * } */ public function __construct($data = NULL) { @@ -41,7 +41,7 @@ public function __construct($data = NULL) { /** * Optional. Root directory path to the Paralellstore filesystem, starting - * with '/'. Defaults to '/' if unset. + * with `/`. Defaults to `/` if unset. * * Generated from protobuf field string path = 1 [(.google.api.field_behavior) = OPTIONAL]; * @return string @@ -53,7 +53,7 @@ public function getPath() /** * Optional. Root directory path to the Paralellstore filesystem, starting - * with '/'. Defaults to '/' if unset. + * with `/`. Defaults to `/` if unset. * * Generated from protobuf field string path = 1 [(.google.api.field_behavior) = OPTIONAL]; * @param string $var diff --git a/Parallelstore/src/V1beta/TransferOperationMetadata.php b/Parallelstore/src/V1beta/TransferOperationMetadata.php index b454093a3cae..6a51f19d65e6 100644 --- a/Parallelstore/src/V1beta/TransferOperationMetadata.php +++ b/Parallelstore/src/V1beta/TransferOperationMetadata.php @@ -9,14 +9,14 @@ use Google\Protobuf\Internal\GPBUtil; /** - * Represents the metadata of the long-running operation. + * Long-running operation metadata related to a data transfer. * * Generated from protobuf message google.cloud.parallelstore.v1beta.TransferOperationMetadata */ class TransferOperationMetadata extends \Google\Protobuf\Internal\Message { /** - * Output only. Information about the progress of the transfer operation. + * Output only. The progress of the transfer operation. * * Generated from protobuf field .google.cloud.parallelstore.v1beta.TransferCounters counters = 3 [(.google.api.field_behavior) = OUTPUT_ONLY]; */ @@ -45,7 +45,7 @@ class TransferOperationMetadata extends \Google\Protobuf\Internal\Message * @type \Google\Cloud\Parallelstore\V1beta\DestinationParallelstore $destination_parallelstore * Output only. Parallelstore destination. * @type \Google\Cloud\Parallelstore\V1beta\TransferCounters $counters - * Output only. Information about the progress of the transfer operation. + * Output only. The progress of the transfer operation. * @type int $transfer_type * Output only. The type of transfer occurring. * } @@ -180,7 +180,7 @@ public function setDestinationParallelstore($var) } /** - * Output only. Information about the progress of the transfer operation. + * Output only. The progress of the transfer operation. * * Generated from protobuf field .google.cloud.parallelstore.v1beta.TransferCounters counters = 3 [(.google.api.field_behavior) = OUTPUT_ONLY]; * @return \Google\Cloud\Parallelstore\V1beta\TransferCounters|null @@ -201,7 +201,7 @@ public function clearCounters() } /** - * Output only. Information about the progress of the transfer operation. + * Output only. The progress of the transfer operation. * * Generated from protobuf field .google.cloud.parallelstore.v1beta.TransferCounters counters = 3 [(.google.api.field_behavior) = OUTPUT_ONLY]; * @param \Google\Cloud\Parallelstore\V1beta\TransferCounters $var diff --git a/Parallelstore/src/V1beta/UpdateInstanceRequest.php b/Parallelstore/src/V1beta/UpdateInstanceRequest.php index 1bdb861f0d2b..4ef5ca11a7b2 100644 --- a/Parallelstore/src/V1beta/UpdateInstanceRequest.php +++ b/Parallelstore/src/V1beta/UpdateInstanceRequest.php @@ -9,14 +9,14 @@ use Google\Protobuf\Internal\GPBUtil; /** - * Message for updating a Instance + * Update an instance. * * Generated from protobuf message google.cloud.parallelstore.v1beta.UpdateInstanceRequest */ class UpdateInstanceRequest extends \Google\Protobuf\Internal\Message { /** - * Required. Mask of fields to update .Field mask is used to specify the + * Required. Mask of fields to update. Field mask is used to specify the * fields to be overwritten in the Instance resource by the update. At least * one path must be supplied in this field. The fields specified in the * update_mask are relative to the resource, not the full request. @@ -25,7 +25,7 @@ class UpdateInstanceRequest extends \Google\Protobuf\Internal\Message */ protected $update_mask = null; /** - * Required. The instance to update + * Required. The instance to update. * * Generated from protobuf field .google.cloud.parallelstore.v1beta.Instance instance = 2 [(.google.api.field_behavior) = REQUIRED]; */ @@ -48,8 +48,8 @@ class UpdateInstanceRequest extends \Google\Protobuf\Internal\Message protected $request_id = ''; /** - * @param \Google\Cloud\Parallelstore\V1beta\Instance $instance Required. The instance to update - * @param \Google\Protobuf\FieldMask $updateMask Required. Mask of fields to update .Field mask is used to specify the + * @param \Google\Cloud\Parallelstore\V1beta\Instance $instance Required. The instance to update. + * @param \Google\Protobuf\FieldMask $updateMask Required. Mask of fields to update. Field mask is used to specify the * fields to be overwritten in the Instance resource by the update. At least * one path must be supplied in this field. The fields specified in the * update_mask are relative to the resource, not the full request. @@ -72,12 +72,12 @@ public static function build(\Google\Cloud\Parallelstore\V1beta\Instance $instan * Optional. Data for populating the Message object. * * @type \Google\Protobuf\FieldMask $update_mask - * Required. Mask of fields to update .Field mask is used to specify the + * Required. Mask of fields to update. Field mask is used to specify the * fields to be overwritten in the Instance resource by the update. At least * one path must be supplied in this field. The fields specified in the * update_mask are relative to the resource, not the full request. * @type \Google\Cloud\Parallelstore\V1beta\Instance $instance - * Required. The instance to update + * Required. The instance to update. * @type string $request_id * Optional. An optional request ID to identify requests. Specify a unique * request ID so that if you must retry your request, the server will know to @@ -98,7 +98,7 @@ public function __construct($data = NULL) { } /** - * Required. Mask of fields to update .Field mask is used to specify the + * Required. Mask of fields to update. Field mask is used to specify the * fields to be overwritten in the Instance resource by the update. At least * one path must be supplied in this field. The fields specified in the * update_mask are relative to the resource, not the full request. @@ -122,7 +122,7 @@ public function clearUpdateMask() } /** - * Required. Mask of fields to update .Field mask is used to specify the + * Required. Mask of fields to update. Field mask is used to specify the * fields to be overwritten in the Instance resource by the update. At least * one path must be supplied in this field. The fields specified in the * update_mask are relative to the resource, not the full request. @@ -140,7 +140,7 @@ public function setUpdateMask($var) } /** - * Required. The instance to update + * Required. The instance to update. * * Generated from protobuf field .google.cloud.parallelstore.v1beta.Instance instance = 2 [(.google.api.field_behavior) = REQUIRED]; * @return \Google\Cloud\Parallelstore\V1beta\Instance|null @@ -161,7 +161,7 @@ public function clearInstance() } /** - * Required. The instance to update + * Required. The instance to update. * * Generated from protobuf field .google.cloud.parallelstore.v1beta.Instance instance = 2 [(.google.api.field_behavior) = REQUIRED]; * @param \Google\Cloud\Parallelstore\V1beta\Instance $var