# Source: https://docs.datadoghq.com/ddsql_reference/data_directory/gcp/gcp.storagetransfer_transfer_job.dataset.md

---
title: Storage Transfer Service Transfer Job
description: Datadog, the leading service for cloud-scale monitoring.
breadcrumbs: >-
  Docs > DDSQL Reference > Data Directory > Storage Transfer Service Transfer
  Job
---

# Storage Transfer Service Transfer Job

A Storage Transfer Service Transfer Job in Google Cloud is a managed resource that automates data transfers between storage systems. It supports moving data from on-premises storage, other cloud providers, or Google Cloud Storage buckets. The job defines the source, destination, schedule, and transfer options, enabling efficient, secure, and repeatable data migration or synchronization workflows without manual intervention.

```
gcp.storagetransfer_transfer_job
```

## Fields

| Title                  | ID   | Type          | Data Type                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   | Description |
| ---------------------- | ---- | ------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------- |
| _key                   | core | string        |
| ancestors              | core | array<string> |
| creation_time          | core | timestamp     | Output only. The time that the transfer job was created.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| datadog_display_name   | core | string        |
| deletion_time          | core | timestamp     | Output only. The time that the transfer job was deleted.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| description            | core | string        | A description provided by the user for the job. Its max length is 1024 bytes when Unicode-encoded.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| event_stream           | core | json          | Specifies the event stream for the transfer job for event-driven transfers. When EventStream is specified, the Schedule fields are ignored.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| gcp_status             | core | 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. Possible values: ['STATUS_UNSPECIFIED', 'ENABLED', 'DISABLED', 'DELETED']. Values descriptions: ['Zero is an illegal value.', 'New transfers are performed based on the schedule.', 'New transfers are not scheduled.', '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`.']                                                                                                                                                  |
| labels                 | core | array<string> |
| last_modification_time | core | timestamp     | Output only. The time that the transfer job was last modified.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| latest_operation_name  | core | string        | The name of the most recently started TransferOperation of this JobConfig. Present if a TransferOperation has been created for this JobConfig.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| logging_config         | core | json          | Logging configuration.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| name                   | core | 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. |
| notification_config    | core | json          | Notification configuration.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| organization_id        | core | string        |
| parent                 | core | string        |
| project_id             | core | string        | The ID of the Google Cloud project that owns the job.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| project_number         | core | string        |
| region_id              | core | string        |
| replication_spec       | core | json          | Replication specification.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| resource_name          | core | string        |
| schedule               | core | json          | Specifies schedule for the transfer job. This is an optional field. When the field is not set, the job never executes a transfer, unless you invoke RunTransferJob or update the job to have a non-empty schedule.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| service_account        | core | string        | Optional. The user-managed service account to which to delegate service agent permissions. You can grant Cloud Storage bucket permissions to this service account instead of to the Transfer Service service agent. Either the service account email (`SERVICE_ACCOUNT_NAME@PROJECT_ID.iam.gserviceaccount.com`) or the unique ID (`123456789012345678901`) are accepted. See https://docs.cloud.google.com/storage-transfer/docs/delegate-service-agent-permissions for required permissions.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| tags                   | core | hstore_csv    |
| transfer_spec          | core | json          | Transfer specification.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| zone_id                | core | string        |