aws.kms.ReplicaKey
Explore with Pulumi AI
Manages a KMS multi-Region replica key.
Example Usage
import * as pulumi from "@pulumi/pulumi";
import * as aws from "@pulumi/aws";
const primary = new aws.kms.Key("primary", {
description: "Multi-Region primary key",
deletionWindowInDays: 30,
multiRegion: true,
});
const replica = new aws.kms.ReplicaKey("replica", {
description: "Multi-Region replica key",
deletionWindowInDays: 7,
primaryKeyArn: primary.arn,
});
import pulumi
import pulumi_aws as aws
primary = aws.kms.Key("primary",
description="Multi-Region primary key",
deletion_window_in_days=30,
multi_region=True)
replica = aws.kms.ReplicaKey("replica",
description="Multi-Region replica key",
deletion_window_in_days=7,
primary_key_arn=primary.arn)
package main
import (
"github.com/pulumi/pulumi-aws/sdk/v6/go/aws/kms"
"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)
func main() {
pulumi.Run(func(ctx *pulumi.Context) error {
primary, err := kms.NewKey(ctx, "primary", &kms.KeyArgs{
Description: pulumi.String("Multi-Region primary key"),
DeletionWindowInDays: pulumi.Int(30),
MultiRegion: pulumi.Bool(true),
})
if err != nil {
return err
}
_, err = kms.NewReplicaKey(ctx, "replica", &kms.ReplicaKeyArgs{
Description: pulumi.String("Multi-Region replica key"),
DeletionWindowInDays: pulumi.Int(7),
PrimaryKeyArn: primary.Arn,
})
if err != nil {
return err
}
return nil
})
}
using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Aws = Pulumi.Aws;
return await Deployment.RunAsync(() =>
{
var primary = new Aws.Kms.Key("primary", new()
{
Description = "Multi-Region primary key",
DeletionWindowInDays = 30,
MultiRegion = true,
});
var replica = new Aws.Kms.ReplicaKey("replica", new()
{
Description = "Multi-Region replica key",
DeletionWindowInDays = 7,
PrimaryKeyArn = primary.Arn,
});
});
package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.aws.kms.Key;
import com.pulumi.aws.kms.KeyArgs;
import com.pulumi.aws.kms.ReplicaKey;
import com.pulumi.aws.kms.ReplicaKeyArgs;
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) {
var primary = new Key("primary", KeyArgs.builder()
.description("Multi-Region primary key")
.deletionWindowInDays(30)
.multiRegion(true)
.build());
var replica = new ReplicaKey("replica", ReplicaKeyArgs.builder()
.description("Multi-Region replica key")
.deletionWindowInDays(7)
.primaryKeyArn(primary.arn())
.build());
}
}
resources:
primary:
type: aws:kms:Key
properties:
description: Multi-Region primary key
deletionWindowInDays: 30
multiRegion: true
replica:
type: aws:kms:ReplicaKey
properties:
description: Multi-Region replica key
deletionWindowInDays: 7
primaryKeyArn: ${primary.arn}
Create ReplicaKey Resource
Resources are created with functions called constructors. To learn more about declaring and configuring resources, see Resources.
Constructor syntax
new ReplicaKey(name: string, args: ReplicaKeyArgs, opts?: CustomResourceOptions);
@overload
def ReplicaKey(resource_name: str,
args: ReplicaKeyArgs,
opts: Optional[ResourceOptions] = None)
@overload
def ReplicaKey(resource_name: str,
opts: Optional[ResourceOptions] = None,
primary_key_arn: Optional[str] = None,
bypass_policy_lockout_safety_check: Optional[bool] = None,
deletion_window_in_days: Optional[int] = None,
description: Optional[str] = None,
enabled: Optional[bool] = None,
policy: Optional[str] = None,
tags: Optional[Mapping[str, str]] = None)
func NewReplicaKey(ctx *Context, name string, args ReplicaKeyArgs, opts ...ResourceOption) (*ReplicaKey, error)
public ReplicaKey(string name, ReplicaKeyArgs args, CustomResourceOptions? opts = null)
public ReplicaKey(String name, ReplicaKeyArgs args)
public ReplicaKey(String name, ReplicaKeyArgs args, CustomResourceOptions options)
type: aws:kms:ReplicaKey
properties: # The arguments to resource properties.
options: # Bag of options to control resource's behavior.
Parameters
- name string
- The unique name of the resource.
- args ReplicaKeyArgs
- The arguments to resource properties.
- opts CustomResourceOptions
- Bag of options to control resource's behavior.
- resource_name str
- The unique name of the resource.
- args ReplicaKeyArgs
- The arguments to resource properties.
- opts ResourceOptions
- Bag of options to control resource's behavior.
- ctx Context
- Context object for the current deployment.
- name string
- The unique name of the resource.
- args ReplicaKeyArgs
- The arguments to resource properties.
- opts ResourceOption
- Bag of options to control resource's behavior.
- name string
- The unique name of the resource.
- args ReplicaKeyArgs
- The arguments to resource properties.
- opts CustomResourceOptions
- Bag of options to control resource's behavior.
- name String
- The unique name of the resource.
- args ReplicaKeyArgs
- The arguments to resource properties.
- options CustomResourceOptions
- Bag of options to control resource's behavior.
Constructor example
The following reference example uses placeholder values for all input properties.
var replicaKeyResource = new Aws.Kms.ReplicaKey("replicaKeyResource", new()
{
PrimaryKeyArn = "string",
BypassPolicyLockoutSafetyCheck = false,
DeletionWindowInDays = 0,
Description = "string",
Enabled = false,
Policy = "string",
Tags =
{
{ "string", "string" },
},
});
example, err := kms.NewReplicaKey(ctx, "replicaKeyResource", &kms.ReplicaKeyArgs{
PrimaryKeyArn: pulumi.String("string"),
BypassPolicyLockoutSafetyCheck: pulumi.Bool(false),
DeletionWindowInDays: pulumi.Int(0),
Description: pulumi.String("string"),
Enabled: pulumi.Bool(false),
Policy: pulumi.String("string"),
Tags: pulumi.StringMap{
"string": pulumi.String("string"),
},
})
var replicaKeyResource = new ReplicaKey("replicaKeyResource", ReplicaKeyArgs.builder()
.primaryKeyArn("string")
.bypassPolicyLockoutSafetyCheck(false)
.deletionWindowInDays(0)
.description("string")
.enabled(false)
.policy("string")
.tags(Map.of("string", "string"))
.build());
replica_key_resource = aws.kms.ReplicaKey("replicaKeyResource",
primary_key_arn="string",
bypass_policy_lockout_safety_check=False,
deletion_window_in_days=0,
description="string",
enabled=False,
policy="string",
tags={
"string": "string",
})
const replicaKeyResource = new aws.kms.ReplicaKey("replicaKeyResource", {
primaryKeyArn: "string",
bypassPolicyLockoutSafetyCheck: false,
deletionWindowInDays: 0,
description: "string",
enabled: false,
policy: "string",
tags: {
string: "string",
},
});
type: aws:kms:ReplicaKey
properties:
bypassPolicyLockoutSafetyCheck: false
deletionWindowInDays: 0
description: string
enabled: false
policy: string
primaryKeyArn: string
tags:
string: string
ReplicaKey Resource Properties
To learn more about resource properties and how to use them, see Inputs and Outputs in the Architecture and Concepts docs.
Inputs
The ReplicaKey resource accepts the following input properties:
- Primary
Key stringArn - The ARN of the multi-Region primary key to replicate. The primary key must be in a different AWS Region of the same AWS Partition. You can create only one replica of a given primary key in each AWS Region.
- Bypass
Policy boolLockout Safety Check - A flag to indicate whether to bypass the key policy lockout safety check.
Setting this value to true increases the risk that the KMS key becomes unmanageable. Do not set this value to true indiscriminately.
For more information, refer to the scenario in the Default Key Policy section in the AWS Key Management Service Developer Guide.
The default value is
false
. - Deletion
Window intIn Days - The waiting period, specified in number of days. After the waiting period ends, AWS KMS deletes the KMS key.
If you specify a value, it must be between
7
and30
, inclusive. If you do not specify a value, it defaults to30
. - Description string
- A description of the KMS key.
- Enabled bool
- Specifies whether the replica key is enabled. Disabled KMS keys cannot be used in cryptographic operations. The default value is
true
. - Policy string
- The key policy to attach to the KMS key. If you do not specify a key policy, AWS KMS attaches the default key policy to the KMS key.
- Dictionary<string, string>
- A map of tags to assign to the replica key. If configured with a provider
default_tags
configuration block present, tags with matching keys will overwrite those defined at the provider-level.
- Primary
Key stringArn - The ARN of the multi-Region primary key to replicate. The primary key must be in a different AWS Region of the same AWS Partition. You can create only one replica of a given primary key in each AWS Region.
- Bypass
Policy boolLockout Safety Check - A flag to indicate whether to bypass the key policy lockout safety check.
Setting this value to true increases the risk that the KMS key becomes unmanageable. Do not set this value to true indiscriminately.
For more information, refer to the scenario in the Default Key Policy section in the AWS Key Management Service Developer Guide.
The default value is
false
. - Deletion
Window intIn Days - The waiting period, specified in number of days. After the waiting period ends, AWS KMS deletes the KMS key.
If you specify a value, it must be between
7
and30
, inclusive. If you do not specify a value, it defaults to30
. - Description string
- A description of the KMS key.
- Enabled bool
- Specifies whether the replica key is enabled. Disabled KMS keys cannot be used in cryptographic operations. The default value is
true
. - Policy string
- The key policy to attach to the KMS key. If you do not specify a key policy, AWS KMS attaches the default key policy to the KMS key.
- map[string]string
- A map of tags to assign to the replica key. If configured with a provider
default_tags
configuration block present, tags with matching keys will overwrite those defined at the provider-level.
- primary
Key StringArn - The ARN of the multi-Region primary key to replicate. The primary key must be in a different AWS Region of the same AWS Partition. You can create only one replica of a given primary key in each AWS Region.
- bypass
Policy BooleanLockout Safety Check - A flag to indicate whether to bypass the key policy lockout safety check.
Setting this value to true increases the risk that the KMS key becomes unmanageable. Do not set this value to true indiscriminately.
For more information, refer to the scenario in the Default Key Policy section in the AWS Key Management Service Developer Guide.
The default value is
false
. - deletion
Window IntegerIn Days - The waiting period, specified in number of days. After the waiting period ends, AWS KMS deletes the KMS key.
If you specify a value, it must be between
7
and30
, inclusive. If you do not specify a value, it defaults to30
. - description String
- A description of the KMS key.
- enabled Boolean
- Specifies whether the replica key is enabled. Disabled KMS keys cannot be used in cryptographic operations. The default value is
true
. - policy String
- The key policy to attach to the KMS key. If you do not specify a key policy, AWS KMS attaches the default key policy to the KMS key.
- Map<String,String>
- A map of tags to assign to the replica key. If configured with a provider
default_tags
configuration block present, tags with matching keys will overwrite those defined at the provider-level.
- primary
Key stringArn - The ARN of the multi-Region primary key to replicate. The primary key must be in a different AWS Region of the same AWS Partition. You can create only one replica of a given primary key in each AWS Region.
- bypass
Policy booleanLockout Safety Check - A flag to indicate whether to bypass the key policy lockout safety check.
Setting this value to true increases the risk that the KMS key becomes unmanageable. Do not set this value to true indiscriminately.
For more information, refer to the scenario in the Default Key Policy section in the AWS Key Management Service Developer Guide.
The default value is
false
. - deletion
Window numberIn Days - The waiting period, specified in number of days. After the waiting period ends, AWS KMS deletes the KMS key.
If you specify a value, it must be between
7
and30
, inclusive. If you do not specify a value, it defaults to30
. - description string
- A description of the KMS key.
- enabled boolean
- Specifies whether the replica key is enabled. Disabled KMS keys cannot be used in cryptographic operations. The default value is
true
. - policy string
- The key policy to attach to the KMS key. If you do not specify a key policy, AWS KMS attaches the default key policy to the KMS key.
- {[key: string]: string}
- A map of tags to assign to the replica key. If configured with a provider
default_tags
configuration block present, tags with matching keys will overwrite those defined at the provider-level.
- primary_
key_ strarn - The ARN of the multi-Region primary key to replicate. The primary key must be in a different AWS Region of the same AWS Partition. You can create only one replica of a given primary key in each AWS Region.
- bypass_
policy_ boollockout_ safety_ check - A flag to indicate whether to bypass the key policy lockout safety check.
Setting this value to true increases the risk that the KMS key becomes unmanageable. Do not set this value to true indiscriminately.
For more information, refer to the scenario in the Default Key Policy section in the AWS Key Management Service Developer Guide.
The default value is
false
. - deletion_
window_ intin_ days - The waiting period, specified in number of days. After the waiting period ends, AWS KMS deletes the KMS key.
If you specify a value, it must be between
7
and30
, inclusive. If you do not specify a value, it defaults to30
. - description str
- A description of the KMS key.
- enabled bool
- Specifies whether the replica key is enabled. Disabled KMS keys cannot be used in cryptographic operations. The default value is
true
. - policy str
- The key policy to attach to the KMS key. If you do not specify a key policy, AWS KMS attaches the default key policy to the KMS key.
- Mapping[str, str]
- A map of tags to assign to the replica key. If configured with a provider
default_tags
configuration block present, tags with matching keys will overwrite those defined at the provider-level.
- primary
Key StringArn - The ARN of the multi-Region primary key to replicate. The primary key must be in a different AWS Region of the same AWS Partition. You can create only one replica of a given primary key in each AWS Region.
- bypass
Policy BooleanLockout Safety Check - A flag to indicate whether to bypass the key policy lockout safety check.
Setting this value to true increases the risk that the KMS key becomes unmanageable. Do not set this value to true indiscriminately.
For more information, refer to the scenario in the Default Key Policy section in the AWS Key Management Service Developer Guide.
The default value is
false
. - deletion
Window NumberIn Days - The waiting period, specified in number of days. After the waiting period ends, AWS KMS deletes the KMS key.
If you specify a value, it must be between
7
and30
, inclusive. If you do not specify a value, it defaults to30
. - description String
- A description of the KMS key.
- enabled Boolean
- Specifies whether the replica key is enabled. Disabled KMS keys cannot be used in cryptographic operations. The default value is
true
. - policy String
- The key policy to attach to the KMS key. If you do not specify a key policy, AWS KMS attaches the default key policy to the KMS key.
- Map<String>
- A map of tags to assign to the replica key. If configured with a provider
default_tags
configuration block present, tags with matching keys will overwrite those defined at the provider-level.
Outputs
All input properties are implicitly available as output properties. Additionally, the ReplicaKey resource produces the following output properties:
- Arn string
- The Amazon Resource Name (ARN) of the replica key. The key ARNs of related multi-Region keys differ only in the Region value.
- Id string
- The provider-assigned unique ID for this managed resource.
- Key
Id string - The key ID of the replica key. Related multi-Region keys have the same key ID.
- Key
Rotation boolEnabled - A Boolean value that specifies whether key rotation is enabled. This is a shared property of multi-Region keys.
- Key
Spec string - The type of key material in the KMS key. This is a shared property of multi-Region keys.
- Key
Usage string - The cryptographic operations for which you can use the KMS key. This is a shared property of multi-Region keys.
- Dictionary<string, string>
- A map of tags assigned to the resource, including those inherited from the provider
default_tags
configuration block.
- Arn string
- The Amazon Resource Name (ARN) of the replica key. The key ARNs of related multi-Region keys differ only in the Region value.
- Id string
- The provider-assigned unique ID for this managed resource.
- Key
Id string - The key ID of the replica key. Related multi-Region keys have the same key ID.
- Key
Rotation boolEnabled - A Boolean value that specifies whether key rotation is enabled. This is a shared property of multi-Region keys.
- Key
Spec string - The type of key material in the KMS key. This is a shared property of multi-Region keys.
- Key
Usage string - The cryptographic operations for which you can use the KMS key. This is a shared property of multi-Region keys.
- map[string]string
- A map of tags assigned to the resource, including those inherited from the provider
default_tags
configuration block.
- arn String
- The Amazon Resource Name (ARN) of the replica key. The key ARNs of related multi-Region keys differ only in the Region value.
- id String
- The provider-assigned unique ID for this managed resource.
- key
Id String - The key ID of the replica key. Related multi-Region keys have the same key ID.
- key
Rotation BooleanEnabled - A Boolean value that specifies whether key rotation is enabled. This is a shared property of multi-Region keys.
- key
Spec String - The type of key material in the KMS key. This is a shared property of multi-Region keys.
- key
Usage String - The cryptographic operations for which you can use the KMS key. This is a shared property of multi-Region keys.
- Map<String,String>
- A map of tags assigned to the resource, including those inherited from the provider
default_tags
configuration block.
- arn string
- The Amazon Resource Name (ARN) of the replica key. The key ARNs of related multi-Region keys differ only in the Region value.
- id string
- The provider-assigned unique ID for this managed resource.
- key
Id string - The key ID of the replica key. Related multi-Region keys have the same key ID.
- key
Rotation booleanEnabled - A Boolean value that specifies whether key rotation is enabled. This is a shared property of multi-Region keys.
- key
Spec string - The type of key material in the KMS key. This is a shared property of multi-Region keys.
- key
Usage string - The cryptographic operations for which you can use the KMS key. This is a shared property of multi-Region keys.
- {[key: string]: string}
- A map of tags assigned to the resource, including those inherited from the provider
default_tags
configuration block.
- arn str
- The Amazon Resource Name (ARN) of the replica key. The key ARNs of related multi-Region keys differ only in the Region value.
- id str
- The provider-assigned unique ID for this managed resource.
- key_
id str - The key ID of the replica key. Related multi-Region keys have the same key ID.
- key_
rotation_ boolenabled - A Boolean value that specifies whether key rotation is enabled. This is a shared property of multi-Region keys.
- key_
spec str - The type of key material in the KMS key. This is a shared property of multi-Region keys.
- key_
usage str - The cryptographic operations for which you can use the KMS key. This is a shared property of multi-Region keys.
- Mapping[str, str]
- A map of tags assigned to the resource, including those inherited from the provider
default_tags
configuration block.
- arn String
- The Amazon Resource Name (ARN) of the replica key. The key ARNs of related multi-Region keys differ only in the Region value.
- id String
- The provider-assigned unique ID for this managed resource.
- key
Id String - The key ID of the replica key. Related multi-Region keys have the same key ID.
- key
Rotation BooleanEnabled - A Boolean value that specifies whether key rotation is enabled. This is a shared property of multi-Region keys.
- key
Spec String - The type of key material in the KMS key. This is a shared property of multi-Region keys.
- key
Usage String - The cryptographic operations for which you can use the KMS key. This is a shared property of multi-Region keys.
- Map<String>
- A map of tags assigned to the resource, including those inherited from the provider
default_tags
configuration block.
Look up Existing ReplicaKey Resource
Get an existing ReplicaKey resource’s state with the given name, ID, and optional extra properties used to qualify the lookup.
public static get(name: string, id: Input<ID>, state?: ReplicaKeyState, opts?: CustomResourceOptions): ReplicaKey
@staticmethod
def get(resource_name: str,
id: str,
opts: Optional[ResourceOptions] = None,
arn: Optional[str] = None,
bypass_policy_lockout_safety_check: Optional[bool] = None,
deletion_window_in_days: Optional[int] = None,
description: Optional[str] = None,
enabled: Optional[bool] = None,
key_id: Optional[str] = None,
key_rotation_enabled: Optional[bool] = None,
key_spec: Optional[str] = None,
key_usage: Optional[str] = None,
policy: Optional[str] = None,
primary_key_arn: Optional[str] = None,
tags: Optional[Mapping[str, str]] = None,
tags_all: Optional[Mapping[str, str]] = None) -> ReplicaKey
func GetReplicaKey(ctx *Context, name string, id IDInput, state *ReplicaKeyState, opts ...ResourceOption) (*ReplicaKey, error)
public static ReplicaKey Get(string name, Input<string> id, ReplicaKeyState? state, CustomResourceOptions? opts = null)
public static ReplicaKey get(String name, Output<String> id, ReplicaKeyState state, CustomResourceOptions options)
Resource lookup is not supported in YAML
- name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- state
- Any extra arguments used during the lookup.
- opts
- A bag of options that control this resource's behavior.
- resource_name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- state
- Any extra arguments used during the lookup.
- opts
- A bag of options that control this resource's behavior.
- name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- state
- Any extra arguments used during the lookup.
- opts
- A bag of options that control this resource's behavior.
- name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- state
- Any extra arguments used during the lookup.
- opts
- A bag of options that control this resource's behavior.
- Arn string
- The Amazon Resource Name (ARN) of the replica key. The key ARNs of related multi-Region keys differ only in the Region value.
- Bypass
Policy boolLockout Safety Check - A flag to indicate whether to bypass the key policy lockout safety check.
Setting this value to true increases the risk that the KMS key becomes unmanageable. Do not set this value to true indiscriminately.
For more information, refer to the scenario in the Default Key Policy section in the AWS Key Management Service Developer Guide.
The default value is
false
. - Deletion
Window intIn Days - The waiting period, specified in number of days. After the waiting period ends, AWS KMS deletes the KMS key.
If you specify a value, it must be between
7
and30
, inclusive. If you do not specify a value, it defaults to30
. - Description string
- A description of the KMS key.
- Enabled bool
- Specifies whether the replica key is enabled. Disabled KMS keys cannot be used in cryptographic operations. The default value is
true
. - Key
Id string - The key ID of the replica key. Related multi-Region keys have the same key ID.
- Key
Rotation boolEnabled - A Boolean value that specifies whether key rotation is enabled. This is a shared property of multi-Region keys.
- Key
Spec string - The type of key material in the KMS key. This is a shared property of multi-Region keys.
- Key
Usage string - The cryptographic operations for which you can use the KMS key. This is a shared property of multi-Region keys.
- Policy string
- The key policy to attach to the KMS key. If you do not specify a key policy, AWS KMS attaches the default key policy to the KMS key.
- Primary
Key stringArn - The ARN of the multi-Region primary key to replicate. The primary key must be in a different AWS Region of the same AWS Partition. You can create only one replica of a given primary key in each AWS Region.
- Dictionary<string, string>
- A map of tags to assign to the replica key. If configured with a provider
default_tags
configuration block present, tags with matching keys will overwrite those defined at the provider-level. - Dictionary<string, string>
- A map of tags assigned to the resource, including those inherited from the provider
default_tags
configuration block.
- Arn string
- The Amazon Resource Name (ARN) of the replica key. The key ARNs of related multi-Region keys differ only in the Region value.
- Bypass
Policy boolLockout Safety Check - A flag to indicate whether to bypass the key policy lockout safety check.
Setting this value to true increases the risk that the KMS key becomes unmanageable. Do not set this value to true indiscriminately.
For more information, refer to the scenario in the Default Key Policy section in the AWS Key Management Service Developer Guide.
The default value is
false
. - Deletion
Window intIn Days - The waiting period, specified in number of days. After the waiting period ends, AWS KMS deletes the KMS key.
If you specify a value, it must be between
7
and30
, inclusive. If you do not specify a value, it defaults to30
. - Description string
- A description of the KMS key.
- Enabled bool
- Specifies whether the replica key is enabled. Disabled KMS keys cannot be used in cryptographic operations. The default value is
true
. - Key
Id string - The key ID of the replica key. Related multi-Region keys have the same key ID.
- Key
Rotation boolEnabled - A Boolean value that specifies whether key rotation is enabled. This is a shared property of multi-Region keys.
- Key
Spec string - The type of key material in the KMS key. This is a shared property of multi-Region keys.
- Key
Usage string - The cryptographic operations for which you can use the KMS key. This is a shared property of multi-Region keys.
- Policy string
- The key policy to attach to the KMS key. If you do not specify a key policy, AWS KMS attaches the default key policy to the KMS key.
- Primary
Key stringArn - The ARN of the multi-Region primary key to replicate. The primary key must be in a different AWS Region of the same AWS Partition. You can create only one replica of a given primary key in each AWS Region.
- map[string]string
- A map of tags to assign to the replica key. If configured with a provider
default_tags
configuration block present, tags with matching keys will overwrite those defined at the provider-level. - map[string]string
- A map of tags assigned to the resource, including those inherited from the provider
default_tags
configuration block.
- arn String
- The Amazon Resource Name (ARN) of the replica key. The key ARNs of related multi-Region keys differ only in the Region value.
- bypass
Policy BooleanLockout Safety Check - A flag to indicate whether to bypass the key policy lockout safety check.
Setting this value to true increases the risk that the KMS key becomes unmanageable. Do not set this value to true indiscriminately.
For more information, refer to the scenario in the Default Key Policy section in the AWS Key Management Service Developer Guide.
The default value is
false
. - deletion
Window IntegerIn Days - The waiting period, specified in number of days. After the waiting period ends, AWS KMS deletes the KMS key.
If you specify a value, it must be between
7
and30
, inclusive. If you do not specify a value, it defaults to30
. - description String
- A description of the KMS key.
- enabled Boolean
- Specifies whether the replica key is enabled. Disabled KMS keys cannot be used in cryptographic operations. The default value is
true
. - key
Id String - The key ID of the replica key. Related multi-Region keys have the same key ID.
- key
Rotation BooleanEnabled - A Boolean value that specifies whether key rotation is enabled. This is a shared property of multi-Region keys.
- key
Spec String - The type of key material in the KMS key. This is a shared property of multi-Region keys.
- key
Usage String - The cryptographic operations for which you can use the KMS key. This is a shared property of multi-Region keys.
- policy String
- The key policy to attach to the KMS key. If you do not specify a key policy, AWS KMS attaches the default key policy to the KMS key.
- primary
Key StringArn - The ARN of the multi-Region primary key to replicate. The primary key must be in a different AWS Region of the same AWS Partition. You can create only one replica of a given primary key in each AWS Region.
- Map<String,String>
- A map of tags to assign to the replica key. If configured with a provider
default_tags
configuration block present, tags with matching keys will overwrite those defined at the provider-level. - Map<String,String>
- A map of tags assigned to the resource, including those inherited from the provider
default_tags
configuration block.
- arn string
- The Amazon Resource Name (ARN) of the replica key. The key ARNs of related multi-Region keys differ only in the Region value.
- bypass
Policy booleanLockout Safety Check - A flag to indicate whether to bypass the key policy lockout safety check.
Setting this value to true increases the risk that the KMS key becomes unmanageable. Do not set this value to true indiscriminately.
For more information, refer to the scenario in the Default Key Policy section in the AWS Key Management Service Developer Guide.
The default value is
false
. - deletion
Window numberIn Days - The waiting period, specified in number of days. After the waiting period ends, AWS KMS deletes the KMS key.
If you specify a value, it must be between
7
and30
, inclusive. If you do not specify a value, it defaults to30
. - description string
- A description of the KMS key.
- enabled boolean
- Specifies whether the replica key is enabled. Disabled KMS keys cannot be used in cryptographic operations. The default value is
true
. - key
Id string - The key ID of the replica key. Related multi-Region keys have the same key ID.
- key
Rotation booleanEnabled - A Boolean value that specifies whether key rotation is enabled. This is a shared property of multi-Region keys.
- key
Spec string - The type of key material in the KMS key. This is a shared property of multi-Region keys.
- key
Usage string - The cryptographic operations for which you can use the KMS key. This is a shared property of multi-Region keys.
- policy string
- The key policy to attach to the KMS key. If you do not specify a key policy, AWS KMS attaches the default key policy to the KMS key.
- primary
Key stringArn - The ARN of the multi-Region primary key to replicate. The primary key must be in a different AWS Region of the same AWS Partition. You can create only one replica of a given primary key in each AWS Region.
- {[key: string]: string}
- A map of tags to assign to the replica key. If configured with a provider
default_tags
configuration block present, tags with matching keys will overwrite those defined at the provider-level. - {[key: string]: string}
- A map of tags assigned to the resource, including those inherited from the provider
default_tags
configuration block.
- arn str
- The Amazon Resource Name (ARN) of the replica key. The key ARNs of related multi-Region keys differ only in the Region value.
- bypass_
policy_ boollockout_ safety_ check - A flag to indicate whether to bypass the key policy lockout safety check.
Setting this value to true increases the risk that the KMS key becomes unmanageable. Do not set this value to true indiscriminately.
For more information, refer to the scenario in the Default Key Policy section in the AWS Key Management Service Developer Guide.
The default value is
false
. - deletion_
window_ intin_ days - The waiting period, specified in number of days. After the waiting period ends, AWS KMS deletes the KMS key.
If you specify a value, it must be between
7
and30
, inclusive. If you do not specify a value, it defaults to30
. - description str
- A description of the KMS key.
- enabled bool
- Specifies whether the replica key is enabled. Disabled KMS keys cannot be used in cryptographic operations. The default value is
true
. - key_
id str - The key ID of the replica key. Related multi-Region keys have the same key ID.
- key_
rotation_ boolenabled - A Boolean value that specifies whether key rotation is enabled. This is a shared property of multi-Region keys.
- key_
spec str - The type of key material in the KMS key. This is a shared property of multi-Region keys.
- key_
usage str - The cryptographic operations for which you can use the KMS key. This is a shared property of multi-Region keys.
- policy str
- The key policy to attach to the KMS key. If you do not specify a key policy, AWS KMS attaches the default key policy to the KMS key.
- primary_
key_ strarn - The ARN of the multi-Region primary key to replicate. The primary key must be in a different AWS Region of the same AWS Partition. You can create only one replica of a given primary key in each AWS Region.
- Mapping[str, str]
- A map of tags to assign to the replica key. If configured with a provider
default_tags
configuration block present, tags with matching keys will overwrite those defined at the provider-level. - Mapping[str, str]
- A map of tags assigned to the resource, including those inherited from the provider
default_tags
configuration block.
- arn String
- The Amazon Resource Name (ARN) of the replica key. The key ARNs of related multi-Region keys differ only in the Region value.
- bypass
Policy BooleanLockout Safety Check - A flag to indicate whether to bypass the key policy lockout safety check.
Setting this value to true increases the risk that the KMS key becomes unmanageable. Do not set this value to true indiscriminately.
For more information, refer to the scenario in the Default Key Policy section in the AWS Key Management Service Developer Guide.
The default value is
false
. - deletion
Window NumberIn Days - The waiting period, specified in number of days. After the waiting period ends, AWS KMS deletes the KMS key.
If you specify a value, it must be between
7
and30
, inclusive. If you do not specify a value, it defaults to30
. - description String
- A description of the KMS key.
- enabled Boolean
- Specifies whether the replica key is enabled. Disabled KMS keys cannot be used in cryptographic operations. The default value is
true
. - key
Id String - The key ID of the replica key. Related multi-Region keys have the same key ID.
- key
Rotation BooleanEnabled - A Boolean value that specifies whether key rotation is enabled. This is a shared property of multi-Region keys.
- key
Spec String - The type of key material in the KMS key. This is a shared property of multi-Region keys.
- key
Usage String - The cryptographic operations for which you can use the KMS key. This is a shared property of multi-Region keys.
- policy String
- The key policy to attach to the KMS key. If you do not specify a key policy, AWS KMS attaches the default key policy to the KMS key.
- primary
Key StringArn - The ARN of the multi-Region primary key to replicate. The primary key must be in a different AWS Region of the same AWS Partition. You can create only one replica of a given primary key in each AWS Region.
- Map<String>
- A map of tags to assign to the replica key. If configured with a provider
default_tags
configuration block present, tags with matching keys will overwrite those defined at the provider-level. - Map<String>
- A map of tags assigned to the resource, including those inherited from the provider
default_tags
configuration block.
Import
Using pulumi import
, import KMS multi-Region replica keys using the id
. For example:
$ pulumi import aws:kms/replicaKey:ReplicaKey example 1234abcd-12ab-34cd-56ef-1234567890ab
To learn more about importing existing cloud resources, see Importing resources.
Package Details
- Repository
- AWS Classic pulumi/pulumi-aws
- License
- Apache-2.0
- Notes
- This Pulumi package is based on the
aws
Terraform Provider.