Class: Google::Apis::StoragetransferV1::TransferJob
- Inherits:
-
Object
- Object
- Google::Apis::StoragetransferV1::TransferJob
- Includes:
- Core::Hashable, Core::JsonObjectSupport
- Defined in:
- lib/google/apis/storagetransfer_v1/classes.rb,
lib/google/apis/storagetransfer_v1/representations.rb,
lib/google/apis/storagetransfer_v1/representations.rb
Overview
This resource represents the configuration of a transfer job that runs periodically.
Instance Attribute Summary collapse
-
#creation_time ⇒ String
Output only.
-
#deletion_time ⇒ String
Output only.
-
#description ⇒ String
A description provided by the user for the job.
-
#event_stream ⇒ Google::Apis::StoragetransferV1::EventStream
Specifies the Event-driven transfer options.
-
#last_modification_time ⇒ String
Output only.
-
#latest_operation_name ⇒ String
The name of the most recently started TransferOperation of this JobConfig.
-
#logging_config ⇒ Google::Apis::StoragetransferV1::LoggingConfig
Specifies the logging behavior for transfer operations.
-
#name ⇒ String
A unique name (within the transfer project) assigned when the job is created.
-
#notification_config ⇒ Google::Apis::StoragetransferV1::NotificationConfig
Specification to configure notifications published to Pub/Sub.
-
#project_id ⇒ String
The ID of the Google Cloud project that owns the job.
-
#replication_spec ⇒ Google::Apis::StoragetransferV1::ReplicationSpec
Specifies the configuration for running a replication job.
-
#schedule ⇒ Google::Apis::StoragetransferV1::Schedule
Transfers can be scheduled to recur or to run just once.
-
#status ⇒ String
Status of the job.
-
#transfer_spec ⇒ Google::Apis::StoragetransferV1::TransferSpec
Configuration for running a transfer.
Instance Method Summary collapse
-
#initialize(**args) ⇒ TransferJob
constructor
A new instance of TransferJob.
-
#update!(**args) ⇒ Object
Update properties of this object.
Constructor Details
#initialize(**args) ⇒ TransferJob
Returns a new instance of TransferJob.
1583 1584 1585 |
# File 'lib/google/apis/storagetransfer_v1/classes.rb', line 1583 def initialize(**args) update!(**args) end |
Instance Attribute Details
#creation_time ⇒ String
Output only. The time that the transfer job was created.
Corresponds to the JSON property creationTime
1487 1488 1489 |
# File 'lib/google/apis/storagetransfer_v1/classes.rb', line 1487 def creation_time @creation_time end |
#deletion_time ⇒ String
Output only. The time that the transfer job was deleted.
Corresponds to the JSON property deletionTime
1492 1493 1494 |
# File 'lib/google/apis/storagetransfer_v1/classes.rb', line 1492 def deletion_time @deletion_time end |
#description ⇒ String
A description provided by the user for the job. Its max length is 1024 bytes
when Unicode-encoded.
Corresponds to the JSON property description
1498 1499 1500 |
# File 'lib/google/apis/storagetransfer_v1/classes.rb', line 1498 def description @description end |
#event_stream ⇒ Google::Apis::StoragetransferV1::EventStream
Specifies the Event-driven transfer options. Event-driven transfers listen to
an event stream to transfer updated files.
Corresponds to the JSON property eventStream
1504 1505 1506 |
# File 'lib/google/apis/storagetransfer_v1/classes.rb', line 1504 def event_stream @event_stream end |
#last_modification_time ⇒ String
Output only. The time that the transfer job was last modified.
Corresponds to the JSON property lastModificationTime
1509 1510 1511 |
# File 'lib/google/apis/storagetransfer_v1/classes.rb', line 1509 def last_modification_time @last_modification_time end |
#latest_operation_name ⇒ String
The name of the most recently started TransferOperation of this JobConfig.
Present if a TransferOperation has been created for this JobConfig.
Corresponds to the JSON property latestOperationName
1515 1516 1517 |
# File 'lib/google/apis/storagetransfer_v1/classes.rb', line 1515 def latest_operation_name @latest_operation_name end |
#logging_config ⇒ Google::Apis::StoragetransferV1::LoggingConfig
Specifies the logging behavior for transfer operations. Logs can be sent to
Cloud Logging for all transfer types. See Read transfer logs for details.
Corresponds to the JSON property loggingConfig
1522 1523 1524 |
# File 'lib/google/apis/storagetransfer_v1/classes.rb', line 1522 def logging_config @logging_config end |
#name ⇒ 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
assigns 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 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. For transfers involving PosixFilesystem, this name
must start with transferJobs/OPI
specifically. For all other transfer types,
this name must not start with transferJobs/OPI
. Non-PosixFilesystem example:
"transferJobs/^(?!OPI)[A-Za-z0-9-._~]*[A-Za-z0-9]$"
PosixFilesystem example:
"transferJobs/OPI^[A-Za-z0-9-._~]*[A-Za-z0-9]$"
Applications must not rely
on the enforcement of naming requirements involving OPI. Invalid job names
fail with an INVALID_ARGUMENT error.
Corresponds to the JSON property name
1539 1540 1541 |
# File 'lib/google/apis/storagetransfer_v1/classes.rb', line 1539 def name @name end |
#notification_config ⇒ Google::Apis::StoragetransferV1::NotificationConfig
Specification to configure notifications published to Pub/Sub. Notifications
are published to the customer-provided topic using the following
PubsubMessage.attributes
: * "eventType"
: one of the EventType values * "
payloadFormat"
: one of the PayloadFormat values * "projectId"
: the
project_id of the TransferOperation
* "transferJobName"
: the
transfer_job_name of the TransferOperation
* "transferOperationName"
: the
name of the TransferOperation
The PubsubMessage.data
contains a
TransferOperation resource formatted according to the specified PayloadFormat
.
Corresponds to the JSON property notificationConfig
1552 1553 1554 |
# File 'lib/google/apis/storagetransfer_v1/classes.rb', line 1552 def notification_config @notification_config end |
#project_id ⇒ String
The ID of the Google Cloud project that owns the job.
Corresponds to the JSON property projectId
1557 1558 1559 |
# File 'lib/google/apis/storagetransfer_v1/classes.rb', line 1557 def project_id @project_id end |
#replication_spec ⇒ Google::Apis::StoragetransferV1::ReplicationSpec
Specifies the configuration for running a replication job.
Corresponds to the JSON property replicationSpec
1562 1563 1564 |
# File 'lib/google/apis/storagetransfer_v1/classes.rb', line 1562 def replication_spec @replication_spec end |
#schedule ⇒ Google::Apis::StoragetransferV1::Schedule
Transfers can be scheduled to recur or to run just once.
Corresponds to the JSON property schedule
1567 1568 1569 |
# File 'lib/google/apis/storagetransfer_v1/classes.rb', line 1567 def schedule @schedule end |
#status ⇒ String
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 ENABLED to DISABLED,
and an operation spawned by the transfer is running, the status change would
not affect the current operation.
Corresponds to the JSON property status
1576 1577 1578 |
# File 'lib/google/apis/storagetransfer_v1/classes.rb', line 1576 def status @status end |
#transfer_spec ⇒ Google::Apis::StoragetransferV1::TransferSpec
Configuration for running a transfer.
Corresponds to the JSON property transferSpec
1581 1582 1583 |
# File 'lib/google/apis/storagetransfer_v1/classes.rb', line 1581 def transfer_spec @transfer_spec end |
Instance Method Details
#update!(**args) ⇒ Object
Update properties of this object
1588 1589 1590 1591 1592 1593 1594 1595 1596 1597 1598 1599 1600 1601 1602 1603 |
# File 'lib/google/apis/storagetransfer_v1/classes.rb', line 1588 def update!(**args) @creation_time = args[:creation_time] if args.key?(:creation_time) @deletion_time = args[:deletion_time] if args.key?(:deletion_time) @description = args[:description] if args.key?(:description) @event_stream = args[:event_stream] if args.key?(:event_stream) @last_modification_time = args[:last_modification_time] if args.key?(:last_modification_time) @latest_operation_name = args[:latest_operation_name] if args.key?(:latest_operation_name) @logging_config = args[:logging_config] if args.key?(:logging_config) @name = args[:name] if args.key?(:name) @notification_config = args[:notification_config] if args.key?(:notification_config) @project_id = args[:project_id] if args.key?(:project_id) @replication_spec = args[:replication_spec] if args.key?(:replication_spec) @schedule = args[:schedule] if args.key?(:schedule) @status = args[:status] if args.key?(:status) @transfer_spec = args[:transfer_spec] if args.key?(:transfer_spec) end |