REST API - get

esx settings clusters software reports last check result: get

Returns the most recent available result of checks run on the cluster before the application of the desired software document to all hosts within the cluster.

Request:

HTTP request

GET https://{server}/api/esx/settings/clusters/{cluster}/software/reports/last-check-result

Path Parameters

Name Type Description
Required
cluster string The cluster identifier.

Response:

HTTP Status Code: 200

Response Body Structure:

{
    "start_time""2015-01-01T22:13:05.651Z",
    "end_time""2015-01-01T22:13:05.651Z",
    "commit""obj-103",
    "entity_results"[
        {
            "cluster""obj-103",
            "host""obj-103",
            "type""CLUSTER",
            "status""OK",
            "check_statuses"[
                {
                    "check"{
                        "name"{
                            "args"[
                                "string",
                                "string"
                            ],
                            "default_message""string",
                            "localized""string",
                            "id""string",
                            "params"{
                                "<string>"{
                                    "dt""2015-01-01T22:13:05.651Z",
                                    "s""string",
                                    "d"1.5,
                                    "precision"1,
                                    "format""SHORT_DATE",
                                    "i"1,
                                    "l"{
                                        "id""string",
                                        "params"{
                                            "<string>"{
                                                "dt""2015-01-01T22:13:05.651Z",
                                                "s""string",
                                                "d"1.5,
                                                "precision"1,
                                                "format""SHORT_DATE",
                                                "i"1,
                                                "l"{
                                                    "id""string",
                                                    "params"{}
                                                }
                                            }
                                        }
                                    }
                                }
                            }
                        },
                        "description"{
                            "args"[
                                "string",
                                "string"
                            ],
                            "default_message""string",
                            "localized""string",
                            "id""string",
                            "params"{
                                "<string>"{
                                    "dt""2015-01-01T22:13:05.651Z",
                                    "s""string",
                                    "d"1.5,
                                    "precision"1,
                                    "format""SHORT_DATE",
                                    "i"1,
                                    "l"{
                                        "id""string",
                                        "params"{
                                            "<string>"{
                                                "dt""2015-01-01T22:13:05.651Z",
                                                "s""string",
                                                "d"1.5,
                                                "precision"1,
                                                "format""SHORT_DATE",
                                                "i"1,
                                                "l"{
                                                    "id""string",
                                                    "params"{}
                                                }
                                            }
                                        }
                                    }
                                }
                            }
                        },
                        "check""string"
                    },
                    "issues"[
                        {
                            "args"[
                                "string",
                                "string"
                            ],
                            "default_message""string",
                            "localized""string",
                            "id""string",
                            "params"{
                                "<string>"{
                                    "dt""2015-01-01T22:13:05.651Z",
                                    "s""string",
                                    "d"1.5,
                                    "precision"1,
                                    "format""SHORT_DATE",
                                    "i"1,
                                    "l"{
                                        "id""string",
                                        "params"{
                                            "<string>"{
                                                "dt""2015-01-01T22:13:05.651Z",
                                                "s""string",
                                                "d"1.5,
                                                "precision"1,
                                                "format""SHORT_DATE",
                                                "i"1,
                                                "l"{
                                                    "id""string",
                                                    "params"{}
                                                }
                                            }
                                        }
                                    }
                                }
                            }
                        },
                        {
                            "args"[
                                "string",
                                "string"
                            ],
                            "default_message""string",
                            "localized""string",
                            "id""string",
                            "params"{
                                "<string>"{
                                    "dt""2015-01-01T22:13:05.651Z",
                                    "s""string",
                                    "d"1.5,
                                    "precision"1,
                                    "format""SHORT_DATE",
                                    "i"1,
                                    "l"{
                                        "id""string",
                                        "params"{
                                            "<string>"{
                                                "dt""2015-01-01T22:13:05.651Z",
                                                "s""string",
                                                "d"1.5,
                                                "precision"1,
                                                "format""SHORT_DATE",
                                                "i"1,
                                                "l"{
                                                    "id""string",
                                                    "params"{}
                                                }
                                            }
                                        }
                                    }
                                }
                            }
                        }
                    ],
                    "status""OK"
                },
                {
                    "check"{
                        "name"{
                            "args"[
                                "string",
                                "string"
                            ],
                            "default_message""string",
                            "localized""string",
                            "id""string",
                            "params"{
                                "<string>"{
                                    "dt""2015-01-01T22:13:05.651Z",
                                    "s""string",
                                    "d"1.5,
                                    "precision"1,
                                    "format""SHORT_DATE",
                                    "i"1,
                                    "l"{
                                        "id""string",
                                        "params"{
                                            "<string>"{
                                                "dt""2015-01-01T22:13:05.651Z",
                                                "s""string",
                                                "d"1.5,
                                                "precision"1,
                                                "format""SHORT_DATE",
                                                "i"1,
                                                "l"{
                                                    "id""string",
                                                    "params"{}
                                                }
                                            }
                                        }
                                    }
                                }
                            }
                        },
                        "description"{
                            "args"[
                                "string",
                                "string"
                            ],
                            "default_message""string",
                            "localized""string",
                            "id""string",
                            "params"{
                                "<string>"{
                                    "dt""2015-01-01T22:13:05.651Z",
                                    "s""string",
                                    "d"1.5,
                                    "precision"1,
                                    "format""SHORT_DATE",
                                    "i"1,
                                    "l"{
                                        "id""string",
                                        "params"{
                                            "<string>"{
                                                "dt""2015-01-01T22:13:05.651Z",
                                                "s""string",
                                                "d"1.5,
                                                "precision"1,
                                                "format""SHORT_DATE",
                                                "i"1,
                                                "l"{
                                                    "id""string",
                                                    "params"{}
                                                }
                                            }
                                        }
                                    }
                                }
                            }
                        },
                        "check""string"
                    },
                    "issues"[
                        {
                            "args"[
                                "string",
                                "string"
                            ],
                            "default_message""string",
                            "localized""string",
                            "id""string",
                            "params"{
                                "<string>"{
                                    "dt""2015-01-01T22:13:05.651Z",
                                    "s""string",
                                    "d"1.5,
                                    "precision"1,
                                    "format""SHORT_DATE",
                                    "i"1,
                                    "l"{
                                        "id""string",
                                        "params"{
                                            "<string>"{
                                                "dt""2015-01-01T22:13:05.651Z",
                                                "s""string",
                                                "d"1.5,
                                                "precision"1,
                                                "format""SHORT_DATE",
                                                "i"1,
                                                "l"{
                                                    "id""string",
                                                    "params"{}
                                                }
                                            }
                                        }
                                    }
                                }
                            }
                        },
                        {
                            "args"[
                                "string",
                                "string"
                            ],
                            "default_message""string",
                            "localized""string",
                            "id""string",
                            "params"{
                                "<string>"{
                                    "dt""2015-01-01T22:13:05.651Z",
                                    "s""string",
                                    "d"1.5,
                                    "precision"1,
                                    "format""SHORT_DATE",
                                    "i"1,
                                    "l"{
                                        "id""string",
                                        "params"{
                                            "<string>"{
                                                "dt""2015-01-01T22:13:05.651Z",
                                                "s""string",
                                                "d"1.5,
                                                "precision"1,
                                                "format""SHORT_DATE",
                                                "i"1,
                                                "l"{
                                                    "id""string",
                                                    "params"{}
                                                }
                                            }
                                        }
                                    }
                                }
                            }
                        }
                    ],
                    "status""OK"
                }
            ]
        },
        {
            "cluster""obj-103",
            "host""obj-103",
            "type""CLUSTER",
            "status""OK",
            "check_statuses"[
                {
                    "check"{
                        "name"{
                            "args"[
                                "string",
                                "string"
                            ],
                            "default_message""string",
                            "localized""string",
                            "id""string",
                            "params"{
                                "<string>"{
                                    "dt""2015-01-01T22:13:05.651Z",
                                    "s""string",
                                    "d"1.5,
                                    "precision"1,
                                    "format""SHORT_DATE",
                                    "i"1,
                                    "l"{
                                        "id""string",
                                        "params"{
                                            "<string>"{
                                                "dt""2015-01-01T22:13:05.651Z",
                                                "s""string",
                                                "d"1.5,
                                                "precision"1,
                                                "format""SHORT_DATE",
                                                "i"1,
                                                "l"{
                                                    "id""string",
                                                    "params"{}
                                                }
                                            }
                                        }
                                    }
                                }
                            }
                        },
                        "description"{
                            "args"[
                                "string",
                                "string"
                            ],
                            "default_message""string",
                            "localized""string",
                            "id""string",
                            "params"{
                                "<string>"{
                                    "dt""2015-01-01T22:13:05.651Z",
                                    "s""string",
                                    "d"1.5,
                                    "precision"1,
                                    "format""SHORT_DATE",
                                    "i"1,
                                    "l"{
                                        "id""string",
                                        "params"{
                                            "<string>"{
                                                "dt""2015-01-01T22:13:05.651Z",
                                                "s""string",
                                                "d"1.5,
                                                "precision"1,
                                                "format""SHORT_DATE",
                                                "i"1,
                                                "l"{
                                                    "id""string",
                                                    "params"{}
                                                }
                                            }
                                        }
                                    }
                                }
                            }
                        },
                        "check""string"
                    },
                    "issues"[
                        {
                            "args"[
                                "string",
                                "string"
                            ],
                            "default_message""string",
                            "localized""string",
                            "id""string",
                            "params"{
                                "<string>"{
                                    "dt""2015-01-01T22:13:05.651Z",
                                    "s""string",
                                    "d"1.5,
                                    "precision"1,
                                    "format""SHORT_DATE",
                                    "i"1,
                                    "l"{
                                        "id""string",
                                        "params"{
                                            "<string>"{
                                                "dt""2015-01-01T22:13:05.651Z",
                                                "s""string",
                                                "d"1.5,
                                                "precision"1,
                                                "format""SHORT_DATE",
                                                "i"1,
                                                "l"{
                                                    "id""string",
                                                    "params"{}
                                                }
                                            }
                                        }
                                    }
                                }
                            }
                        },
                        {
                            "args"[
                                "string",
                                "string"
                            ],
                            "default_message""string",
                            "localized""string",
                            "id""string",
                            "params"{
                                "<string>"{
                                    "dt""2015-01-01T22:13:05.651Z",
                                    "s""string",
                                    "d"1.5,
                                    "precision"1,
                                    "format""SHORT_DATE",
                                    "i"1,
                                    "l"{
                                        "id""string",
                                        "params"{
                                            "<string>"{
                                                "dt""2015-01-01T22:13:05.651Z",
                                                "s""string",
                                                "d"1.5,
                                                "precision"1,
                                                "format""SHORT_DATE",
                                                "i"1,
                                                "l"{
                                                    "id""string",
                                                    "params"{}
                                                }
                                            }
                                        }
                                    }
                                }
                            }
                        }
                    ],
                    "status""OK"
                },
                {
                    "check"{
                        "name"{
                            "args"[
                                "string",
                                "string"
                            ],
                            "default_message""string",
                            "localized""string",
                            "id""string",
                            "params"{
                                "<string>"{
                                    "dt""2015-01-01T22:13:05.651Z",
                                    "s""string",
                                    "d"1.5,
                                    "precision"1,
                                    "format""SHORT_DATE",
                                    "i"1,
                                    "l"{
                                        "id""string",
                                        "params"{
                                            "<string>"{
                                                "dt""2015-01-01T22:13:05.651Z",
                                                "s""string",
                                                "d"1.5,
                                                "precision"1,
                                                "format""SHORT_DATE",
                                                "i"1,
                                                "l"{
                                                    "id""string",
                                                    "params"{}
                                                }
                                            }
                                        }
                                    }
                                }
                            }
                        },
                        "description"{
                            "args"[
                                "string",
                                "string"
                            ],
                            "default_message""string",
                            "localized""string",
                            "id""string",
                            "params"{
                                "<string>"{
                                    "dt""2015-01-01T22:13:05.651Z",
                                    "s""string",
                                    "d"1.5,
                                    "precision"1,
                                    "format""SHORT_DATE",
                                    "i"1,
                                    "l"{
                                        "id""string",
                                        "params"{
                                            "<string>"{
                                                "dt""2015-01-01T22:13:05.651Z",
                                                "s""string",
                                                "d"1.5,
                                                "precision"1,
                                                "format""SHORT_DATE",
                                                "i"1,
                                                "l"{
                                                    "id""string",
                                                    "params"{}
                                                }
                                            }
                                        }
                                    }
                                }
                            }
                        },
                        "check""string"
                    },
                    "issues"[
                        {
                            "args"[
                                "string",
                                "string"
                            ],
                            "default_message""string",
                            "localized""string",
                            "id""string",
                            "params"{
                                "<string>"{
                                    "dt""2015-01-01T22:13:05.651Z",
                                    "s""string",
                                    "d"1.5,
                                    "precision"1,
                                    "format""SHORT_DATE",
                                    "i"1,
                                    "l"{
                                        "id""string",
                                        "params"{
                                            "<string>"{
                                                "dt""2015-01-01T22:13:05.651Z",
                                                "s""string",
                                                "d"1.5,
                                                "precision"1,
                                                "format""SHORT_DATE",
                                                "i"1,
                                                "l"{
                                                    "id""string",
                                                    "params"{}
                                                }
                                            }
                                        }
                                    }
                                }
                            }
                        },
                        {
                            "args"[
                                "string",
                                "string"
                            ],
                            "default_message""string",
                            "localized""string",
                            "id""string",
                            "params"{
                                "<string>"{
                                    "dt""2015-01-01T22:13:05.651Z",
                                    "s""string",
                                    "d"1.5,
                                    "precision"1,
                                    "format""SHORT_DATE",
                                    "i"1,
                                    "l"{
                                        "id""string",
                                        "params"{
                                            "<string>"{
                                                "dt""2015-01-01T22:13:05.651Z",
                                                "s""string",
                                                "d"1.5,
                                                "precision"1,
                                                "format""SHORT_DATE",
                                                "i"1,
                                                "l"{
                                                    "id""string",
                                                    "params"{}
                                                }
                                            }
                                        }
                                    }
                                }
                            }
                        }
                    ],
                    "status""OK"
                }
            ]
        }
    ],
    "status""OK",
    "host_info"{
        "obj-103"{
            "name""string"
        }
    }
}

Headers:

None

Type:

Name Type Description
bold = required
- check_result Most recent result available of the checks run on the cluster.
-.status string Aggregated status from all checks performed.

Defines the status result for a particular check. Value is one of:
OK: The check indicates a success.
WARNING: The check indicates a warning.
TIMEOUT: The check did not return in a timely manner.
ERROR: The check indicates an error.

-.start_time date_time Time when the operation started.

-.end_time date_time Time when the operation completed.

-.commit string The identifier of the commit on which checks have been run.

When clients pass a value of this structure as a parameter, the field must be an identifier for the resource type: com.vmware.esx.settings.commit. When operations return a value of this structure as a result, the field will be an identifier for the resource type: com.vmware.esx.settings.commit.

-.host_info object Information about the hosts in this cluster for which checks have been requested to be run.

When clients pass a value of this structure as a parameter, the key in the field key/value pairs must be an identifier for the resource type: HostSystem. When operations return a value of this structure as a result, the key in the field key/value pairs will be an identifier for the resource type: HostSystem.Object with element values of type host_info.

-.host_info.* host_info
-.host_info.*.name string Name of the host.

-.entity_results entity_check_result[] List of entity_check_result for all entities for which checks have been run.

-.entity_results[].type string The entity type for which these checks are being run.

Contains the entitites on which checks can be performed. Value is one of:
CLUSTER: Entity type Cluster
HOST: Entity type Host

-.entity_results[].cluster string If the entity type is CLUSTER then the cluster identifier for which the checks have been run.

Optional. It is only relevant when type has value CLUSTER. This field is optional and it is only relevant when the value of type is CLUSTER.When clients pass a value of this structure as a parameter, the field must be an identifier for the resource type: ClusterComputeResource. When operations return a value of this structure as a result, the field will be an identifier for the resource type: ClusterComputeResource.

-.entity_results[].host string If the entity type is HOST then the host identifier for which the checks have been run.

Optional. It is only relevant when type has value HOST. This field is optional and it is only relevant when the value of type is HOST.When clients pass a value of this structure as a parameter, the field must be an identifier for the resource type: HostSystem. When operations return a value of this structure as a result, the field will be an identifier for the resource type: HostSystem.

-.entity_results[].status string Aggregated status from all checks performed on this entity.

Defines the status result for a particular check. Value is one of:
OK: The check indicates a success.
WARNING: The check indicates a warning.
TIMEOUT: The check did not return in a timely manner.
ERROR: The check indicates an error.

-.entity_results[].check_statuses check_status[] List of check_status for all checks performed.

-.entity_results[].check_statuses[].check check_info Information about this check.

-.entity_results[].check_statuses[].check.check string The check identifier.

-.entity_results[].check_statuses[].check.name localizable_message The check name.

-.entity_results[].check_statuses[].check.name.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.

-.entity_results[].check_statuses[].check.name.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.

-.entity_results[].check_statuses[].check.name.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.

Errors:

HTTP Status Code Type Description
500 error If there is an unknown internal error. The accompanying error message will give more details about the failure.
404 not_found If there is no cluster associated with cluster in the system or if there is no result associated with the cluster cluster
503 service_unavailable If the service is not available.
401 unauthenticated if the caller is not authenticated.