google-cloud-storage_transfer-v1 0.3.0 → 0.5.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- checksums.yaml +4 -4
- data/AUTHENTICATION.md +1 -1
- data/README.md +2 -2
- data/lib/google/cloud/storage_transfer/v1/rest.rb +37 -0
- data/lib/google/cloud/storage_transfer/v1/storage_transfer_service/client.rb +115 -18
- data/lib/google/cloud/storage_transfer/v1/storage_transfer_service/operations.rb +12 -14
- data/lib/google/cloud/storage_transfer/v1/storage_transfer_service/rest/client.rb +1381 -0
- data/lib/google/cloud/storage_transfer/v1/storage_transfer_service/rest/operations.rb +793 -0
- data/lib/google/cloud/storage_transfer/v1/storage_transfer_service/rest/service_stub.rb +877 -0
- data/lib/google/cloud/storage_transfer/v1/storage_transfer_service/rest.rb +55 -0
- data/lib/google/cloud/storage_transfer/v1/storage_transfer_service.rb +7 -1
- data/lib/google/cloud/storage_transfer/v1/version.rb +1 -1
- data/lib/google/cloud/storage_transfer/v1.rb +7 -2
- data/lib/google/storagetransfer/v1/transfer_pb.rb +5 -0
- data/lib/google/storagetransfer/v1/transfer_services_pb.rb +3 -0
- data/lib/google/storagetransfer/v1/transfer_types_pb.rb +42 -0
- data/proto_docs/google/api/client.rb +318 -0
- data/proto_docs/google/api/launch_stage.rb +71 -0
- data/proto_docs/google/protobuf/empty.rb +0 -2
- data/proto_docs/google/rpc/code.rb +6 -6
- data/proto_docs/google/rpc/status.rb +4 -2
- data/proto_docs/google/storagetransfer/v1/transfer.rb +14 -1
- data/proto_docs/google/storagetransfer/v1/transfer_types.rb +115 -8
- metadata +16 -8
| @@ -59,7 +59,7 @@ module Google | |
| 59 59 | 
             
                    #     other fields are rejected with the error
         | 
| 60 60 | 
             
                    #     {::Google::Rpc::Code::INVALID_ARGUMENT INVALID_ARGUMENT}. Updating a job status
         | 
| 61 61 | 
             
                    #     to {::Google::Cloud::StorageTransfer::V1::TransferJob::Status::DELETED DELETED} requires
         | 
| 62 | 
            -
                    #     `storagetransfer.jobs.delete`  | 
| 62 | 
            +
                    #     `storagetransfer.jobs.delete` permission.
         | 
| 63 63 | 
             
                    # @!attribute [rw] update_transfer_job_field_mask
         | 
| 64 64 | 
             
                    #   @return [::Google::Protobuf::FieldMask]
         | 
| 65 65 | 
             
                    #     The field mask of the fields in `transferJob` that are to be updated in
         | 
| @@ -90,6 +90,19 @@ module Google | |
| 90 90 | 
             
                      extend ::Google::Protobuf::MessageExts::ClassMethods
         | 
| 91 91 | 
             
                    end
         | 
| 92 92 |  | 
| 93 | 
            +
                    # Request passed to DeleteTransferJob.
         | 
| 94 | 
            +
                    # @!attribute [rw] job_name
         | 
| 95 | 
            +
                    #   @return [::String]
         | 
| 96 | 
            +
                    #     Required. The job to delete.
         | 
| 97 | 
            +
                    # @!attribute [rw] project_id
         | 
| 98 | 
            +
                    #   @return [::String]
         | 
| 99 | 
            +
                    #     Required. The ID of the Google Cloud project that owns the
         | 
| 100 | 
            +
                    #     job.
         | 
| 101 | 
            +
                    class DeleteTransferJobRequest
         | 
| 102 | 
            +
                      include ::Google::Protobuf::MessageExts
         | 
| 103 | 
            +
                      extend ::Google::Protobuf::MessageExts::ClassMethods
         | 
| 104 | 
            +
                    end
         | 
| 105 | 
            +
             | 
| 93 106 | 
             
                    # `projectId`, `jobNames`, and `jobStatuses` are query parameters that can
         | 
| 94 107 | 
             
                    # be specified when listing transfer jobs.
         | 
| 95 108 | 
             
                    # @!attribute [rw] filter
         | 
| @@ -332,6 +332,109 @@ module Google | |
| 332 332 | 
             
                      extend ::Google::Protobuf::MessageExts::ClassMethods
         | 
| 333 333 | 
             
                    end
         | 
| 334 334 |  | 
| 335 | 
            +
                    # An AwsS3CompatibleData resource.
         | 
| 336 | 
            +
                    # @!attribute [rw] bucket_name
         | 
| 337 | 
            +
                    #   @return [::String]
         | 
| 338 | 
            +
                    #     Required. Specifies the name of the bucket.
         | 
| 339 | 
            +
                    # @!attribute [rw] path
         | 
| 340 | 
            +
                    #   @return [::String]
         | 
| 341 | 
            +
                    #     Specifies the root path to transfer objects.
         | 
| 342 | 
            +
                    #
         | 
| 343 | 
            +
                    #     Must be an empty string or full path name that ends with a '/'. This
         | 
| 344 | 
            +
                    #     field is treated as an object prefix. As such, it should generally not
         | 
| 345 | 
            +
                    #     begin with a '/'.
         | 
| 346 | 
            +
                    # @!attribute [rw] endpoint
         | 
| 347 | 
            +
                    #   @return [::String]
         | 
| 348 | 
            +
                    #     Required. Specifies the endpoint of the storage service.
         | 
| 349 | 
            +
                    # @!attribute [rw] region
         | 
| 350 | 
            +
                    #   @return [::String]
         | 
| 351 | 
            +
                    #     Specifies the region to sign requests with. This can be left blank if
         | 
| 352 | 
            +
                    #     requests should be signed with an empty region.
         | 
| 353 | 
            +
                    # @!attribute [rw] s3_metadata
         | 
| 354 | 
            +
                    #   @return [::Google::Cloud::StorageTransfer::V1::S3CompatibleMetadata]
         | 
| 355 | 
            +
                    #     A S3 compatible metadata.
         | 
| 356 | 
            +
                    class AwsS3CompatibleData
         | 
| 357 | 
            +
                      include ::Google::Protobuf::MessageExts
         | 
| 358 | 
            +
                      extend ::Google::Protobuf::MessageExts::ClassMethods
         | 
| 359 | 
            +
                    end
         | 
| 360 | 
            +
             | 
| 361 | 
            +
                    # S3CompatibleMetadata contains the metadata fields that apply to the basic
         | 
| 362 | 
            +
                    # types of S3-compatible data providers.
         | 
| 363 | 
            +
                    # @!attribute [rw] auth_method
         | 
| 364 | 
            +
                    #   @return [::Google::Cloud::StorageTransfer::V1::S3CompatibleMetadata::AuthMethod]
         | 
| 365 | 
            +
                    #     Specifies the authentication and authorization method used by the storage
         | 
| 366 | 
            +
                    #     service. When not specified, Transfer Service will attempt to determine
         | 
| 367 | 
            +
                    #     right auth method to use.
         | 
| 368 | 
            +
                    # @!attribute [rw] request_model
         | 
| 369 | 
            +
                    #   @return [::Google::Cloud::StorageTransfer::V1::S3CompatibleMetadata::RequestModel]
         | 
| 370 | 
            +
                    #     Specifies the API request model used to call the storage service. When not
         | 
| 371 | 
            +
                    #     specified, the default value of RequestModel
         | 
| 372 | 
            +
                    #     REQUEST_MODEL_VIRTUAL_HOSTED_STYLE is used.
         | 
| 373 | 
            +
                    # @!attribute [rw] protocol
         | 
| 374 | 
            +
                    #   @return [::Google::Cloud::StorageTransfer::V1::S3CompatibleMetadata::NetworkProtocol]
         | 
| 375 | 
            +
                    #     Specifies the network protocol of the agent. When not specified, the
         | 
| 376 | 
            +
                    #     default value of NetworkProtocol NETWORK_PROTOCOL_HTTPS is used.
         | 
| 377 | 
            +
                    # @!attribute [rw] list_api
         | 
| 378 | 
            +
                    #   @return [::Google::Cloud::StorageTransfer::V1::S3CompatibleMetadata::ListApi]
         | 
| 379 | 
            +
                    #     The Listing API to use for discovering objects. When not specified,
         | 
| 380 | 
            +
                    #     Transfer Service will attempt to determine the right API to use.
         | 
| 381 | 
            +
                    class S3CompatibleMetadata
         | 
| 382 | 
            +
                      include ::Google::Protobuf::MessageExts
         | 
| 383 | 
            +
                      extend ::Google::Protobuf::MessageExts::ClassMethods
         | 
| 384 | 
            +
             | 
| 385 | 
            +
                      # The authentication and authorization method used by the storage service.
         | 
| 386 | 
            +
                      module AuthMethod
         | 
| 387 | 
            +
                        # AuthMethod is not specified.
         | 
| 388 | 
            +
                        AUTH_METHOD_UNSPECIFIED = 0
         | 
| 389 | 
            +
             | 
| 390 | 
            +
                        # Auth requests with AWS SigV4.
         | 
| 391 | 
            +
                        AUTH_METHOD_AWS_SIGNATURE_V4 = 1
         | 
| 392 | 
            +
             | 
| 393 | 
            +
                        # Auth requests with AWS SigV2.
         | 
| 394 | 
            +
                        AUTH_METHOD_AWS_SIGNATURE_V2 = 2
         | 
| 395 | 
            +
                      end
         | 
| 396 | 
            +
             | 
| 397 | 
            +
                      # The request model of the API.
         | 
| 398 | 
            +
                      module RequestModel
         | 
| 399 | 
            +
                        # RequestModel is not specified.
         | 
| 400 | 
            +
                        REQUEST_MODEL_UNSPECIFIED = 0
         | 
| 401 | 
            +
             | 
| 402 | 
            +
                        # Perform requests using Virtual Hosted Style.
         | 
| 403 | 
            +
                        # Example: https://bucket-name.s3.region.amazonaws.com/key-name
         | 
| 404 | 
            +
                        REQUEST_MODEL_VIRTUAL_HOSTED_STYLE = 1
         | 
| 405 | 
            +
             | 
| 406 | 
            +
                        # Perform requests using Path Style.
         | 
| 407 | 
            +
                        # Example: https://s3.region.amazonaws.com/bucket-name/key-name
         | 
| 408 | 
            +
                        REQUEST_MODEL_PATH_STYLE = 2
         | 
| 409 | 
            +
                      end
         | 
| 410 | 
            +
             | 
| 411 | 
            +
                      # The agent network protocol to access the storage service.
         | 
| 412 | 
            +
                      module NetworkProtocol
         | 
| 413 | 
            +
                        # NetworkProtocol is not specified.
         | 
| 414 | 
            +
                        NETWORK_PROTOCOL_UNSPECIFIED = 0
         | 
| 415 | 
            +
             | 
| 416 | 
            +
                        # Perform requests using HTTPS.
         | 
| 417 | 
            +
                        NETWORK_PROTOCOL_HTTPS = 1
         | 
| 418 | 
            +
             | 
| 419 | 
            +
                        # Not recommended: This sends data in clear-text. This is only
         | 
| 420 | 
            +
                        # appropriate within a closed network or for publicly available data.
         | 
| 421 | 
            +
                        # Perform requests using HTTP.
         | 
| 422 | 
            +
                        NETWORK_PROTOCOL_HTTP = 2
         | 
| 423 | 
            +
                      end
         | 
| 424 | 
            +
             | 
| 425 | 
            +
                      # The Listing API to use for discovering objects.
         | 
| 426 | 
            +
                      module ListApi
         | 
| 427 | 
            +
                        # ListApi is not specified.
         | 
| 428 | 
            +
                        LIST_API_UNSPECIFIED = 0
         | 
| 429 | 
            +
             | 
| 430 | 
            +
                        # Perform listing using ListObjectsV2 API.
         | 
| 431 | 
            +
                        LIST_OBJECTS_V2 = 1
         | 
| 432 | 
            +
             | 
| 433 | 
            +
                        # Legacy ListObjects API.
         | 
| 434 | 
            +
                        LIST_OBJECTS = 2
         | 
| 435 | 
            +
                      end
         | 
| 436 | 
            +
                    end
         | 
| 437 | 
            +
             | 
| 335 438 | 
             
                    # Represents an On-Premises Agent pool.
         | 
| 336 439 | 
             
                    # @!attribute [rw] name
         | 
| 337 440 | 
             
                    #   @return [::String]
         | 
| @@ -403,13 +506,12 @@ module Google | |
| 403 506 | 
             
                    #     exclusive.
         | 
| 404 507 | 
             
                    # @!attribute [rw] overwrite_when
         | 
| 405 508 | 
             
                    #   @return [::Google::Cloud::StorageTransfer::V1::TransferOptions::OverwriteWhen]
         | 
| 406 | 
            -
                    #     When to overwrite objects that already exist in the sink. If not set
         | 
| 509 | 
            +
                    #     When to overwrite objects that already exist in the sink. If not set,
         | 
| 407 510 | 
             
                    #     overwrite behavior is determined by
         | 
| 408 511 | 
             
                    #     {::Google::Cloud::StorageTransfer::V1::TransferOptions#overwrite_objects_already_existing_in_sink overwrite_objects_already_existing_in_sink}.
         | 
| 409 512 | 
             
                    # @!attribute [rw] metadata_options
         | 
| 410 513 | 
             
                    #   @return [::Google::Cloud::StorageTransfer::V1::MetadataOptions]
         | 
| 411 | 
            -
                    #     Represents the selected metadata options for a transfer job. | 
| 412 | 
            -
                    #     is in Preview.
         | 
| 514 | 
            +
                    #     Represents the selected metadata options for a transfer job.
         | 
| 413 515 | 
             
                    class TransferOptions
         | 
| 414 516 | 
             
                      include ::Google::Protobuf::MessageExts
         | 
| 415 517 | 
             
                      extend ::Google::Protobuf::MessageExts::ClassMethods
         | 
| @@ -417,17 +519,19 @@ module Google | |
| 417 519 | 
             
                      # Specifies when to overwrite an object in the sink when an object with
         | 
| 418 520 | 
             
                      # matching name is found in the source.
         | 
| 419 521 | 
             
                      module OverwriteWhen
         | 
| 420 | 
            -
                        #  | 
| 522 | 
            +
                        # Overwrite behavior is unspecified.
         | 
| 421 523 | 
             
                        OVERWRITE_WHEN_UNSPECIFIED = 0
         | 
| 422 524 |  | 
| 423 | 
            -
                        #  | 
| 424 | 
            -
                        # different.
         | 
| 525 | 
            +
                        # Overwrites destination objects with the source objects, only if the
         | 
| 526 | 
            +
                        # objects have the same name but different HTTP ETags or checksum values.
         | 
| 425 527 | 
             
                        DIFFERENT = 1
         | 
| 426 528 |  | 
| 427 | 
            -
                        # Never  | 
| 529 | 
            +
                        # Never overwrites a destination object if a source object has the
         | 
| 530 | 
            +
                        # same name. In this case, the source object is not transferred.
         | 
| 428 531 | 
             
                        NEVER = 2
         | 
| 429 532 |  | 
| 430 | 
            -
                        # Always overwrite destination object | 
| 533 | 
            +
                        # Always overwrite the destination object with the source object, even if
         | 
| 534 | 
            +
                        # the HTTP Etags or checksum values are the same.
         | 
| 431 535 | 
             
                        ALWAYS = 3
         | 
| 432 536 | 
             
                      end
         | 
| 433 537 | 
             
                    end
         | 
| @@ -454,6 +558,9 @@ module Google | |
| 454 558 | 
             
                    # @!attribute [rw] azure_blob_storage_data_source
         | 
| 455 559 | 
             
                    #   @return [::Google::Cloud::StorageTransfer::V1::AzureBlobStorageData]
         | 
| 456 560 | 
             
                    #     An Azure Blob Storage data source.
         | 
| 561 | 
            +
                    # @!attribute [rw] aws_s3_compatible_data_source
         | 
| 562 | 
            +
                    #   @return [::Google::Cloud::StorageTransfer::V1::AwsS3CompatibleData]
         | 
| 563 | 
            +
                    #     An AWS S3 compatible data source.
         | 
| 457 564 | 
             
                    # @!attribute [rw] gcs_intermediate_data_location
         | 
| 458 565 | 
             
                    #   @return [::Google::Cloud::StorageTransfer::V1::GcsData]
         | 
| 459 566 | 
             
                    #     Cloud Storage intermediate data location.
         | 
    
        metadata
    CHANGED
    
    | @@ -1,14 +1,14 @@ | |
| 1 1 | 
             
            --- !ruby/object:Gem::Specification
         | 
| 2 2 | 
             
            name: google-cloud-storage_transfer-v1
         | 
| 3 3 | 
             
            version: !ruby/object:Gem::Version
         | 
| 4 | 
            -
              version: 0. | 
| 4 | 
            +
              version: 0.5.0
         | 
| 5 5 | 
             
            platform: ruby
         | 
| 6 6 | 
             
            authors:
         | 
| 7 7 | 
             
            - Google LLC
         | 
| 8 8 | 
             
            autorequire: 
         | 
| 9 9 | 
             
            bindir: bin
         | 
| 10 10 | 
             
            cert_chain: []
         | 
| 11 | 
            -
            date:  | 
| 11 | 
            +
            date: 2023-03-08 00:00:00.000000000 Z
         | 
| 12 12 | 
             
            dependencies:
         | 
| 13 13 | 
             
            - !ruby/object:Gem::Dependency
         | 
| 14 14 | 
             
              name: gapic-common
         | 
| @@ -16,7 +16,7 @@ dependencies: | |
| 16 16 | 
             
                requirements:
         | 
| 17 17 | 
             
                - - ">="
         | 
| 18 18 | 
             
                  - !ruby/object:Gem::Version
         | 
| 19 | 
            -
                    version:  | 
| 19 | 
            +
                    version: 0.18.0
         | 
| 20 20 | 
             
                - - "<"
         | 
| 21 21 | 
             
                  - !ruby/object:Gem::Version
         | 
| 22 22 | 
             
                    version: 2.a
         | 
| @@ -26,7 +26,7 @@ dependencies: | |
| 26 26 | 
             
                requirements:
         | 
| 27 27 | 
             
                - - ">="
         | 
| 28 28 | 
             
                  - !ruby/object:Gem::Version
         | 
| 29 | 
            -
                    version:  | 
| 29 | 
            +
                    version: 0.18.0
         | 
| 30 30 | 
             
                - - "<"
         | 
| 31 31 | 
             
                  - !ruby/object:Gem::Version
         | 
| 32 32 | 
             
                    version: 2.a
         | 
| @@ -50,14 +50,14 @@ dependencies: | |
| 50 50 | 
             
                requirements:
         | 
| 51 51 | 
             
                - - "~>"
         | 
| 52 52 | 
             
                  - !ruby/object:Gem::Version
         | 
| 53 | 
            -
                    version: 1.26. | 
| 53 | 
            +
                    version: 1.26.3
         | 
| 54 54 | 
             
              type: :development
         | 
| 55 55 | 
             
              prerelease: false
         | 
| 56 56 | 
             
              version_requirements: !ruby/object:Gem::Requirement
         | 
| 57 57 | 
             
                requirements:
         | 
| 58 58 | 
             
                - - "~>"
         | 
| 59 59 | 
             
                  - !ruby/object:Gem::Version
         | 
| 60 | 
            -
                    version: 1.26. | 
| 60 | 
            +
                    version: 1.26.3
         | 
| 61 61 | 
             
            - !ruby/object:Gem::Dependency
         | 
| 62 62 | 
             
              name: minitest
         | 
| 63 63 | 
             
              requirement: !ruby/object:Gem::Requirement
         | 
| @@ -173,17 +173,24 @@ files: | |
| 173 173 | 
             
            - README.md
         | 
| 174 174 | 
             
            - lib/google-cloud-storage_transfer-v1.rb
         | 
| 175 175 | 
             
            - lib/google/cloud/storage_transfer/v1.rb
         | 
| 176 | 
            +
            - lib/google/cloud/storage_transfer/v1/rest.rb
         | 
| 176 177 | 
             
            - lib/google/cloud/storage_transfer/v1/storage_transfer_service.rb
         | 
| 177 178 | 
             
            - lib/google/cloud/storage_transfer/v1/storage_transfer_service/client.rb
         | 
| 178 179 | 
             
            - lib/google/cloud/storage_transfer/v1/storage_transfer_service/credentials.rb
         | 
| 179 180 | 
             
            - lib/google/cloud/storage_transfer/v1/storage_transfer_service/operations.rb
         | 
| 180 181 | 
             
            - lib/google/cloud/storage_transfer/v1/storage_transfer_service/paths.rb
         | 
| 182 | 
            +
            - lib/google/cloud/storage_transfer/v1/storage_transfer_service/rest.rb
         | 
| 183 | 
            +
            - lib/google/cloud/storage_transfer/v1/storage_transfer_service/rest/client.rb
         | 
| 184 | 
            +
            - lib/google/cloud/storage_transfer/v1/storage_transfer_service/rest/operations.rb
         | 
| 185 | 
            +
            - lib/google/cloud/storage_transfer/v1/storage_transfer_service/rest/service_stub.rb
         | 
| 181 186 | 
             
            - lib/google/cloud/storage_transfer/v1/version.rb
         | 
| 182 187 | 
             
            - lib/google/storagetransfer/v1/transfer_pb.rb
         | 
| 183 188 | 
             
            - lib/google/storagetransfer/v1/transfer_services_pb.rb
         | 
| 184 189 | 
             
            - lib/google/storagetransfer/v1/transfer_types_pb.rb
         | 
| 185 190 | 
             
            - proto_docs/README.md
         | 
| 191 | 
            +
            - proto_docs/google/api/client.rb
         | 
| 186 192 | 
             
            - proto_docs/google/api/field_behavior.rb
         | 
| 193 | 
            +
            - proto_docs/google/api/launch_stage.rb
         | 
| 187 194 | 
             
            - proto_docs/google/api/resource.rb
         | 
| 188 195 | 
             
            - proto_docs/google/longrunning/operations.rb
         | 
| 189 196 | 
             
            - proto_docs/google/protobuf/any.rb
         | 
| @@ -216,8 +223,9 @@ required_rubygems_version: !ruby/object:Gem::Requirement | |
| 216 223 | 
             
                - !ruby/object:Gem::Version
         | 
| 217 224 | 
             
                  version: '0'
         | 
| 218 225 | 
             
            requirements: []
         | 
| 219 | 
            -
            rubygems_version: 3. | 
| 226 | 
            +
            rubygems_version: 3.4.2
         | 
| 220 227 | 
             
            signing_key: 
         | 
| 221 228 | 
             
            specification_version: 4
         | 
| 222 | 
            -
            summary:  | 
| 229 | 
            +
            summary: Transfers data from external data sources to a Google Cloud Storage bucket
         | 
| 230 | 
            +
              or between Google Cloud Storage buckets.
         | 
| 223 231 | 
             
            test_files: []
         |