migration_trace
The migration_trace method retrieves detailed information about a single
user in a current or historical migration job.
Migration trace files are not available until the migration has started.
Syntax
{
<credentials object>
"job":<job id>,
"user":<username>
}
Request fields for migration_trace
The following fields can be used in the migration_trace method:
Field name | Obligation | Definition/Value |
---|---|---|
job | Required | The ID of the job you are querying. The ID is returned in the migration_add response. |
user | Required | The username of the person whose migration job is being retrieved. |
Response fields for migration_trace
The following fields may be returned when the migration_trace method is submitted:
Field name | Obligation | Description/Value |
---|---|---|
error | Returned if success = false | A text string that explains the error. |
error_number | Returned if success = false | A number that represents the error. |
success | Always returned | Indicates whether the requested change was successful or not. Allowed values are true and false. |
trace | Returned if success = true | The URL where the trace file can be downloaded. The trace file provides detailed information about the migration job. |
Examples for migration_trace
Request
{
"credentials": {
"user": "[email protected]",
"password": "sw0rdf1sh"
},
"user": "[email protected]",
"job": "1326229437638"
}
Response
{
"success": true,
"trace":"https://admin.a.hostedemail.com/api/oma_file/get?type=migrat iontrace&id=joe_user%40democo.com%3A1326229437638&user=domain_admin%40d emoco.com&token=44d904b456a2ffe0c0e77653e0ac44e9"
}
Updated less than a minute ago