Start Import History
Released in v6.7Creates and starts task for importing vCenter historical data.
Request
URLURL
https://{api_host}/rest/vcenter/deployment/history?action=start
Header Parameters
Header Parameters
string
vmware-api-session-id
Required
Required session ID, acquired from Create Session API under CIS product
vmware-api-session-id Example
b00db39f948d13ea1e59b4d6fce56389
Request Body
Request Body
DeploymentImportHistoryStartRequestBody of type application/json (required){
"spec": {
"description": "string",
"name": "string"
}
}
spec
Optional
An optional ImportHistory.CreateSpec info that can be passed for creating a new historical data import task and starts it. If unset, default value will be: - name : vcenter.deployment.history.import - description : vCenter Server history import
cURL Command
curl -X POST -H "vmware-api-session-id: b00db39f948d13ea1e59b4d6fce56389" -H "Content-Type: application/json" -d '{"spec":{"description":"string","name":"string"}}' https://{api_host}/rest/vcenter/deployment/history?action=start
Errors
401
com.vmware.vapi.std.errors.unauthenticated : if the caller is not authenticated. | com.vmware.vapi.std.errors.unauthorized : if the caller is not authorized to perform the operation.
409
com.vmware.vapi.std.errors.not_allowed_in_current_state : if vCenter historical data import task cannot be started at this time. This can happen in the following cases:
- If historical data import has already been canceled because a canceled task cannot be re-started
- If historical data import has already been completed because a completed task cannot be re-started
- If historical data import has already been paused because a paused task can only be resumed or canceled
| com.vmware.vapi.std.errors.already_in_desired_state : if vCenter historical data import task has already being started.
default
'Default' means this response is used for all HTTP codes that are not covered individually for this operation.
On This Page
Import History Operations
post
post