Cloudflare

v4.13.0 published on Monday, Nov 28, 2022 by Pulumi

CertificatePack

Import

 $ pulumi import cloudflare:index/certificatePack:CertificatePack example 1d5fdc9e88c8a8c4518b068cd94331fe/8fda82e2-6af9-4eb2-992a-5ab65b792ef1

While supported, importing isn’t recommended and it is advised to replace the certificate entirely instead.

Example Usage

using System.Collections.Generic;
using Pulumi;
using Cloudflare = Pulumi.Cloudflare;

return await Deployment.RunAsync(() => 
{
    // Advanced certificate manager for Let's Encrypt
    var example = new Cloudflare.CertificatePack("example", new()
    {
        CertificateAuthority = "lets_encrypt",
        CloudflareBranding = false,
        Hosts = new[]
        {
            "example.com",
            "*.example.com",
        },
        Type = "advanced",
        ValidationMethod = "http",
        ValidityDays = 90,
        WaitForActiveStatus = true,
        ZoneId = "0da42c8d2132a9ddaf714f9e7c920711",
    });

});

package main

import (
	"github.com/pulumi/pulumi-cloudflare/sdk/v4/go/cloudflare"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_, err := cloudflare.NewCertificatePack(ctx, "example", &cloudflare.CertificatePackArgs{
			CertificateAuthority: pulumi.String("lets_encrypt"),
			CloudflareBranding:   pulumi.Bool(false),
			Hosts: pulumi.StringArray{
				pulumi.String("example.com"),
				pulumi.String("*.example.com"),
			},
			Type:                pulumi.String("advanced"),
			ValidationMethod:    pulumi.String("http"),
			ValidityDays:        pulumi.Int(90),
			WaitForActiveStatus: pulumi.Bool(true),
			ZoneId:              pulumi.String("0da42c8d2132a9ddaf714f9e7c920711"),
		})
		if err != nil {
			return err
		}
		return nil
	})
}

package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.cloudflare.CertificatePack;
import com.pulumi.cloudflare.CertificatePackArgs;
import java.util.List;
import java.util.ArrayList;
import java.util.Map;
import java.io.File;
import java.nio.file.Files;
import java.nio.file.Paths;

public class App {
    public static void main(String[] args) {
        Pulumi.run(App::stack);
    }

    public static void stack(Context ctx) {
        var example = new CertificatePack("example", CertificatePackArgs.builder()        
            .certificateAuthority("lets_encrypt")
            .cloudflareBranding(false)
            .hosts(            
                "example.com",
                "*.example.com")
            .type("advanced")
            .validationMethod("http")
            .validityDays(90)
            .waitForActiveStatus(true)
            .zoneId("0da42c8d2132a9ddaf714f9e7c920711")
            .build());

    }
}

import pulumi
import pulumi_cloudflare as cloudflare

# Advanced certificate manager for Let's Encrypt
example = cloudflare.CertificatePack("example",
    certificate_authority="lets_encrypt",
    cloudflare_branding=False,
    hosts=[
        "example.com",
        "*.example.com",
    ],
    type="advanced",
    validation_method="http",
    validity_days=90,
    wait_for_active_status=True,
    zone_id="0da42c8d2132a9ddaf714f9e7c920711")

import * as pulumi from "@pulumi/pulumi";
import * as cloudflare from "@pulumi/cloudflare";

// Advanced certificate manager for Let's Encrypt
const example = new cloudflare.CertificatePack("example", {
    certificateAuthority: "lets_encrypt",
    cloudflareBranding: false,
    hosts: [
        "example.com",
        "*.example.com",
    ],
    type: "advanced",
    validationMethod: "http",
    validityDays: 90,
    waitForActiveStatus: true,
    zoneId: "0da42c8d2132a9ddaf714f9e7c920711",
});

resources:
  # Advanced certificate manager for Let's Encrypt
  example:
    type: cloudflare:CertificatePack
    properties:
      certificateAuthority: lets_encrypt
      cloudflareBranding: false
      hosts:
        - example.com
        - '*.example.com'
      type: advanced
      validationMethod: http
      validityDays: 90
      waitForActiveStatus: true
      zoneId: 0da42c8d2132a9ddaf714f9e7c920711

Create CertificatePack Resource

new CertificatePack(name: string, args: CertificatePackArgs, opts?: CustomResourceOptions);

@overload
def CertificatePack(resource_name: str,
                    opts: Optional[ResourceOptions] = None,
                    certificate_authority: Optional[str] = None,
                    cloudflare_branding: Optional[bool] = None,
                    hosts: Optional[Sequence[str]] = None,
                    type: Optional[str] = None,
                    validation_errors: Optional[Sequence[CertificatePackValidationErrorArgs]] = None,
                    validation_method: Optional[str] = None,
                    validation_records: Optional[Sequence[CertificatePackValidationRecordArgs]] = None,
                    validity_days: Optional[int] = None,
                    wait_for_active_status: Optional[bool] = None,
                    zone_id: Optional[str] = None)
@overload
def CertificatePack(resource_name: str,
                    args: CertificatePackArgs,
                    opts: Optional[ResourceOptions] = None)

func NewCertificatePack(ctx *Context, name string, args CertificatePackArgs, opts ...ResourceOption) (*CertificatePack, error)

public CertificatePack(string name, CertificatePackArgs args, CustomResourceOptions? opts = null)

public CertificatePack(String name, CertificatePackArgs args)
public CertificatePack(String name, CertificatePackArgs args, CustomResourceOptions options)

type: cloudflare:CertificatePack
properties: # The arguments to resource properties.
options: # Bag of options to control resource's behavior.

name string: The unique name of the resource.
args CertificatePackArgs: The arguments to resource properties.
opts CustomResourceOptions: Bag of options to control resource's behavior.

resource_name str: The unique name of the resource.
args CertificatePackArgs: The arguments to resource properties.
opts ResourceOptions: Bag of options to control resource's behavior.

ctx Context: Context object for the current deployment.
name string: The unique name of the resource.
args CertificatePackArgs: The arguments to resource properties.
opts ResourceOption: Bag of options to control resource's behavior.

name string: The unique name of the resource.
args CertificatePackArgs: The arguments to resource properties.
opts CustomResourceOptions: Bag of options to control resource's behavior.

name String: The unique name of the resource.
args CertificatePackArgs: The arguments to resource properties.
options CustomResourceOptions: Bag of options to control resource's behavior.

CertificatePack Resource Properties

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

Inputs

The CertificatePack resource accepts the following input properties:

CertificateAuthority string: Which certificate authority to issue the certificate pack. Available values: digicert, lets_encrypt, google.
Hosts List<string>: List of hostnames to provision the certificate pack for. The zone name must be included as a host. Note: If using Let's Encrypt, you cannot use individual subdomains and only a wildcard for subdomain is available.
Type string: Certificate pack configuration type. Available values: advanced.
ValidationMethod string: Which validation method to use in order to prove domain ownership. Available values: txt, http, email.
ValidityDays int: How long the certificate is valid for. Note: If using Let's Encrypt, this value can only be 90 days. Available values: 14, 30, 90, 365.
ZoneId string: The zone identifier to target for the resource.
CloudflareBranding bool: Whether or not to include Cloudflare branding. This will add sni.cloudflaressl.com as the Common Name if set to true.
ValidationErrors List<CertificatePackValidationErrorArgs>
ValidationRecords List<CertificatePackValidationRecordArgs>
WaitForActiveStatus bool: Whether or not to wait for a certificate pack to reach status active during creation. Defaults to false.

CertificateAuthority string: Which certificate authority to issue the certificate pack. Available values: digicert, lets_encrypt, google.
Hosts []string: List of hostnames to provision the certificate pack for. The zone name must be included as a host. Note: If using Let's Encrypt, you cannot use individual subdomains and only a wildcard for subdomain is available.
Type string: Certificate pack configuration type. Available values: advanced.
ValidationMethod string: Which validation method to use in order to prove domain ownership. Available values: txt, http, email.
ValidityDays int: How long the certificate is valid for. Note: If using Let's Encrypt, this value can only be 90 days. Available values: 14, 30, 90, 365.
ZoneId string: The zone identifier to target for the resource.
CloudflareBranding bool: Whether or not to include Cloudflare branding. This will add sni.cloudflaressl.com as the Common Name if set to true.
ValidationErrors []CertificatePackValidationErrorArgs
ValidationRecords []CertificatePackValidationRecordArgs
WaitForActiveStatus bool: Whether or not to wait for a certificate pack to reach status active during creation. Defaults to false.

certificateAuthority String: Which certificate authority to issue the certificate pack. Available values: digicert, lets_encrypt, google.
hosts List<String>: List of hostnames to provision the certificate pack for. The zone name must be included as a host. Note: If using Let's Encrypt, you cannot use individual subdomains and only a wildcard for subdomain is available.
type String: Certificate pack configuration type. Available values: advanced.
validationMethod String: Which validation method to use in order to prove domain ownership. Available values: txt, http, email.
validityDays Integer: How long the certificate is valid for. Note: If using Let's Encrypt, this value can only be 90 days. Available values: 14, 30, 90, 365.
zoneId String: The zone identifier to target for the resource.
cloudflareBranding Boolean: Whether or not to include Cloudflare branding. This will add sni.cloudflaressl.com as the Common Name if set to true.
validationErrors List<CertificatePackValidationErrorArgs>
validationRecords List<CertificatePackValidationRecordArgs>
waitForActiveStatus Boolean: Whether or not to wait for a certificate pack to reach status active during creation. Defaults to false.

certificateAuthority string: Which certificate authority to issue the certificate pack. Available values: digicert, lets_encrypt, google.
hosts string[]: List of hostnames to provision the certificate pack for. The zone name must be included as a host. Note: If using Let's Encrypt, you cannot use individual subdomains and only a wildcard for subdomain is available.
type string: Certificate pack configuration type. Available values: advanced.
validationMethod string: Which validation method to use in order to prove domain ownership. Available values: txt, http, email.
validityDays number: How long the certificate is valid for. Note: If using Let's Encrypt, this value can only be 90 days. Available values: 14, 30, 90, 365.
zoneId string: The zone identifier to target for the resource.
cloudflareBranding boolean: Whether or not to include Cloudflare branding. This will add sni.cloudflaressl.com as the Common Name if set to true.
validationErrors CertificatePackValidationErrorArgs[]
validationRecords CertificatePackValidationRecordArgs[]
waitForActiveStatus boolean: Whether or not to wait for a certificate pack to reach status active during creation. Defaults to false.

certificate_authority str: Which certificate authority to issue the certificate pack. Available values: digicert, lets_encrypt, google.
hosts Sequence[str]: List of hostnames to provision the certificate pack for. The zone name must be included as a host. Note: If using Let's Encrypt, you cannot use individual subdomains and only a wildcard for subdomain is available.
type str: Certificate pack configuration type. Available values: advanced.
validation_method str: Which validation method to use in order to prove domain ownership. Available values: txt, http, email.
validity_days int: How long the certificate is valid for. Note: If using Let's Encrypt, this value can only be 90 days. Available values: 14, 30, 90, 365.
zone_id str: The zone identifier to target for the resource.
cloudflare_branding bool: Whether or not to include Cloudflare branding. This will add sni.cloudflaressl.com as the Common Name if set to true.
validation_errors Sequence[CertificatePackValidationErrorArgs]
validation_records Sequence[CertificatePackValidationRecordArgs]
wait_for_active_status bool: Whether or not to wait for a certificate pack to reach status active during creation. Defaults to false.

certificateAuthority String: Which certificate authority to issue the certificate pack. Available values: digicert, lets_encrypt, google.
hosts List<String>: List of hostnames to provision the certificate pack for. The zone name must be included as a host. Note: If using Let's Encrypt, you cannot use individual subdomains and only a wildcard for subdomain is available.
type String: Certificate pack configuration type. Available values: advanced.
validationMethod String: Which validation method to use in order to prove domain ownership. Available values: txt, http, email.
validityDays Number: How long the certificate is valid for. Note: If using Let's Encrypt, this value can only be 90 days. Available values: 14, 30, 90, 365.
zoneId String: The zone identifier to target for the resource.
cloudflareBranding Boolean: Whether or not to include Cloudflare branding. This will add sni.cloudflaressl.com as the Common Name if set to true.
validationErrors List<Property Map>
validationRecords List<Property Map>
waitForActiveStatus Boolean: Whether or not to wait for a certificate pack to reach status active during creation. Defaults to false.

Outputs

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

Id string: The provider-assigned unique ID for this managed resource.

Id string: The provider-assigned unique ID for this managed resource.

id String: The provider-assigned unique ID for this managed resource.

id string: The provider-assigned unique ID for this managed resource.

id str: The provider-assigned unique ID for this managed resource.

id String: The provider-assigned unique ID for this managed resource.

Look up Existing CertificatePack Resource

Get an existing CertificatePack 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?: CertificatePackState, opts?: CustomResourceOptions): CertificatePack

@staticmethod
def get(resource_name: str,
        id: str,
        opts: Optional[ResourceOptions] = None,
        certificate_authority: Optional[str] = None,
        cloudflare_branding: Optional[bool] = None,
        hosts: Optional[Sequence[str]] = None,
        type: Optional[str] = None,
        validation_errors: Optional[Sequence[CertificatePackValidationErrorArgs]] = None,
        validation_method: Optional[str] = None,
        validation_records: Optional[Sequence[CertificatePackValidationRecordArgs]] = None,
        validity_days: Optional[int] = None,
        wait_for_active_status: Optional[bool] = None,
        zone_id: Optional[str] = None) -> CertificatePack

func GetCertificatePack(ctx *Context, name string, id IDInput, state *CertificatePackState, opts ...ResourceOption) (*CertificatePack, error)

public static CertificatePack Get(string name, Input<string> id, CertificatePackState? state, CustomResourceOptions? opts = null)

public static CertificatePack get(String name, Output<String> id, CertificatePackState state, CustomResourceOptions options)

Resource lookup is not supported in YAML

name: The unique name of the resulting resource.
id: 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: The unique name of the resulting resource.
id: The unique provider ID of the resource to lookup.

name: The unique name of the resulting resource.
id: 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: The unique name of the resulting resource.
id: 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: The unique name of the resulting resource.
id: 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:

CertificateAuthority string: Which certificate authority to issue the certificate pack. Available values: digicert, lets_encrypt, google.
CloudflareBranding bool: Whether or not to include Cloudflare branding. This will add sni.cloudflaressl.com as the Common Name if set to true.
Hosts List<string>: List of hostnames to provision the certificate pack for. The zone name must be included as a host. Note: If using Let's Encrypt, you cannot use individual subdomains and only a wildcard for subdomain is available.
Type string: Certificate pack configuration type. Available values: advanced.
ValidationErrors List<CertificatePackValidationErrorArgs>
ValidationMethod string: Which validation method to use in order to prove domain ownership. Available values: txt, http, email.
ValidationRecords List<CertificatePackValidationRecordArgs>
ValidityDays int: How long the certificate is valid for. Note: If using Let's Encrypt, this value can only be 90 days. Available values: 14, 30, 90, 365.
WaitForActiveStatus bool: Whether or not to wait for a certificate pack to reach status active during creation. Defaults to false.
ZoneId string: The zone identifier to target for the resource.

CertificateAuthority string: Which certificate authority to issue the certificate pack. Available values: digicert, lets_encrypt, google.
CloudflareBranding bool: Whether or not to include Cloudflare branding. This will add sni.cloudflaressl.com as the Common Name if set to true.
Hosts []string: List of hostnames to provision the certificate pack for. The zone name must be included as a host. Note: If using Let's Encrypt, you cannot use individual subdomains and only a wildcard for subdomain is available.
Type string: Certificate pack configuration type. Available values: advanced.
ValidationErrors []CertificatePackValidationErrorArgs
ValidationMethod string: Which validation method to use in order to prove domain ownership. Available values: txt, http, email.
ValidationRecords []CertificatePackValidationRecordArgs
ValidityDays int: How long the certificate is valid for. Note: If using Let's Encrypt, this value can only be 90 days. Available values: 14, 30, 90, 365.
WaitForActiveStatus bool: Whether or not to wait for a certificate pack to reach status active during creation. Defaults to false.
ZoneId string: The zone identifier to target for the resource.

certificateAuthority String: Which certificate authority to issue the certificate pack. Available values: digicert, lets_encrypt, google.
cloudflareBranding Boolean: Whether or not to include Cloudflare branding. This will add sni.cloudflaressl.com as the Common Name if set to true.
hosts List<String>: List of hostnames to provision the certificate pack for. The zone name must be included as a host. Note: If using Let's Encrypt, you cannot use individual subdomains and only a wildcard for subdomain is available.
type String: Certificate pack configuration type. Available values: advanced.
validationErrors List<CertificatePackValidationErrorArgs>
validationMethod String: Which validation method to use in order to prove domain ownership. Available values: txt, http, email.
validationRecords List<CertificatePackValidationRecordArgs>
validityDays Integer: How long the certificate is valid for. Note: If using Let's Encrypt, this value can only be 90 days. Available values: 14, 30, 90, 365.
waitForActiveStatus Boolean: Whether or not to wait for a certificate pack to reach status active during creation. Defaults to false.
zoneId String: The zone identifier to target for the resource.

certificateAuthority string: Which certificate authority to issue the certificate pack. Available values: digicert, lets_encrypt, google.
cloudflareBranding boolean: Whether or not to include Cloudflare branding. This will add sni.cloudflaressl.com as the Common Name if set to true.
hosts string[]: List of hostnames to provision the certificate pack for. The zone name must be included as a host. Note: If using Let's Encrypt, you cannot use individual subdomains and only a wildcard for subdomain is available.
type string: Certificate pack configuration type. Available values: advanced.
validationErrors CertificatePackValidationErrorArgs[]
validationMethod string: Which validation method to use in order to prove domain ownership. Available values: txt, http, email.
validationRecords CertificatePackValidationRecordArgs[]
validityDays number: How long the certificate is valid for. Note: If using Let's Encrypt, this value can only be 90 days. Available values: 14, 30, 90, 365.
waitForActiveStatus boolean: Whether or not to wait for a certificate pack to reach status active during creation. Defaults to false.
zoneId string: The zone identifier to target for the resource.

certificate_authority str: Which certificate authority to issue the certificate pack. Available values: digicert, lets_encrypt, google.
cloudflare_branding bool: Whether or not to include Cloudflare branding. This will add sni.cloudflaressl.com as the Common Name if set to true.
hosts Sequence[str]: List of hostnames to provision the certificate pack for. The zone name must be included as a host. Note: If using Let's Encrypt, you cannot use individual subdomains and only a wildcard for subdomain is available.
type str: Certificate pack configuration type. Available values: advanced.
validation_errors Sequence[CertificatePackValidationErrorArgs]
validation_method str: Which validation method to use in order to prove domain ownership. Available values: txt, http, email.
validation_records Sequence[CertificatePackValidationRecordArgs]
validity_days int: How long the certificate is valid for. Note: If using Let's Encrypt, this value can only be 90 days. Available values: 14, 30, 90, 365.
wait_for_active_status bool: Whether or not to wait for a certificate pack to reach status active during creation. Defaults to false.
zone_id str: The zone identifier to target for the resource.

certificateAuthority String: Which certificate authority to issue the certificate pack. Available values: digicert, lets_encrypt, google.
cloudflareBranding Boolean: Whether or not to include Cloudflare branding. This will add sni.cloudflaressl.com as the Common Name if set to true.
hosts List<String>: List of hostnames to provision the certificate pack for. The zone name must be included as a host. Note: If using Let's Encrypt, you cannot use individual subdomains and only a wildcard for subdomain is available.
type String: Certificate pack configuration type. Available values: advanced.
validationErrors List<Property Map>
validationMethod String: Which validation method to use in order to prove domain ownership. Available values: txt, http, email.
validationRecords List<Property Map>
validityDays Number: How long the certificate is valid for. Note: If using Let's Encrypt, this value can only be 90 days. Available values: 14, 30, 90, 365.
waitForActiveStatus Boolean: Whether or not to wait for a certificate pack to reach status active during creation. Defaults to false.
zoneId String: The zone identifier to target for the resource.