vcenter deployment install remote psc: check
Checks whether the remote PSC is reachable and the deployed vCenter Server can be registered with the remote PSC. This operation was added in vSphere API 6.7.
Request:
HTTP request
POST https://{server}/rest/vcenter/deployment/install/remote-psc?action=check
Request Body Structure:
{
"spec" : {
"https_port" : 1,
"sso_admin_password" : "string",
"psc_hostname" : "string",
"ssl_thumbprint" : "string",
"ssl_verify" : true
}
}
"spec" : {
"https_port" : 1,
"sso_admin_password" : "string",
"psc_hostname" : "string",
"ssl_thumbprint" : "string",
"ssl_verify" : true
}
}
Request Body Parameters:
| Name | Type | Description |
|---|---|---|
| bold = required | ||
| spec | remote_psc_spec | Information to connect to the remote PSC. |
| spec.psc_hostname | string | The IP address or DNS resolvable name of the remote PSC to which this configuring vCenter Server will be registered to. This attribute was added in vSphere API 6.7. |
| spec.https_port | long | The HTTPS port of the external PSC appliance. This attribute was added in vSphere API 6.7. Optional. If unset, port 443 will be used. |
| spec.sso_admin_password | string | The SSO administrator account password. This attribute was added in vSphere API 6.7. |
| spec.ssl_thumbprint | string | SHA1 thumbprint of the server SSL certificate will be used for verification when ssl_verify field is set to true. This attribute was added in vSphere API 6.7. Optional. This field is only relevant if ssl_verify is unset or has the value true. |
| spec.ssl_verify | boolean | SSL verification should be enabled or disabled. If ssl_verify is true and and ssl_thumbprint is unset, the CA certificate will be used for verification. If ssl_verify is true and ssl_thumbprint is set then the thumbprint will be used for verification. No verification will be performed if ssl_verify value is set to false. This attribute was added in vSphere API 6.7. Optional. If unset, ssl_verify true will be used. |
Response:
HTTP Status Code: 200
Representation:
{
"value" : {
"result" : {
"warnings" : [
{
"id" : "string",
"time" : "2015-01-01T22:13:05.651Z",
"message" : {
"args" : [
"string",
"string"
],
"default_message" : "string",
"localized" : "string",
"id" : "string",
"params" : [
{
"value" : {
"dt" : "2015-01-01T22:13:05.651Z",
"s" : "string",
"d" : 1.5,
"precision" : 1,
"format" : "SHORT_DATE",
"i" : 1,
"l" : {
"id" : "string",
"params" : [
{
"value" : {
"dt" : "2015-01-01T22:13:05.651Z",
"s" : "string",
"d" : 1.5,
"precision" : 1,
"format" : "SHORT_DATE",
"i" : 1,
"l" : {
"id" : "string",
"params" : [
{
"key" : "string"
}
]
}
},
"key" : "string"
}
]
}
},
"key" : "string"
}
]
},
"resolution" : {
"args" : [
"string",
"string"
],
"default_message" : "string",
"localized" : "string",
"id" : "string",
"params" : [
{
"value" : {
"dt" : "2015-01-01T22:13:05.651Z",
"s" : "string",
"d" : 1.5,
"precision" : 1,
"format" : "SHORT_DATE",
"i" : 1,
"l" : {
"id" : "string",
"params" : [
{
"value" : {
"dt" : "2015-01-01T22:13:05.651Z",
"s" : "string",
"d" : 1.5,
"precision" : 1,
"format" : "SHORT_DATE",
"i" : 1,
"l" : {
"id" : "string",
"params" : [
{
"key" : "string"
}
]
}
},
"key" : "string"
}
]
}
},
"key" : "string"
}
]
}
},
{
"id" : "string",
"time" : "2015-01-01T22:13:05.651Z",
"message" : {
"args" : [
"string",
"string"
],
"default_message" : "string",
"localized" : "string",
"id" : "string",
"params" : [
{
"value" : {
"dt" : "2015-01-01T22:13:05.651Z",
"s" : "string",
"d" : 1.5,
"precision" : 1,
"format" : "SHORT_DATE",
"i" : 1,
"l" : {
"id" : "string",
"params" : [
{
"value" : {
"dt" : "2015-01-01T22:13:05.651Z",
"s" : "string",
"d" : 1.5,
"precision" : 1,
"format" : "SHORT_DATE",
"i" : 1,
"l" : {
"id" : "string",
"params" : [
{
"key" : "string"
}
]
}
},
"key" : "string"
}
]
}
},
"key" : "string"
}
]
},
"resolution" : {
"args" : [
"string",
"string"
],
"default_message" : "string",
"localized" : "string",
"id" : "string",
"params" : [
{
"value" : {
"dt" : "2015-01-01T22:13:05.651Z",
"s" : "string",
"d" : 1.5,
"precision" : 1,
"format" : "SHORT_DATE",
"i" : 1,
"l" : {
"id" : "string",
"params" : [
{
"value" : {
"dt" : "2015-01-01T22:13:05.651Z",
"s" : "string",
"d" : 1.5,
"precision" : 1,
"format" : "SHORT_DATE",
"i" : 1,
"l" : {
"id" : "string",
"params" : [
{
"key" : "string"
}
]
}
},
"key" : "string"
}
]
}
},
"key" : "string"
}
]
}
}
],
"errors" : [
{
"id" : "string",
"time" : "2015-01-01T22:13:05.651Z",
"message" : {
"args" : [
"string",
"string"
],
"default_message" : "string",
"localized" : "string",
"id" : "string",
"params" : [
{
"value" : {
"dt" : "2015-01-01T22:13:05.651Z",
"s" : "string",
"d" : 1.5,
"precision" : 1,
"format" : "SHORT_DATE",
"i" : 1,
"l" : {
"id" : "string",
"params" : [
{
"value" : {
"dt" : "2015-01-01T22:13:05.651Z",
"s" : "string",
"d" : 1.5,
"precision" : 1,
"format" : "SHORT_DATE",
"i" : 1,
"l" : {
"id" : "string",
"params" : [
{
"key" : "string"
}
]
}
},
"key" : "string"
}
]
}
},
"key" : "string"
}
]
},
"resolution" : {
"args" : [
"string",
"string"
],
"default_message" : "string",
"localized" : "string",
"id" : "string",
"params" : [
{
"value" : {
"dt" : "2015-01-01T22:13:05.651Z",
"s" : "string",
"d" : 1.5,
"precision" : 1,
"format" : "SHORT_DATE",
"i" : 1,
"l" : {
"id" : "string",
"params" : [
{
"value" : {
"dt" : "2015-01-01T22:13:05.651Z",
"s" : "string",
"d" : 1.5,
"precision" : 1,
"format" : "SHORT_DATE",
"i" : 1,
"l" : {
"id" : "string",
"params" : [
{
"key" : "string"
}
]
}
},
"key" : "string"
}
]
}
},
"key" : "string"
}
]
}
},
{
"id" : "string",
"time" : "2015-01-01T22:13:05.651Z",
"message" : {
"args" : [
"string",
"string"
],
"default_message" : "string",
"localized" : "string",
"id" : "string",
"params" : [
{
"value" : {
"dt" : "2015-01-01T22:13:05.651Z",
"s" : "string",
"d" : 1.5,
"precision" : 1,
"format" : "SHORT_DATE",
"i" : 1,
"l" : {
"id" : "string",
"params" : [
{
"value" : {
"dt" : "2015-01-01T22:13:05.651Z",
"s" : "string",
"d" : 1.5,
"precision" : 1,
"format" : "SHORT_DATE",
"i" : 1,
"l" : {
"id" : "string",
"params" : [
{
"key" : "string"
}
]
}
},
"key" : "string"
}
]
}
},
"key" : "string"
}
]
},
"resolution" : {
"args" : [
"string",
"string"
],
"default_message" : "string",
"localized" : "string",
"id" : "string",
"params" : [
{
"value" : {
"dt" : "2015-01-01T22:13:05.651Z",
"s" : "string",
"d" : 1.5,
"precision" : 1,
"format" : "SHORT_DATE",
"i" : 1,
"l" : {
"id" : "string",
"params" : [
{
"value" : {
"dt" : "2015-01-01T22:13:05.651Z",
"s" : "string",
"d" : 1.5,
"precision" : 1,
"format" : "SHORT_DATE",
"i" : 1,
"l" : {
"id" : "string",
"params" : [
{
"key" : "string"
}
]
}
},
"key" : "string"
}
]
}
},
"key" : "string"
}
]
}
}
],
"info" : [
{
"id" : "string",
"time" : "2015-01-01T22:13:05.651Z",
"message" : {
"args" : [
"string",
"string"
],
"default_message" : "string",
"localized" : "string",
"id" : "string",
"params" : [
{
"value" : {
"dt" : "2015-01-01T22:13:05.651Z",
"s" : "string",
"d" : 1.5,
"precision" : 1,
"format" : "SHORT_DATE",
"i" : 1,
"l" : {
"id" : "string",
"params" : [
{
"value" : {
"dt" : "2015-01-01T22:13:05.651Z",
"s" : "string",
"d" : 1.5,
"precision" : 1,
"format" : "SHORT_DATE",
"i" : 1,
"l" : {
"id" : "string",
"params" : [
{
"key" : "string"
}
]
}
},
"key" : "string"
}
]
}
},
"key" : "string"
}
]
},
"resolution" : {
"args" : [
"string",
"string"
],
"default_message" : "string",
"localized" : "string",
"id" : "string",
"params" : [
{
"value" : {
"dt" : "2015-01-01T22:13:05.651Z",
"s" : "string",
"d" : 1.5,
"precision" : 1,
"format" : "SHORT_DATE",
"i" : 1,
"l" : {
"id" : "string",
"params" : [
{
"value" : {
"dt" : "2015-01-01T22:13:05.651Z",
"s" : "string",
"d" : 1.5,
"precision" : 1,
"format" : "SHORT_DATE",
"i" : 1,
"l" : {
"id" : "string",
"params" : [
{
"key" : "string"
}
]
}
},
"key" : "string"
}
]
}
},
"key" : "string"
}
]
}
},
{
"id" : "string",
"time" : "2015-01-01T22:13:05.651Z",
"message" : {
"args" : [
"string",
"string"
],
"default_message" : "string",
"localized" : "string",
"id" : "string",
"params" : [
{
"value" : {
"dt" : "2015-01-01T22:13:05.651Z",
"s" : "string",
"d" : 1.5,
"precision" : 1,
"format" : "SHORT_DATE",
"i" : 1,
"l" : {
"id" : "string",
"params" : [
{
"value" : {
"dt" : "2015-01-01T22:13:05.651Z",
"s" : "string",
"d" : 1.5,
"precision" : 1,
"format" : "SHORT_DATE",
"i" : 1,
"l" : {
"id" : "string",
"params" : [
{
"key" : "string"
}
]
}
},
"key" : "string"
}
]
}
},
"key" : "string"
}
]
},
"resolution" : {
"args" : [
"string",
"string"
],
"default_message" : "string",
"localized" : "string",
"id" : "string",
"params" : [
{
"value" : {
"dt" : "2015-01-01T22:13:05.651Z",
"s" : "string",
"d" : 1.5,
"precision" : 1,
"format" : "SHORT_DATE",
"i" : 1,
"l" : {
"id" : "string",
"params" : [
{
"value" : {
"dt" : "2015-01-01T22:13:05.651Z",
"s" : "string",
"d" : 1.5,
"precision" : 1,
"format" : "SHORT_DATE",
"i" : 1,
"l" : {
"id" : "string",
"params" : [
{
"key" : "string"
}
]
}
},
"key" : "string"
}
]
}
},
"key" : "string"
}
]
}
}
]
},
"source_info" : {
"replicated_partners" : [
"string",
"string"
],
"deployment_type" : "VCSA_EMBEDDED",
"hostname" : "string",
"sso_domain_name" : "string",
"active_directory_domain" : "string",
"disk_info" : [
{
"size" : 1.5,
"mount_point" : "string",
"used" : 1.5,
"free" : 1.5
},
{
"size" : 1.5,
"mount_point" : "string",
"used" : 1.5,
"free" : 1.5
}
],
"data_migration_info" : {
"all" : {
"estimated_import_time" : 1,
"required_free_disk_space_on_source" : 1.5,
"estimated_export_time" : 1
},
"core" : {
"estimated_import_time" : 1,
"required_free_disk_space_on_source" : 1.5,
"estimated_export_time" : 1
},
"core_events_tasks" : {
"estimated_import_time" : 1,
"required_free_disk_space_on_source" : 1.5,
"estimated_export_time" : 1
},
"core_events_tasks_with_deferred" : {
"estimated_import_time" : 1,
"required_free_disk_space_on_source" : 1.5,
"estimated_export_time" : 1
},
"all_with_deferred" : {
"estimated_import_time" : 1,
"required_free_disk_space_on_source" : 1.5,
"estimated_export_time" : 1
}
},
"version" : "string",
"deployment_size" : "TINY",
"dns_servers" : [
"string",
"string"
]
},
"status" : "SUCCESS"
}
}
"value" : {
"result" : {
"warnings" : [
{
"id" : "string",
"time" : "2015-01-01T22:13:05.651Z",
"message" : {
"args" : [
"string",
"string"
],
"default_message" : "string",
"localized" : "string",
"id" : "string",
"params" : [
{
"value" : {
"dt" : "2015-01-01T22:13:05.651Z",
"s" : "string",
"d" : 1.5,
"precision" : 1,
"format" : "SHORT_DATE",
"i" : 1,
"l" : {
"id" : "string",
"params" : [
{
"value" : {
"dt" : "2015-01-01T22:13:05.651Z",
"s" : "string",
"d" : 1.5,
"precision" : 1,
"format" : "SHORT_DATE",
"i" : 1,
"l" : {
"id" : "string",
"params" : [
{
"key" : "string"
}
]
}
},
"key" : "string"
}
]
}
},
"key" : "string"
}
]
},
"resolution" : {
"args" : [
"string",
"string"
],
"default_message" : "string",
"localized" : "string",
"id" : "string",
"params" : [
{
"value" : {
"dt" : "2015-01-01T22:13:05.651Z",
"s" : "string",
"d" : 1.5,
"precision" : 1,
"format" : "SHORT_DATE",
"i" : 1,
"l" : {
"id" : "string",
"params" : [
{
"value" : {
"dt" : "2015-01-01T22:13:05.651Z",
"s" : "string",
"d" : 1.5,
"precision" : 1,
"format" : "SHORT_DATE",
"i" : 1,
"l" : {
"id" : "string",
"params" : [
{
"key" : "string"
}
]
}
},
"key" : "string"
}
]
}
},
"key" : "string"
}
]
}
},
{
"id" : "string",
"time" : "2015-01-01T22:13:05.651Z",
"message" : {
"args" : [
"string",
"string"
],
"default_message" : "string",
"localized" : "string",
"id" : "string",
"params" : [
{
"value" : {
"dt" : "2015-01-01T22:13:05.651Z",
"s" : "string",
"d" : 1.5,
"precision" : 1,
"format" : "SHORT_DATE",
"i" : 1,
"l" : {
"id" : "string",
"params" : [
{
"value" : {
"dt" : "2015-01-01T22:13:05.651Z",
"s" : "string",
"d" : 1.5,
"precision" : 1,
"format" : "SHORT_DATE",
"i" : 1,
"l" : {
"id" : "string",
"params" : [
{
"key" : "string"
}
]
}
},
"key" : "string"
}
]
}
},
"key" : "string"
}
]
},
"resolution" : {
"args" : [
"string",
"string"
],
"default_message" : "string",
"localized" : "string",
"id" : "string",
"params" : [
{
"value" : {
"dt" : "2015-01-01T22:13:05.651Z",
"s" : "string",
"d" : 1.5,
"precision" : 1,
"format" : "SHORT_DATE",
"i" : 1,
"l" : {
"id" : "string",
"params" : [
{
"value" : {
"dt" : "2015-01-01T22:13:05.651Z",
"s" : "string",
"d" : 1.5,
"precision" : 1,
"format" : "SHORT_DATE",
"i" : 1,
"l" : {
"id" : "string",
"params" : [
{
"key" : "string"
}
]
}
},
"key" : "string"
}
]
}
},
"key" : "string"
}
]
}
}
],
"errors" : [
{
"id" : "string",
"time" : "2015-01-01T22:13:05.651Z",
"message" : {
"args" : [
"string",
"string"
],
"default_message" : "string",
"localized" : "string",
"id" : "string",
"params" : [
{
"value" : {
"dt" : "2015-01-01T22:13:05.651Z",
"s" : "string",
"d" : 1.5,
"precision" : 1,
"format" : "SHORT_DATE",
"i" : 1,
"l" : {
"id" : "string",
"params" : [
{
"value" : {
"dt" : "2015-01-01T22:13:05.651Z",
"s" : "string",
"d" : 1.5,
"precision" : 1,
"format" : "SHORT_DATE",
"i" : 1,
"l" : {
"id" : "string",
"params" : [
{
"key" : "string"
}
]
}
},
"key" : "string"
}
]
}
},
"key" : "string"
}
]
},
"resolution" : {
"args" : [
"string",
"string"
],
"default_message" : "string",
"localized" : "string",
"id" : "string",
"params" : [
{
"value" : {
"dt" : "2015-01-01T22:13:05.651Z",
"s" : "string",
"d" : 1.5,
"precision" : 1,
"format" : "SHORT_DATE",
"i" : 1,
"l" : {
"id" : "string",
"params" : [
{
"value" : {
"dt" : "2015-01-01T22:13:05.651Z",
"s" : "string",
"d" : 1.5,
"precision" : 1,
"format" : "SHORT_DATE",
"i" : 1,
"l" : {
"id" : "string",
"params" : [
{
"key" : "string"
}
]
}
},
"key" : "string"
}
]
}
},
"key" : "string"
}
]
}
},
{
"id" : "string",
"time" : "2015-01-01T22:13:05.651Z",
"message" : {
"args" : [
"string",
"string"
],
"default_message" : "string",
"localized" : "string",
"id" : "string",
"params" : [
{
"value" : {
"dt" : "2015-01-01T22:13:05.651Z",
"s" : "string",
"d" : 1.5,
"precision" : 1,
"format" : "SHORT_DATE",
"i" : 1,
"l" : {
"id" : "string",
"params" : [
{
"value" : {
"dt" : "2015-01-01T22:13:05.651Z",
"s" : "string",
"d" : 1.5,
"precision" : 1,
"format" : "SHORT_DATE",
"i" : 1,
"l" : {
"id" : "string",
"params" : [
{
"key" : "string"
}
]
}
},
"key" : "string"
}
]
}
},
"key" : "string"
}
]
},
"resolution" : {
"args" : [
"string",
"string"
],
"default_message" : "string",
"localized" : "string",
"id" : "string",
"params" : [
{
"value" : {
"dt" : "2015-01-01T22:13:05.651Z",
"s" : "string",
"d" : 1.5,
"precision" : 1,
"format" : "SHORT_DATE",
"i" : 1,
"l" : {
"id" : "string",
"params" : [
{
"value" : {
"dt" : "2015-01-01T22:13:05.651Z",
"s" : "string",
"d" : 1.5,
"precision" : 1,
"format" : "SHORT_DATE",
"i" : 1,
"l" : {
"id" : "string",
"params" : [
{
"key" : "string"
}
]
}
},
"key" : "string"
}
]
}
},
"key" : "string"
}
]
}
}
],
"info" : [
{
"id" : "string",
"time" : "2015-01-01T22:13:05.651Z",
"message" : {
"args" : [
"string",
"string"
],
"default_message" : "string",
"localized" : "string",
"id" : "string",
"params" : [
{
"value" : {
"dt" : "2015-01-01T22:13:05.651Z",
"s" : "string",
"d" : 1.5,
"precision" : 1,
"format" : "SHORT_DATE",
"i" : 1,
"l" : {
"id" : "string",
"params" : [
{
"value" : {
"dt" : "2015-01-01T22:13:05.651Z",
"s" : "string",
"d" : 1.5,
"precision" : 1,
"format" : "SHORT_DATE",
"i" : 1,
"l" : {
"id" : "string",
"params" : [
{
"key" : "string"
}
]
}
},
"key" : "string"
}
]
}
},
"key" : "string"
}
]
},
"resolution" : {
"args" : [
"string",
"string"
],
"default_message" : "string",
"localized" : "string",
"id" : "string",
"params" : [
{
"value" : {
"dt" : "2015-01-01T22:13:05.651Z",
"s" : "string",
"d" : 1.5,
"precision" : 1,
"format" : "SHORT_DATE",
"i" : 1,
"l" : {
"id" : "string",
"params" : [
{
"value" : {
"dt" : "2015-01-01T22:13:05.651Z",
"s" : "string",
"d" : 1.5,
"precision" : 1,
"format" : "SHORT_DATE",
"i" : 1,
"l" : {
"id" : "string",
"params" : [
{
"key" : "string"
}
]
}
},
"key" : "string"
}
]
}
},
"key" : "string"
}
]
}
},
{
"id" : "string",
"time" : "2015-01-01T22:13:05.651Z",
"message" : {
"args" : [
"string",
"string"
],
"default_message" : "string",
"localized" : "string",
"id" : "string",
"params" : [
{
"value" : {
"dt" : "2015-01-01T22:13:05.651Z",
"s" : "string",
"d" : 1.5,
"precision" : 1,
"format" : "SHORT_DATE",
"i" : 1,
"l" : {
"id" : "string",
"params" : [
{
"value" : {
"dt" : "2015-01-01T22:13:05.651Z",
"s" : "string",
"d" : 1.5,
"precision" : 1,
"format" : "SHORT_DATE",
"i" : 1,
"l" : {
"id" : "string",
"params" : [
{
"key" : "string"
}
]
}
},
"key" : "string"
}
]
}
},
"key" : "string"
}
]
},
"resolution" : {
"args" : [
"string",
"string"
],
"default_message" : "string",
"localized" : "string",
"id" : "string",
"params" : [
{
"value" : {
"dt" : "2015-01-01T22:13:05.651Z",
"s" : "string",
"d" : 1.5,
"precision" : 1,
"format" : "SHORT_DATE",
"i" : 1,
"l" : {
"id" : "string",
"params" : [
{
"value" : {
"dt" : "2015-01-01T22:13:05.651Z",
"s" : "string",
"d" : 1.5,
"precision" : 1,
"format" : "SHORT_DATE",
"i" : 1,
"l" : {
"id" : "string",
"params" : [
{
"key" : "string"
}
]
}
},
"key" : "string"
}
]
}
},
"key" : "string"
}
]
}
}
]
},
"source_info" : {
"replicated_partners" : [
"string",
"string"
],
"deployment_type" : "VCSA_EMBEDDED",
"hostname" : "string",
"sso_domain_name" : "string",
"active_directory_domain" : "string",
"disk_info" : [
{
"size" : 1.5,
"mount_point" : "string",
"used" : 1.5,
"free" : 1.5
},
{
"size" : 1.5,
"mount_point" : "string",
"used" : 1.5,
"free" : 1.5
}
],
"data_migration_info" : {
"all" : {
"estimated_import_time" : 1,
"required_free_disk_space_on_source" : 1.5,
"estimated_export_time" : 1
},
"core" : {
"estimated_import_time" : 1,
"required_free_disk_space_on_source" : 1.5,
"estimated_export_time" : 1
},
"core_events_tasks" : {
"estimated_import_time" : 1,
"required_free_disk_space_on_source" : 1.5,
"estimated_export_time" : 1
},
"core_events_tasks_with_deferred" : {
"estimated_import_time" : 1,
"required_free_disk_space_on_source" : 1.5,
"estimated_export_time" : 1
},
"all_with_deferred" : {
"estimated_import_time" : 1,
"required_free_disk_space_on_source" : 1.5,
"estimated_export_time" : 1
}
},
"version" : "string",
"deployment_size" : "TINY",
"dns_servers" : [
"string",
"string"
]
},
"status" : "SUCCESS"
}
}
Response Type:
| Name | Type | Description |
|---|---|---|
| bold = required | ||
| value | check_info | Information about the success or failure of the checks that were performed. |
| value.status | string | Status of the check. This attribute was added in vSphere API 6.7. Defines the status of the checks. This enumeration was added in vSphere API 6.7. Value is one of: SUCCESS: All checks have completed successfully. This constant was added in vSphere API 6.7. FAILED: A fatal error was encountered when running the sanity checks. This constant was added in vSphere API 6.7. |
| value.result | notifications | Result of the check. This attribute was added in vSphere API 6.7. Optional. This field will be unset if result is not available at the current step of the task. |
| value.result.info | notification[] | Info notification messages reported. This attribute was added in vSphere API 6.7. Optional. Only set if an info was reported by the task. |
| value.result.info[].id | string | The notification id. This attribute was added in vSphere API 6.7. |
| value.result.info[].time | date_time | The time the notification was raised/found. This attribute was added in vSphere API 6.7. Optional. Only set if the time information is available. |
| value.result.info[].message | localizable_message | The notification message. This attribute was added in vSphere API 6.7. |
| value.result.info[].message.id | string | Unique identifier of the localizable string or message template. This identifier is typically used to retrieve a locale-specific string or message template from a message catalog. |
| value.result.info[].message.default_message | string | The value of this localizable string or message template in the en_US (English) locale. If vapi.std.localizable_message.id refers to a message template, the default message will contain the substituted arguments. This value can be used by clients that do not need to display strings and messages in the native language of the user. It could also be used as a fallback if a client is unable to access the appropriate message catalog. |
| value.result.info[].message.args | string[] | Positional arguments to be substituted into the message template. This list will be empty if the message uses named arguments or has no arguments. |
| value.result.warnings | notification[] | Warning notification messages reported. This attribute was added in vSphere API 6.7. Optional. Only set if an warning was reported by the task. |
| value.result.errors | notification[] | Error notification messages reported. This attribute was added in vSphere API 6.7. Optional. Only set if an error was reported by the task. |
| value.source_info | source_info | Information collected from the source machine. This attribute was added in vSphere API 7.0.0.0. Optional. This field is used only for upgrade and migrate. |
| value.source_info.hostname | string | The IP address or DNS resolvable name of the source vCenter Server. This attribute was added in vSphere API 7.0.0.0. |
| value.source_info.version | string | Source vCenter Server version. This attribute was added in vSphere API 7.0.0.0. |
| value.source_info.deployment_type | string | Deployment type of the source vCenter Server. This attribute was added in vSphere API 7.0.0.0. Defines the vCenter appliance types. This enumeration was added in vSphere API 6.7. Value is one of: VCSA_EMBEDDED: vCenter Server Appliance with an embedded Platform Services Controller. This constant was added in vSphere API 6.7. VCSA_EXTERNAL: vCenter Server Appliance with an external Platform Services Controller. This constant was added in vSphere API 6.7. PSC_EXTERNAL: An external Platform Services Controller. This constant was added in vSphere API 6.7. |
| value.source_info.deployment_size | string | Deployment size of the source vCenter Server. This attribute was added in vSphere API 7.0.0.0. Defines the vCenter Server Appliance sizes. This enumeration was added in vSphere API 7.0.0.0. Value is one of: TINY: Appliance size of 'tiny'. This constant was added in vSphere API 7.0.0.0. SMALL: Appliance size of 'small'. This constant was added in vSphere API 7.0.0.0. MEDIUM: Appliance size of 'medium'. This constant was added in vSphere API 7.0.0.0. LARGE: Appliance size of 'large'. This constant was added in vSphere API 7.0.0.0. XLARGE: Appliance size of 'extra large'. This constant was added in vSphere API 7.0.0.0. |
| value.source_info.sso_domain_name | string | The SSO domain name of the source vCenter Server. This attribute was added in vSphere API 7.0.0.0. |
| value.source_info.active_directory_domain | string | The domain name of the Active Directory server to which the source vCenter Server is joined. This attribute was added in vSphere API 7.0.0.0. |
| value.source_info.dns_servers | string[] | IP addresses of the DNS servers of the Active Directory server. This attribute was added in vSphere API 7.0.0.0. |
| value.source_info.data_migration_info | data_migration_info | Contains all the available migrate options, estimated export and import time and the space required to migrate the data. This attribute was added in vSphere API 7.0.0.0. Optional. This field will be available if estimate data is available for the appliance. |
| value.source_info.data_migration_info.core | data_migration_estimate | Migrate only core data and configuration from vCenter Server. Events, tasks, and stats will not be migrated. This attribute was added in vSphere API 7.0.0.0. |
| value.source_info.data_migration_info.core.estimated_export_time | long | The time estimated to export data from the source vCenter Server. This attribute was added in vSphere API 7.0.0.0. |
| value.source_info.data_migration_info.core.estimated_import_time | long | The time estimated to import data to the upgraded vCenter Server. This attribute was added in vSphere API 7.0.0.0. |
| value.source_info.data_migration_info.core.required_free_disk_space_on_source | double | The extra free space required on source vCenter Server. This attribute was added in vSphere API 7.0.0.0. |
| value.source_info.data_migration_info.core_events_tasks | data_migration_estimate | Migrate core, events, and tasks from vCenter Server. Stats will not be migrated. This attribute was added in vSphere API 7.0.0.0. |
| value.source_info.data_migration_info.core_events_tasks.estimated_export_time | long | The time estimated to export data from the source vCenter Server. This attribute was added in vSphere API 7.0.0.0. |
| value.source_info.data_migration_info.core_events_tasks.estimated_import_time | long | The time estimated to import data to the upgraded vCenter Server. This attribute was added in vSphere API 7.0.0.0. |
| value.source_info.data_migration_info.core_events_tasks.required_free_disk_space_on_source | double | The extra free space required on source vCenter Server. This attribute was added in vSphere API 7.0.0.0. |
| value.source_info.data_migration_info.all | data_migration_estimate | Migrate all data from vCenter Server. This attribute was added in vSphere API 7.0.0.0. |
| value.source_info.data_migration_info.all.estimated_export_time | long | The time estimated to export data from the source vCenter Server. This attribute was added in vSphere API 7.0.0.0. |
| value.source_info.data_migration_info.all.estimated_import_time | long | The time estimated to import data to the upgraded vCenter Server. This attribute was added in vSphere API 7.0.0.0. |
| value.source_info.data_migration_info.all.required_free_disk_space_on_source | double | The extra free space required on source vCenter Server. This attribute was added in vSphere API 7.0.0.0. |
| value.source_info.data_migration_info.core_events_tasks_with_deferred | data_migration_estimate | Migrate core, events, and tasks from vCenter Server. Events and tasks will be migrated after the upgrade. Stats will not be migrated. This attribute was added in vSphere API 7.0.0.0. Optional. This field will be available only if the source database is using an external database. |
| value.source_info.data_migration_info.core_events_tasks_with_deferred.estimated_export_time | long | The time estimated to export data from the source vCenter Server. This attribute was added in vSphere API 7.0.0.0. |
| value.source_info.data_migration_info.core_events_tasks_with_deferred.estimated_import_time | long | The time estimated to import data to the upgraded vCenter Server. This attribute was added in vSphere API 7.0.0.0. |
| value.source_info.data_migration_info.core_events_tasks_with_deferred.required_free_disk_space_on_source | double | The extra free space required on source vCenter Server. This attribute was added in vSphere API 7.0.0.0. |
| value.source_info.data_migration_info.all_with_deferred | data_migration_estimate | Migrate all data from vCenter Server. Events, tasks, and stats will be migrated after the upgrade. This attribute was added in vSphere API 7.0.0.0. Optional. This field will be available only if the source database is using an external database. |
| value.source_info.data_migration_info.all_with_deferred.estimated_export_time | long | The time estimated to export data from the source vCenter Server. This attribute was added in vSphere API 7.0.0.0. |
| value.source_info.data_migration_info.all_with_deferred.estimated_import_time | long | The time estimated to import data to the upgraded vCenter Server. This attribute was added in vSphere API 7.0.0.0. |
| value.source_info.data_migration_info.all_with_deferred.required_free_disk_space_on_source | double | The extra free space required on source vCenter Server. This attribute was added in vSphere API 7.0.0.0. |
| value.source_info.disk_info | disk_info[] | Contains information about the list of available disks. Warning: This attribute is part of a new feature in development. It may be changed at any time and may not have all supported functionality implemented. Optional. If unset disk info was not fetched for the vCenter Server filesystem. |
| value.source_info.replicated_partners | string[] | Contains information about the list of replicated partner nodes. Warning: This attribute is part of a new feature in development. It may be changed at any time and may not have all supported functionality implemented. Optional. If unset replicated partners information is not available for the current vCenter Server. |
Errors:
| HTTP Status Code | Type | Description |
|---|---|---|
| 401 | unauthenticated | if the caller is not authenticated. |
| 400 | invalid_argument | if passed arguments are invalid. |
| 400 | not_allowed_in_current_state | if the appliance is not in INITIALIZED state. |