Creating an Appliance Import Transfer Job
Create an appliance import transfer job.
Create the transfer job in the same compartment as the upload bucket and supply a human-readable name for the transfer job.
Creating a transfer job returns a job OCID that you specify in other transfer tasks. For example:
ocid1.datatransferjob.oci1..exampleuniqueID
Using the Console
-
Open the navigation menu and click Migration & Disaster Recovery. Under Data Transfer, click Imports. The Transfer Jobs page appears.
-
Choose a Compartment you have permission to work in under List scope. All transfer jobs in that compartment are listed in tabular form.
-
Click Create Transfer Job. The Create Transfer Job dialog box appears.
-
Complete the following:
-
Job Name: Enter a name for the transfer job.
-
Bucket: Select the bucket that contains the transfer data from the list. All available buckets for the selected compartment are listed. If you want to select a bucket in a different compartment, click Change Compartment and select the compartment that contains the bucket you want.
-
Transfer Type Device: Select the Appliance option.
-
(Optional) Complete the tagging settings:
-
Tag namespace: Select a namespace from the list.
-
Tag key: Enter a tagging key.
-
Tag value: Enter a value for the tagging key.
See Overview of Tagging for more information.
-
-
-
Click Create Transfer Job.
Using the CLI
Use the oci dts job create command and required parameters to create an appliance import transfer job
oci dts job create --bucket bucket --compartment-id compartment_id
--display-name display_name --device-type appliance [OPTIONS]
For a complete list of flags and variable options for CLI commands, see the Command Line Reference.
For example:
oci dts job create --bucket MyBucket1 --compartment-id ocid.compartment.oc1..exampleuniqueID
--display-name MyApplianceImportJob --device-type appliance
{
"data": {
"attached-transfer-appliance-labels": [],
"attached-transfer-device-labels": [],
"attached-transfer-package-labels": [],
"compartment-id": "ocid.compartment.oc1..exampleuniqueID",
"creation-time": "2019-12-18T19:43:58+00:00",
"defined-tags": {},
"device-type": "APPLIANCE",
"display-name": "MyApplianceImportJob",
"freeform-tags": {},
"id": "ocid1.datatransferjob.oc1..exampleuniqueID",
"label": "JAKQVAGJF",
"lifecycle-state": "INITIATED",
"upload-bucket-name": "MyBucket1"
},
"etag": "2--gzip"
}
Optionally, you can specify one or more defined or freeform tags when you create a transfer job. For more information about tagging, see Resource Tags.
Defined TagsTo specify defined tags when creating a job:
oci dts job create --bucket bucket --compartment-id compartment_id --display-name display_name --device-type appliance --defined-tags '{ "tag_namespace": { "tag_key":"value" }}'
For example:
oci dts job create --bucket MyBucket1 --compartment-id ocid.compartment.oc1..exampleuniqueID --display-name MyApplianceImportJob --device-type appliance --defined-tags '{"Operations": {"CostCenter": "01"}}'
{
"data": {
"attached-transfer-appliance-labels": [],
"attached-transfer-device-labels": [],
"attached-transfer-package-labels": [],
"compartment-id": "ocid.compartment.oc1..exampleuniqueID",
"creation-time": "2019-12-18T19:43:58+00:00",
"defined-tags": {
"operations": {
"costcenter": "01"
}
},
"device-type": "APPLIANCE",
"display-name": "MyApplianceImportJob",
"freeform-tags": {},
"id": "ocid1.datatransferjob.oc1..exampleuniqueID",
"label": "JAKQVAGJF",
"lifecycle-state": "INITIATED",
"upload-bucket-name": "MyBucket1"
},
"etag": "2--gzip"
}
Freeform Tags
To specify freeform tags when creating a job:
oci dts job create --bucket bucket --compartment-id compartment_id --display-name display_name --device-type appliance --freeform-tags '{ "tag_key":"value" }'
For example:
oci dts job create --bucket MyBucket1 --compartment-id ocid.compartment.oc1..exampleuniqueID --display-name MyApplianceImportJob --device-type appliance --freeform-tags '{"Pittsburg_Team":"brochures"}'
{
"data": {
"attached-transfer-appliance-labels": [],
"attached-transfer-device-labels": [],
"attached-transfer-package-labels": [],
"compartment-id": "ocid.compartment.oc1..exampleuniqueID",
"creation-time": "2019-12-18T19:43:58+00:00",
"defined-tags": {},
"device-type": "APPLIANCE",
"display-name": "MyApplianceImportJob",
"freeform-tags": {
"Pittsburg_Team": "brochures"
},
"id": "ocid1.datatransferjob.oc1..exampleuniqueID",
"label": "JAKQVAGJF",
"lifecycle-state": "INITIATED",
"upload-bucket-name": "MyBucket1"
},
"etag": "2--gzip"
}
Users create tag namespaces and tag keys with the required permissions. These items must exist before you can specify them when creating a job. See Tags and Tag Namespace Concepts for details.
To specify multiple tags, comma separate the JSON-formatted key/value pairs:
oci dts job create --bucket bucket --compartment-id compartment_id --display-name display_name --device-type appliance --freeform-tags '{ "tag_key":"value" }', '{ "tag_key":"value" }'
Notifications
To include notifications, include the --setup-notifications
option. See Setting Up Transfer Job Notifications from the CLI for more information on this feature.