Update Job Properties

The Update Job Properties operation updates specific properties of a job. You can call this operation to notify the Import/Export service that the hard drives comprising the import or export job have been shipped to the Microsoft data center. An Update Job Properties request can also be used to cancel an existing job.

Request

The Update Job Properties request may be constructed as follows. HTTPS is required. Replace <subscription-id> with your subscription ID, <storage-account-name> with the name of your storage account, and <jobname> with the name of your job:

URI Parameters

Request Headers

The following table describes required and optional request headers.

Request Body

The format of the XML request body is as follows.

{
  "odata.type":"Microsoft.Cis.Services.ImportExport.Public.Job",
  "odata.id":"name",
  "odata.editLink":"https://management.core.windows.net/<subscription-id>/services/importexport/jobs/name",
  "Name":"name",
  "Properties":{
    "FriendlyName":"human-readable-job-name",
    "Description":"job-description",
"Metadata":"job-metadata",
"State":"Shipping",
"CancelRequested":true,
    "ReturnAddress":{
      "Name":"return-name",
      "Address":"return-address",
      "Phone":"return-phone",
      "Email":"return-email"
    },
    "ReturnShipping":{
      "CarrierName":"carrier-name",
      "CarrierAccountNumber":"carrier-account-number"
    },
"DeliveryPackage":{
  "CarrierName":"carrier-name"
  "TrackingNumber":"tracking-number",
  "DriveCount":drive-count,
  "ShipDate":"ship-date"
},
    "EnableVerboseLog":enable-verbose-log,
    "BackupDriveManifest":backup-drive-manifest
  }
}

The following table describes the elements of the request body.

Response

The response includes an HTTP status code and a set of response headers.

Status Code

A successful operation returns status code 204 (No Content).

Response Headers

Response Body

If the request succeeds, there is no response body.

If the request fails, the response body will contain the following error message format:

{
  "odata.error": {
    "code": "http-code",
    "message": {
        "lang": "en-US",
        "value": "detailed-error-message"
    },
    "azure.values": [
      { "ExtendedCode": "extended-error-code" },
      { "ExtendedInformation": "extended-information" }
    ]
  }
}

Sample Request and Response

The following shows a sample request and response for the Update Job Properties operation.

Request

PATCH https://management.core.windows.net/afb1a4eb-bc88-4ce1-b1af-dfec80067464/services/importexport/storageaccounts/xttest/jobs/MySampleJob?timeout=3600 HTTP/1.1
x-ms-version: 2014-05-01
x-ms-date: Wed, 30 Apr 2014 00:25:41 GMT
DataServiceVersion: 3.0;
Content-Type: application/json
Accept: application/json
Host: management.core.windows.net
Content-Length: 388
Expect: 100-continue
Connection: Keep-Alive

{
  "odata.type":"Microsoft.Cis.Services.ImportExport.Public.Job","odata.id":"MySampleJob","odata.editLink":"https://management.core.windows.net/afb1a4eb-bc88-4ce1-b1af-dfec80067464/services/importexport/jobs/MySampleJob","Properties":{
    "DeliveryPackage":{
      "CarrierName":"FedEx","TrackingNumber":"999999999999","DriveCount":2,"ShipDate":"4/30/2014 12:25:40 AM"
    }
  }
}

Response

HTTP/1.1 200 OK
Cache-Control: no-cache
Transfer-Encoding: chunked
Content-Encoding: identity
Content-Language: en-us
Last-Modified: Wed, 30 Apr 2014 00:23:52 GMT
ETag: W/"datetime'2014-04-30T00%3A23%3A52.6173161Z'"
Server: 1.0.6198.70 (rd_rdfe_stable.140426-2318) Microsoft-HTTPAPI/2.0
x-ms-servedbyregion: ussouth2
DataServiceId: https://management.core.windows.net/afb1a4eb-bc88-4ce1-b1af-dfec80067464/services/importexport/jobs/MySampleJob
x-ms-version: 2014-05-01
x-ms-request-id: 8d21cb4a7ea496a1b4b71b6dfcc8e287
Date: Wed, 30 Apr 2014 00:25:43 GMT

0

Remarks

The Update Job Properties operation enables you to update properties of a job after the job has been created. After you ship your drives to a Windows Azure data center, you are required to update certain fields before your job can be processed.

Some properties, like the Metadata property, may be updated at any time during the lifetime of a job, whereas the DeliveryPackage property can only be updated prior to the package's arrival at the Windows Azure data center.

The table below describes when various properties can be changed.

You can call Update Job Properties to update your shipping information, or to cancel a job. These two functions are described in detail below.

Shipping

After you ship your drives, you must call Update Job Properties with the State property set to Shipping, and with the ReturnAddress and DeliveryPackage properties set to valid values. In this way you notify the Import/Export service that your drives have been shipped.

Cancellation

To cancel a job, you must call Update Job Properties and set the CancelRequested property to true. You can cancel a job if its state is Creating, Shipping, or Transferring, but not if the state is Packaging.

When you cancel a job, any drives that have not entered the data transfer process will be skipped. The job will be completed for any drives that are already in the data transfer process.

Conditional Headers

You can call Update Job Properties with conditional headers specified to update the job only when certain conditions are met. When specifying conditional headers, keep in mind the following:

• If a request specifies both the If-None-Match and If-Modified-Since headers, the request is evaluated based on the criteria specified in If-None-Match.

• If a request specifies both the If-Match and If-Unmodified-Since headers, the request is evaluated based on the criteria specified in If-Match.

• With the exception of the two combinations of conditional headers listed above, a request may specify only a single conditional header. Specifying more than one conditional header results in status code 400 (Bad Request).

The following table indicates the response codes returned for an unmet condition for each conditional header:

See Also

Azure Import/Export Service Operations