1. Packages
  2. Google Cloud (GCP) Classic
  3. API Docs
  4. kms
  5. getCryptoKeyLatestVersion
Google Cloud v8.26.0 published on Thursday, Apr 10, 2025 by Pulumi

gcp.kms.getCryptoKeyLatestVersion

Explore with Pulumi AI

Provides access to the latest Google Cloud Platform KMS CryptoKeyVersion in a CryptoKey. For more information see the official documentation and API.

Example Usage

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

const myKeyRing = gcp.kms.getKMSKeyRing({
    name: "my-key-ring",
    location: "us-central1",
});
const myCryptoKey = myKeyRing.then(myKeyRing => gcp.kms.getKMSCryptoKey({
    name: "my-crypto-key",
    keyRing: myKeyRing.id,
}));
const myCryptoKeyLatestVersion = gcp.kms.getCryptoKeyLatestVersion({
    cryptoKey: myKey.id,
});
Copy
import pulumi
import pulumi_gcp as gcp

my_key_ring = gcp.kms.get_kms_key_ring(name="my-key-ring",
    location="us-central1")
my_crypto_key = gcp.kms.get_kms_crypto_key(name="my-crypto-key",
    key_ring=my_key_ring.id)
my_crypto_key_latest_version = gcp.kms.get_crypto_key_latest_version(crypto_key=my_key["id"])
Copy
package main

import (
	"github.com/pulumi/pulumi-gcp/sdk/v8/go/gcp/kms"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		myKeyRing, err := kms.GetKMSKeyRing(ctx, &kms.GetKMSKeyRingArgs{
			Name:     "my-key-ring",
			Location: "us-central1",
		}, nil)
		if err != nil {
			return err
		}
		_, err = kms.GetKMSCryptoKey(ctx, &kms.GetKMSCryptoKeyArgs{
			Name:    "my-crypto-key",
			KeyRing: myKeyRing.Id,
		}, nil)
		if err != nil {
			return err
		}
		_, err = kms.GetCryptoKeyLatestVersion(ctx, &kms.GetCryptoKeyLatestVersionArgs{
			CryptoKey: myKey.Id,
		}, nil)
		if err != nil {
			return err
		}
		return nil
	})
}
Copy
using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Gcp = Pulumi.Gcp;

return await Deployment.RunAsync(() => 
{
    var myKeyRing = Gcp.Kms.GetKMSKeyRing.Invoke(new()
    {
        Name = "my-key-ring",
        Location = "us-central1",
    });

    var myCryptoKey = Gcp.Kms.GetKMSCryptoKey.Invoke(new()
    {
        Name = "my-crypto-key",
        KeyRing = myKeyRing.Apply(getKMSKeyRingResult => getKMSKeyRingResult.Id),
    });

    var myCryptoKeyLatestVersion = Gcp.Kms.GetCryptoKeyLatestVersion.Invoke(new()
    {
        CryptoKey = myKey.Id,
    });

});
Copy
package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.gcp.kms.KmsFunctions;
import com.pulumi.gcp.kms.inputs.GetKMSKeyRingArgs;
import com.pulumi.gcp.kms.inputs.GetKMSCryptoKeyArgs;
import com.pulumi.gcp.kms.inputs.GetCryptoKeyLatestVersionArgs;
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 myKeyRing = KmsFunctions.getKMSKeyRing(GetKMSKeyRingArgs.builder()
            .name("my-key-ring")
            .location("us-central1")
            .build());

        final var myCryptoKey = KmsFunctions.getKMSCryptoKey(GetKMSCryptoKeyArgs.builder()
            .name("my-crypto-key")
            .keyRing(myKeyRing.id())
            .build());

        final var myCryptoKeyLatestVersion = KmsFunctions.getCryptoKeyLatestVersion(GetCryptoKeyLatestVersionArgs.builder()
            .cryptoKey(myKey.id())
            .build());

    }
}
Copy
variables:
  myKeyRing:
    fn::invoke:
      function: gcp:kms:getKMSKeyRing
      arguments:
        name: my-key-ring
        location: us-central1
  myCryptoKey:
    fn::invoke:
      function: gcp:kms:getKMSCryptoKey
      arguments:
        name: my-crypto-key
        keyRing: ${myKeyRing.id}
  myCryptoKeyLatestVersion:
    fn::invoke:
      function: gcp:kms:getCryptoKeyLatestVersion
      arguments:
        cryptoKey: ${myKey.id}
Copy

Using getCryptoKeyLatestVersion

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 getCryptoKeyLatestVersion(args: GetCryptoKeyLatestVersionArgs, opts?: InvokeOptions): Promise<GetCryptoKeyLatestVersionResult>
function getCryptoKeyLatestVersionOutput(args: GetCryptoKeyLatestVersionOutputArgs, opts?: InvokeOptions): Output<GetCryptoKeyLatestVersionResult>
Copy
def get_crypto_key_latest_version(crypto_key: Optional[str] = None,
                                  filter: Optional[str] = None,
                                  opts: Optional[InvokeOptions] = None) -> GetCryptoKeyLatestVersionResult
def get_crypto_key_latest_version_output(crypto_key: Optional[pulumi.Input[str]] = None,
                                  filter: Optional[pulumi.Input[str]] = None,
                                  opts: Optional[InvokeOptions] = None) -> Output[GetCryptoKeyLatestVersionResult]
Copy
func GetCryptoKeyLatestVersion(ctx *Context, args *GetCryptoKeyLatestVersionArgs, opts ...InvokeOption) (*GetCryptoKeyLatestVersionResult, error)
func GetCryptoKeyLatestVersionOutput(ctx *Context, args *GetCryptoKeyLatestVersionOutputArgs, opts ...InvokeOption) GetCryptoKeyLatestVersionResultOutput
Copy

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

public static class GetCryptoKeyLatestVersion 
{
    public static Task<GetCryptoKeyLatestVersionResult> InvokeAsync(GetCryptoKeyLatestVersionArgs args, InvokeOptions? opts = null)
    public static Output<GetCryptoKeyLatestVersionResult> Invoke(GetCryptoKeyLatestVersionInvokeArgs args, InvokeOptions? opts = null)
}
Copy
public static CompletableFuture<GetCryptoKeyLatestVersionResult> getCryptoKeyLatestVersion(GetCryptoKeyLatestVersionArgs args, InvokeOptions options)
public static Output<GetCryptoKeyLatestVersionResult> getCryptoKeyLatestVersion(GetCryptoKeyLatestVersionArgs args, InvokeOptions options)
Copy
fn::invoke:
  function: gcp:kms/getCryptoKeyLatestVersion:getCryptoKeyLatestVersion
  arguments:
    # arguments dictionary
Copy

The following arguments are supported:

CryptoKey
This property is required.
Changes to this property will trigger replacement.
string
The id of the Google Cloud Platform CryptoKey to which the key version belongs. This is also the id field of the gcp.kms.CryptoKey resource/datasource.
Filter string

The filter argument is used to add a filter query parameter that limits which type of cryptoKeyVersion is retrieved as the latest by the data source: ?filter={{filter}}. When no value is provided there is no filtering.

Example filter values if filtering on state.

  • "state:ENABLED" will retrieve the latest cryptoKeyVersion that has the state "ENABLED".

See the documentation about using filters

CryptoKey
This property is required.
Changes to this property will trigger replacement.
string
The id of the Google Cloud Platform CryptoKey to which the key version belongs. This is also the id field of the gcp.kms.CryptoKey resource/datasource.
Filter string

The filter argument is used to add a filter query parameter that limits which type of cryptoKeyVersion is retrieved as the latest by the data source: ?filter={{filter}}. When no value is provided there is no filtering.

Example filter values if filtering on state.

  • "state:ENABLED" will retrieve the latest cryptoKeyVersion that has the state "ENABLED".

See the documentation about using filters

cryptoKey
This property is required.
Changes to this property will trigger replacement.
String
The id of the Google Cloud Platform CryptoKey to which the key version belongs. This is also the id field of the gcp.kms.CryptoKey resource/datasource.
filter String

The filter argument is used to add a filter query parameter that limits which type of cryptoKeyVersion is retrieved as the latest by the data source: ?filter={{filter}}. When no value is provided there is no filtering.

Example filter values if filtering on state.

  • "state:ENABLED" will retrieve the latest cryptoKeyVersion that has the state "ENABLED".

See the documentation about using filters

cryptoKey
This property is required.
Changes to this property will trigger replacement.
string
The id of the Google Cloud Platform CryptoKey to which the key version belongs. This is also the id field of the gcp.kms.CryptoKey resource/datasource.
filter string

The filter argument is used to add a filter query parameter that limits which type of cryptoKeyVersion is retrieved as the latest by the data source: ?filter={{filter}}. When no value is provided there is no filtering.

Example filter values if filtering on state.

  • "state:ENABLED" will retrieve the latest cryptoKeyVersion that has the state "ENABLED".

See the documentation about using filters

crypto_key
This property is required.
Changes to this property will trigger replacement.
str
The id of the Google Cloud Platform CryptoKey to which the key version belongs. This is also the id field of the gcp.kms.CryptoKey resource/datasource.
filter str

The filter argument is used to add a filter query parameter that limits which type of cryptoKeyVersion is retrieved as the latest by the data source: ?filter={{filter}}. When no value is provided there is no filtering.

Example filter values if filtering on state.

  • "state:ENABLED" will retrieve the latest cryptoKeyVersion that has the state "ENABLED".

See the documentation about using filters

cryptoKey
This property is required.
Changes to this property will trigger replacement.
String
The id of the Google Cloud Platform CryptoKey to which the key version belongs. This is also the id field of the gcp.kms.CryptoKey resource/datasource.
filter String

The filter argument is used to add a filter query parameter that limits which type of cryptoKeyVersion is retrieved as the latest by the data source: ?filter={{filter}}. When no value is provided there is no filtering.

Example filter values if filtering on state.

  • "state:ENABLED" will retrieve the latest cryptoKeyVersion that has the state "ENABLED".

See the documentation about using filters

getCryptoKeyLatestVersion Result

The following output properties are available:

Algorithm string
The CryptoKeyVersionAlgorithm that this CryptoKeyVersion supports.
CryptoKey string
Id string
The provider-assigned unique ID for this managed resource.
Name string
ProtectionLevel string
The ProtectionLevel describing how crypto operations are performed with this CryptoKeyVersion. See the protection_level reference for possible outputs.
PublicKeys List<GetCryptoKeyLatestVersionPublicKey>
If the enclosing CryptoKey has purpose ASYMMETRIC_SIGN or ASYMMETRIC_DECRYPT, this block contains details about the public key associated to this CryptoKeyVersion. Structure is documented below.
State string
The current state of the latest CryptoKeyVersion. See the state reference for possible outputs.
Version int
Filter string
Algorithm string
The CryptoKeyVersionAlgorithm that this CryptoKeyVersion supports.
CryptoKey string
Id string
The provider-assigned unique ID for this managed resource.
Name string
ProtectionLevel string
The ProtectionLevel describing how crypto operations are performed with this CryptoKeyVersion. See the protection_level reference for possible outputs.
PublicKeys []GetCryptoKeyLatestVersionPublicKey
If the enclosing CryptoKey has purpose ASYMMETRIC_SIGN or ASYMMETRIC_DECRYPT, this block contains details about the public key associated to this CryptoKeyVersion. Structure is documented below.
State string
The current state of the latest CryptoKeyVersion. See the state reference for possible outputs.
Version int
Filter string
algorithm String
The CryptoKeyVersionAlgorithm that this CryptoKeyVersion supports.
cryptoKey String
id String
The provider-assigned unique ID for this managed resource.
name String
protectionLevel String
The ProtectionLevel describing how crypto operations are performed with this CryptoKeyVersion. See the protection_level reference for possible outputs.
publicKeys List<GetCryptoKeyLatestVersionPublicKey>
If the enclosing CryptoKey has purpose ASYMMETRIC_SIGN or ASYMMETRIC_DECRYPT, this block contains details about the public key associated to this CryptoKeyVersion. Structure is documented below.
state String
The current state of the latest CryptoKeyVersion. See the state reference for possible outputs.
version Integer
filter String
algorithm string
The CryptoKeyVersionAlgorithm that this CryptoKeyVersion supports.
cryptoKey string
id string
The provider-assigned unique ID for this managed resource.
name string
protectionLevel string
The ProtectionLevel describing how crypto operations are performed with this CryptoKeyVersion. See the protection_level reference for possible outputs.
publicKeys GetCryptoKeyLatestVersionPublicKey[]
If the enclosing CryptoKey has purpose ASYMMETRIC_SIGN or ASYMMETRIC_DECRYPT, this block contains details about the public key associated to this CryptoKeyVersion. Structure is documented below.
state string
The current state of the latest CryptoKeyVersion. See the state reference for possible outputs.
version number
filter string
algorithm str
The CryptoKeyVersionAlgorithm that this CryptoKeyVersion supports.
crypto_key str
id str
The provider-assigned unique ID for this managed resource.
name str
protection_level str
The ProtectionLevel describing how crypto operations are performed with this CryptoKeyVersion. See the protection_level reference for possible outputs.
public_keys Sequence[GetCryptoKeyLatestVersionPublicKey]
If the enclosing CryptoKey has purpose ASYMMETRIC_SIGN or ASYMMETRIC_DECRYPT, this block contains details about the public key associated to this CryptoKeyVersion. Structure is documented below.
state str
The current state of the latest CryptoKeyVersion. See the state reference for possible outputs.
version int
filter str
algorithm String
The CryptoKeyVersionAlgorithm that this CryptoKeyVersion supports.
cryptoKey String
id String
The provider-assigned unique ID for this managed resource.
name String
protectionLevel String
The ProtectionLevel describing how crypto operations are performed with this CryptoKeyVersion. See the protection_level reference for possible outputs.
publicKeys List<Property Map>
If the enclosing CryptoKey has purpose ASYMMETRIC_SIGN or ASYMMETRIC_DECRYPT, this block contains details about the public key associated to this CryptoKeyVersion. Structure is documented below.
state String
The current state of the latest CryptoKeyVersion. See the state reference for possible outputs.
version Number
filter String

Supporting Types

GetCryptoKeyLatestVersionPublicKey

Algorithm This property is required. string
The CryptoKeyVersionAlgorithm that this CryptoKeyVersion supports.
Pem This property is required. string
The public key, encoded in PEM format. For more information, see the RFC 7468 sections for General Considerations and Textual Encoding of Subject Public Key Info.
Algorithm This property is required. string
The CryptoKeyVersionAlgorithm that this CryptoKeyVersion supports.
Pem This property is required. string
The public key, encoded in PEM format. For more information, see the RFC 7468 sections for General Considerations and Textual Encoding of Subject Public Key Info.
algorithm This property is required. String
The CryptoKeyVersionAlgorithm that this CryptoKeyVersion supports.
pem This property is required. String
The public key, encoded in PEM format. For more information, see the RFC 7468 sections for General Considerations and Textual Encoding of Subject Public Key Info.
algorithm This property is required. string
The CryptoKeyVersionAlgorithm that this CryptoKeyVersion supports.
pem This property is required. string
The public key, encoded in PEM format. For more information, see the RFC 7468 sections for General Considerations and Textual Encoding of Subject Public Key Info.
algorithm This property is required. str
The CryptoKeyVersionAlgorithm that this CryptoKeyVersion supports.
pem This property is required. str
The public key, encoded in PEM format. For more information, see the RFC 7468 sections for General Considerations and Textual Encoding of Subject Public Key Info.
algorithm This property is required. String
The CryptoKeyVersionAlgorithm that this CryptoKeyVersion supports.
pem This property is required. String
The public key, encoded in PEM format. For more information, see the RFC 7468 sections for General Considerations and Textual Encoding of Subject Public Key Info.

Package Details

Repository
Google Cloud (GCP) Classic pulumi/pulumi-gcp
License
Apache-2.0
Notes
This Pulumi package is based on the google-beta Terraform Provider.