google-cloud-storage_transfer-v1 0.1.0

data/proto_docs/google/rpc/code.rb

@@ -0,0 +1,185 @@
+# frozen_string_literal: true
+
+# Copyright 2021 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+# Auto-generated by gapic-generator-ruby. DO NOT EDIT!
+
+
+module Google
+  module Rpc
+    # The canonical error codes for gRPC APIs.
+    #
+    #
+    # Sometimes multiple error codes may apply.  Services should return
+    # the most specific error code that applies.  For example, prefer
+    # `OUT_OF_RANGE` over `FAILED_PRECONDITION` if both codes apply.
+    # Similarly prefer `NOT_FOUND` or `ALREADY_EXISTS` over `FAILED_PRECONDITION`.
+    module Code
+      # Not an error; returned on success
+      #
+      # HTTP Mapping: 200 OK
+      OK = 0
+
+      # The operation was cancelled, typically by the caller.
+      #
+      # HTTP Mapping: 499 Client Closed Request
+      CANCELLED = 1
+
+      # Unknown error.  For example, this error may be returned when
+      # a `Status` value received from another address space belongs to
+      # an error space that is not known in this address space.  Also
+      # errors raised by APIs that do not return enough error information
+      # may be converted to this error.
+      #
+      # HTTP Mapping: 500 Internal Server Error
+      UNKNOWN = 2
+
+      # The client specified an invalid argument.  Note that this differs
+      # from `FAILED_PRECONDITION`.  `INVALID_ARGUMENT` indicates arguments
+      # that are problematic regardless of the state of the system
+      # (e.g., a malformed file name).
+      #
+      # HTTP Mapping: 400 Bad Request
+      INVALID_ARGUMENT = 3
+
+      # The deadline expired before the operation could complete. For operations
+      # that change the state of the system, this error may be returned
+      # even if the operation has completed successfully.  For example, a
+      # successful response from a server could have been delayed long
+      # enough for the deadline to expire.
+      #
+      # HTTP Mapping: 504 Gateway Timeout
+      DEADLINE_EXCEEDED = 4
+
+      # Some requested entity (e.g., file or directory) was not found.
+      #
+      # Note to server developers: if a request is denied for an entire class
+      # of users, such as gradual feature rollout or undocumented whitelist,
+      # `NOT_FOUND` may be used. If a request is denied for some users within
+      # a class of users, such as user-based access control, `PERMISSION_DENIED`
+      # must be used.
+      #
+      # HTTP Mapping: 404 Not Found
+      NOT_FOUND = 5
+
+      # The entity that a client attempted to create (e.g., file or directory)
+      # already exists.
+      #
+      # HTTP Mapping: 409 Conflict
+      ALREADY_EXISTS = 6
+
+      # The caller does not have permission to execute the specified
+      # operation. `PERMISSION_DENIED` must not be used for rejections
+      # caused by exhausting some resource (use `RESOURCE_EXHAUSTED`
+      # instead for those errors). `PERMISSION_DENIED` must not be
+      # used if the caller can not be identified (use `UNAUTHENTICATED`
+      # instead for those errors). This error code does not imply the
+      # request is valid or the requested entity exists or satisfies
+      # other pre-conditions.
+      #
+      # HTTP Mapping: 403 Forbidden
+      PERMISSION_DENIED = 7
+
+      # The request does not have valid authentication credentials for the
+      # operation.
+      #
+      # HTTP Mapping: 401 Unauthorized
+      UNAUTHENTICATED = 16
+
+      # Some resource has been exhausted, perhaps a per-user quota, or
+      # perhaps the entire file system is out of space.
+      #
+      # HTTP Mapping: 429 Too Many Requests
+      RESOURCE_EXHAUSTED = 8
+
+      # The operation was rejected because the system is not in a state
+      # required for the operation's execution.  For example, the directory
+      # to be deleted is non-empty, an rmdir operation is applied to
+      # a non-directory, etc.
+      #
+      # Service implementors can use the following guidelines to decide
+      # between `FAILED_PRECONDITION`, `ABORTED`, and `UNAVAILABLE`:
+      #  (a) Use `UNAVAILABLE` if the client can retry just the failing call.
+      #  (b) Use `ABORTED` if the client should retry at a higher level
+      #      (e.g., when a client-specified test-and-set fails, indicating the
+      #      client should restart a read-modify-write sequence).
+      #  (c) Use `FAILED_PRECONDITION` if the client should not retry until
+      #      the system state has been explicitly fixed.  E.g., if an "rmdir"
+      #      fails because the directory is non-empty, `FAILED_PRECONDITION`
+      #      should be returned since the client should not retry unless
+      #      the files are deleted from the directory.
+      #
+      # HTTP Mapping: 400 Bad Request
+      FAILED_PRECONDITION = 9
+
+      # The operation was aborted, typically due to a concurrency issue such as
+      # a sequencer check failure or transaction abort.
+      #
+      # See the guidelines above for deciding between `FAILED_PRECONDITION`,
+      # `ABORTED`, and `UNAVAILABLE`.
+      #
+      # HTTP Mapping: 409 Conflict
+      ABORTED = 10
+
+      # The operation was attempted past the valid range.  E.g., seeking or
+      # reading past end-of-file.
+      #
+      # Unlike `INVALID_ARGUMENT`, this error indicates a problem that may
+      # be fixed if the system state changes. For example, a 32-bit file
+      # system will generate `INVALID_ARGUMENT` if asked to read at an
+      # offset that is not in the range [0,2^32-1], but it will generate
+      # `OUT_OF_RANGE` if asked to read from an offset past the current
+      # file size.
+      #
+      # There is a fair bit of overlap between `FAILED_PRECONDITION` and
+      # `OUT_OF_RANGE`.  We recommend using `OUT_OF_RANGE` (the more specific
+      # error) when it applies so that callers who are iterating through
+      # a space can easily look for an `OUT_OF_RANGE` error to detect when
+      # they are done.
+      #
+      # HTTP Mapping: 400 Bad Request
+      OUT_OF_RANGE = 11
+
+      # The operation is not implemented or is not supported/enabled in this
+      # service.
+      #
+      # HTTP Mapping: 501 Not Implemented
+      UNIMPLEMENTED = 12
+
+      # Internal errors.  This means that some invariants expected by the
+      # underlying system have been broken.  This error code is reserved
+      # for serious errors.
+      #
+      # HTTP Mapping: 500 Internal Server Error
+      INTERNAL = 13
+
+      # The service is currently unavailable.  This is most likely a
+      # transient condition, which can be corrected by retrying with
+      # a backoff. Note that it is not always safe to retry
+      # non-idempotent operations.
+      #
+      # See the guidelines above for deciding between `FAILED_PRECONDITION`,
+      # `ABORTED`, and `UNAVAILABLE`.
+      #
+      # HTTP Mapping: 503 Service Unavailable
+      UNAVAILABLE = 14
+
+      # Unrecoverable data loss or corruption.
+      #
+      # HTTP Mapping: 500 Internal Server Error
+      DATA_LOSS = 15
+    end
+  end
+end

data/proto_docs/google/rpc/status.rb

@@ -0,0 +1,46 @@
+# frozen_string_literal: true
+
+# Copyright 2021 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+# Auto-generated by gapic-generator-ruby. DO NOT EDIT!
+
+
+module Google
+  module Rpc
+    # The `Status` type defines a logical error model that is suitable for
+    # different programming environments, including REST APIs and RPC APIs. It is
+    # used by [gRPC](https://github.com/grpc). Each `Status` message contains
+    # three pieces of data: error code, error message, and error details.
+    #
+    # You can find out more about this error model and how to work with it in the
+    # [API Design Guide](https://cloud.google.com/apis/design/errors).
+    # @!attribute [rw] code
+    #   @return [::Integer]
+    #     The status code, which should be an enum value of {::Google::Rpc::Code google.rpc.Code}.
+    # @!attribute [rw] message
+    #   @return [::String]
+    #     A developer-facing error message, which should be in English. Any
+    #     user-facing error message should be localized and sent in the
+    #     {::Google::Rpc::Status#details google.rpc.Status.details} field, or localized by the client.
+    # @!attribute [rw] details
+    #   @return [::Array<::Google::Protobuf::Any>]
+    #     A list of messages that carry the error details.  There is a common set of
+    #     message types for APIs to use.
+    class Status
+      include ::Google::Protobuf::MessageExts
+      extend ::Google::Protobuf::MessageExts::ClassMethods
+    end
+  end
+end

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

@@ -0,0 +1,167 @@
+# frozen_string_literal: true
+
+# Copyright 2021 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+# Auto-generated by gapic-generator-ruby. DO NOT EDIT!
+
+
+module Google
+  module Cloud
+    module StorageTransfer
+      module V1
+        # Request passed to GetGoogleServiceAccount.
+        # @!attribute [rw] project_id
+        #   @return [::String]
+        #     Required. The ID of the Google Cloud Platform Console project that the
+        #     Google service account is associated with.
+        class GetGoogleServiceAccountRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Request passed to CreateTransferJob.
+        # @!attribute [rw] transfer_job
+        #   @return [::Google::Cloud::StorageTransfer::V1::TransferJob]
+        #     Required. The job to create.
+        class CreateTransferJobRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Request passed to UpdateTransferJob.
+        # @!attribute [rw] job_name
+        #   @return [::String]
+        #     Required. The name of job to update.
+        # @!attribute [rw] project_id
+        #   @return [::String]
+        #     Required. The ID of the Google Cloud Platform Console project that owns the
+        #     job.
+        # @!attribute [rw] transfer_job
+        #   @return [::Google::Cloud::StorageTransfer::V1::TransferJob]
+        #     Required. The job to update. `transferJob` is expected to specify only
+        #     four fields:
+        #     {::Google::Cloud::StorageTransfer::V1::TransferJob#description description},
+        #     {::Google::Cloud::StorageTransfer::V1::TransferJob#transfer_spec transfer_spec},
+        #     {::Google::Cloud::StorageTransfer::V1::TransferJob#notification_config notification_config},
+        #     and {::Google::Cloud::StorageTransfer::V1::TransferJob#status status}.  An
+        #     `UpdateTransferJobRequest` that specifies other fields are rejected with
+        #     the error {::Google::Rpc::Code::INVALID_ARGUMENT INVALID_ARGUMENT}. Updating a
+        #     job status to
+        #     {::Google::Cloud::StorageTransfer::V1::TransferJob::Status::DELETED DELETED} requires
+        #     `storagetransfer.jobs.delete` permissions.
+        # @!attribute [rw] update_transfer_job_field_mask
+        #   @return [::Google::Protobuf::FieldMask]
+        #     The field mask of the fields in `transferJob` that are to be updated in
+        #     this request.  Fields in `transferJob` that can be updated are:
+        #     {::Google::Cloud::StorageTransfer::V1::TransferJob#description description},
+        #     {::Google::Cloud::StorageTransfer::V1::TransferJob#transfer_spec transfer_spec},
+        #     {::Google::Cloud::StorageTransfer::V1::TransferJob#notification_config notification_config},
+        #     and {::Google::Cloud::StorageTransfer::V1::TransferJob#status status}.  To update the
+        #     `transfer_spec` of the job, a complete transfer specification must be
+        #     provided. An incomplete specification missing any required fields is
+        #     rejected with the error
+        #     {::Google::Rpc::Code::INVALID_ARGUMENT INVALID_ARGUMENT}.
+        class UpdateTransferJobRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Request passed to GetTransferJob.
+        # @!attribute [rw] job_name
+        #   @return [::String]
+        #     Required.
+        #     The job to get.
+        # @!attribute [rw] project_id
+        #   @return [::String]
+        #     Required. The ID of the Google Cloud Platform Console project that owns the
+        #     job.
+        class GetTransferJobRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # `projectId`, `jobNames`, and `jobStatuses` are query parameters that can
+        # be specified when listing transfer jobs.
+        # @!attribute [rw] filter
+        #   @return [::String]
+        #     Required. A list of query parameters specified as JSON text in the form of:
+        #     `{"projectId":"my_project_id",
+        #      "jobNames":["jobid1","jobid2",...],
+        #      "jobStatuses":["status1","status2",...]}`
+        #
+        #     Since `jobNames` and `jobStatuses` support multiple values, their values
+        #     must be specified with array notation. `projectId` is required.
+        #     `jobNames` and `jobStatuses` are optional.  The valid values for
+        #     `jobStatuses` are case-insensitive:
+        #     {::Google::Cloud::StorageTransfer::V1::TransferJob::Status::ENABLED ENABLED},
+        #     {::Google::Cloud::StorageTransfer::V1::TransferJob::Status::DISABLED DISABLED}, and
+        #     {::Google::Cloud::StorageTransfer::V1::TransferJob::Status::DELETED DELETED}.
+        # @!attribute [rw] page_size
+        #   @return [::Integer]
+        #     The list page size. The max allowed value is 256.
+        # @!attribute [rw] page_token
+        #   @return [::String]
+        #     The list page token.
+        class ListTransferJobsRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Response from ListTransferJobs.
+        # @!attribute [rw] transfer_jobs
+        #   @return [::Array<::Google::Cloud::StorageTransfer::V1::TransferJob>]
+        #     A list of transfer jobs.
+        # @!attribute [rw] next_page_token
+        #   @return [::String]
+        #     The list next page token.
+        class ListTransferJobsResponse
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Request passed to PauseTransferOperation.
+        # @!attribute [rw] name
+        #   @return [::String]
+        #     Required. The name of the transfer operation.
+        class PauseTransferOperationRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Request passed to ResumeTransferOperation.
+        # @!attribute [rw] name
+        #   @return [::String]
+        #     Required. The name of the transfer operation.
+        class ResumeTransferOperationRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Request passed to RunTransferJob.
+        # @!attribute [rw] job_name
+        #   @return [::String]
+        #     Required. The name of the transfer job.
+        # @!attribute [rw] project_id
+        #   @return [::String]
+        #     Required. The ID of the Google Cloud Platform Console project that owns the
+        #     transfer job.
+        class RunTransferJobRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,790 @@
+# frozen_string_literal: true
+
+# Copyright 2021 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+# Auto-generated by gapic-generator-ruby. DO NOT EDIT!
+
+
+module Google
+  module Cloud
+    module StorageTransfer
+      module V1
+        # Google service account
+        # @!attribute [rw] account_email
+        #   @return [::String]
+        #     Email address of the service account.
+        # @!attribute [rw] subject_id
+        #   @return [::String]
+        #     Unique identifier for the service account.
+        class GoogleServiceAccount
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # AWS access key (see
+        # [AWS Security
+        # Credentials](https://docs.aws.amazon.com/general/latest/gr/aws-security-credentials.html)).
+        #
+        # For information on our data retention policy for user credentials, see
+        # [User credentials](/storage-transfer/docs/data-retention#user-credentials).
+        # @!attribute [rw] access_key_id
+        #   @return [::String]
+        #     Required. AWS access key ID.
+        # @!attribute [rw] secret_access_key
+        #   @return [::String]
+        #     Required. AWS secret access key. This field is not returned in RPC
+        #     responses.
+        class AwsAccessKey
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Azure credentials
+        #
+        # For information on our data retention policy for user credentials, see
+        # [User credentials](/storage-transfer/docs/data-retention#user-credentials).
+        # @!attribute [rw] sas_token
+        #   @return [::String]
+        #     Required. Azure shared access signature (SAS).
+        #
+        #     <aside class="note">
+        #     <strong>Note:</strong>Copying data from Azure Data Lake
+        #     Storage (ADLS) Gen 2 is in [Preview](/products/#product-launch-stages).
+        #     During Preview, if you are copying data from ADLS Gen 2, you must use an
+        #     account SAS.
+        #     </aside>
+        #
+        #     For more information about SAS, see
+        #     [Grant limited access to Azure Storage resources using shared access
+        #     signatures
+        #     (SAS)](https://docs.microsoft.com/en-us/azure/storage/common/storage-sas-overview).
+        class AzureCredentials
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Conditions that determine which objects will be transferred. Applies only
+        # to Cloud Data Sources such as S3, Azure, and Cloud Storage.
+        #
+        # The "last modification time" refers to the time of the
+        # last change to the object's content or metadata — specifically, this is
+        # the `updated` property of Cloud Storage objects, the `LastModified` field
+        # of S3 objects, and the `Last-Modified` header of Azure blobs.
+        # @!attribute [rw] min_time_elapsed_since_last_modification
+        #   @return [::Google::Protobuf::Duration]
+        #     If specified, only objects with a "last modification time" before
+        #     `NOW` - `min_time_elapsed_since_last_modification` and objects that don't
+        #      have a "last modification time" are transferred.
+        #
+        #     For each {::Google::Cloud::StorageTransfer::V1::TransferOperation TransferOperation}
+        #     started by this {::Google::Cloud::StorageTransfer::V1::TransferJob TransferJob}, `NOW`
+        #     refers to the [start_time]
+        #     [google.storagetransfer.v1.TransferOperation.start_time] of the
+        #     `TransferOperation`.
+        # @!attribute [rw] max_time_elapsed_since_last_modification
+        #   @return [::Google::Protobuf::Duration]
+        #     If specified, only objects with a "last modification time" on or after
+        #     `NOW` - `max_time_elapsed_since_last_modification` and objects that don't
+        #     have a "last modification time" are transferred.
+        #
+        #     For each {::Google::Cloud::StorageTransfer::V1::TransferOperation TransferOperation}
+        #     started by this {::Google::Cloud::StorageTransfer::V1::TransferJob TransferJob},
+        #     `NOW` refers to the [start_time]
+        #     [google.storagetransfer.v1.TransferOperation.start_time] of the
+        #     `TransferOperation`.
+        # @!attribute [rw] include_prefixes
+        #   @return [::Array<::String>]
+        #     If you specify `include_prefixes`, Storage Transfer Service uses the items
+        #     in the `include_prefixes` array to determine which objects to include in a
+        #     transfer. Objects must start with one of the matching `include_prefixes`
+        #     for inclusion in the transfer. If [exclude_prefixes]
+        #     [google.storagetransfer.v1.ObjectConditions.exclude_prefixes] is specified,
+        #     objects must not start with any of the `exclude_prefixes` specified for
+        #     inclusion in the transfer.
+        #
+        #     The following are requirements of `include_prefixes`:
+        #
+        #       * Each include-prefix can contain any sequence of Unicode characters, to
+        #         a max length of 1024 bytes when UTF8-encoded, and must not contain
+        #         Carriage Return or Line Feed characters.  Wildcard matching and regular
+        #         expression matching are not supported.
+        #
+        #       * Each include-prefix must omit the leading slash. For example, to
+        #         include the object `s3://my-aws-bucket/logs/y=2015/requests.gz`,
+        #         specify the include-prefix as `logs/y=2015/requests.gz`.
+        #
+        #       * None of the include-prefix values can be empty, if specified.
+        #
+        #       * Each include-prefix must include a distinct portion of the object
+        #         namespace. No include-prefix may be a prefix of another
+        #         include-prefix.
+        #
+        #     The max size of `include_prefixes` is 1000.
+        #
+        #     For more information, see [Filtering objects from
+        #     transfers](/storage-transfer/docs/filtering-objects-from-transfers).
+        # @!attribute [rw] exclude_prefixes
+        #   @return [::Array<::String>]
+        #     If you specify `exclude_prefixes`, Storage Transfer Service uses the items
+        #     in the `exclude_prefixes` array to determine which objects to exclude from
+        #     a transfer. Objects must not start with one of the matching
+        #     `exclude_prefixes` for inclusion in a transfer.
+        #
+        #     The following are requirements of `exclude_prefixes`:
+        #
+        #       * Each exclude-prefix can contain any sequence of Unicode characters, to
+        #         a max length of 1024 bytes when UTF8-encoded, and must not contain
+        #         Carriage Return or Line Feed characters.  Wildcard matching and regular
+        #         expression matching are not supported.
+        #
+        #       * Each exclude-prefix must omit the leading slash. For example, to
+        #         exclude the object `s3://my-aws-bucket/logs/y=2015/requests.gz`,
+        #         specify the exclude-prefix as `logs/y=2015/requests.gz`.
+        #
+        #       * None of the exclude-prefix values can be empty, if specified.
+        #
+        #       * Each exclude-prefix must exclude a distinct portion of the object
+        #         namespace. No exclude-prefix may be a prefix of another
+        #         exclude-prefix.
+        #
+        #       * If [include_prefixes]
+        #         [google.storagetransfer.v1.ObjectConditions.include_prefixes] is
+        #         specified, then each exclude-prefix must start with the value of a path
+        #         explicitly included by `include_prefixes`.
+        #
+        #     The max size of `exclude_prefixes` is 1000.
+        #
+        #     For more information, see [Filtering objects from
+        #     transfers](/storage-transfer/docs/filtering-objects-from-transfers).
+        # @!attribute [rw] last_modified_since
+        #   @return [::Google::Protobuf::Timestamp]
+        #     If specified, only objects with a "last modification time" on or after
+        #     this timestamp and objects that don't have a "last modification time" are
+        #     transferred.
+        #
+        #     The `last_modified_since` and `last_modified_before` fields can be used
+        #     together for chunked data processing. For example, consider a script that
+        #     processes each day's worth of data at a time. For that you'd set each
+        #     of the fields as follows:
+        #
+        #     *  `last_modified_since` to the start of the day
+        #
+        #     *  `last_modified_before` to the end of the day
+        # @!attribute [rw] last_modified_before
+        #   @return [::Google::Protobuf::Timestamp]
+        #     If specified, only objects with a "last modification time" before this
+        #     timestamp and objects that don't have a "last modification time" will be
+        #     transferred.
+        class ObjectConditions
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # In a GcsData resource, an object's name is the Cloud Storage object's
+        # name and its "last modification time" refers to the object's `updated`
+        # property of Cloud Storage objects, which changes when the content or the
+        # metadata of the object is updated.
+        # @!attribute [rw] bucket_name
+        #   @return [::String]
+        #     Required. Cloud Storage bucket name. Must meet
+        #     [Bucket Name Requirements](/storage/docs/naming#requirements).
+        # @!attribute [rw] path
+        #   @return [::String]
+        #     Root path to transfer objects.
+        #
+        #     Must be an empty string or full path name that ends with a '/'. This field
+        #     is treated as an object prefix. As such, it should generally not begin with
+        #     a '/'.
+        #
+        #     The root path value must meet
+        #     [Object Name Requirements](/storage/docs/naming#objectnames).
+        class GcsData
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # An AwsS3Data resource can be a data source, but not a data sink.
+        # In an AwsS3Data resource, an object's name is the S3 object's key name.
+        # @!attribute [rw] bucket_name
+        #   @return [::String]
+        #     Required. S3 Bucket name (see
+        #     [Creating a
+        #     bucket](https://docs.aws.amazon.com/AmazonS3/latest/dev/create-bucket-get-location-example.html)).
+        # @!attribute [rw] aws_access_key
+        #   @return [::Google::Cloud::StorageTransfer::V1::AwsAccessKey]
+        #     Input only. AWS access key used to sign the API requests to the AWS S3
+        #     bucket. Permissions on the bucket must be granted to the access ID of the
+        #     AWS access key. This field is required.
+        #
+        #     For information on our data retention policy for user credentials, see
+        #     [User credentials](/storage-transfer/docs/data-retention#user-credentials).
+        # @!attribute [rw] path
+        #   @return [::String]
+        #     Root path to transfer objects.
+        #
+        #     Must be an empty string or full path name that ends with a '/'. This field
+        #     is treated as an object prefix. As such, it should generally not begin with
+        #     a '/'.
+        # @!attribute [rw] role_arn
+        #   @return [::String]
+        #     Input only. Role arn to support temporary credentials via
+        #     AssumeRoleWithWebIdentity.
+        #
+        #     When role arn is provided, transfer service will fetch temporary
+        #     credentials for the session using AssumeRoleWithWebIdentity call for the
+        #     provided role using the [GoogleServiceAccount] for this project.
+        class AwsS3Data
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # An AzureBlobStorageData resource can be a data source, but not a data sink.
+        # An AzureBlobStorageData resource represents one Azure container. The storage
+        # account determines the [Azure
+        # endpoint](https://docs.microsoft.com/en-us/azure/storage/common/storage-create-storage-account#storage-account-endpoints).
+        # In an AzureBlobStorageData resource, a blobs's name is the [Azure Blob
+        # Storage blob's key
+        # name](https://docs.microsoft.com/en-us/rest/api/storageservices/naming-and-referencing-containers--blobs--and-metadata#blob-names).
+        # @!attribute [rw] storage_account
+        #   @return [::String]
+        #     Required. The name of the Azure Storage account.
+        # @!attribute [rw] azure_credentials
+        #   @return [::Google::Cloud::StorageTransfer::V1::AzureCredentials]
+        #     Required. Input only. Credentials used to authenticate API requests to
+        #     Azure.
+        #
+        #     For information on our data retention policy for user credentials, see
+        #     [User credentials](/storage-transfer/docs/data-retention#user-credentials).
+        # @!attribute [rw] container
+        #   @return [::String]
+        #     Required. The container to transfer from the Azure Storage account.
+        # @!attribute [rw] path
+        #   @return [::String]
+        #     Root path to transfer objects.
+        #
+        #     Must be an empty string or full path name that ends with a '/'. This field
+        #     is treated as an object prefix. As such, it should generally not begin with
+        #     a '/'.
+        class AzureBlobStorageData
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        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:
+        #
+        # * **HTTP URL** — The location of the object.
+        #
+        # * **Length** — The size of the object in bytes.
+        #
+        # * **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).
+        #
+        # 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
+        # `<hostname>/<URL-path>`.
+        #
+        # * If the specified size of an object does not match the actual size of the
+        # object fetched, the object will not be transferred.
+        #
+        # * If the specified MD5 does not match the MD5 computed from the transferred
+        # bytes, the object transfer will fail.
+        #
+        # * 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.
+        #
+        # * 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.
+        #
+        # * {::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.
+        class HttpData
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # TransferOptions define the actions to be performed on objects in a transfer.
+        # @!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
+        #     true, all objects in the sink whose name matches an object in the source
+        #     will be overwritten with the source object.
+        # @!attribute [rw] delete_objects_unique_in_sink
+        #   @return [::Boolean]
+        #     Whether objects that exist only in the sink should be deleted.
+        #
+        #     **Note:** This option and [delete_objects_from_source_after_transfer]
+        #     [google.storagetransfer.v1.TransferOptions.delete_objects_from_source_after_transfer]
+        #     are mutually exclusive.
+        # @!attribute [rw] delete_objects_from_source_after_transfer
+        #   @return [::Boolean]
+        #     Whether objects should be deleted from the source after they are
+        #     transferred to the sink.
+        #
+        #     **Note:** This option and [delete_objects_unique_in_sink]
+        #     [google.storagetransfer.v1.TransferOptions.delete_objects_unique_in_sink]
+        #     are mutually exclusive.
+        class TransferOptions
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Configuration for running a transfer.
+        # @!attribute [rw] gcs_data_sink
+        #   @return [::Google::Cloud::StorageTransfer::V1::GcsData]
+        #     A Cloud Storage data sink.
+        # @!attribute [rw] gcs_data_source
+        #   @return [::Google::Cloud::StorageTransfer::V1::GcsData]
+        #     A Cloud Storage data source.
+        # @!attribute [rw] aws_s3_data_source
+        #   @return [::Google::Cloud::StorageTransfer::V1::AwsS3Data]
+        #     An AWS S3 data source.
+        # @!attribute [rw] http_data_source
+        #   @return [::Google::Cloud::StorageTransfer::V1::HttpData]
+        #     An HTTP URL data source.
+        # @!attribute [rw] azure_blob_storage_data_source
+        #   @return [::Google::Cloud::StorageTransfer::V1::AzureBlobStorageData]
+        #     An Azure Blob Storage data source.
+        # @!attribute [rw] object_conditions
+        #   @return [::Google::Cloud::StorageTransfer::V1::ObjectConditions]
+        #     Only objects that satisfy these object conditions are included in the set
+        #     of data source and data sink objects.  Object conditions based on
+        #     objects' "last modification time" do not exclude objects in a data sink.
+        # @!attribute [rw] transfer_options
+        #   @return [::Google::Cloud::StorageTransfer::V1::TransferOptions]
+        #     If the option
+        #     {::Google::Cloud::StorageTransfer::V1::TransferOptions#delete_objects_unique_in_sink delete_objects_unique_in_sink}
+        #     is `true` and time-based object conditions such as 'last modification time'
+        #     are specified, the request fails with an
+        #     {::Google::Rpc::Code::INVALID_ARGUMENT INVALID_ARGUMENT} error.
+        class TransferSpec
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Transfers can be scheduled to recur or to run just once.
+        # @!attribute [rw] schedule_start_date
+        #   @return [::Google::Type::Date]
+        #     Required. The start date of a transfer. Date boundaries are determined
+        #     relative to UTC time. If `schedule_start_date` and
+        #     {::Google::Cloud::StorageTransfer::V1::Schedule#start_time_of_day start_time_of_day}
+        #     are in the past relative to the job's creation time, the transfer starts
+        #     the day after you schedule the transfer request.
+        #
+        #     **Note:** When starting jobs at or near midnight UTC it is possible that
+        #     a job will start later than expected. For example, if you send an outbound
+        #     request on June 1 one millisecond prior to midnight UTC and the Storage
+        #     Transfer Service server receives the request on June 2, then it will create
+        #     a TransferJob with `schedule_start_date` set to June 2 and a
+        #     `start_time_of_day` set to midnight UTC. The first scheduled
+        #     {::Google::Cloud::StorageTransfer::V1::TransferOperation TransferOperation} will take
+        #     place on June 3 at midnight UTC.
+        # @!attribute [rw] schedule_end_date
+        #   @return [::Google::Type::Date]
+        #     The last day a transfer runs. Date boundaries are determined relative to
+        #     UTC time. A job will run once per 24 hours within the following guidelines:
+        #
+        #     *   If `schedule_end_date` and
+        #     {::Google::Cloud::StorageTransfer::V1::Schedule#schedule_start_date schedule_start_date}
+        #     are the same and in
+        #         the future relative to UTC, the transfer is executed only one time.
+        #     *   If `schedule_end_date` is later than `schedule_start_date`  and
+        #         `schedule_end_date` is in the future relative to UTC, the job will
+        #         run each day at
+        #         {::Google::Cloud::StorageTransfer::V1::Schedule#start_time_of_day start_time_of_day}
+        #         through `schedule_end_date`.
+        # @!attribute [rw] start_time_of_day
+        #   @return [::Google::Type::TimeOfDay]
+        #     The time in UTC that a transfer job is scheduled to run. Transfers may
+        #     start later than this time.
+        #
+        #     If `start_time_of_day` is not specified:
+        #
+        #     *   One-time transfers run immediately.
+        #     *   Recurring transfers run immediately, and each day at midnight UTC,
+        #         through
+        #         {::Google::Cloud::StorageTransfer::V1::Schedule#schedule_end_date schedule_end_date}.
+        #
+        #     If `start_time_of_day` is specified:
+        #
+        #     *   One-time transfers run at the specified time.
+        #     *   Recurring transfers run at the specified time each day, through
+        #         `schedule_end_date`.
+        # @!attribute [rw] end_time_of_day
+        #   @return [::Google::Type::TimeOfDay]
+        #     The time in UTC that no further transfer operations are scheduled. Combined
+        #     with
+        #     {::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
+        #     {::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},
+        #     and is subject to the following:
+        #
+        #     *   If `end_time_of_day` is not set and `schedule_end_date` is set, then
+        #         a default value of `23:59:59` is used for `end_time_of_day`.
+        #
+        #     *   If `end_time_of_day` is set and `schedule_end_date` is not set, then
+        #         {::Google::Rpc::Code::INVALID_ARGUMENT INVALID_ARGUMENT} is returned.
+        # @!attribute [rw] repeat_interval
+        #   @return [::Google::Protobuf::Duration]
+        #     Interval between the start of each scheduled TransferOperation. If
+        #     unspecified, the default value is 24 hours. This value may not be less than
+        #     1 hour.
+        class Schedule
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # This resource represents the configuration of a transfer job that runs
+        # periodically.
+        # @!attribute [rw] name
+        #   @return [::String]
+        #     A unique name (within the transfer project) assigned when the job is
+        #     created.  If this field is empty in a CreateTransferJobRequest, Storage
+        #     Transfer Service will assign a unique name. Otherwise, the specified name
+        #     is used as the unique name for this job.
+        #
+        #     If the specified name is in use by a job, the creation request fails with
+        #     an {::Google::Rpc::Code::ALREADY_EXISTS ALREADY_EXISTS} error.
+        #
+        #     This name must start with `"transferJobs/"` prefix and end with a letter or
+        #     a number, and should be no more than 128 characters. This name must not
+        #     start with 'transferJobs/OPI'. 'transferJobs/OPI' is a reserved prefix.
+        #     Example:
+        #     `"transferJobs/^(?!OPI)[A-Za-z0-9-._~]*[A-Za-z0-9]$"`
+        #
+        #     Invalid job names will fail with an
+        #     {::Google::Rpc::Code::INVALID_ARGUMENT INVALID_ARGUMENT} error.
+        # @!attribute [rw] description
+        #   @return [::String]
+        #     A description provided by the user for the job. Its max length is 1024
+        #     bytes when Unicode-encoded.
+        # @!attribute [rw] project_id
+        #   @return [::String]
+        #     The ID of the Google Cloud Platform Project that owns the job.
+        # @!attribute [rw] transfer_spec
+        #   @return [::Google::Cloud::StorageTransfer::V1::TransferSpec]
+        #     Transfer specification.
+        # @!attribute [rw] notification_config
+        #   @return [::Google::Cloud::StorageTransfer::V1::NotificationConfig]
+        #     Notification configuration.
+        # @!attribute [rw] schedule
+        #   @return [::Google::Cloud::StorageTransfer::V1::Schedule]
+        #     Specifies schedule for the transfer job.
+        #     This is an optional field. When the field is not set, the job will never
+        #     execute a transfer, unless you invoke RunTransferJob or update the job to
+        #     have a non-empty schedule.
+        # @!attribute [rw] status
+        #   @return [::Google::Cloud::StorageTransfer::V1::TransferJob::Status]
+        #     Status of the job. This value MUST be specified for
+        #     `CreateTransferJobRequests`.
+        #
+        #     **Note:** The effect of the new job status takes place during a subsequent
+        #     job run. For example, if you change the job status from
+        #     {::Google::Cloud::StorageTransfer::V1::TransferJob::Status::ENABLED ENABLED} to
+        #     {::Google::Cloud::StorageTransfer::V1::TransferJob::Status::DISABLED DISABLED}, and an
+        #     operation spawned by the transfer is running, the status change would not
+        #     affect the current operation.
+        # @!attribute [r] creation_time
+        #   @return [::Google::Protobuf::Timestamp]
+        #     Output only. The time that the transfer job was created.
+        # @!attribute [r] last_modification_time
+        #   @return [::Google::Protobuf::Timestamp]
+        #     Output only. The time that the transfer job was last modified.
+        # @!attribute [r] deletion_time
+        #   @return [::Google::Protobuf::Timestamp]
+        #     Output only. The time that the transfer job was deleted.
+        # @!attribute [rw] latest_operation_name
+        #   @return [::String]
+        #     The name of the most recently started TransferOperation of this JobConfig.
+        #     Present if a TransferOperation has been created for this JobConfig.
+        class TransferJob
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+
+          # The status of the transfer job.
+          module Status
+            # Zero is an illegal value.
+            STATUS_UNSPECIFIED = 0
+
+            # New transfers will be performed based on the schedule.
+            ENABLED = 1
+
+            # New transfers will not be scheduled.
+            DISABLED = 2
+
+            # This is a soft delete state. After a transfer job is set to this
+            # state, the job and all the transfer executions are subject to
+            # garbage collection. Transfer jobs become eligible for garbage collection
+            # 30 days after their status is set to `DELETED`.
+            DELETED = 3
+          end
+        end
+
+        # An entry describing an error that has occurred.
+        # @!attribute [rw] url
+        #   @return [::String]
+        #     Required. A URL that refers to the target (a data source, a data sink,
+        #     or an object) with which the error is associated.
+        # @!attribute [rw] error_details
+        #   @return [::Array<::String>]
+        #     A list of messages that carry the error details.
+        class ErrorLogEntry
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # A summary of errors by error code, plus a count and sample error log
+        # entries.
+        # @!attribute [rw] error_code
+        #   @return [::Google::Rpc::Code]
+        #     Required.
+        # @!attribute [rw] error_count
+        #   @return [::Integer]
+        #     Required. Count of this type of error.
+        # @!attribute [rw] error_log_entries
+        #   @return [::Array<::Google::Cloud::StorageTransfer::V1::ErrorLogEntry>]
+        #     Error samples.
+        #
+        #     At most 5 error log entries will be recorded for a given
+        #     error code for a single transfer operation.
+        class ErrorSummary
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # A collection of counters that report the progress of a transfer operation.
+        # @!attribute [rw] objects_found_from_source
+        #   @return [::Integer]
+        #     Objects found in the data source that are scheduled to be transferred,
+        #     excluding any that are filtered based on object conditions or skipped due
+        #     to sync.
+        # @!attribute [rw] bytes_found_from_source
+        #   @return [::Integer]
+        #     Bytes found in the data source that are scheduled to be transferred,
+        #     excluding any that are filtered based on object conditions or skipped due
+        #     to sync.
+        # @!attribute [rw] objects_found_only_from_sink
+        #   @return [::Integer]
+        #     Objects found only in the data sink that are scheduled to be deleted.
+        # @!attribute [rw] bytes_found_only_from_sink
+        #   @return [::Integer]
+        #     Bytes found only in the data sink that are scheduled to be deleted.
+        # @!attribute [rw] objects_from_source_skipped_by_sync
+        #   @return [::Integer]
+        #     Objects in the data source that are not transferred because they already
+        #     exist in the data sink.
+        # @!attribute [rw] bytes_from_source_skipped_by_sync
+        #   @return [::Integer]
+        #     Bytes in the data source that are not transferred because they already
+        #     exist in the data sink.
+        # @!attribute [rw] objects_copied_to_sink
+        #   @return [::Integer]
+        #     Objects that are copied to the data sink.
+        # @!attribute [rw] bytes_copied_to_sink
+        #   @return [::Integer]
+        #     Bytes that are copied to the data sink.
+        # @!attribute [rw] objects_deleted_from_source
+        #   @return [::Integer]
+        #     Objects that are deleted from the data source.
+        # @!attribute [rw] bytes_deleted_from_source
+        #   @return [::Integer]
+        #     Bytes that are deleted from the data source.
+        # @!attribute [rw] objects_deleted_from_sink
+        #   @return [::Integer]
+        #     Objects that are deleted from the data sink.
+        # @!attribute [rw] bytes_deleted_from_sink
+        #   @return [::Integer]
+        #     Bytes that are deleted from the data sink.
+        # @!attribute [rw] objects_from_source_failed
+        #   @return [::Integer]
+        #     Objects in the data source that failed to be transferred or that failed
+        #     to be deleted after being transferred.
+        # @!attribute [rw] bytes_from_source_failed
+        #   @return [::Integer]
+        #     Bytes in the data source that failed to be transferred or that failed to
+        #     be deleted after being transferred.
+        # @!attribute [rw] objects_failed_to_delete_from_sink
+        #   @return [::Integer]
+        #     Objects that failed to be deleted from the data sink.
+        # @!attribute [rw] bytes_failed_to_delete_from_sink
+        #   @return [::Integer]
+        #     Bytes that failed to be deleted from the data sink.
+        class TransferCounters
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Specification to configure notifications published to Cloud Pub/Sub.
+        # Notifications will be published to the customer-provided topic using the
+        # following `PubsubMessage.attributes`:
+        #
+        # * `"eventType"`: one of the
+        # {::Google::Cloud::StorageTransfer::V1::NotificationConfig::EventType EventType} values
+        # * `"payloadFormat"`: one of the
+        # {::Google::Cloud::StorageTransfer::V1::NotificationConfig::PayloadFormat PayloadFormat}
+        # values
+        # * `"projectId"`: the
+        # {::Google::Cloud::StorageTransfer::V1::TransferOperation#project_id project_id} of the
+        # `TransferOperation`
+        # * `"transferJobName"`: the
+        # {::Google::Cloud::StorageTransfer::V1::TransferOperation#transfer_job_name transfer_job_name}
+        # of the `TransferOperation`
+        # * `"transferOperationName"`: the
+        # {::Google::Cloud::StorageTransfer::V1::TransferOperation#name name} of the
+        # `TransferOperation`
+        #
+        # The `PubsubMessage.data` will contain a
+        # {::Google::Cloud::StorageTransfer::V1::TransferOperation TransferOperation} resource
+        # formatted according to the specified `PayloadFormat`.
+        # @!attribute [rw] pubsub_topic
+        #   @return [::String]
+        #     Required. The `Topic.name` of the Cloud Pub/Sub topic to which to publish
+        #     notifications. Must be of the format: `projects/{project}/topics/{topic}`.
+        #     Not matching this format will result in an
+        #     {::Google::Rpc::Code::INVALID_ARGUMENT INVALID_ARGUMENT} error.
+        # @!attribute [rw] event_types
+        #   @return [::Array<::Google::Cloud::StorageTransfer::V1::NotificationConfig::EventType>]
+        #     Event types for which a notification is desired. If empty, send
+        #     notifications for all event types.
+        # @!attribute [rw] payload_format
+        #   @return [::Google::Cloud::StorageTransfer::V1::NotificationConfig::PayloadFormat]
+        #     Required. The desired format of the notification message payloads.
+        class NotificationConfig
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+
+          # Enum for specifying event types for which notifications are to be
+          # published.
+          #
+          # Additional event types may be added in the future. Clients should either
+          # safely ignore unrecognized event types or explicitly specify which event
+          # types they are prepared to accept.
+          module EventType
+            # Illegal value, to avoid allowing a default.
+            EVENT_TYPE_UNSPECIFIED = 0
+
+            # `TransferOperation` completed with status
+            # {::Google::Cloud::StorageTransfer::V1::TransferOperation::Status::SUCCESS SUCCESS}.
+            TRANSFER_OPERATION_SUCCESS = 1
+
+            # `TransferOperation` completed with status
+            # {::Google::Cloud::StorageTransfer::V1::TransferOperation::Status::FAILED FAILED}.
+            TRANSFER_OPERATION_FAILED = 2
+
+            # `TransferOperation` completed with status
+            # {::Google::Cloud::StorageTransfer::V1::TransferOperation::Status::ABORTED ABORTED}.
+            TRANSFER_OPERATION_ABORTED = 3
+          end
+
+          # Enum for specifying the format of a notification message's payload.
+          module PayloadFormat
+            # Illegal value, to avoid allowing a default.
+            PAYLOAD_FORMAT_UNSPECIFIED = 0
+
+            # No payload is included with the notification.
+            NONE = 1
+
+            # `TransferOperation` is [formatted as a JSON
+            # response](https://developers.google.com/protocol-buffers/docs/proto3#json),
+            # in application/json.
+            JSON = 2
+          end
+        end
+
+        # A description of the execution of a transfer.
+        # @!attribute [rw] name
+        #   @return [::String]
+        #     A globally unique ID assigned by the system.
+        # @!attribute [rw] project_id
+        #   @return [::String]
+        #     The ID of the Google Cloud Platform Project that owns the operation.
+        # @!attribute [rw] transfer_spec
+        #   @return [::Google::Cloud::StorageTransfer::V1::TransferSpec]
+        #     Transfer specification.
+        # @!attribute [rw] notification_config
+        #   @return [::Google::Cloud::StorageTransfer::V1::NotificationConfig]
+        #     Notification configuration.
+        # @!attribute [rw] start_time
+        #   @return [::Google::Protobuf::Timestamp]
+        #     Start time of this transfer execution.
+        # @!attribute [rw] end_time
+        #   @return [::Google::Protobuf::Timestamp]
+        #     End time of this transfer execution.
+        # @!attribute [rw] status
+        #   @return [::Google::Cloud::StorageTransfer::V1::TransferOperation::Status]
+        #     Status of the transfer operation.
+        # @!attribute [rw] counters
+        #   @return [::Google::Cloud::StorageTransfer::V1::TransferCounters]
+        #     Information about the progress of the transfer operation.
+        # @!attribute [rw] error_breakdowns
+        #   @return [::Array<::Google::Cloud::StorageTransfer::V1::ErrorSummary>]
+        #     Summarizes errors encountered with sample error log entries.
+        # @!attribute [rw] transfer_job_name
+        #   @return [::String]
+        #     The name of the transfer job that triggers this transfer operation.
+        class TransferOperation
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+
+          # The status of a TransferOperation.
+          module Status
+            # Zero is an illegal value.
+            STATUS_UNSPECIFIED = 0
+
+            # In progress.
+            IN_PROGRESS = 1
+
+            # Paused.
+            PAUSED = 2
+
+            # Completed successfully.
+            SUCCESS = 3
+
+            # Terminated due to an unrecoverable failure.
+            FAILED = 4
+
+            # Aborted by the user.
+            ABORTED = 5
+
+            # Temporarily delayed by the system. No user action is required.
+            QUEUED = 6
+          end
+        end
+      end
+    end
+  end
+end