import * as pulumi from "@pulumi/pulumi"; import * as inputs from "../types/input"; import * as outputs from "../types/output"; /** * This resource provides the Key Version resource in Oracle Cloud Infrastructure Kms service. * Api doc link for the resource: https://docs.oracle.com/iaas/api/#/en/key/latest/KeyVersion * * Example terraform configs related to the resource : https://github.com/oracle/terraform-provider-oci/tree/master/examples/kms * * Generates a new [KeyVersion](https://docs.cloud.oracle.com/iaas/api/#/en/key/latest/KeyVersion/) resource that provides new cryptographic * material for a master encryption key. The key must be in an `ENABLED` state to be rotated. * * As a management operation, this call is subject to a Key Management limit that applies to the total number * of requests across all management write operations. Key Management might throttle this call to reject an * otherwise valid request when the total rate of management write operations exceeds 10 requests per second * for a given tenancy. * * ## Import * * KeyVersions can be imported using the `id`, e.g. * * ```sh * $ pulumi import oci:Kms/keyVersion:KeyVersion test_key_version "managementEndpoint/{managementEndpoint}/keys/{keyId}/keyVersions/{keyVersionId}" * ``` */ export declare class KeyVersion extends pulumi.CustomResource { /** * Get an existing KeyVersion resource's state with the given name, ID, and optional extra * properties used to qualify the lookup. * * @param name The _unique_ name of the resulting resource. * @param id The _unique_ provider ID of the resource to lookup. * @param state Any extra arguments used during the lookup. * @param opts Optional settings to control the behavior of the CustomResource. */ static get(name: string, id: pulumi.Input, state?: KeyVersionState, opts?: pulumi.CustomResourceOptions): KeyVersion; /** * Returns true if the given object is an instance of KeyVersion. This is designed to work even * when multiple copies of the Pulumi SDK have been loaded into the same process. */ static isInstance(obj: any): obj is KeyVersion; /** * The OCID of the compartment that contains this key version. */ readonly compartmentId: pulumi.Output; /** * Key reference data to be returned to the customer as a response. */ readonly externalKeyReferenceDetails: pulumi.Output; /** * Key version ID associated with the external key. */ readonly externalKeyVersionId: pulumi.Output; /** * An optional property indicating whether this keyversion is generated from auto rotatation. */ readonly isAutoRotated: pulumi.Output; /** * A Boolean value that indicates whether the KeyVersion belongs to primary Vault or replica Vault. */ readonly isPrimary: pulumi.Output; /** * The OCID of the key. */ readonly keyId: pulumi.Output; readonly keyVersionId: pulumi.Output; /** * The service endpoint to perform management operations against. Management operations include 'Create,' 'Update,' 'List,' 'Get,' and 'Delete' operations. See Vault Management endpoint. */ readonly managementEndpoint: pulumi.Output; /** * The public key in PEM format. (This value pertains only to RSA and ECDSA keys.) */ readonly publicKey: pulumi.Output; /** * KeyVersion replica details */ readonly replicaDetails: pulumi.Output; readonly restoredFromKeyId: pulumi.Output; /** * The OCID of the key version from which this key version was restored. */ readonly restoredFromKeyVersionId: pulumi.Output; /** * The key version's current lifecycle state. Example: `ENABLED` */ readonly state: pulumi.Output; /** * The date and time this key version was created, expressed in [RFC 3339](https://tools.ietf.org/html/rfc3339) timestamp format. Example: "2018-04-03T21:10:29.600Z" */ readonly timeCreated: pulumi.Output; /** * (Updatable) An optional property for the deletion time of the key version, expressed in [RFC 3339](https://tools.ietf.org/html/rfc3339) timestamp format. Example: `2019-04-03T21:10:29.600Z` * * ** IMPORTANT ** * Any change to a property that does not support update will force the destruction and recreation of the resource with the new property values */ readonly timeOfDeletion: pulumi.Output; /** * The OCID of the vault that contains this key version. */ readonly vaultId: pulumi.Output; /** * Create a KeyVersion resource with the given unique name, arguments, and options. * * @param name The _unique_ name of the resource. * @param args The arguments to use to populate this resource's properties. * @param opts A bag of options that control this resource's behavior. */ constructor(name: string, args: KeyVersionArgs, opts?: pulumi.CustomResourceOptions); } /** * Input properties used for looking up and filtering KeyVersion resources. */ export interface KeyVersionState { /** * The OCID of the compartment that contains this key version. */ compartmentId?: pulumi.Input; /** * Key reference data to be returned to the customer as a response. */ externalKeyReferenceDetails?: pulumi.Input[] | undefined>; /** * Key version ID associated with the external key. */ externalKeyVersionId?: pulumi.Input; /** * An optional property indicating whether this keyversion is generated from auto rotatation. */ isAutoRotated?: pulumi.Input; /** * A Boolean value that indicates whether the KeyVersion belongs to primary Vault or replica Vault. */ isPrimary?: pulumi.Input; /** * The OCID of the key. */ keyId?: pulumi.Input; keyVersionId?: pulumi.Input; /** * The service endpoint to perform management operations against. Management operations include 'Create,' 'Update,' 'List,' 'Get,' and 'Delete' operations. See Vault Management endpoint. */ managementEndpoint?: pulumi.Input; /** * The public key in PEM format. (This value pertains only to RSA and ECDSA keys.) */ publicKey?: pulumi.Input; /** * KeyVersion replica details */ replicaDetails?: pulumi.Input[] | undefined>; restoredFromKeyId?: pulumi.Input; /** * The OCID of the key version from which this key version was restored. */ restoredFromKeyVersionId?: pulumi.Input; /** * The key version's current lifecycle state. Example: `ENABLED` */ state?: pulumi.Input; /** * The date and time this key version was created, expressed in [RFC 3339](https://tools.ietf.org/html/rfc3339) timestamp format. Example: "2018-04-03T21:10:29.600Z" */ timeCreated?: pulumi.Input; /** * (Updatable) An optional property for the deletion time of the key version, expressed in [RFC 3339](https://tools.ietf.org/html/rfc3339) timestamp format. Example: `2019-04-03T21:10:29.600Z` * * ** IMPORTANT ** * Any change to a property that does not support update will force the destruction and recreation of the resource with the new property values */ timeOfDeletion?: pulumi.Input; /** * The OCID of the vault that contains this key version. */ vaultId?: pulumi.Input; } /** * The set of arguments for constructing a KeyVersion resource. */ export interface KeyVersionArgs { /** * Key version ID associated with the external key. */ externalKeyVersionId?: pulumi.Input; /** * The OCID of the key. */ keyId: pulumi.Input; /** * The service endpoint to perform management operations against. Management operations include 'Create,' 'Update,' 'List,' 'Get,' and 'Delete' operations. See Vault Management endpoint. */ managementEndpoint: pulumi.Input; /** * (Updatable) An optional property for the deletion time of the key version, expressed in [RFC 3339](https://tools.ietf.org/html/rfc3339) timestamp format. Example: `2019-04-03T21:10:29.600Z` * * ** IMPORTANT ** * Any change to a property that does not support update will force the destruction and recreation of the resource with the new property values */ timeOfDeletion?: pulumi.Input; } //# sourceMappingURL=keyVersion.d.ts.map