REST API - create

vcenter certificate management vcenter trusted root chains: create

Creates a new trusted root certificate chain from the CreateSpec. This operation was added in vSphere API 6.7.2.

Request:

HTTP request

POST https://{server}/rest/vcenter/certificate-management/vcenter/trusted-root-chains

Request Body Structure:

{
    "spec" : {
        "chain" : "string",
        "cert_chain" : {
            "cert_chain" : [
                "string",
                "string"
            ]
        }
    }
}

Request Body Parameters:

Name	Type	Description
bold = required
spec	create_spec	The information needed to create a trusted root certificate chain.
spec.cert_chain	x509_cert_chain	Certificate chain in base64 encoding. This attribute was added in vSphere API 6.7.2.
spec.cert_chain.cert_chain	string[]	Certificate chain in base64 format. This attribute was added in vSphere API 6.7.2.
spec.chain	string	Unique identifier for this trusted root. Client can specify at creation as long as it is unique, otherwise one will be generated. An example of a client providing the identifier would be if this trusted root is associated with a VC trust. In this case the identifier would be the domain id. This attribute was added in vSphere API 6.7.2. Optional. A unique id will be generated if not given.

Response:

HTTP Status Code: 200

Representation:

{
"value" : "string"
}

Response Type:

Name	Type	Description
bold = required
value	string	The unique identifier for the new trusted root chain.

Errors:

HTTP Status Code	Type	Description
403	unauthorized	if authorization is not given to caller.
400	already_exists	if a trusted root certificate chain exists with id in given spec.