1. Packages
  2. Fastly Provider
  3. API Docs
  4. getTlsCertificate
Fastly v8.13.0 published on Wednesday, Nov 13, 2024 by Pulumi

fastly.getTlsCertificate

Explore with Pulumi AI

fastly logo
Fastly v8.13.0 published on Wednesday, Nov 13, 2024 by Pulumi

    Use this data source to get information of a TLS certificate for use with other resources.

    Warning: The data source’s filters are applied using an AND boolean operator, so depending on the combination of filters, they may become mutually exclusive. The exception to this is id which must not be specified in combination with any of the others.

    Note: If more or less than a single match is returned by the search, this provider will fail. Ensure that your search is specific enough to return a single key.

    Example Usage

    import * as pulumi from "@pulumi/pulumi";
    import * as fastly from "@pulumi/fastly";
    
    const example = fastly.getTlsCertificate({
        name: "example.com",
    });
    
    import pulumi
    import pulumi_fastly as fastly
    
    example = fastly.get_tls_certificate(name="example.com")
    
    package main
    
    import (
    	"github.com/pulumi/pulumi-fastly/sdk/v8/go/fastly"
    	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
    )
    
    func main() {
    	pulumi.Run(func(ctx *pulumi.Context) error {
    		_, err := fastly.LookupTlsCertificate(ctx, &fastly.LookupTlsCertificateArgs{
    			Name: pulumi.StringRef("example.com"),
    		}, nil)
    		if err != nil {
    			return err
    		}
    		return nil
    	})
    }
    
    using System.Collections.Generic;
    using System.Linq;
    using Pulumi;
    using Fastly = Pulumi.Fastly;
    
    return await Deployment.RunAsync(() => 
    {
        var example = Fastly.GetTlsCertificate.Invoke(new()
        {
            Name = "example.com",
        });
    
    });
    
    package generated_program;
    
    import com.pulumi.Context;
    import com.pulumi.Pulumi;
    import com.pulumi.core.Output;
    import com.pulumi.fastly.FastlyFunctions;
    import com.pulumi.fastly.inputs.GetTlsCertificateArgs;
    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) {
            final var example = FastlyFunctions.getTlsCertificate(GetTlsCertificateArgs.builder()
                .name("example.com")
                .build());
    
        }
    }
    
    variables:
      example:
        fn::invoke:
          Function: fastly:getTlsCertificate
          Arguments:
            name: example.com
    

    Using getTlsCertificate

    Two invocation forms are available. The direct form accepts plain arguments and either blocks until the result value is available, or returns a Promise-wrapped result. The output form accepts Input-wrapped arguments and returns an Output-wrapped result.

    function getTlsCertificate(args: GetTlsCertificateArgs, opts?: InvokeOptions): Promise<GetTlsCertificateResult>
    function getTlsCertificateOutput(args: GetTlsCertificateOutputArgs, opts?: InvokeOptions): Output<GetTlsCertificateResult>
    def get_tls_certificate(domains: Optional[Sequence[str]] = None,
                            id: Optional[str] = None,
                            issued_to: Optional[str] = None,
                            issuer: Optional[str] = None,
                            name: Optional[str] = None,
                            opts: Optional[InvokeOptions] = None) -> GetTlsCertificateResult
    def get_tls_certificate_output(domains: Optional[pulumi.Input[Sequence[pulumi.Input[str]]]] = None,
                            id: Optional[pulumi.Input[str]] = None,
                            issued_to: Optional[pulumi.Input[str]] = None,
                            issuer: Optional[pulumi.Input[str]] = None,
                            name: Optional[pulumi.Input[str]] = None,
                            opts: Optional[InvokeOptions] = None) -> Output[GetTlsCertificateResult]
    func LookupTlsCertificate(ctx *Context, args *LookupTlsCertificateArgs, opts ...InvokeOption) (*LookupTlsCertificateResult, error)
    func LookupTlsCertificateOutput(ctx *Context, args *LookupTlsCertificateOutputArgs, opts ...InvokeOption) LookupTlsCertificateResultOutput

    > Note: This function is named LookupTlsCertificate in the Go SDK.

    public static class GetTlsCertificate 
    {
        public static Task<GetTlsCertificateResult> InvokeAsync(GetTlsCertificateArgs args, InvokeOptions? opts = null)
        public static Output<GetTlsCertificateResult> Invoke(GetTlsCertificateInvokeArgs args, InvokeOptions? opts = null)
    }
    public static CompletableFuture<GetTlsCertificateResult> getTlsCertificate(GetTlsCertificateArgs args, InvokeOptions options)
    // Output-based functions aren't available in Java yet
    
    fn::invoke:
      function: fastly:index/getTlsCertificate:getTlsCertificate
      arguments:
        # arguments dictionary

    The following arguments are supported:

    Domains List<string>
    Domains that are listed in any certificates' Subject Alternative Names (SAN) list.
    Id string
    Unique ID assigned to certificate by Fastly
    IssuedTo string
    The hostname for which a certificate was issued.
    Issuer string
    The certificate authority that issued the certificate.
    Name string
    Human-readable name used to identify the certificate. Defaults to the certificate's Common Name or first Subject Alternative Name entry.
    Domains []string
    Domains that are listed in any certificates' Subject Alternative Names (SAN) list.
    Id string
    Unique ID assigned to certificate by Fastly
    IssuedTo string
    The hostname for which a certificate was issued.
    Issuer string
    The certificate authority that issued the certificate.
    Name string
    Human-readable name used to identify the certificate. Defaults to the certificate's Common Name or first Subject Alternative Name entry.
    domains List<String>
    Domains that are listed in any certificates' Subject Alternative Names (SAN) list.
    id String
    Unique ID assigned to certificate by Fastly
    issuedTo String
    The hostname for which a certificate was issued.
    issuer String
    The certificate authority that issued the certificate.
    name String
    Human-readable name used to identify the certificate. Defaults to the certificate's Common Name or first Subject Alternative Name entry.
    domains string[]
    Domains that are listed in any certificates' Subject Alternative Names (SAN) list.
    id string
    Unique ID assigned to certificate by Fastly
    issuedTo string
    The hostname for which a certificate was issued.
    issuer string
    The certificate authority that issued the certificate.
    name string
    Human-readable name used to identify the certificate. Defaults to the certificate's Common Name or first Subject Alternative Name entry.
    domains Sequence[str]
    Domains that are listed in any certificates' Subject Alternative Names (SAN) list.
    id str
    Unique ID assigned to certificate by Fastly
    issued_to str
    The hostname for which a certificate was issued.
    issuer str
    The certificate authority that issued the certificate.
    name str
    Human-readable name used to identify the certificate. Defaults to the certificate's Common Name or first Subject Alternative Name entry.
    domains List<String>
    Domains that are listed in any certificates' Subject Alternative Names (SAN) list.
    id String
    Unique ID assigned to certificate by Fastly
    issuedTo String
    The hostname for which a certificate was issued.
    issuer String
    The certificate authority that issued the certificate.
    name String
    Human-readable name used to identify the certificate. Defaults to the certificate's Common Name or first Subject Alternative Name entry.

    getTlsCertificate Result

    The following output properties are available:

    CreatedAt string
    Timestamp (GMT) when the certificate was created
    Domains List<string>
    Domains that are listed in any certificates' Subject Alternative Names (SAN) list.
    Id string
    Unique ID assigned to certificate by Fastly
    IssuedTo string
    The hostname for which a certificate was issued.
    Issuer string
    The certificate authority that issued the certificate.
    Name string
    Human-readable name used to identify the certificate. Defaults to the certificate's Common Name or first Subject Alternative Name entry.
    Replace bool
    A recommendation from Fastly indicating the key associated with this certificate is in need of rotation
    SerialNumber string
    A value assigned by the issuer that is unique to a certificate
    SignatureAlgorithm string
    The algorithm used to sign the certificate
    UpdatedAt string
    Timestamp (GMT) when the certificate was last updated
    CreatedAt string
    Timestamp (GMT) when the certificate was created
    Domains []string
    Domains that are listed in any certificates' Subject Alternative Names (SAN) list.
    Id string
    Unique ID assigned to certificate by Fastly
    IssuedTo string
    The hostname for which a certificate was issued.
    Issuer string
    The certificate authority that issued the certificate.
    Name string
    Human-readable name used to identify the certificate. Defaults to the certificate's Common Name or first Subject Alternative Name entry.
    Replace bool
    A recommendation from Fastly indicating the key associated with this certificate is in need of rotation
    SerialNumber string
    A value assigned by the issuer that is unique to a certificate
    SignatureAlgorithm string
    The algorithm used to sign the certificate
    UpdatedAt string
    Timestamp (GMT) when the certificate was last updated
    createdAt String
    Timestamp (GMT) when the certificate was created
    domains List<String>
    Domains that are listed in any certificates' Subject Alternative Names (SAN) list.
    id String
    Unique ID assigned to certificate by Fastly
    issuedTo String
    The hostname for which a certificate was issued.
    issuer String
    The certificate authority that issued the certificate.
    name String
    Human-readable name used to identify the certificate. Defaults to the certificate's Common Name or first Subject Alternative Name entry.
    replace Boolean
    A recommendation from Fastly indicating the key associated with this certificate is in need of rotation
    serialNumber String
    A value assigned by the issuer that is unique to a certificate
    signatureAlgorithm String
    The algorithm used to sign the certificate
    updatedAt String
    Timestamp (GMT) when the certificate was last updated
    createdAt string
    Timestamp (GMT) when the certificate was created
    domains string[]
    Domains that are listed in any certificates' Subject Alternative Names (SAN) list.
    id string
    Unique ID assigned to certificate by Fastly
    issuedTo string
    The hostname for which a certificate was issued.
    issuer string
    The certificate authority that issued the certificate.
    name string
    Human-readable name used to identify the certificate. Defaults to the certificate's Common Name or first Subject Alternative Name entry.
    replace boolean
    A recommendation from Fastly indicating the key associated with this certificate is in need of rotation
    serialNumber string
    A value assigned by the issuer that is unique to a certificate
    signatureAlgorithm string
    The algorithm used to sign the certificate
    updatedAt string
    Timestamp (GMT) when the certificate was last updated
    created_at str
    Timestamp (GMT) when the certificate was created
    domains Sequence[str]
    Domains that are listed in any certificates' Subject Alternative Names (SAN) list.
    id str
    Unique ID assigned to certificate by Fastly
    issued_to str
    The hostname for which a certificate was issued.
    issuer str
    The certificate authority that issued the certificate.
    name str
    Human-readable name used to identify the certificate. Defaults to the certificate's Common Name or first Subject Alternative Name entry.
    replace bool
    A recommendation from Fastly indicating the key associated with this certificate is in need of rotation
    serial_number str
    A value assigned by the issuer that is unique to a certificate
    signature_algorithm str
    The algorithm used to sign the certificate
    updated_at str
    Timestamp (GMT) when the certificate was last updated
    createdAt String
    Timestamp (GMT) when the certificate was created
    domains List<String>
    Domains that are listed in any certificates' Subject Alternative Names (SAN) list.
    id String
    Unique ID assigned to certificate by Fastly
    issuedTo String
    The hostname for which a certificate was issued.
    issuer String
    The certificate authority that issued the certificate.
    name String
    Human-readable name used to identify the certificate. Defaults to the certificate's Common Name or first Subject Alternative Name entry.
    replace Boolean
    A recommendation from Fastly indicating the key associated with this certificate is in need of rotation
    serialNumber String
    A value assigned by the issuer that is unique to a certificate
    signatureAlgorithm String
    The algorithm used to sign the certificate
    updatedAt String
    Timestamp (GMT) when the certificate was last updated

    Package Details

    Repository
    Fastly pulumi/pulumi-fastly
    License
    Apache-2.0
    Notes
    This Pulumi package is based on the fastly Terraform Provider.
    fastly logo
    Fastly v8.13.0 published on Wednesday, Nov 13, 2024 by Pulumi