Host System Query Tpm Attestation Report

Basic information about TPM attestation state of the host.

Required privileges: System.Read

Request

URI

POST

https://{vcenter-host}/sdk/vim25/{release}/HostSystem/{moId}/QueryTpmAttestationReport

COPY

Path Parameters

string

moId

Required

The unique identifier for the managed object to which the method attaches; the serialized managed object reference for a request has the form moType/moId, in this case HostSystem/{moId}.

string

release

Required

The vSphere release schema. The current specification covers vSphere 8.0.3.0 APIs.

Authentication

This operation uses the following authentication methods.

Session

Responses

200

Returns HostTpmAttestationReport of type(s) application/json

This response body class contains all of the following: DataObject

{
    "_typeName": "string",
    "tpmPcrValues": [
        {
            "_typeName": "string",
            "digestMethod": "string",
            "digestValue": [
                0
            ],
            "objectName": "string",
            "pcrNumber": 0
        }
    ],
    "tpmEvents": [
        {
            "_typeName": "string",
            "pcrIndex": 0,
            "eventDetails": {
                "_typeName": "string",
                "dataHash": [
                    0
                ],
                "dataHashMethod": "string"
            }
        }
    ],
    "tpmLogReliable": false
}

array of HostTpmDigestInfo

tpmPcrValues

Required

The array of PCR digest values stored in the TPM device since the last host boot time.

array of HostTpmEventLogEntry

tpmEvents

Required

Log of TPM software stack attestation events.

boolean

tpmLogReliable

Required

This flag indicates whether the provided TPM events are a complete and reliable information about host boot status.

TPM event log may be incomplete (and therfore unreliable) if certain modules have inappropriate origin or if the package information is incomplete. Only first 1000 events are recorded by the kernel. Further events will not be recorded in the log and will cause the log to be marked as unreliable.

On This Page

Description

Request

Path Parameters

Authentication

Response

200 Response Body

Virtual Infrastructure Operations

POST

Host System Acquire Cim Services Ticket

POST

Host System Configure Crypto Key