Rancher 2 v6.1.1 published on Friday, May 10, 2024 by Pulumi
rancher2.getCertificate
Explore with Pulumi AI
Use this data source to retrieve information about a Rancher v2 certificate.
Depending of the availability, there are 2 types of Rancher v2 certificates:
- Project certificate: Available to all namespaces in the 
project_id - Namespaced certificate: Available to just 
namespace_idin theproject_id 
Example Usage
import * as pulumi from "@pulumi/pulumi";
import * as rancher2 from "@pulumi/rancher2";
// Retrieve a rancher2 Project Certificate
const foo = rancher2.getCertificate({
    name: "<name>",
    projectId: "<project_id>",
});
import pulumi
import pulumi_rancher2 as rancher2
# Retrieve a rancher2 Project Certificate
foo = rancher2.get_certificate(name="<name>",
    project_id="<project_id>")
package main
import (
	"github.com/pulumi/pulumi-rancher2/sdk/v6/go/rancher2"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)
func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		// Retrieve a rancher2 Project Certificate
		_, err := rancher2.LookupCertificate(ctx, &rancher2.LookupCertificateArgs{
			Name:      "<name>",
			ProjectId: "<project_id>",
		}, nil)
		if err != nil {
			return err
		}
		return nil
	})
}
using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Rancher2 = Pulumi.Rancher2;
return await Deployment.RunAsync(() => 
{
    // Retrieve a rancher2 Project Certificate
    var foo = Rancher2.GetCertificate.Invoke(new()
    {
        Name = "<name>",
        ProjectId = "<project_id>",
    });
});
package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.rancher2.Rancher2Functions;
import com.pulumi.rancher2.inputs.GetCertificateArgs;
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) {
        // Retrieve a rancher2 Project Certificate
        final var foo = Rancher2Functions.getCertificate(GetCertificateArgs.builder()
            .name("<name>")
            .projectId("<project_id>")
            .build());
    }
}
variables:
  # Retrieve a rancher2 Project Certificate
  foo:
    fn::invoke:
      Function: rancher2:getCertificate
      Arguments:
        name: <name>
        projectId: <project_id>
import * as pulumi from "@pulumi/pulumi";
import * as rancher2 from "@pulumi/rancher2";
// Retrieve a rancher2 Namespaced Certificate
const foo = rancher2.getCertificate({
    name: "<name>",
    projectId: "<project_id>",
    namespaceId: "<namespace_id>",
});
import pulumi
import pulumi_rancher2 as rancher2
# Retrieve a rancher2 Namespaced Certificate
foo = rancher2.get_certificate(name="<name>",
    project_id="<project_id>",
    namespace_id="<namespace_id>")
package main
import (
	"github.com/pulumi/pulumi-rancher2/sdk/v6/go/rancher2"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)
func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		// Retrieve a rancher2 Namespaced Certificate
		_, err := rancher2.LookupCertificate(ctx, &rancher2.LookupCertificateArgs{
			Name:        "<name>",
			ProjectId:   "<project_id>",
			NamespaceId: pulumi.StringRef("<namespace_id>"),
		}, nil)
		if err != nil {
			return err
		}
		return nil
	})
}
using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Rancher2 = Pulumi.Rancher2;
return await Deployment.RunAsync(() => 
{
    // Retrieve a rancher2 Namespaced Certificate
    var foo = Rancher2.GetCertificate.Invoke(new()
    {
        Name = "<name>",
        ProjectId = "<project_id>",
        NamespaceId = "<namespace_id>",
    });
});
package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.rancher2.Rancher2Functions;
import com.pulumi.rancher2.inputs.GetCertificateArgs;
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) {
        // Retrieve a rancher2 Namespaced Certificate
        final var foo = Rancher2Functions.getCertificate(GetCertificateArgs.builder()
            .name("<name>")
            .projectId("<project_id>")
            .namespaceId("<namespace_id>")
            .build());
    }
}
variables:
  # Retrieve a rancher2 Namespaced Certificate
  foo:
    fn::invoke:
      Function: rancher2:getCertificate
      Arguments:
        name: <name>
        projectId: <project_id>
        namespaceId: <namespace_id>
Using getCertificate
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 getCertificate(args: GetCertificateArgs, opts?: InvokeOptions): Promise<GetCertificateResult>
function getCertificateOutput(args: GetCertificateOutputArgs, opts?: InvokeOptions): Output<GetCertificateResult>def get_certificate(name: Optional[str] = None,
                    namespace_id: Optional[str] = None,
                    project_id: Optional[str] = None,
                    opts: Optional[InvokeOptions] = None) -> GetCertificateResult
def get_certificate_output(name: Optional[pulumi.Input[str]] = None,
                    namespace_id: Optional[pulumi.Input[str]] = None,
                    project_id: Optional[pulumi.Input[str]] = None,
                    opts: Optional[InvokeOptions] = None) -> Output[GetCertificateResult]func LookupCertificate(ctx *Context, args *LookupCertificateArgs, opts ...InvokeOption) (*LookupCertificateResult, error)
func LookupCertificateOutput(ctx *Context, args *LookupCertificateOutputArgs, opts ...InvokeOption) LookupCertificateResultOutput> Note: This function is named LookupCertificate in the Go SDK.
public static class GetCertificate 
{
    public static Task<GetCertificateResult> InvokeAsync(GetCertificateArgs args, InvokeOptions? opts = null)
    public static Output<GetCertificateResult> Invoke(GetCertificateInvokeArgs args, InvokeOptions? opts = null)
}public static CompletableFuture<GetCertificateResult> getCertificate(GetCertificateArgs args, InvokeOptions options)
// Output-based functions aren't available in Java yet
fn::invoke:
  function: rancher2:index/getCertificate:getCertificate
  arguments:
    # arguments dictionaryThe following arguments are supported:
- Name string
 - The name of the certificate (string)
 - Project
Id string - The project id where to assign the certificate (string)
 - Namespace
Id string - The namespace id where to assign the namespaced certificate (string)
 
- Name string
 - The name of the certificate (string)
 - Project
Id string - The project id where to assign the certificate (string)
 - Namespace
Id string - The namespace id where to assign the namespaced certificate (string)
 
- name String
 - The name of the certificate (string)
 - project
Id String - The project id where to assign the certificate (string)
 - namespace
Id String - The namespace id where to assign the namespaced certificate (string)
 
- name string
 - The name of the certificate (string)
 - project
Id string - The project id where to assign the certificate (string)
 - namespace
Id string - The namespace id where to assign the namespaced certificate (string)
 
- name str
 - The name of the certificate (string)
 - project_
id str - The project id where to assign the certificate (string)
 - namespace_
id str - The namespace id where to assign the namespaced certificate (string)
 
- name String
 - The name of the certificate (string)
 - project
Id String - The project id where to assign the certificate (string)
 - namespace
Id String - The namespace id where to assign the namespaced certificate (string)
 
getCertificate Result
The following output properties are available:
- Annotations Dictionary<string, object>
 - (Computed) Annotations for certificate object (map)
 - Certs string
 - (Computed) Base64 encoded certs (string)
 - Description string
 - (Computed) A certificate description (string)
 - Id string
 - The provider-assigned unique ID for this managed resource.
 - Labels Dictionary<string, object>
 - (Computed) Labels for certificate object (map)
 - Name string
 - Project
Id string - Namespace
Id string 
- Annotations map[string]interface{}
 - (Computed) Annotations for certificate object (map)
 - Certs string
 - (Computed) Base64 encoded certs (string)
 - Description string
 - (Computed) A certificate description (string)
 - Id string
 - The provider-assigned unique ID for this managed resource.
 - Labels map[string]interface{}
 - (Computed) Labels for certificate object (map)
 - Name string
 - Project
Id string - Namespace
Id string 
- annotations Map<String,Object>
 - (Computed) Annotations for certificate object (map)
 - certs String
 - (Computed) Base64 encoded certs (string)
 - description String
 - (Computed) A certificate description (string)
 - id String
 - The provider-assigned unique ID for this managed resource.
 - labels Map<String,Object>
 - (Computed) Labels for certificate object (map)
 - name String
 - project
Id String - namespace
Id String 
- annotations {[key: string]: any}
 - (Computed) Annotations for certificate object (map)
 - certs string
 - (Computed) Base64 encoded certs (string)
 - description string
 - (Computed) A certificate description (string)
 - id string
 - The provider-assigned unique ID for this managed resource.
 - labels {[key: string]: any}
 - (Computed) Labels for certificate object (map)
 - name string
 - project
Id string - namespace
Id string 
- annotations Mapping[str, Any]
 - (Computed) Annotations for certificate object (map)
 - certs str
 - (Computed) Base64 encoded certs (string)
 - description str
 - (Computed) A certificate description (string)
 - id str
 - The provider-assigned unique ID for this managed resource.
 - labels Mapping[str, Any]
 - (Computed) Labels for certificate object (map)
 - name str
 - project_
id str - namespace_
id str 
- annotations Map<Any>
 - (Computed) Annotations for certificate object (map)
 - certs String
 - (Computed) Base64 encoded certs (string)
 - description String
 - (Computed) A certificate description (string)
 - id String
 - The provider-assigned unique ID for this managed resource.
 - labels Map<Any>
 - (Computed) Labels for certificate object (map)
 - name String
 - project
Id String - namespace
Id String 
Package Details
- Repository
 - Rancher2 pulumi/pulumi-rancher2
 - License
 - Apache-2.0
 - Notes
 - This Pulumi package is based on the 
rancher2Terraform Provider.