Editing an Appliance Import Transfer Job's Tags

Use the oci dts job update command and required parameters to edit an appliance import transfer job's tags. The CLI command replaces any existing tags with the new key/value pairs you specify. For more information about tagging, see Resource Tags.

oci dts job update --job-id job_id --defined-tags '{ "tag_namespace": { "tag_key":"value" }}' [OPTIONS]

For example:

oci dts job update --job-id ocid1.datatransferjob.oc1..exampleuniqueID --defined-tags '{"Operations": {"CostCenter": "42"}}'
				
{
  "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": "42"
    }
  },
  "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"
}

To edit free-form tags, provide the replacement key/value pairs:

oci dts job update --job-id <job_id> --freeform-tags '{ "tag_key":"value" }' [OPTIONS]

Here is an example of the output:

oci dts job update --job-id ocid1.datatransferjob.oc1..exampleuniqueID --freeform-tags '{"Chicago_Team":"marketing_videos"}'
				
{
  "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": {
    "Chicago_Team": "marketing_videos"
  },  
  "id": "ocid1.datatransferjob.oc1..exampleuniqueID",
  "label": "JAKQVAGJF",
  "lifecycle-state": "INITIATED",
  "upload-bucket-name": "MyBucket1"
  },
  "etag": "2--gzip"
}

For a complete list of flags and variable options for CLI commands, see the Command Line Reference.