1. Packages
  2. Scaleway
  3. API Docs
  4. loadbalancers
  5. Certificate
Scaleway v1.26.0 published on Friday, Mar 28, 2025 by pulumiverse

scaleway.loadbalancers.Certificate

Explore with Pulumi AI

Create Certificate Resource

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

Constructor syntax

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

@overload
def Certificate(resource_name: str,
                opts: Optional[ResourceOptions] = None,
                lb_id: Optional[str] = None,
                custom_certificate: Optional[CertificateCustomCertificateArgs] = None,
                letsencrypt: Optional[CertificateLetsencryptArgs] = None,
                name: Optional[str] = None)
func NewCertificate(ctx *Context, name string, args CertificateArgs, opts ...ResourceOption) (*Certificate, error)
public Certificate(string name, CertificateArgs args, CustomResourceOptions? opts = null)
public Certificate(String name, CertificateArgs args)
public Certificate(String name, CertificateArgs args, CustomResourceOptions options)
type: scaleway:loadbalancers:Certificate
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. CertificateArgs
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. CertificateArgs
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. CertificateArgs
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. CertificateArgs
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. CertificateArgs
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 certificateResource = new Scaleway.Loadbalancers.Certificate("certificateResource", new()
{
    LbId = "string",
    CustomCertificate = new Scaleway.Loadbalancers.Inputs.CertificateCustomCertificateArgs
    {
        CertificateChain = "string",
    },
    Letsencrypt = new Scaleway.Loadbalancers.Inputs.CertificateLetsencryptArgs
    {
        CommonName = "string",
        SubjectAlternativeNames = new[]
        {
            "string",
        },
    },
    Name = "string",
});
Copy
example, err := loadbalancers.NewCertificate(ctx, "certificateResource", &loadbalancers.CertificateArgs{
	LbId: pulumi.String("string"),
	CustomCertificate: &loadbalancers.CertificateCustomCertificateArgs{
		CertificateChain: pulumi.String("string"),
	},
	Letsencrypt: &loadbalancers.CertificateLetsencryptArgs{
		CommonName: pulumi.String("string"),
		SubjectAlternativeNames: pulumi.StringArray{
			pulumi.String("string"),
		},
	},
	Name: pulumi.String("string"),
})
Copy
var certificateResource = new Certificate("certificateResource", CertificateArgs.builder()
    .lbId("string")
    .customCertificate(CertificateCustomCertificateArgs.builder()
        .certificateChain("string")
        .build())
    .letsencrypt(CertificateLetsencryptArgs.builder()
        .commonName("string")
        .subjectAlternativeNames("string")
        .build())
    .name("string")
    .build());
Copy
certificate_resource = scaleway.loadbalancers.Certificate("certificateResource",
    lb_id="string",
    custom_certificate={
        "certificate_chain": "string",
    },
    letsencrypt={
        "common_name": "string",
        "subject_alternative_names": ["string"],
    },
    name="string")
Copy
const certificateResource = new scaleway.loadbalancers.Certificate("certificateResource", {
    lbId: "string",
    customCertificate: {
        certificateChain: "string",
    },
    letsencrypt: {
        commonName: "string",
        subjectAlternativeNames: ["string"],
    },
    name: "string",
});
Copy
type: scaleway:loadbalancers:Certificate
properties:
    customCertificate:
        certificateChain: string
    lbId: string
    letsencrypt:
        commonName: string
        subjectAlternativeNames:
            - string
    name: string
Copy

Certificate 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 Certificate resource accepts the following input properties:

LbId
This property is required.
Changes to this property will trigger replacement.
string
The load-balancer ID
CustomCertificate Changes to this property will trigger replacement. Pulumiverse.Scaleway.Loadbalancers.Inputs.CertificateCustomCertificate
The custom type certificate type configuration
Letsencrypt Changes to this property will trigger replacement. Pulumiverse.Scaleway.Loadbalancers.Inputs.CertificateLetsencrypt
The Let's Encrypt type certificate configuration
Name string
The name of the load-balancer certificate
LbId
This property is required.
Changes to this property will trigger replacement.
string
The load-balancer ID
CustomCertificate Changes to this property will trigger replacement. CertificateCustomCertificateArgs
The custom type certificate type configuration
Letsencrypt Changes to this property will trigger replacement. CertificateLetsencryptArgs
The Let's Encrypt type certificate configuration
Name string
The name of the load-balancer certificate
lbId
This property is required.
Changes to this property will trigger replacement.
String
The load-balancer ID
customCertificate Changes to this property will trigger replacement. CertificateCustomCertificate
The custom type certificate type configuration
letsencrypt Changes to this property will trigger replacement. CertificateLetsencrypt
The Let's Encrypt type certificate configuration
name String
The name of the load-balancer certificate
lbId
This property is required.
Changes to this property will trigger replacement.
string
The load-balancer ID
customCertificate Changes to this property will trigger replacement. CertificateCustomCertificate
The custom type certificate type configuration
letsencrypt Changes to this property will trigger replacement. CertificateLetsencrypt
The Let's Encrypt type certificate configuration
name string
The name of the load-balancer certificate
lb_id
This property is required.
Changes to this property will trigger replacement.
str
The load-balancer ID
custom_certificate Changes to this property will trigger replacement. CertificateCustomCertificateArgs
The custom type certificate type configuration
letsencrypt Changes to this property will trigger replacement. CertificateLetsencryptArgs
The Let's Encrypt type certificate configuration
name str
The name of the load-balancer certificate
lbId
This property is required.
Changes to this property will trigger replacement.
String
The load-balancer ID
customCertificate Changes to this property will trigger replacement. Property Map
The custom type certificate type configuration
letsencrypt Changes to this property will trigger replacement. Property Map
The Let's Encrypt type certificate configuration
name String
The name of the load-balancer certificate

Outputs

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

CommonName string
Main domain of the certificate
Fingerprint string
The identifier (SHA-1) of the certificate
Id string
The provider-assigned unique ID for this managed resource.
NotValidAfter string
The not valid after validity bound timestamp
NotValidBefore string
The not valid before validity bound timestamp
Status string
Certificate status
SubjectAlternativeNames List<string>
The alternative domain names of the certificate
CommonName string
Main domain of the certificate
Fingerprint string
The identifier (SHA-1) of the certificate
Id string
The provider-assigned unique ID for this managed resource.
NotValidAfter string
The not valid after validity bound timestamp
NotValidBefore string
The not valid before validity bound timestamp
Status string
Certificate status
SubjectAlternativeNames []string
The alternative domain names of the certificate
commonName String
Main domain of the certificate
fingerprint String
The identifier (SHA-1) of the certificate
id String
The provider-assigned unique ID for this managed resource.
notValidAfter String
The not valid after validity bound timestamp
notValidBefore String
The not valid before validity bound timestamp
status String
Certificate status
subjectAlternativeNames List<String>
The alternative domain names of the certificate
commonName string
Main domain of the certificate
fingerprint string
The identifier (SHA-1) of the certificate
id string
The provider-assigned unique ID for this managed resource.
notValidAfter string
The not valid after validity bound timestamp
notValidBefore string
The not valid before validity bound timestamp
status string
Certificate status
subjectAlternativeNames string[]
The alternative domain names of the certificate
common_name str
Main domain of the certificate
fingerprint str
The identifier (SHA-1) of the certificate
id str
The provider-assigned unique ID for this managed resource.
not_valid_after str
The not valid after validity bound timestamp
not_valid_before str
The not valid before validity bound timestamp
status str
Certificate status
subject_alternative_names Sequence[str]
The alternative domain names of the certificate
commonName String
Main domain of the certificate
fingerprint String
The identifier (SHA-1) of the certificate
id String
The provider-assigned unique ID for this managed resource.
notValidAfter String
The not valid after validity bound timestamp
notValidBefore String
The not valid before validity bound timestamp
status String
Certificate status
subjectAlternativeNames List<String>
The alternative domain names of the certificate

Look up Existing Certificate Resource

Get an existing Certificate 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?: CertificateState, opts?: CustomResourceOptions): Certificate
@staticmethod
def get(resource_name: str,
        id: str,
        opts: Optional[ResourceOptions] = None,
        common_name: Optional[str] = None,
        custom_certificate: Optional[CertificateCustomCertificateArgs] = None,
        fingerprint: Optional[str] = None,
        lb_id: Optional[str] = None,
        letsencrypt: Optional[CertificateLetsencryptArgs] = None,
        name: Optional[str] = None,
        not_valid_after: Optional[str] = None,
        not_valid_before: Optional[str] = None,
        status: Optional[str] = None,
        subject_alternative_names: Optional[Sequence[str]] = None) -> Certificate
func GetCertificate(ctx *Context, name string, id IDInput, state *CertificateState, opts ...ResourceOption) (*Certificate, error)
public static Certificate Get(string name, Input<string> id, CertificateState? state, CustomResourceOptions? opts = null)
public static Certificate get(String name, Output<String> id, CertificateState state, CustomResourceOptions options)
resources:  _:    type: scaleway:loadbalancers:Certificate    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:
CommonName string
Main domain of the certificate
CustomCertificate Changes to this property will trigger replacement. Pulumiverse.Scaleway.Loadbalancers.Inputs.CertificateCustomCertificate
The custom type certificate type configuration
Fingerprint string
The identifier (SHA-1) of the certificate
LbId Changes to this property will trigger replacement. string
The load-balancer ID
Letsencrypt Changes to this property will trigger replacement. Pulumiverse.Scaleway.Loadbalancers.Inputs.CertificateLetsencrypt
The Let's Encrypt type certificate configuration
Name string
The name of the load-balancer certificate
NotValidAfter string
The not valid after validity bound timestamp
NotValidBefore string
The not valid before validity bound timestamp
Status string
Certificate status
SubjectAlternativeNames List<string>
The alternative domain names of the certificate
CommonName string
Main domain of the certificate
CustomCertificate Changes to this property will trigger replacement. CertificateCustomCertificateArgs
The custom type certificate type configuration
Fingerprint string
The identifier (SHA-1) of the certificate
LbId Changes to this property will trigger replacement. string
The load-balancer ID
Letsencrypt Changes to this property will trigger replacement. CertificateLetsencryptArgs
The Let's Encrypt type certificate configuration
Name string
The name of the load-balancer certificate
NotValidAfter string
The not valid after validity bound timestamp
NotValidBefore string
The not valid before validity bound timestamp
Status string
Certificate status
SubjectAlternativeNames []string
The alternative domain names of the certificate
commonName String
Main domain of the certificate
customCertificate Changes to this property will trigger replacement. CertificateCustomCertificate
The custom type certificate type configuration
fingerprint String
The identifier (SHA-1) of the certificate
lbId Changes to this property will trigger replacement. String
The load-balancer ID
letsencrypt Changes to this property will trigger replacement. CertificateLetsencrypt
The Let's Encrypt type certificate configuration
name String
The name of the load-balancer certificate
notValidAfter String
The not valid after validity bound timestamp
notValidBefore String
The not valid before validity bound timestamp
status String
Certificate status
subjectAlternativeNames List<String>
The alternative domain names of the certificate
commonName string
Main domain of the certificate
customCertificate Changes to this property will trigger replacement. CertificateCustomCertificate
The custom type certificate type configuration
fingerprint string
The identifier (SHA-1) of the certificate
lbId Changes to this property will trigger replacement. string
The load-balancer ID
letsencrypt Changes to this property will trigger replacement. CertificateLetsencrypt
The Let's Encrypt type certificate configuration
name string
The name of the load-balancer certificate
notValidAfter string
The not valid after validity bound timestamp
notValidBefore string
The not valid before validity bound timestamp
status string
Certificate status
subjectAlternativeNames string[]
The alternative domain names of the certificate
common_name str
Main domain of the certificate
custom_certificate Changes to this property will trigger replacement. CertificateCustomCertificateArgs
The custom type certificate type configuration
fingerprint str
The identifier (SHA-1) of the certificate
lb_id Changes to this property will trigger replacement. str
The load-balancer ID
letsencrypt Changes to this property will trigger replacement. CertificateLetsencryptArgs
The Let's Encrypt type certificate configuration
name str
The name of the load-balancer certificate
not_valid_after str
The not valid after validity bound timestamp
not_valid_before str
The not valid before validity bound timestamp
status str
Certificate status
subject_alternative_names Sequence[str]
The alternative domain names of the certificate
commonName String
Main domain of the certificate
customCertificate Changes to this property will trigger replacement. Property Map
The custom type certificate type configuration
fingerprint String
The identifier (SHA-1) of the certificate
lbId Changes to this property will trigger replacement. String
The load-balancer ID
letsencrypt Changes to this property will trigger replacement. Property Map
The Let's Encrypt type certificate configuration
name String
The name of the load-balancer certificate
notValidAfter String
The not valid after validity bound timestamp
notValidBefore String
The not valid before validity bound timestamp
status String
Certificate status
subjectAlternativeNames List<String>
The alternative domain names of the certificate

Supporting Types

CertificateCustomCertificate
, CertificateCustomCertificateArgs

CertificateChain
This property is required.
Changes to this property will trigger replacement.
string
The full PEM-formatted certificate chain
CertificateChain
This property is required.
Changes to this property will trigger replacement.
string
The full PEM-formatted certificate chain
certificateChain
This property is required.
Changes to this property will trigger replacement.
String
The full PEM-formatted certificate chain
certificateChain
This property is required.
Changes to this property will trigger replacement.
string
The full PEM-formatted certificate chain
certificate_chain
This property is required.
Changes to this property will trigger replacement.
str
The full PEM-formatted certificate chain
certificateChain
This property is required.
Changes to this property will trigger replacement.
String
The full PEM-formatted certificate chain

CertificateLetsencrypt
, CertificateLetsencryptArgs

CommonName
This property is required.
Changes to this property will trigger replacement.
string
Main domain of the certificate
SubjectAlternativeNames Changes to this property will trigger replacement. List<string>
The alternative domain names of the certificate
CommonName
This property is required.
Changes to this property will trigger replacement.
string
Main domain of the certificate
SubjectAlternativeNames Changes to this property will trigger replacement. []string
The alternative domain names of the certificate
commonName
This property is required.
Changes to this property will trigger replacement.
String
Main domain of the certificate
subjectAlternativeNames Changes to this property will trigger replacement. List<String>
The alternative domain names of the certificate
commonName
This property is required.
Changes to this property will trigger replacement.
string
Main domain of the certificate
subjectAlternativeNames Changes to this property will trigger replacement. string[]
The alternative domain names of the certificate
common_name
This property is required.
Changes to this property will trigger replacement.
str
Main domain of the certificate
subject_alternative_names Changes to this property will trigger replacement. Sequence[str]
The alternative domain names of the certificate
commonName
This property is required.
Changes to this property will trigger replacement.
String
Main domain of the certificate
subjectAlternativeNames Changes to this property will trigger replacement. List<String>
The alternative domain names of the certificate

Package Details

Repository
scaleway pulumiverse/pulumi-scaleway
License
Apache-2.0
Notes
This Pulumi package is based on the scaleway Terraform Provider.