Create Trusted Certificates
Adds a certificate to content library trust store. This API has to be invoked separately for each certificate block - (BEGIN_CERTIFICATE … END_CERTIFICATE)
if you do not have all of the privileges described as follows: - Operation execution requires ContentLibrary.AddCertToTrustStore.
Request
URLURL
https://{api_host}/api/content/trusted-certificates
Header Parameters
Header Parameters
string
vmware-api-session-id
Required
Required session ID, acquired from Create Session API under CIS product
vmware-api-session-id example
"b00db39f948d13ea1e59b4d6fce56389"
Request Body
Request Body
TrustedCertificatesCreateSpec of mimetype application/json
Required
Specification for the certificate to be added to content library trust store.
{
"cert_text": "string"
}
string
cert_text
Required
A certText is the certificate in Base64 encoded PEM format. The input must be a single line string with escape sequence for new-lines.
Authentication
This operation uses the following authentication methods.
Response
Response
Response BodyResponse Body
201 Created returns
string of type application/json
ID of the certificates added. The certificate ID will be unique for each certificate. If the certificate already exists, existing ID is returned. The result will be an identifier for the resource type: com.vmware.content.TrustedCertificate.
Errors
500
com.vmware.vapi.std.errors.error : if the system reports an error while responding to the request.
default
‘Default’ means this response is used for all HTTP codes that are not covered individually for this operation.
Code Samples
PowerCLI Client SDK Example
$TrustedCertificatesCreateSpec = Initialize-TrustedCertificatesCreateSpec -CertText "MyCertText"
Invoke-CreateContentTrustedCertificates -TrustedCertificatesCreateSpec $TrustedCertificatesCreateSpec
cURL Command
curl -X POST -H "vmware-api-session-id: b00db39f948d13ea1e59b4d6fce56389" -H "Content-Type: application/json" -d '{"cert_text":"string"}' https://{api_host}/api/content/trusted-certificates
Vendor Extensions
This operation contains the following vendor extensions defined in the spec:
x-vmw-doc-operation: create
Availability
Added in 7.0.3.0
