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

  1. Open the navigation menu and click Migration & Disaster Recovery. Under Data Transfer, click Imports. The Transfer Jobs page appears.

  2. Choose a Compartment you have permission to work in under List scope. All transfer jobs in that compartment are listed in tabular form.

  3. Click Create Transfer Job. The Create Transfer Job dialog box appears.

  4. 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.

  5. 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 Tags

To 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"
}
Note

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.

Multiple Tags

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.