feat: add transfer metadata options proto definition

docs: update tickets component number

PiperOrigin-RevId: 839132650

Author: Google APIs

google/cloud/parallelstore/v1/parallelstore.proto

@@ -270,8 +270,8 @@ message Instance {
     (google.api.field_behavior) = REQUIRED
   ];
 
-  // 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.
   string daos_version = 9
       [deprecated = true, (google.api.field_behavior) = OUTPUT_ONLY];
 
@@ -343,6 +343,54 @@ message Instance {
   ];
 }
 
+// Transfer metadata options for the instance.
+message TransferMetadataOptions {
+  // The UID preservation behavior.
+  enum Uid {
+    // default is UID_NUMBER_PRESERVE.
+    UID_UNSPECIFIED = 0;
+
+    // Do not preserve UID during a transfer job.
+    UID_SKIP = 1;
+
+    // Preserve UID that is in number format during a transfer job.
+    UID_NUMBER_PRESERVE = 2;
+  }
+
+  // The GID preservation behavior.
+  enum Gid {
+    // default is GID_NUMBER_PRESERVE.
+    GID_UNSPECIFIED = 0;
+
+    // Do not preserve GID during a transfer job.
+    GID_SKIP = 1;
+
+    // Preserve GID that is in number format during a transfer job.
+    GID_NUMBER_PRESERVE = 2;
+  }
+
+  // The mode preservation behavior.
+  enum Mode {
+    // default is MODE_PRESERVE.
+    MODE_UNSPECIFIED = 0;
+
+    // Do not preserve mode during a transfer job.
+    MODE_SKIP = 1;
+
+    // Preserve mode during a transfer job.
+    MODE_PRESERVE = 2;
+  }
+
+  // Optional. The UID preservation behavior.
+  Uid uid = 1 [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. The GID preservation behavior.
+  Gid gid = 2 [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. The mode preservation behavior.
+  Mode mode = 3 [(google.api.field_behavior) = OPTIONAL];
+}
+
 // List instances request.
 message ListInstancesRequest {
   // Required. The project and location for which to retrieve instance
@@ -425,8 +473,8 @@ message CreateInstanceRequest {
   // 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.
@@ -453,8 +501,8 @@ message UpdateInstanceRequest {
   // 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.
@@ -479,8 +527,8 @@ message DeleteInstanceRequest {
   // 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.
@@ -577,8 +625,8 @@ message ImportDataRequest {
   // 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.
@@ -607,6 +655,10 @@ message ImportDataRequest {
       type: "iam.googleapis.com/ServiceAccount"
     }
   ];
+
+  // Optional. The transfer metadata options for the import data.
+  TransferMetadataOptions metadata_options = 6
+      [(google.api.field_behavior) = OPTIONAL];
 }
 
 // Export data from Parallelstore to Cloud Storage.
@@ -636,8 +688,8 @@ message ExportDataRequest {
   // 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.
@@ -665,6 +717,10 @@ message ExportDataRequest {
       type: "iam.googleapis.com/ServiceAccount"
     }
   ];
+
+  // Optional. The metadata options for the export data.
+  TransferMetadataOptions metadata_options = 6
+      [(google.api.field_behavior) = OPTIONAL];
 }
 
 // The response to a request to import data to Parallelstore.
@@ -824,9 +880,9 @@ message TransferCounters {
   // Bytes that are copied to the data destination.
   int64 bytes_copied = 6;
 
-  // Objects that are failed to write to the data destination.
+  // Objects that failed to be written to the data destination.
   int64 objects_failed = 7;
 
-  // Bytes that are failed to write to the data destination.
+  // Bytes that failed to be written to the data destination.
   int64 bytes_failed = 8;
 }

google/cloud/parallelstore/v1/parallelstore_v1.yaml

@@ -55,7 +55,7 @@ authentication:
         https://www.googleapis.com/auth/cloud-platform
 
 publishing:
-  new_issue_uri: https://issuetracker.google.com/issues/new?component=1605177
+  new_issue_uri: https://issuetracker.google.com/issues/new?component=1181190
   documentation_uri: https://cloud.google.com/parallelstore?hl=en
   api_short_name: parallelstore
   github_label: 'api: parallelstore'