v8

latestSwagger 2.02026-07-13274484.3 KB

Imports a certificate into a specified key vault.

Imports an existing valid certificate, containing a private key, into Azure Key Vault. This operation requires the certificates/import permission. The certificate to be imported can be in either PFX or PEM format. If the certificate is in PEM format the PEM file must contain the key as well as x509 certificates. Key Vault will only accept a key in PKCS#8 format.

post/certificates/{certificate-name}/import

Path parameters

certificate-namestring required

The name of the certificate. The value you provide may be copied globally for the purpose of running the service. The value provided should not include personally identifiable or sensitive information.

Query parameters

api-versionstring required

The API version to use for this operation.

Request body

valuestring required

Base64 encoded representation of the certificate object to import. This certificate needs to contain the private key.

pwdstring

If the private key in base64EncodedCertificate is encrypted, the password used for encryption.

tagsobject

Application specific metadata in the form of key-value pairs.

preserveCertOrderboolean

Specifies whether the certificate chain preserves its original order. The default value is false, which sets the leaf certificate at index 0.

Response

The request has succeeded.

idstring

The certificate id.

kidstring

The key id.

sidstring

The secret id.

x5tstring base64url

Thumbprint of the certificate.

cerstring byte

CER contents of x509 certificate.

contentTypestring

The content type of the secret. eg. 'application/x-pem-file' or 'application/x-pkcs12'.

tagsobject

Application specific metadata in the form of key-value pairs.

preserveCertOrderboolean

Specifies whether the certificate chain preserves its original order. The default value is false, which sets the leaf certificate at index 0.