Docs Home Pulumi IaC Pulumi ESC Pulumi Insights Pulumi Cloud Packages Tutorials
  1. Packages
  2. Oracle Cloud Infrastructure
  3. API Docs
  4. CertificatesManagement
  5. getCertificateVersions
Oracle Cloud Infrastructure v2.33.0 published on Thursday, May 1, 2025 by Pulumi
pulumi/pulumi-oci

oci.CertificatesManagement.getCertificateVersions

Explore with Pulumi AI

oci logo
Oracle Cloud Infrastructure v2.33.0 published on Thursday, May 1, 2025 by Pulumi
pulumi/pulumi-oci

    This data source provides the list of Certificate Versions in Oracle Cloud Infrastructure Certificates Management service.

    Lists all certificate versions for the specified certificate. Optionally, you can use the parameter FilterByVersionNumberQueryParam to limit the result set to a single item that matches the specified version number.

    Example Usage

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

const testCertificateVersions = oci.CertificatesManagement.getCertificateVersions({
    certificateId: testCertificate.id,
    versionNumber: certificateVersionVersionNumber,
});

    import pulumi
import pulumi_oci as oci

test_certificate_versions = oci.CertificatesManagement.get_certificate_versions(certificate_id=test_certificate["id"],
    version_number=certificate_version_version_number)

    package main

import (
	"github.com/pulumi/pulumi-oci/sdk/v2/go/oci/certificatesmanagement"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_, err := certificatesmanagement.GetCertificateVersions(ctx, &certificatesmanagement.GetCertificateVersionsArgs{
			CertificateId: testCertificate.Id,
			VersionNumber: pulumi.StringRef(certificateVersionVersionNumber),
		}, nil)
		if err != nil {
			return err
		}
		return nil
	})
}

    using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Oci = Pulumi.Oci;

return await Deployment.RunAsync(() => 
{
    var testCertificateVersions = Oci.CertificatesManagement.GetCertificateVersions.Invoke(new()
    {
        CertificateId = testCertificate.Id,
        VersionNumber = certificateVersionVersionNumber,
    });

});

    package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.oci.CertificatesManagement.CertificatesManagementFunctions;
import com.pulumi.oci.CertificatesManagement.inputs.GetCertificateVersionsArgs;
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 testCertificateVersions = CertificatesManagementFunctions.getCertificateVersions(GetCertificateVersionsArgs.builder()
            .certificateId(testCertificate.id())
            .versionNumber(certificateVersionVersionNumber)
            .build());

    }
}

    variables:
  testCertificateVersions:
    fn::invoke:
      function: oci:CertificatesManagement:getCertificateVersions
      arguments:
        certificateId: ${testCertificate.id}
        versionNumber: ${certificateVersionVersionNumber}

    Using getCertificateVersions

    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 getCertificateVersions(args: GetCertificateVersionsArgs, opts?: InvokeOptions): Promise<GetCertificateVersionsResult>
function getCertificateVersionsOutput(args: GetCertificateVersionsOutputArgs, opts?: InvokeOptions): Output<GetCertificateVersionsResult>
    def get_certificate_versions(certificate_id: Optional[str] = None,
                             filters: Optional[Sequence[GetCertificateVersionsFilter]] = None,
                             version_number: Optional[str] = None,
                             opts: Optional[InvokeOptions] = None) -> GetCertificateVersionsResult
def get_certificate_versions_output(certificate_id: Optional[pulumi.Input[str]] = None,
                             filters: Optional[pulumi.Input[Sequence[pulumi.Input[GetCertificateVersionsFilterArgs]]]] = None,
                             version_number: Optional[pulumi.Input[str]] = None,
                             opts: Optional[InvokeOptions] = None) -> Output[GetCertificateVersionsResult]
    func GetCertificateVersions(ctx *Context, args *GetCertificateVersionsArgs, opts ...InvokeOption) (*GetCertificateVersionsResult, error)
func GetCertificateVersionsOutput(ctx *Context, args *GetCertificateVersionsOutputArgs, opts ...InvokeOption) GetCertificateVersionsResultOutput

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

    public static class GetCertificateVersions 
{
    public static Task<GetCertificateVersionsResult> InvokeAsync(GetCertificateVersionsArgs args, InvokeOptions? opts = null)
    public static Output<GetCertificateVersionsResult> Invoke(GetCertificateVersionsInvokeArgs args, InvokeOptions? opts = null)
}
    public static CompletableFuture<GetCertificateVersionsResult> getCertificateVersions(GetCertificateVersionsArgs args, InvokeOptions options)
public static Output<GetCertificateVersionsResult> getCertificateVersions(GetCertificateVersionsArgs args, InvokeOptions options)

    fn::invoke:
  function: oci:CertificatesManagement/getCertificateVersions:getCertificateVersions
  arguments:
    # arguments dictionary

    The following arguments are supported:

    CertificateId string
    The OCID of the certificate.
    Filters List<GetCertificateVersionsFilter>
    VersionNumber string
    A filter that returns only resources that match the specified version number. The default value is 0, which means that this filter is not applied.
    CertificateId string
    The OCID of the certificate.
    Filters []GetCertificateVersionsFilter
    VersionNumber string
    A filter that returns only resources that match the specified version number. The default value is 0, which means that this filter is not applied.
    certificateId String
    The OCID of the certificate.
    filters List<GetCertificateVersionsFilter>
    versionNumber String
    A filter that returns only resources that match the specified version number. The default value is 0, which means that this filter is not applied.
    certificateId string
    The OCID of the certificate.
    filters GetCertificateVersionsFilter[]
    versionNumber string
    A filter that returns only resources that match the specified version number. The default value is 0, which means that this filter is not applied.
    certificate_id str
    The OCID of the certificate.
    filters Sequence[GetCertificateVersionsFilter]
    version_number str
    A filter that returns only resources that match the specified version number. The default value is 0, which means that this filter is not applied.
    certificateId String
    The OCID of the certificate.
    filters List<Property Map>
    versionNumber String
    A filter that returns only resources that match the specified version number. The default value is 0, which means that this filter is not applied.

    getCertificateVersions Result

    The following output properties are available:

    CertificateId string
    The OCID of the certificate.
    CertificateVersionCollections List<GetCertificateVersionsCertificateVersionCollection>
    The list of certificate_version_collection.
    Id string
    The provider-assigned unique ID for this managed resource.
    Filters List<GetCertificateVersionsFilter>
    VersionNumber string
    The version number of the certificate.
    CertificateId string
    The OCID of the certificate.
    CertificateVersionCollections []GetCertificateVersionsCertificateVersionCollection
    The list of certificate_version_collection.
    Id string
    The provider-assigned unique ID for this managed resource.
    Filters []GetCertificateVersionsFilter
    VersionNumber string
    The version number of the certificate.
    certificateId String
    The OCID of the certificate.
    certificateVersionCollections List<GetCertificateVersionsCertificateVersionCollection>
    The list of certificate_version_collection.
    id String
    The provider-assigned unique ID for this managed resource.
    filters List<GetCertificateVersionsFilter>
    versionNumber String
    The version number of the certificate.
    certificateId string
    The OCID of the certificate.
    certificateVersionCollections GetCertificateVersionsCertificateVersionCollection[]
    The list of certificate_version_collection.
    id string
    The provider-assigned unique ID for this managed resource.
    filters GetCertificateVersionsFilter[]
    versionNumber string
    The version number of the certificate.
    certificate_id str
    The OCID of the certificate.
    certificate_version_collections Sequence[GetCertificateVersionsCertificateVersionCollection]
    The list of certificate_version_collection.
    id str
    The provider-assigned unique ID for this managed resource.
    filters Sequence[GetCertificateVersionsFilter]
    version_number str
    The version number of the certificate.
    certificateId String
    The OCID of the certificate.
    certificateVersionCollections List<Property Map>
    The list of certificate_version_collection.
    id String
    The provider-assigned unique ID for this managed resource.
    filters List<Property Map>
    versionNumber String
    The version number of the certificate.

    Supporting Types

    GetCertificateVersionsCertificateVersionCollection

    Items List<GetCertificateVersionsCertificateVersionCollectionItem>
    A list of certificate version summary objects.
    Items []GetCertificateVersionsCertificateVersionCollectionItem
    A list of certificate version summary objects.
    items List<GetCertificateVersionsCertificateVersionCollectionItem>
    A list of certificate version summary objects.
    items GetCertificateVersionsCertificateVersionCollectionItem[]
    A list of certificate version summary objects.
    items Sequence[GetCertificateVersionsCertificateVersionCollectionItem]
    A list of certificate version summary objects.
    items List<Property Map>
    A list of certificate version summary objects.

    GetCertificateVersionsCertificateVersionCollectionItem

    CertificateId string
    The OCID of the certificate.
    IssuerCaVersionNumber string
    The version number of the issuing certificate authority (CA).
    RevocationStatuses List<GetCertificateVersionsCertificateVersionCollectionItemRevocationStatus>
    The current revocation status of the entity.
    SerialNumber string
    A unique certificate identifier used in certificate revocation tracking, formatted as octets. Example: 03 AC FC FA CC B3 CB 02 B8 F8 DE F5 85 E7 7B FF
    Stages List<string>
    A list of rotation states for this certificate version.
    SubjectAlternativeNames List<GetCertificateVersionsCertificateVersionCollectionItemSubjectAlternativeName>
    A list of subject alternative names.
    TimeCreated string
    A optional property indicating the time when the certificate version was created, expressed in RFC 3339 timestamp format. Example: 2019-04-03T21:10:29.600Z
    TimeOfDeletion string
    An optional property indicating when to delete the certificate version, expressed in RFC 3339 timestamp format. Example: 2019-04-03T21:10:29.600Z
    Validities List<GetCertificateVersionsCertificateVersionCollectionItemValidity>
    An object that describes a period of time during which an entity is valid. If this is not provided when you create a certificate, the validity of the issuing CA is used.
    VersionName string
    The name of the certificate version. When the value is not null, a name is unique across versions of a given certificate.
    VersionNumber string
    A filter that returns only resources that match the specified version number. The default value is 0, which means that this filter is not applied.
    CertificateId string
    The OCID of the certificate.
    IssuerCaVersionNumber string
    The version number of the issuing certificate authority (CA).
    RevocationStatuses []GetCertificateVersionsCertificateVersionCollectionItemRevocationStatus
    The current revocation status of the entity.
    SerialNumber string
    A unique certificate identifier used in certificate revocation tracking, formatted as octets. Example: 03 AC FC FA CC B3 CB 02 B8 F8 DE F5 85 E7 7B FF
    Stages []string
    A list of rotation states for this certificate version.
    SubjectAlternativeNames []GetCertificateVersionsCertificateVersionCollectionItemSubjectAlternativeName
    A list of subject alternative names.
    TimeCreated string
    A optional property indicating the time when the certificate version was created, expressed in RFC 3339 timestamp format. Example: 2019-04-03T21:10:29.600Z
    TimeOfDeletion string
    An optional property indicating when to delete the certificate version, expressed in RFC 3339 timestamp format. Example: 2019-04-03T21:10:29.600Z
    Validities []GetCertificateVersionsCertificateVersionCollectionItemValidity
    An object that describes a period of time during which an entity is valid. If this is not provided when you create a certificate, the validity of the issuing CA is used.
    VersionName string
    The name of the certificate version. When the value is not null, a name is unique across versions of a given certificate.
    VersionNumber string
    A filter that returns only resources that match the specified version number. The default value is 0, which means that this filter is not applied.
    certificateId String
    The OCID of the certificate.
    issuerCaVersionNumber String
    The version number of the issuing certificate authority (CA).
    revocationStatuses List<GetCertificateVersionsCertificateVersionCollectionItemRevocationStatus>
    The current revocation status of the entity.
    serialNumber String
    A unique certificate identifier used in certificate revocation tracking, formatted as octets. Example: 03 AC FC FA CC B3 CB 02 B8 F8 DE F5 85 E7 7B FF
    stages List<String>
    A list of rotation states for this certificate version.
    subjectAlternativeNames List<GetCertificateVersionsCertificateVersionCollectionItemSubjectAlternativeName>
    A list of subject alternative names.
    timeCreated String
    A optional property indicating the time when the certificate version was created, expressed in RFC 3339 timestamp format. Example: 2019-04-03T21:10:29.600Z
    timeOfDeletion String
    An optional property indicating when to delete the certificate version, expressed in RFC 3339 timestamp format. Example: 2019-04-03T21:10:29.600Z
    validities List<GetCertificateVersionsCertificateVersionCollectionItemValidity>
    An object that describes a period of time during which an entity is valid. If this is not provided when you create a certificate, the validity of the issuing CA is used.
    versionName String
    The name of the certificate version. When the value is not null, a name is unique across versions of a given certificate.
    versionNumber String
    A filter that returns only resources that match the specified version number. The default value is 0, which means that this filter is not applied.
    certificateId string
    The OCID of the certificate.
    issuerCaVersionNumber string
    The version number of the issuing certificate authority (CA).
    revocationStatuses GetCertificateVersionsCertificateVersionCollectionItemRevocationStatus[]
    The current revocation status of the entity.
    serialNumber string
    A unique certificate identifier used in certificate revocation tracking, formatted as octets. Example: 03 AC FC FA CC B3 CB 02 B8 F8 DE F5 85 E7 7B FF
    stages string[]
    A list of rotation states for this certificate version.
    subjectAlternativeNames GetCertificateVersionsCertificateVersionCollectionItemSubjectAlternativeName[]
    A list of subject alternative names.
    timeCreated string
    A optional property indicating the time when the certificate version was created, expressed in RFC 3339 timestamp format. Example: 2019-04-03T21:10:29.600Z
    timeOfDeletion string
    An optional property indicating when to delete the certificate version, expressed in RFC 3339 timestamp format. Example: 2019-04-03T21:10:29.600Z
    validities GetCertificateVersionsCertificateVersionCollectionItemValidity[]
    An object that describes a period of time during which an entity is valid. If this is not provided when you create a certificate, the validity of the issuing CA is used.
    versionName string
    The name of the certificate version. When the value is not null, a name is unique across versions of a given certificate.
    versionNumber string
    A filter that returns only resources that match the specified version number. The default value is 0, which means that this filter is not applied.
    certificate_id str
    The OCID of the certificate.
    issuer_ca_version_number str
    The version number of the issuing certificate authority (CA).
    revocation_statuses Sequence[GetCertificateVersionsCertificateVersionCollectionItemRevocationStatus]
    The current revocation status of the entity.
    serial_number str
    A unique certificate identifier used in certificate revocation tracking, formatted as octets. Example: 03 AC FC FA CC B3 CB 02 B8 F8 DE F5 85 E7 7B FF
    stages Sequence[str]
    A list of rotation states for this certificate version.
    subject_alternative_names Sequence[GetCertificateVersionsCertificateVersionCollectionItemSubjectAlternativeName]
    A list of subject alternative names.
    time_created str
    A optional property indicating the time when the certificate version was created, expressed in RFC 3339 timestamp format. Example: 2019-04-03T21:10:29.600Z
    time_of_deletion str
    An optional property indicating when to delete the certificate version, expressed in RFC 3339 timestamp format. Example: 2019-04-03T21:10:29.600Z
    validities Sequence[GetCertificateVersionsCertificateVersionCollectionItemValidity]
    An object that describes a period of time during which an entity is valid. If this is not provided when you create a certificate, the validity of the issuing CA is used.
    version_name str
    The name of the certificate version. When the value is not null, a name is unique across versions of a given certificate.
    version_number str
    A filter that returns only resources that match the specified version number. The default value is 0, which means that this filter is not applied.
    certificateId String
    The OCID of the certificate.
    issuerCaVersionNumber String
    The version number of the issuing certificate authority (CA).
    revocationStatuses List<Property Map>
    The current revocation status of the entity.
    serialNumber String
    A unique certificate identifier used in certificate revocation tracking, formatted as octets. Example: 03 AC FC FA CC B3 CB 02 B8 F8 DE F5 85 E7 7B FF
    stages List<String>
    A list of rotation states for this certificate version.
    subjectAlternativeNames List<Property Map>
    A list of subject alternative names.
    timeCreated String
    A optional property indicating the time when the certificate version was created, expressed in RFC 3339 timestamp format. Example: 2019-04-03T21:10:29.600Z
    timeOfDeletion String
    An optional property indicating when to delete the certificate version, expressed in RFC 3339 timestamp format. Example: 2019-04-03T21:10:29.600Z
    validities List<Property Map>
    An object that describes a period of time during which an entity is valid. If this is not provided when you create a certificate, the validity of the issuing CA is used.
    versionName String
    The name of the certificate version. When the value is not null, a name is unique across versions of a given certificate.
    versionNumber String
    A filter that returns only resources that match the specified version number. The default value is 0, which means that this filter is not applied.

    GetCertificateVersionsCertificateVersionCollectionItemRevocationStatus

    RevocationReason string
    The reason the certificate or certificate authority (CA) was revoked.
    TimeOfRevocation string
    The time when the entity was revoked, expressed in RFC 3339 timestamp format. Example: 2019-04-03T21:10:29.600Z
    RevocationReason string
    The reason the certificate or certificate authority (CA) was revoked.
    TimeOfRevocation string
    The time when the entity was revoked, expressed in RFC 3339 timestamp format. Example: 2019-04-03T21:10:29.600Z
    revocationReason String
    The reason the certificate or certificate authority (CA) was revoked.
    timeOfRevocation String
    The time when the entity was revoked, expressed in RFC 3339 timestamp format. Example: 2019-04-03T21:10:29.600Z
    revocationReason string
    The reason the certificate or certificate authority (CA) was revoked.
    timeOfRevocation string
    The time when the entity was revoked, expressed in RFC 3339 timestamp format. Example: 2019-04-03T21:10:29.600Z
    revocation_reason str
    The reason the certificate or certificate authority (CA) was revoked.
    time_of_revocation str
    The time when the entity was revoked, expressed in RFC 3339 timestamp format. Example: 2019-04-03T21:10:29.600Z
    revocationReason String
    The reason the certificate or certificate authority (CA) was revoked.
    timeOfRevocation String
    The time when the entity was revoked, expressed in RFC 3339 timestamp format. Example: 2019-04-03T21:10:29.600Z

    GetCertificateVersionsCertificateVersionCollectionItemSubjectAlternativeName

    Type string
    The subject alternative name type. Currently only DNS domain or host names and IP addresses are supported.
    Value string
    The subject alternative name.
    Type string
    The subject alternative name type. Currently only DNS domain or host names and IP addresses are supported.
    Value string
    The subject alternative name.
    type String
    The subject alternative name type. Currently only DNS domain or host names and IP addresses are supported.
    value String
    The subject alternative name.
    type string
    The subject alternative name type. Currently only DNS domain or host names and IP addresses are supported.
    value string
    The subject alternative name.
    type str
    The subject alternative name type. Currently only DNS domain or host names and IP addresses are supported.
    value str
    The subject alternative name.
    type String
    The subject alternative name type. Currently only DNS domain or host names and IP addresses are supported.
    value String
    The subject alternative name.

    GetCertificateVersionsCertificateVersionCollectionItemValidity

    TimeOfValidityNotAfter string
    The date on which the certificate validity period ends, expressed in RFC 3339 timestamp format. Example: 2019-04-03T21:10:29.600Z
    TimeOfValidityNotBefore string
    The date on which the certificate validity period begins, expressed in RFC 3339 timestamp format. Example: 2019-04-03T21:10:29.600Z
    TimeOfValidityNotAfter string
    The date on which the certificate validity period ends, expressed in RFC 3339 timestamp format. Example: 2019-04-03T21:10:29.600Z
    TimeOfValidityNotBefore string
    The date on which the certificate validity period begins, expressed in RFC 3339 timestamp format. Example: 2019-04-03T21:10:29.600Z
    timeOfValidityNotAfter String
    The date on which the certificate validity period ends, expressed in RFC 3339 timestamp format. Example: 2019-04-03T21:10:29.600Z
    timeOfValidityNotBefore String
    The date on which the certificate validity period begins, expressed in RFC 3339 timestamp format. Example: 2019-04-03T21:10:29.600Z
    timeOfValidityNotAfter string
    The date on which the certificate validity period ends, expressed in RFC 3339 timestamp format. Example: 2019-04-03T21:10:29.600Z
    timeOfValidityNotBefore string
    The date on which the certificate validity period begins, expressed in RFC 3339 timestamp format. Example: 2019-04-03T21:10:29.600Z
    time_of_validity_not_after str
    The date on which the certificate validity period ends, expressed in RFC 3339 timestamp format. Example: 2019-04-03T21:10:29.600Z
    time_of_validity_not_before str
    The date on which the certificate validity period begins, expressed in RFC 3339 timestamp format. Example: 2019-04-03T21:10:29.600Z
    timeOfValidityNotAfter String
    The date on which the certificate validity period ends, expressed in RFC 3339 timestamp format. Example: 2019-04-03T21:10:29.600Z
    timeOfValidityNotBefore String
    The date on which the certificate validity period begins, expressed in RFC 3339 timestamp format. Example: 2019-04-03T21:10:29.600Z

    GetCertificateVersionsFilter

    Name string
    Values List<string>
    Regex bool
    Name string
    Values []string
    Regex bool
    name String
    values List<String>
    regex Boolean
    name string
    values string[]
    regex boolean
    name str
    values Sequence[str]
    regex bool
    name String
    values List<String>
    regex Boolean

    Package Details

    Repository
    oci pulumi/pulumi-oci
    License
    Apache-2.0
    Notes
    This Pulumi package is based on the oci Terraform Provider.
    oci logo
    Oracle Cloud Infrastructure v2.33.0 published on Thursday, May 1, 2025 by Pulumi
    pulumi/pulumi-oci