Crypto Manager Kmip Query Crypto Key Status

Crypto Manager Kmip Query Crypto Key Status

Check CryptoKey status, such as if VC can access the key, if the key is used by some VMs or as host key.

Required privileges: Cryptographer.ManageKeys

Request
URI
POST
https://{vcenter-host}/sdk/vim25/{release}/CryptoManagerKmip/{moId}/QueryCryptoKeyStatus
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 CryptoManagerKmip/{moId}.

string
release
Required

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


Request Body
QueryCryptoKeyStatusRequestType of type(s) application/json
Required
{
    "keyIds": [
        {
            "_typeName": "string",
            "keyId": "string",
            "providerId": {
                "_typeName": "string",
                "id": "string"
            }
        }
    ],
    "checkKeyBitMap": 0
}
keyIds
Optional

[in] The Crypto Key Ids to query.

integer As int32 As int32
checkKeyBitMap
Required

[in] The key state to check. Supported value: 0x01. check if key data is available to VC. 0x02. check the VMs which use that key. 0x04. check the hosts using this key as host key. 0x08. Check 3rd party program which use that key. Other bits - reserved and will be igonred.

Authentication
This operation uses the following authentication methods.
Responses
200

The structure combined with key status. If bit in parameter is not set when invoke, the returned data in related CryptoKeyStatus will be unknown.

Returns Array of CryptoManagerKmipCryptoKeyStatus of type(s) application/json
[
    {
        "_typeName": "string",
        "keyId": {
            "_typeName": "string",
            "keyId": "string",
            "providerId": {
                "_typeName": "string",
                "id": "string"
            }
        },
        "keyAvailable": false,
        "reason": "string",
        "encryptedVMs": [
            {
                "_typeName": "string",
                "type": "string",
                "value": "string"
            }
        ],
        "affectedHosts": [
            {
                "_typeName": "string",
                "type": "string",
                "value": "string"
            }
        ],
        "referencedByTags": [
            "string"
        ]
    }
]

Crypto Manager Kmip Operations
POST
Crypto Manager Kmip Add Key
POST
Crypto Manager Kmip Add Keys
POST
Crypto Manager Kmip Generate Client Csr
POST
Crypto Manager Kmip Generate Key
POST
Crypto Manager Kmip Generate Self Signed Client Cert
POST
Crypto Manager Kmip Get Default Kms Cluster
GET
Crypto Manager Kmip Get Enabled
GET
Crypto Manager Kmip Get Kmip Servers
POST
Crypto Manager Kmip Is Kms Cluster Active
POST
Crypto Manager Kmip List Keys
POST
Crypto Manager Kmip List Kmip Servers
POST
Crypto Manager Kmip List Kms Clusters
POST
Crypto Manager Kmip Mark Default
POST
Crypto Manager Kmip Query Crypto Key Status
POST
Crypto Manager Kmip Register Kmip Server
POST
Crypto Manager Kmip Register Kms Cluster
POST
Crypto Manager Kmip Remove Key
POST
Crypto Manager Kmip Remove Keys
POST
Crypto Manager Kmip Remove Kmip Server
POST
Crypto Manager Kmip Retrieve Client Cert
POST
Crypto Manager Kmip Retrieve Client Csr
POST
Crypto Manager Kmip Retrieve Kmip Server Cert
POST
Crypto Manager Kmip Retrieve Kmip Servers Status Task
POST
Crypto Manager Kmip Retrieve Self Signed Client Cert
POST
Crypto Manager Kmip Set Default Kms Cluster
POST
Crypto Manager Kmip Set Key Custom Attributes
POST
Crypto Manager Kmip Unregister Kms Cluster
POST
Crypto Manager Kmip Update Kmip Server
POST
Crypto Manager Kmip Update Kms Signed Csr Client Cert
POST
Crypto Manager Kmip Update Self Signed Client Cert
POST
Crypto Manager Kmip Upload Client Cert
POST
Crypto Manager Kmip Upload Kmip Server Cert