google-cloud-storage_transfer-v1 0.8.0 → 1.10.0

data/proto_docs/google/storagetransfer/v1/transfer_types.rb

@@ -76,6 +76,13 @@ module Google
         # the `updated` property of Cloud Storage objects, the `LastModified` field
         # of S3 objects, and the `Last-Modified` header of Azure blobs.
         #
+        # For S3 objects, the `LastModified` value is the time the object begins
+        # uploading. If the object meets your "last modification time" criteria,
+        # but has not finished uploading, the object is not transferred. See
+        # [Transfer from Amazon S3 to Cloud
+        # Storage](https://cloud.google.com/storage-transfer/docs/create-transfers/agentless/s3#transfer_options)
+        # for more information.
+        #
         # Transfers with a {::Google::Cloud::StorageTransfer::V1::PosixFilesystem PosixFilesystem}
         # source or destination don't support `ObjectConditions`.
         # @!attribute [rw] min_time_elapsed_since_last_modification
@@ -206,6 +213,21 @@ module Google
         #
         #     The root path value must meet
         #     [Object Name Requirements](/storage/docs/naming#objectnames).
+        # @!attribute [rw] managed_folder_transfer_enabled
+        #   @return [::Boolean]
+        #     Preview. Enables the transfer of managed folders between Cloud Storage
+        #     buckets. Set this option on the gcs_data_source.
+        #
+        #     If set to true:
+        #
+        #     - Managed folders in the source bucket are transferred to the
+        #       destination bucket.
+        #     - Managed folders in the destination bucket are overwritten. Other
+        #       OVERWRITE options are not supported.
+        #
+        #     See
+        #     [Transfer Cloud Storage managed
+        #     folders](/storage-transfer/docs/managed-folders).
         class GcsData
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -245,27 +267,45 @@ module Google
         #     the provided role using the
         #     {::Google::Cloud::StorageTransfer::V1::GoogleServiceAccount GoogleServiceAccount} for
         #     this project.
+        # @!attribute [rw] cloudfront_domain
+        #   @return [::String]
+        #     Optional. The CloudFront distribution domain name pointing to this bucket,
+        #     to use when fetching.
+        #
+        #     See
+        #     [Transfer from S3 via
+        #     CloudFront](https://cloud.google.com/storage-transfer/docs/s3-cloudfront)
+        #     for more information.
+        #
+        #     Format: `https://{id}.cloudfront.net` or any valid custom domain. Must
+        #     begin with `https://`.
         # @!attribute [rw] credentials_secret
         #   @return [::String]
         #     Optional. The Resource name of a secret in Secret Manager.
         #
-        #     The Azure SAS token must be stored in Secret Manager in JSON format:
-        #     <pre>{
-        #      "sas_token" : "<var>SAS_TOKEN</var>"
-        #     }</pre>
+        #     AWS credentials must be stored in Secret Manager in JSON format:
+        #
+        #     {
+        #      "access_key_id": "ACCESS_KEY_ID",
+        #      "secret_access_key": "SECRET_ACCESS_KEY"
+        #     }
+        #
         #     {::Google::Cloud::StorageTransfer::V1::GoogleServiceAccount GoogleServiceAccount} must
         #     be granted `roles/secretmanager.secretAccessor` for the resource.
         #
-        #     See [Configure access to a source: Microsoft Azure Blob Storage]
-        #     (https://cloud.google.com/storage-transfer/docs/source-microsoft-azure#secret_manager)
+        #     See [Configure access to a source: Amazon S3]
+        #     (https://cloud.google.com/storage-transfer/docs/source-amazon-s3#secret_manager)
         #     for more information.
         #
-        #     If `credentials_secret` is specified, do not specify [azure_credentials][].
-        #
-        #     This feature is in
-        #     [preview](https://cloud.google.com/terms/service-terms#1).
+        #     If `credentials_secret` is specified, do not specify
+        #     {::Google::Cloud::StorageTransfer::V1::AwsS3Data#role_arn role_arn} or
+        #     {::Google::Cloud::StorageTransfer::V1::AwsS3Data#aws_access_key aws_access_key}.
         #
         #     Format: `projects/{project_number}/secrets/{secret_name}`
+        # @!attribute [rw] managed_private_network
+        #   @return [::Boolean]
+        #     Egress bytes over a Google-managed private network.
+        #     This network is shared between other users of Storage Transfer Service.
         class AwsS3Data
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -303,9 +343,11 @@ module Google
         #     Optional. The Resource name of a secret in Secret Manager.
         #
         #     The Azure SAS token must be stored in Secret Manager in JSON format:
-        #     <pre>{
-        #      "sas_token" : "<var>SAS_TOKEN</var>"
-        #     }</pre>
+        #
+        #     {
+        #      "sas_token" : "SAS_TOKEN"
+        #     }
+        #
         #     {::Google::Cloud::StorageTransfer::V1::GoogleServiceAccount GoogleServiceAccount} must
         #     be granted `roles/secretmanager.secretAccessor` for the resource.
         #
@@ -316,60 +358,89 @@ module Google
         #     If `credentials_secret` is specified, do not specify
         #     {::Google::Cloud::StorageTransfer::V1::AzureBlobStorageData#azure_credentials azure_credentials}.
         #
-        #     This feature is in
-        #     [preview](https://cloud.google.com/terms/service-terms#1).
-        #
         #     Format: `projects/{project_number}/secrets/{secret_name}`
+        # @!attribute [rw] federated_identity_config
+        #   @return [::Google::Cloud::StorageTransfer::V1::AzureBlobStorageData::FederatedIdentityConfig]
+        #     Optional. Federated identity config of a user registered Azure application.
+        #
+        #     If `federated_identity_config` is specified, do not specify
+        #     {::Google::Cloud::StorageTransfer::V1::AzureBlobStorageData#azure_credentials azure_credentials}
+        #     or
+        #     {::Google::Cloud::StorageTransfer::V1::AzureBlobStorageData#credentials_secret credentials_secret}.
         class AzureBlobStorageData
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
+
+          # The identity of an Azure application through which Storage Transfer Service
+          # can authenticate requests using Azure workload identity federation.
+          #
+          # Storage Transfer Service can issue requests to Azure Storage through
+          # registered Azure applications, eliminating the need to pass credentials to
+          # Storage Transfer Service directly.
+          #
+          # To configure federated identity, see
+          # [Configure access to Microsoft Azure
+          # Storage](https://cloud.google.com/storage-transfer/docs/source-microsoft-azure#option_3_authenticate_using_federated_identity).
+          # @!attribute [rw] client_id
+          #   @return [::String]
+          #     Required. The client (application) ID of the application with federated
+          #     credentials.
+          # @!attribute [rw] tenant_id
+          #   @return [::String]
+          #     Required. The tenant (directory) ID of the application with federated
+          #     credentials.
+          class FederatedIdentityConfig
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
         end
 
-        # An HttpData resource specifies a list of objects on the web to be transferred
-        # over HTTP.  The information of the objects to be transferred is contained in
-        # a file referenced by a URL. The first line in the file must be
-        # `"TsvHttpData-1.0"`, which specifies the format of the file.  Subsequent
-        # lines specify the information of the list of objects, one object per list
-        # entry. Each entry has the following tab-delimited fields:
+        # An HttpData resource specifies a list of objects on the web to be
+        #  transferred over HTTP.  The information of the objects to be transferred is
+        #  contained in a file referenced by a URL. The first line in the file must be
+        #  `"TsvHttpData-1.0"`, which specifies the format of the file.  Subsequent
+        #  lines specify the information of the list of objects, one object per list
+        #  entry. Each entry has the following tab-delimited fields:
         #
-        # * **HTTP URL** — The location of the object.
+        #  * **HTTP URL** — The location of the object.
         #
-        # * **Length** — The size of the object in bytes.
+        #  * **Length** — The size of the object in bytes.
         #
-        # * **MD5** — The base64-encoded MD5 hash of the object.
+        #  * **MD5** — The base64-encoded MD5 hash of the object.
         #
-        # For an example of a valid TSV file, see
-        # [Transferring data from
-        # URLs](https://cloud.google.com/storage-transfer/docs/create-url-list).
+        #  For an example of a valid TSV file, see
+        #  [Transferring data from
+        #  URLs](https://cloud.google.com/storage-transfer/docs/create-url-list).
         #
-        # When transferring data based on a URL list, keep the following in mind:
+        #  When transferring data based on a URL list, keep the following in mind:
         #
         # * When an object located at `http(s)://hostname:port/<URL-path>` is
-        # transferred to a data sink, the name of the object at the data sink is
+        #  transferred to a data sink, the name of the object at the data sink is
         # `<hostname>/<URL-path>`.
         #
         # * If the specified size of an object does not match the actual size of the
-        # object fetched, the object is not transferred.
+        #  object fetched, the object is not transferred.
         #
         # * If the specified MD5 does not match the MD5 computed from the transferred
-        # bytes, the object transfer fails.
+        #  bytes, the object transfer fails.
         #
         # * Ensure that each URL you specify is publicly accessible. For
-        # example, in Cloud Storage you can
-        # [share an object publicly]
-        # (/storage/docs/cloud-console#_sharingdata) and get a link to it.
+        #  example, in Cloud Storage you can
+        #  [share an object publicly]
+        #  (/storage/docs/cloud-console#_sharingdata) and get a link to it.
         #
         # * Storage Transfer Service obeys `robots.txt` rules and requires the source
-        # HTTP server to support `Range` requests and to return a `Content-Length`
-        # header in each response.
+        #  HTTP server to support `Range` requests and to return a `Content-Length`
+        #  header in each response.
         #
         # * {::Google::Cloud::StorageTransfer::V1::ObjectConditions ObjectConditions} have no
         # effect when filtering objects to transfer.
         # @!attribute [rw] list_url
         #   @return [::String]
         #     Required. The URL that points to the file that stores the object list
-        #     entries. This file must allow public access.  Currently, only URLs with
-        #     HTTP and HTTPS schemes are supported.
+        #     entries. This file must allow public access. The URL is either an
+        #     HTTP/HTTPS address (e.g. `https://example.com/urllist.tsv`) or a Cloud
+        #     Storage path (e.g. `gs://my-bucket/urllist.tsv`).
         class HttpData
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -384,6 +455,18 @@ module Google
           extend ::Google::Protobuf::MessageExts::ClassMethods
         end
 
+        # An HdfsData resource specifies a path within an HDFS entity (e.g. a cluster).
+        # All cluster-specific settings, such as namenodes and ports, are configured on
+        # the transfer agents servicing requests, so HdfsData only contains the root
+        # path to the data in our transfer.
+        # @!attribute [rw] path
+        #   @return [::String]
+        #     Root path to transfer files.
+        class HdfsData
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
         # An AwsS3CompatibleData resource.
         # @!attribute [rw] bucket_name
         #   @return [::String]
@@ -487,7 +570,7 @@ module Google
           end
         end
 
-        # Represents an On-Premises Agent pool.
+        # Represents an agent pool.
         # @!attribute [rw] name
         #   @return [::String]
         #     Required. Specifies a unique string that identifies the agent pool.
@@ -522,8 +605,8 @@ module Google
             # Default value. This value is unused.
             STATE_UNSPECIFIED = 0
 
-            # This is an initialization state. During this stage, the resources such as
-            # Pub/Sub topics are allocated for the AgentPool.
+            # This is an initialization state. During this stage, resources are
+            # allocated for the AgentPool.
             CREATING = 1
 
             # Determines that the AgentPool is created for use. At this state, Agents
@@ -540,7 +623,7 @@ module Google
         # @!attribute [rw] overwrite_objects_already_existing_in_sink
         #   @return [::Boolean]
         #     When to overwrite objects that already exist in the sink. The default is
-        #     that only objects that are different from the source are ovewritten. If
+        #     that only objects that are different from the source are overwritten. If
         #     true, all objects in the sink whose name matches an object in the source
         #     are overwritten with the source object.
         # @!attribute [rw] delete_objects_unique_in_sink
@@ -594,27 +677,48 @@ module Google
         # @!attribute [rw] gcs_data_sink
         #   @return [::Google::Cloud::StorageTransfer::V1::GcsData]
         #     A Cloud Storage data sink.
+        #
+        #     Note: The following fields are mutually exclusive: `gcs_data_sink`, `posix_data_sink`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         # @!attribute [rw] posix_data_sink
         #   @return [::Google::Cloud::StorageTransfer::V1::PosixFilesystem]
         #     A POSIX Filesystem data sink.
+        #
+        #     Note: The following fields are mutually exclusive: `posix_data_sink`, `gcs_data_sink`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         # @!attribute [rw] gcs_data_source
         #   @return [::Google::Cloud::StorageTransfer::V1::GcsData]
         #     A Cloud Storage data source.
+        #
+        #     Note: The following fields are mutually exclusive: `gcs_data_source`, `aws_s3_data_source`, `http_data_source`, `posix_data_source`, `azure_blob_storage_data_source`, `aws_s3_compatible_data_source`, `hdfs_data_source`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         # @!attribute [rw] aws_s3_data_source
         #   @return [::Google::Cloud::StorageTransfer::V1::AwsS3Data]
         #     An AWS S3 data source.
+        #
+        #     Note: The following fields are mutually exclusive: `aws_s3_data_source`, `gcs_data_source`, `http_data_source`, `posix_data_source`, `azure_blob_storage_data_source`, `aws_s3_compatible_data_source`, `hdfs_data_source`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         # @!attribute [rw] http_data_source
         #   @return [::Google::Cloud::StorageTransfer::V1::HttpData]
         #     An HTTP URL data source.
+        #
+        #     Note: The following fields are mutually exclusive: `http_data_source`, `gcs_data_source`, `aws_s3_data_source`, `posix_data_source`, `azure_blob_storage_data_source`, `aws_s3_compatible_data_source`, `hdfs_data_source`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         # @!attribute [rw] posix_data_source
         #   @return [::Google::Cloud::StorageTransfer::V1::PosixFilesystem]
         #     A POSIX Filesystem data source.
+        #
+        #     Note: The following fields are mutually exclusive: `posix_data_source`, `gcs_data_source`, `aws_s3_data_source`, `http_data_source`, `azure_blob_storage_data_source`, `aws_s3_compatible_data_source`, `hdfs_data_source`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         # @!attribute [rw] azure_blob_storage_data_source
         #   @return [::Google::Cloud::StorageTransfer::V1::AzureBlobStorageData]
         #     An Azure Blob Storage data source.
+        #
+        #     Note: The following fields are mutually exclusive: `azure_blob_storage_data_source`, `gcs_data_source`, `aws_s3_data_source`, `http_data_source`, `posix_data_source`, `aws_s3_compatible_data_source`, `hdfs_data_source`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         # @!attribute [rw] aws_s3_compatible_data_source
         #   @return [::Google::Cloud::StorageTransfer::V1::AwsS3CompatibleData]
         #     An AWS S3 compatible data source.
+        #
+        #     Note: The following fields are mutually exclusive: `aws_s3_compatible_data_source`, `gcs_data_source`, `aws_s3_data_source`, `http_data_source`, `posix_data_source`, `azure_blob_storage_data_source`, `hdfs_data_source`. If a field in that set is populated, all other fields in the set will automatically be cleared.
+        # @!attribute [rw] hdfs_data_source
+        #   @return [::Google::Cloud::StorageTransfer::V1::HdfsData]
+        #     An HDFS cluster data source.
+        #
+        #     Note: The following fields are mutually exclusive: `hdfs_data_source`, `gcs_data_source`, `aws_s3_data_source`, `http_data_source`, `posix_data_source`, `azure_blob_storage_data_source`, `aws_s3_compatible_data_source`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         # @!attribute [rw] gcs_intermediate_data_location
         #   @return [::Google::Cloud::StorageTransfer::V1::GcsData]
         #     For transfers between file systems, specifies a Cloud Storage bucket
@@ -653,6 +757,32 @@ module Google
           extend ::Google::Protobuf::MessageExts::ClassMethods
         end
 
+        # Specifies the configuration for a cross-bucket replication job. Cross-bucket
+        # replication copies new or updated objects from a source Cloud Storage bucket
+        # to a destination Cloud Storage bucket. Existing objects in the source bucket
+        # are not copied by a new cross-bucket replication job.
+        # @!attribute [rw] gcs_data_source
+        #   @return [::Google::Cloud::StorageTransfer::V1::GcsData]
+        #     The Cloud Storage bucket from which to replicate objects.
+        # @!attribute [rw] gcs_data_sink
+        #   @return [::Google::Cloud::StorageTransfer::V1::GcsData]
+        #     The Cloud Storage bucket to which to replicate objects.
+        # @!attribute [rw] object_conditions
+        #   @return [::Google::Cloud::StorageTransfer::V1::ObjectConditions]
+        #     Object conditions that determine which objects are transferred. For
+        #     replication jobs, only `include_prefixes` and `exclude_prefixes` are
+        #     supported.
+        # @!attribute [rw] transfer_options
+        #   @return [::Google::Cloud::StorageTransfer::V1::TransferOptions]
+        #     Specifies the metadata options to be applied during replication.
+        #     Delete options are not supported. If a delete option is specified, the
+        #     request fails with an {::Google::Rpc::Code::INVALID_ARGUMENT INVALID_ARGUMENT}
+        #     error.
+        class ReplicationSpec
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
         # Specifies the metadata options for running a transfer.
         # @!attribute [rw] symlink
         #   @return [::Google::Cloud::StorageTransfer::V1::MetadataOptions::Symlink]
@@ -699,9 +829,10 @@ module Google
         # @!attribute [rw] time_created
         #   @return [::Google::Cloud::StorageTransfer::V1::MetadataOptions::TimeCreated]
         #     Specifies how each object's `timeCreated` metadata is preserved for
-        #     transfers between Google Cloud Storage buckets.  If unspecified, the
-        #     default behavior is the same as
+        #     transfers. If unspecified, the default behavior is the same as
         #     {::Google::Cloud::StorageTransfer::V1::MetadataOptions::TimeCreated::TIME_CREATED_SKIP TIME_CREATED_SKIP}.
+        #     This behavior is supported for transfers to Cloud Storage buckets from
+        #     Cloud Storage, Amazon S3, S3-compatible storage, and Azure sources.
         class MetadataOptions
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -832,10 +963,10 @@ module Google
             # Do not preserve the `timeCreated` metadata from the source object.
             TIME_CREATED_SKIP = 1
 
-            # Preserves the source object's `timeCreated` metadata in the `customTime`
-            # field in the destination object.  Note that any value stored in the
-            # source object's `customTime` field will not be propagated to the
-            # destination object.
+            # Preserves the source object's `timeCreated` or `lastModified` metadata in
+            # the `customTime` field in the destination object.  Note that any value
+            # stored in the source object's `customTime` field will not be propagated
+            # to the destination object.
             TIME_CREATED_PRESERVE_AS_CUSTOM_TIME = 2
           end
         end
@@ -907,7 +1038,7 @@ module Google
         #     {::Google::Cloud::StorageTransfer::V1::Schedule#schedule_end_date schedule_end_date},
         #     `end_time_of_day` specifies the end date and time for starting new transfer
         #     operations. This field must be greater than or equal to the timestamp
-        #     corresponding to the combintation of
+        #     corresponding to the combination of
         #     {::Google::Cloud::StorageTransfer::V1::Schedule#schedule_start_date schedule_start_date}
         #     and
         #     {::Google::Cloud::StorageTransfer::V1::Schedule#start_time_of_day start_time_of_day},
@@ -988,13 +1119,32 @@ module Google
         # @!attribute [rw] project_id
         #   @return [::String]
         #     The ID of the Google Cloud project that owns the job.
+        # @!attribute [rw] service_account
+        #   @return [::String]
+        #     Optional. The user-managed service account to which to delegate service
+        #     agent permissions. You can grant Cloud Storage bucket permissions to this
+        #     service account instead of to the Transfer Service service agent.
+        #
+        #     Format is
+        #     `projects/-/serviceAccounts/ACCOUNT_EMAIL_OR_UNIQUEID`
+        #
+        #     Either the service account email
+        #     (`SERVICE_ACCOUNT_NAME@PROJECT_ID.iam.gserviceaccount.com`) or the unique
+        #     ID (`123456789012345678901`) are accepted in the string. The `-`
+        #     wildcard character is required; replacing it with a project ID is invalid.
+        #
+        #     See
+        #     https://cloud.google.com//storage-transfer/docs/delegate-service-agent-permissions
+        #     for required permissions.
         # @!attribute [rw] transfer_spec
         #   @return [::Google::Cloud::StorageTransfer::V1::TransferSpec]
         #     Transfer specification.
+        # @!attribute [rw] replication_spec
+        #   @return [::Google::Cloud::StorageTransfer::V1::ReplicationSpec]
+        #     Replication specification.
         # @!attribute [rw] notification_config
         #   @return [::Google::Cloud::StorageTransfer::V1::NotificationConfig]
-        #     Notification configuration. This is not supported for transfers involving
-        #     PosixFilesystem.
+        #     Notification configuration.
         # @!attribute [rw] logging_config
         #   @return [::Google::Cloud::StorageTransfer::V1::LoggingConfig]
         #     Logging configuration.
@@ -1255,32 +1405,25 @@ module Google
 
         # Specifies the logging behavior for transfer operations.
         #
-        # For cloud-to-cloud transfers, logs are sent to Cloud Logging. See
+        # Logs can be sent to Cloud Logging for all transfer types. See
         # [Read transfer
         # logs](https://cloud.google.com/storage-transfer/docs/read-transfer-logs) for
         # details.
-        #
-        # For transfers to or from a POSIX file system, logs are stored in the
-        # Cloud Storage bucket that is the source or sink of the transfer.
-        # See [Managing Transfer for on-premises jobs]
-        # (https://cloud.google.com/storage-transfer/docs/managing-on-prem-jobs#viewing-logs)
-        # for details.
         # @!attribute [rw] log_actions
         #   @return [::Array<::Google::Cloud::StorageTransfer::V1::LoggingConfig::LoggableAction>]
         #     Specifies the actions to be logged. If empty, no logs are generated.
-        #     Not supported for transfers with PosixFilesystem data sources; use
-        #     {::Google::Cloud::StorageTransfer::V1::LoggingConfig#enable_onprem_gcs_transfer_logs enable_onprem_gcs_transfer_logs}
-        #     instead.
         # @!attribute [rw] log_action_states
         #   @return [::Array<::Google::Cloud::StorageTransfer::V1::LoggingConfig::LoggableActionState>]
         #     States in which `log_actions` are logged. If empty, no logs are generated.
-        #     Not supported for transfers with PosixFilesystem data sources; use
-        #     {::Google::Cloud::StorageTransfer::V1::LoggingConfig#enable_onprem_gcs_transfer_logs enable_onprem_gcs_transfer_logs}
-        #     instead.
         # @!attribute [rw] enable_onprem_gcs_transfer_logs
         #   @return [::Boolean]
-        #     For transfers with a PosixFilesystem source, this option enables the Cloud
-        #     Storage transfer logs for this transfer.
+        #     For PosixFilesystem transfers, enables
+        #     [file system transfer
+        #     logs](https://cloud.google.com/storage-transfer/docs/on-prem-transfer-log-format)
+        #     instead of, or in addition to, Cloud Logging.
+        #
+        #     This option ignores [LoggableAction] and [LoggableActionState]. If these
+        #     are set, Cloud Logging will also be enabled for this transfer.
         class LoggingConfig
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -1296,7 +1439,7 @@ module Google
             # Deleting objects at the source or the destination.
             DELETE = 2
 
-            # Copying objects to Google Cloud Storage.
+            # Copying objects to the destination.
             COPY = 3
           end
 
@@ -1312,6 +1455,11 @@ module Google
             # `LoggableAction` terminated in an error state. `FAILED` actions are
             # logged as [ERROR][google.logging.type.LogSeverity.ERROR].
             FAILED = 2
+
+            # The `COPY` action was skipped for this file. Only supported for
+            # agent-based transfers. `SKIPPED` actions are
+            # logged as [INFO][google.logging.type.LogSeverity.INFO].
+            SKIPPED = 3
           end
         end
 

data/proto_docs/google/type/date.rb

@@ -24,14 +24,17 @@ module Google
     # 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 value, with a zero year, such as an anniversary
-    # * A year on its own, with zero month and day values
-    # * A year and month value, with a zero day, such as a credit card expiration
-    # date
+    # * 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 are {::Google::Type::TimeOfDay google.type.TimeOfDay} and
-    # `google.protobuf.Timestamp`.
+    # Related types:
+    #
+    # * {::Google::Type::TimeOfDay google.type.TimeOfDay}
+    # * [google.type.DateTime][google.type.DateTime]
+    # * {::Google::Protobuf::Timestamp google.protobuf.Timestamp}
     # @!attribute [rw] year
     #   @return [::Integer]
     #     Year of the date. Must be from 1 to 9999, or 0 to specify a date without

data/proto_docs/google/type/timeofday.rb

@@ -25,18 +25,22 @@ module Google
     # `google.protobuf.Timestamp`.
     # @!attribute [rw] hours
     #   @return [::Integer]
-    #     Hours of day in 24 hour format. Should be from 0 to 23. An API may choose
-    #     to allow the value "24:00:00" for scenarios like business closing time.
+    #     Hours of a day in 24 hour format. Must be greater than or equal to 0 and
+    #     typically must be less than or equal to 23. An API may choose to allow the
+    #     value "24:00:00" for scenarios like business closing time.
     # @!attribute [rw] minutes
     #   @return [::Integer]
-    #     Minutes of hour of day. Must be from 0 to 59.
+    #     Minutes of an hour. Must be greater than or equal to 0 and less than or
+    #     equal to 59.
     # @!attribute [rw] seconds
     #   @return [::Integer]
-    #     Seconds of minutes of the time. Must normally be from 0 to 59. An API may
-    #     allow the value 60 if it allows leap-seconds.
+    #     Seconds of a minute. Must be greater than or equal to 0 and typically must
+    #     be less than or equal to 59. An API may allow the value 60 if it allows
+    #     leap-seconds.
     # @!attribute [rw] nanos
     #   @return [::Integer]
-    #     Fractions of seconds in nanoseconds. Must be from 0 to 999,999,999.
+    #     Fractions of seconds, in nanoseconds. Must be greater than or equal to 0
+    #     and less than or equal to 999,999,999.
     class TimeOfDay
       include ::Google::Protobuf::MessageExts
       extend ::Google::Protobuf::MessageExts::ClassMethods