1. Packages
  2. Proxmox Virtual Environment (Proxmox VE)
  3. API Docs
  4. Certifi
Proxmox Virtual Environment (Proxmox VE) v7.0.0 published on Tuesday, Apr 1, 2025 by Daniel Muehlbachler-Pietrzykowski

proxmoxve.Certifi

Explore with Pulumi AI

Proxmox Virtual Environment (Proxmox VE) v7.0.0 published on Tuesday, Apr 1, 2025 by Daniel Muehlbachler-Pietrzykowski

Manages the custom SSL/TLS certificate for a specific node.

Example Usage

Coming soon!
Coming soon!
Coming soon!
Coming soon!
Coming soon!
resources:
  example:
    type: proxmoxve:Certifi
    properties:
      certificate: ${proxmoxVirtualEnvironmentCertificateSelfSignedCert.certPem}
      nodeName: first-node
      privateKey: ${proxmoxVirtualEnvironmentCertificatePrivateKey.privateKeyPem}
  proxmoxVirtualEnvironmentCertificatePrivateKey:
    type: tls:PrivateKey
    properties:
      algorithm: RSA
      rsaBits: 2048
  proxmoxVirtualEnvironmentCertificateSelfSignedCert:
    type: tls:SelfSignedCert
    properties:
      keyAlgorithm: ${proxmoxVirtualEnvironmentCertificatePrivateKey.algorithm}
      privateKeyPem: ${proxmoxVirtualEnvironmentCertificatePrivateKey.privateKeyPem}
      subject:
        commonName: example.com
        organization: Terraform Provider for Proxmox
      validityPeriodHours: 8760
      allowedUses:
        - key_encipherment
        - digital_signature
        - server_auth
Copy

Create Certifi Resource

Resources are created with functions called constructors. To learn more about declaring and configuring resources, see Resources.

Constructor syntax

new Certifi(name: string, args: CertifiArgs, opts?: CustomResourceOptions);
@overload
def Certifi(resource_name: str,
            args: CertifiArgs,
            opts: Optional[ResourceOptions] = None)

@overload
def Certifi(resource_name: str,
            opts: Optional[ResourceOptions] = None,
            certificate: Optional[str] = None,
            node_name: Optional[str] = None,
            private_key: Optional[str] = None,
            certificate_chain: Optional[str] = None,
            overwrite: Optional[bool] = None)
func NewCertifi(ctx *Context, name string, args CertifiArgs, opts ...ResourceOption) (*Certifi, error)
public Certifi(string name, CertifiArgs args, CustomResourceOptions? opts = null)
public Certifi(String name, CertifiArgs args)
public Certifi(String name, CertifiArgs args, CustomResourceOptions options)
type: proxmoxve:Certifi
properties: # The arguments to resource properties.
options: # Bag of options to control resource's behavior.

Parameters

name This property is required. string
The unique name of the resource.
args This property is required. CertifiArgs
The arguments to resource properties.
opts CustomResourceOptions
Bag of options to control resource's behavior.
resource_name This property is required. str
The unique name of the resource.
args This property is required. CertifiArgs
The arguments to resource properties.
opts ResourceOptions
Bag of options to control resource's behavior.
ctx Context
Context object for the current deployment.
name This property is required. string
The unique name of the resource.
args This property is required. CertifiArgs
The arguments to resource properties.
opts ResourceOption
Bag of options to control resource's behavior.
name This property is required. string
The unique name of the resource.
args This property is required. CertifiArgs
The arguments to resource properties.
opts CustomResourceOptions
Bag of options to control resource's behavior.
name This property is required. String
The unique name of the resource.
args This property is required. CertifiArgs
The arguments to resource properties.
options CustomResourceOptions
Bag of options to control resource's behavior.

Constructor example

The following reference example uses placeholder values for all input properties.

var certifiResource = new ProxmoxVE.Certifi("certifiResource", new()
{
    Certificate = "string",
    NodeName = "string",
    PrivateKey = "string",
    CertificateChain = "string",
    Overwrite = false,
});
Copy
example, err := proxmoxve.NewCertifi(ctx, "certifiResource", &proxmoxve.CertifiArgs{
	Certificate:      pulumi.String("string"),
	NodeName:         pulumi.String("string"),
	PrivateKey:       pulumi.String("string"),
	CertificateChain: pulumi.String("string"),
	Overwrite:        pulumi.Bool(false),
})
Copy
var certifiResource = new Certifi("certifiResource", CertifiArgs.builder()
    .certificate("string")
    .nodeName("string")
    .privateKey("string")
    .certificateChain("string")
    .overwrite(false)
    .build());
Copy
certifi_resource = proxmoxve.Certifi("certifiResource",
    certificate="string",
    node_name="string",
    private_key="string",
    certificate_chain="string",
    overwrite=False)
Copy
const certifiResource = new proxmoxve.Certifi("certifiResource", {
    certificate: "string",
    nodeName: "string",
    privateKey: "string",
    certificateChain: "string",
    overwrite: false,
});
Copy
type: proxmoxve:Certifi
properties:
    certificate: string
    certificateChain: string
    nodeName: string
    overwrite: false
    privateKey: string
Copy

Certifi Resource Properties

To learn more about resource properties and how to use them, see Inputs and Outputs in the Architecture and Concepts docs.

Inputs

In Python, inputs that are objects can be passed either as argument classes or as dictionary literals.

The Certifi resource accepts the following input properties:

Certificate This property is required. string
The PEM encoded certificate.
NodeName
This property is required.
Changes to this property will trigger replacement.
string
A node name.
PrivateKey This property is required. string
The PEM encoded private key.
CertificateChain string
The PEM encoded certificate chain.
Overwrite bool
Whether to overwrite an existing certificate
Certificate This property is required. string
The PEM encoded certificate.
NodeName
This property is required.
Changes to this property will trigger replacement.
string
A node name.
PrivateKey This property is required. string
The PEM encoded private key.
CertificateChain string
The PEM encoded certificate chain.
Overwrite bool
Whether to overwrite an existing certificate
certificate This property is required. String
The PEM encoded certificate.
nodeName
This property is required.
Changes to this property will trigger replacement.
String
A node name.
privateKey This property is required. String
The PEM encoded private key.
certificateChain String
The PEM encoded certificate chain.
overwrite Boolean
Whether to overwrite an existing certificate
certificate This property is required. string
The PEM encoded certificate.
nodeName
This property is required.
Changes to this property will trigger replacement.
string
A node name.
privateKey This property is required. string
The PEM encoded private key.
certificateChain string
The PEM encoded certificate chain.
overwrite boolean
Whether to overwrite an existing certificate
certificate This property is required. str
The PEM encoded certificate.
node_name
This property is required.
Changes to this property will trigger replacement.
str
A node name.
private_key This property is required. str
The PEM encoded private key.
certificate_chain str
The PEM encoded certificate chain.
overwrite bool
Whether to overwrite an existing certificate
certificate This property is required. String
The PEM encoded certificate.
nodeName
This property is required.
Changes to this property will trigger replacement.
String
A node name.
privateKey This property is required. String
The PEM encoded private key.
certificateChain String
The PEM encoded certificate chain.
overwrite Boolean
Whether to overwrite an existing certificate

Outputs

All input properties are implicitly available as output properties. Additionally, the Certifi resource produces the following output properties:

ExpirationDate string
The expiration date (RFC 3339).
FileName string
The file name.
Id string
The provider-assigned unique ID for this managed resource.
Issuer string
The issuer.
PublicKeySize int
The public key size.
PublicKeyType string
The public key type.
SslFingerprint string
The SSL fingerprint.
StartDate string
The start date (RFC 3339).
Subject string
The subject.
SubjectAlternativeNames List<string>
The subject alternative names.
ExpirationDate string
The expiration date (RFC 3339).
FileName string
The file name.
Id string
The provider-assigned unique ID for this managed resource.
Issuer string
The issuer.
PublicKeySize int
The public key size.
PublicKeyType string
The public key type.
SslFingerprint string
The SSL fingerprint.
StartDate string
The start date (RFC 3339).
Subject string
The subject.
SubjectAlternativeNames []string
The subject alternative names.
expirationDate String
The expiration date (RFC 3339).
fileName String
The file name.
id String
The provider-assigned unique ID for this managed resource.
issuer String
The issuer.
publicKeySize Integer
The public key size.
publicKeyType String
The public key type.
sslFingerprint String
The SSL fingerprint.
startDate String
The start date (RFC 3339).
subject String
The subject.
subjectAlternativeNames List<String>
The subject alternative names.
expirationDate string
The expiration date (RFC 3339).
fileName string
The file name.
id string
The provider-assigned unique ID for this managed resource.
issuer string
The issuer.
publicKeySize number
The public key size.
publicKeyType string
The public key type.
sslFingerprint string
The SSL fingerprint.
startDate string
The start date (RFC 3339).
subject string
The subject.
subjectAlternativeNames string[]
The subject alternative names.
expiration_date str
The expiration date (RFC 3339).
file_name str
The file name.
id str
The provider-assigned unique ID for this managed resource.
issuer str
The issuer.
public_key_size int
The public key size.
public_key_type str
The public key type.
ssl_fingerprint str
The SSL fingerprint.
start_date str
The start date (RFC 3339).
subject str
The subject.
subject_alternative_names Sequence[str]
The subject alternative names.
expirationDate String
The expiration date (RFC 3339).
fileName String
The file name.
id String
The provider-assigned unique ID for this managed resource.
issuer String
The issuer.
publicKeySize Number
The public key size.
publicKeyType String
The public key type.
sslFingerprint String
The SSL fingerprint.
startDate String
The start date (RFC 3339).
subject String
The subject.
subjectAlternativeNames List<String>
The subject alternative names.

Look up Existing Certifi Resource

Get an existing Certifi resource’s state with the given name, ID, and optional extra properties used to qualify the lookup.

public static get(name: string, id: Input<ID>, state?: CertifiState, opts?: CustomResourceOptions): Certifi
@staticmethod
def get(resource_name: str,
        id: str,
        opts: Optional[ResourceOptions] = None,
        certificate: Optional[str] = None,
        certificate_chain: Optional[str] = None,
        expiration_date: Optional[str] = None,
        file_name: Optional[str] = None,
        issuer: Optional[str] = None,
        node_name: Optional[str] = None,
        overwrite: Optional[bool] = None,
        private_key: Optional[str] = None,
        public_key_size: Optional[int] = None,
        public_key_type: Optional[str] = None,
        ssl_fingerprint: Optional[str] = None,
        start_date: Optional[str] = None,
        subject: Optional[str] = None,
        subject_alternative_names: Optional[Sequence[str]] = None) -> Certifi
func GetCertifi(ctx *Context, name string, id IDInput, state *CertifiState, opts ...ResourceOption) (*Certifi, error)
public static Certifi Get(string name, Input<string> id, CertifiState? state, CustomResourceOptions? opts = null)
public static Certifi get(String name, Output<String> id, CertifiState state, CustomResourceOptions options)
resources:  _:    type: proxmoxve:Certifi    get:      id: ${id}
name This property is required.
The unique name of the resulting resource.
id This property is required.
The unique provider ID of the resource to lookup.
state
Any extra arguments used during the lookup.
opts
A bag of options that control this resource's behavior.
resource_name This property is required.
The unique name of the resulting resource.
id This property is required.
The unique provider ID of the resource to lookup.
name This property is required.
The unique name of the resulting resource.
id This property is required.
The unique provider ID of the resource to lookup.
state
Any extra arguments used during the lookup.
opts
A bag of options that control this resource's behavior.
name This property is required.
The unique name of the resulting resource.
id This property is required.
The unique provider ID of the resource to lookup.
state
Any extra arguments used during the lookup.
opts
A bag of options that control this resource's behavior.
name This property is required.
The unique name of the resulting resource.
id This property is required.
The unique provider ID of the resource to lookup.
state
Any extra arguments used during the lookup.
opts
A bag of options that control this resource's behavior.
The following state arguments are supported:
Certificate string
The PEM encoded certificate.
CertificateChain string
The PEM encoded certificate chain.
ExpirationDate string
The expiration date (RFC 3339).
FileName string
The file name.
Issuer string
The issuer.
NodeName Changes to this property will trigger replacement. string
A node name.
Overwrite bool
Whether to overwrite an existing certificate
PrivateKey string
The PEM encoded private key.
PublicKeySize int
The public key size.
PublicKeyType string
The public key type.
SslFingerprint string
The SSL fingerprint.
StartDate string
The start date (RFC 3339).
Subject string
The subject.
SubjectAlternativeNames List<string>
The subject alternative names.
Certificate string
The PEM encoded certificate.
CertificateChain string
The PEM encoded certificate chain.
ExpirationDate string
The expiration date (RFC 3339).
FileName string
The file name.
Issuer string
The issuer.
NodeName Changes to this property will trigger replacement. string
A node name.
Overwrite bool
Whether to overwrite an existing certificate
PrivateKey string
The PEM encoded private key.
PublicKeySize int
The public key size.
PublicKeyType string
The public key type.
SslFingerprint string
The SSL fingerprint.
StartDate string
The start date (RFC 3339).
Subject string
The subject.
SubjectAlternativeNames []string
The subject alternative names.
certificate String
The PEM encoded certificate.
certificateChain String
The PEM encoded certificate chain.
expirationDate String
The expiration date (RFC 3339).
fileName String
The file name.
issuer String
The issuer.
nodeName Changes to this property will trigger replacement. String
A node name.
overwrite Boolean
Whether to overwrite an existing certificate
privateKey String
The PEM encoded private key.
publicKeySize Integer
The public key size.
publicKeyType String
The public key type.
sslFingerprint String
The SSL fingerprint.
startDate String
The start date (RFC 3339).
subject String
The subject.
subjectAlternativeNames List<String>
The subject alternative names.
certificate string
The PEM encoded certificate.
certificateChain string
The PEM encoded certificate chain.
expirationDate string
The expiration date (RFC 3339).
fileName string
The file name.
issuer string
The issuer.
nodeName Changes to this property will trigger replacement. string
A node name.
overwrite boolean
Whether to overwrite an existing certificate
privateKey string
The PEM encoded private key.
publicKeySize number
The public key size.
publicKeyType string
The public key type.
sslFingerprint string
The SSL fingerprint.
startDate string
The start date (RFC 3339).
subject string
The subject.
subjectAlternativeNames string[]
The subject alternative names.
certificate str
The PEM encoded certificate.
certificate_chain str
The PEM encoded certificate chain.
expiration_date str
The expiration date (RFC 3339).
file_name str
The file name.
issuer str
The issuer.
node_name Changes to this property will trigger replacement. str
A node name.
overwrite bool
Whether to overwrite an existing certificate
private_key str
The PEM encoded private key.
public_key_size int
The public key size.
public_key_type str
The public key type.
ssl_fingerprint str
The SSL fingerprint.
start_date str
The start date (RFC 3339).
subject str
The subject.
subject_alternative_names Sequence[str]
The subject alternative names.
certificate String
The PEM encoded certificate.
certificateChain String
The PEM encoded certificate chain.
expirationDate String
The expiration date (RFC 3339).
fileName String
The file name.
issuer String
The issuer.
nodeName Changes to this property will trigger replacement. String
A node name.
overwrite Boolean
Whether to overwrite an existing certificate
privateKey String
The PEM encoded private key.
publicKeySize Number
The public key size.
publicKeyType String
The public key type.
sslFingerprint String
The SSL fingerprint.
startDate String
The start date (RFC 3339).
subject String
The subject.
subjectAlternativeNames List<String>
The subject alternative names.

Package Details

Repository
proxmoxve muhlba91/pulumi-proxmoxve
License
Apache-2.0
Notes
This Pulumi package is based on the proxmox Terraform Provider.
Proxmox Virtual Environment (Proxmox VE) v7.0.0 published on Tuesday, Apr 1, 2025 by Daniel Muehlbachler-Pietrzykowski