All Products
Search
Document Center

Data Online Migration:CreateJobInfo

Last Updated:Jan 30, 2026

Parameter

Type

Description

Example

object

Details of the migration job to create.

Name

string

The name of the job.
The name must be 3 to 63 characters long. It can contain lowercase letters, digits, hyphens (-), and underscores (_). The name is case-sensitive and must be UTF-8 encoded. It cannot start with a hyphen (-) or an underscore (_). The name cannot be empty.

test_name

SrcAddress

string

The name of the source data address.

test_src_address

DestAddress

string

The name of the destination data address.

test_dest_address

OverwriteMode

string

The file overwrite mode.
Valid values: `never` (do not overwrite) and `always` (overwrite).

always

TransferMode

string

The file transfer mode.
Valid values: `all` (full transfer) and `lastmodified` (incremental transfer).
`OverwriteMode` and `TransferMode` are used together as follows:




  • `always` and `all`: Forces an overwrite.

  • `always` and `lastmodified`: Overwrites files based on their last modified time.

  • `never` and an empty value: Files with the same name are not overwritten.

all

Tags

string

The tags in a key-value format.
Allowed characters: uppercase and lowercase letters, digits, and the special characters hyphen (-), underscore (_), and comma (,). The maximum length is 1024 characters.

K1:V1,K2:V2

ParentVersion

string

The parent job ID. Specify the parent job ID when you create a sub-job to retry failed files.

6af62558-970d-4f44-8663-4e297170fd6a

ConvertSymlinkTarget

boolean

Specifies whether to transform the symbolic link target. For migrations from OSS to Local, Local to OSS, or Local to Local, you can enable this option to ensure that the migrated symbolic links can be accessed.

false

Audit Audit

The audit method.

EnableMultiVersioning

boolean

Specifies whether to migrate multiple versions. Multi-version migration is not currently supported.

false

FilterRule FilterRule

The filter rule.

ImportQos ImportQos

Job traffic throttling.

ScheduleRule ScheduleRule

The scheduling rule.

CreateReport

boolean

Specifies whether to create a migration report.

true

WithStorageClass

boolean

Specifies whether to migrate the StorageClass property. This is only allowed for OSS-to-OSS migrations.

false

TargetStorageClass

string

Specifies the StorageClass for the destination files. The destination must be an OSS address. Valid values: Standard, IA, Archive, ColdArchive, and DeepColdArchive.

Standard

WithLastModifyTime

boolean

Specifies whether to retain the lastModifyTime. The default value is true.

true

AppendableToNormal

boolean

Specifies whether to migrate appendable files as normal or multipart files. The default value is false.

false