Documentation ¶
Index ¶
- type DefaultKmsKey
- type DefaultKmsKeyArgs
- type DefaultKmsKeyState
- type EncryptionByDefault
- type EncryptionByDefaultArgs
- type EncryptionByDefaultState
- type GetEbsVolumesArgs
- type GetEbsVolumesFilter
- type GetEbsVolumesFilterArgs
- type GetEbsVolumesFilterArray
- type GetEbsVolumesFilterArrayInput
- type GetEbsVolumesFilterArrayOutput
- func (GetEbsVolumesFilterArrayOutput) ElementType() reflect.Type
- func (o GetEbsVolumesFilterArrayOutput) Index(i pulumi.IntInput) GetEbsVolumesFilterOutput
- func (o GetEbsVolumesFilterArrayOutput) ToGetEbsVolumesFilterArrayOutput() GetEbsVolumesFilterArrayOutput
- func (o GetEbsVolumesFilterArrayOutput) ToGetEbsVolumesFilterArrayOutputWithContext(ctx context.Context) GetEbsVolumesFilterArrayOutput
- type GetEbsVolumesFilterInput
- type GetEbsVolumesFilterOutput
- func (GetEbsVolumesFilterOutput) ElementType() reflect.Type
- func (o GetEbsVolumesFilterOutput) Name() pulumi.StringOutput
- func (o GetEbsVolumesFilterOutput) ToGetEbsVolumesFilterOutput() GetEbsVolumesFilterOutput
- func (o GetEbsVolumesFilterOutput) ToGetEbsVolumesFilterOutputWithContext(ctx context.Context) GetEbsVolumesFilterOutput
- func (o GetEbsVolumesFilterOutput) Values() pulumi.StringArrayOutput
- type GetEbsVolumesResult
- type GetSnapshotFilter
- type GetSnapshotFilterArgs
- type GetSnapshotFilterArray
- type GetSnapshotFilterArrayInput
- type GetSnapshotFilterArrayOutput
- func (GetSnapshotFilterArrayOutput) ElementType() reflect.Type
- func (o GetSnapshotFilterArrayOutput) Index(i pulumi.IntInput) GetSnapshotFilterOutput
- func (o GetSnapshotFilterArrayOutput) ToGetSnapshotFilterArrayOutput() GetSnapshotFilterArrayOutput
- func (o GetSnapshotFilterArrayOutput) ToGetSnapshotFilterArrayOutputWithContext(ctx context.Context) GetSnapshotFilterArrayOutput
- type GetSnapshotFilterInput
- type GetSnapshotFilterOutput
- func (GetSnapshotFilterOutput) ElementType() reflect.Type
- func (o GetSnapshotFilterOutput) Name() pulumi.StringOutput
- func (o GetSnapshotFilterOutput) ToGetSnapshotFilterOutput() GetSnapshotFilterOutput
- func (o GetSnapshotFilterOutput) ToGetSnapshotFilterOutputWithContext(ctx context.Context) GetSnapshotFilterOutput
- func (o GetSnapshotFilterOutput) Values() pulumi.StringArrayOutput
- type GetSnapshotIdsArgs
- type GetSnapshotIdsFilter
- type GetSnapshotIdsFilterArgs
- type GetSnapshotIdsFilterArray
- type GetSnapshotIdsFilterArrayInput
- type GetSnapshotIdsFilterArrayOutput
- func (GetSnapshotIdsFilterArrayOutput) ElementType() reflect.Type
- func (o GetSnapshotIdsFilterArrayOutput) Index(i pulumi.IntInput) GetSnapshotIdsFilterOutput
- func (o GetSnapshotIdsFilterArrayOutput) ToGetSnapshotIdsFilterArrayOutput() GetSnapshotIdsFilterArrayOutput
- func (o GetSnapshotIdsFilterArrayOutput) ToGetSnapshotIdsFilterArrayOutputWithContext(ctx context.Context) GetSnapshotIdsFilterArrayOutput
- type GetSnapshotIdsFilterInput
- type GetSnapshotIdsFilterOutput
- func (GetSnapshotIdsFilterOutput) ElementType() reflect.Type
- func (o GetSnapshotIdsFilterOutput) Name() pulumi.StringOutput
- func (o GetSnapshotIdsFilterOutput) ToGetSnapshotIdsFilterOutput() GetSnapshotIdsFilterOutput
- func (o GetSnapshotIdsFilterOutput) ToGetSnapshotIdsFilterOutputWithContext(ctx context.Context) GetSnapshotIdsFilterOutput
- func (o GetSnapshotIdsFilterOutput) Values() pulumi.StringArrayOutput
- type GetSnapshotIdsResult
- type GetVolumeFilter
- type GetVolumeFilterArgs
- type GetVolumeFilterArray
- type GetVolumeFilterArrayInput
- type GetVolumeFilterArrayOutput
- func (GetVolumeFilterArrayOutput) ElementType() reflect.Type
- func (o GetVolumeFilterArrayOutput) Index(i pulumi.IntInput) GetVolumeFilterOutput
- func (o GetVolumeFilterArrayOutput) ToGetVolumeFilterArrayOutput() GetVolumeFilterArrayOutput
- func (o GetVolumeFilterArrayOutput) ToGetVolumeFilterArrayOutputWithContext(ctx context.Context) GetVolumeFilterArrayOutput
- type GetVolumeFilterInput
- type GetVolumeFilterOutput
- func (GetVolumeFilterOutput) ElementType() reflect.Type
- func (o GetVolumeFilterOutput) Name() pulumi.StringOutput
- func (o GetVolumeFilterOutput) ToGetVolumeFilterOutput() GetVolumeFilterOutput
- func (o GetVolumeFilterOutput) ToGetVolumeFilterOutputWithContext(ctx context.Context) GetVolumeFilterOutput
- func (o GetVolumeFilterOutput) Values() pulumi.StringArrayOutput
- type LookupDefaultKmsKeyResult
- type LookupEncryptionByDefaultResult
- type LookupSnapshotArgs
- type LookupSnapshotResult
- type LookupVolumeArgs
- type LookupVolumeResult
- type Snapshot
- type SnapshotArgs
- type SnapshotCopy
- type SnapshotCopyArgs
- type SnapshotCopyState
- type SnapshotState
- type Volume
- type VolumeArgs
- type VolumeState
Constants ¶
This section is empty.
Variables ¶
This section is empty.
Functions ¶
This section is empty.
Types ¶
type DefaultKmsKey ¶
type DefaultKmsKey struct { pulumi.CustomResourceState // The ARN of the AWS Key Management Service (AWS KMS) customer master key (CMK) to use to encrypt the EBS volume. KeyArn pulumi.StringOutput `pulumi:"keyArn"` }
Provides a resource to manage the default customer master key (CMK) that your AWS account uses to encrypt EBS volumes.
Your AWS account has an AWS-managed default CMK that is used for encrypting an EBS volume when no CMK is specified in the API call that creates the volume. By using the `ebs.DefaultKmsKey` resource, you can specify a customer-managed CMK to use in place of the AWS-managed default CMK.
> **NOTE:** Creating an `ebs.DefaultKmsKey` resource does not enable default EBS encryption. Use the `ebs.EncryptionByDefault` to enable default EBS encryption.
> **NOTE:** Destroying this resource will reset the default CMK to the account's AWS-managed default CMK for EBS.
## Example Usage
```go package main
import (
"github.com/pulumi/pulumi-aws/sdk/v2/go/aws/ebs" "github.com/pulumi/pulumi/sdk/v2/go/pulumi"
)
func main() { pulumi.Run(func(ctx *pulumi.Context) error { example, err := ebs.NewDefaultKmsKey(ctx, "example", &ebs.DefaultKmsKeyArgs{ KeyArn: pulumi.String(aws_kms_key.Example.Arn), }) if err != nil { return err } return nil }) }
```
func GetDefaultKmsKey ¶
func GetDefaultKmsKey(ctx *pulumi.Context, name string, id pulumi.IDInput, state *DefaultKmsKeyState, opts ...pulumi.ResourceOption) (*DefaultKmsKey, error)
GetDefaultKmsKey gets an existing DefaultKmsKey resource's state with the given name, ID, and optional state properties that are used to uniquely qualify the lookup (nil if not required).
func NewDefaultKmsKey ¶
func NewDefaultKmsKey(ctx *pulumi.Context, name string, args *DefaultKmsKeyArgs, opts ...pulumi.ResourceOption) (*DefaultKmsKey, error)
NewDefaultKmsKey registers a new resource with the given unique name, arguments, and options.
type DefaultKmsKeyArgs ¶
type DefaultKmsKeyArgs struct { // The ARN of the AWS Key Management Service (AWS KMS) customer master key (CMK) to use to encrypt the EBS volume. KeyArn pulumi.StringInput }
The set of arguments for constructing a DefaultKmsKey resource.
func (DefaultKmsKeyArgs) ElementType ¶
func (DefaultKmsKeyArgs) ElementType() reflect.Type
type DefaultKmsKeyState ¶
type DefaultKmsKeyState struct { // The ARN of the AWS Key Management Service (AWS KMS) customer master key (CMK) to use to encrypt the EBS volume. KeyArn pulumi.StringPtrInput }
func (DefaultKmsKeyState) ElementType ¶
func (DefaultKmsKeyState) ElementType() reflect.Type
type EncryptionByDefault ¶
type EncryptionByDefault struct { pulumi.CustomResourceState // Whether or not default EBS encryption is enabled. Valid values are `true` or `false`. Defaults to `true`. Enabled pulumi.BoolPtrOutput `pulumi:"enabled"` }
Provides a resource to manage whether default EBS encryption is enabled for your AWS account in the current AWS region. To manage the default KMS key for the region, see the `ebs.DefaultKmsKey` resource.
> **NOTE:** Removing this resource disables default EBS encryption.
## Example Usage
```go package main
import (
"github.com/pulumi/pulumi-aws/sdk/v2/go/aws/ebs" "github.com/pulumi/pulumi/sdk/v2/go/pulumi"
)
func main() { pulumi.Run(func(ctx *pulumi.Context) error { example, err := ebs.NewEncryptionByDefault(ctx, "example", &ebs.EncryptionByDefaultArgs{ Enabled: pulumi.Bool(true), }) if err != nil { return err } return nil }) }
```
func GetEncryptionByDefault ¶
func GetEncryptionByDefault(ctx *pulumi.Context, name string, id pulumi.IDInput, state *EncryptionByDefaultState, opts ...pulumi.ResourceOption) (*EncryptionByDefault, error)
GetEncryptionByDefault gets an existing EncryptionByDefault resource's state with the given name, ID, and optional state properties that are used to uniquely qualify the lookup (nil if not required).
func NewEncryptionByDefault ¶
func NewEncryptionByDefault(ctx *pulumi.Context, name string, args *EncryptionByDefaultArgs, opts ...pulumi.ResourceOption) (*EncryptionByDefault, error)
NewEncryptionByDefault registers a new resource with the given unique name, arguments, and options.
type EncryptionByDefaultArgs ¶
type EncryptionByDefaultArgs struct { // Whether or not default EBS encryption is enabled. Valid values are `true` or `false`. Defaults to `true`. Enabled pulumi.BoolPtrInput }
The set of arguments for constructing a EncryptionByDefault resource.
func (EncryptionByDefaultArgs) ElementType ¶
func (EncryptionByDefaultArgs) ElementType() reflect.Type
type EncryptionByDefaultState ¶
type EncryptionByDefaultState struct { // Whether or not default EBS encryption is enabled. Valid values are `true` or `false`. Defaults to `true`. Enabled pulumi.BoolPtrInput }
func (EncryptionByDefaultState) ElementType ¶
func (EncryptionByDefaultState) ElementType() reflect.Type
type GetEbsVolumesArgs ¶ added in v2.10.0
type GetEbsVolumesArgs struct { // Custom filter block as described below. Filters []GetEbsVolumesFilter `pulumi:"filters"` // A map of tags, each pair of which must exactly match // a pair on the desired volumes. Tags map[string]string `pulumi:"tags"` }
A collection of arguments for invoking getEbsVolumes.
type GetEbsVolumesFilter ¶ added in v2.10.0
type GetEbsVolumesFilter struct { // The name of the field to filter by, as defined by // [the underlying AWS API](https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_DescribeVolumes.html). // For example, if matching against the `size` filter, use: Name string `pulumi:"name"` // Set of values that are accepted for the given field. // EBS Volume IDs will be selected if any one of the given values match. Values []string `pulumi:"values"` }
type GetEbsVolumesFilterArgs ¶ added in v2.10.0
type GetEbsVolumesFilterArgs struct { // The name of the field to filter by, as defined by // [the underlying AWS API](https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_DescribeVolumes.html). // For example, if matching against the `size` filter, use: Name pulumi.StringInput `pulumi:"name"` // Set of values that are accepted for the given field. // EBS Volume IDs will be selected if any one of the given values match. Values pulumi.StringArrayInput `pulumi:"values"` }
func (GetEbsVolumesFilterArgs) ElementType ¶ added in v2.10.0
func (GetEbsVolumesFilterArgs) ElementType() reflect.Type
func (GetEbsVolumesFilterArgs) ToGetEbsVolumesFilterOutput ¶ added in v2.10.0
func (i GetEbsVolumesFilterArgs) ToGetEbsVolumesFilterOutput() GetEbsVolumesFilterOutput
func (GetEbsVolumesFilterArgs) ToGetEbsVolumesFilterOutputWithContext ¶ added in v2.10.0
func (i GetEbsVolumesFilterArgs) ToGetEbsVolumesFilterOutputWithContext(ctx context.Context) GetEbsVolumesFilterOutput
type GetEbsVolumesFilterArray ¶ added in v2.10.0
type GetEbsVolumesFilterArray []GetEbsVolumesFilterInput
func (GetEbsVolumesFilterArray) ElementType ¶ added in v2.10.0
func (GetEbsVolumesFilterArray) ElementType() reflect.Type
func (GetEbsVolumesFilterArray) ToGetEbsVolumesFilterArrayOutput ¶ added in v2.10.0
func (i GetEbsVolumesFilterArray) ToGetEbsVolumesFilterArrayOutput() GetEbsVolumesFilterArrayOutput
func (GetEbsVolumesFilterArray) ToGetEbsVolumesFilterArrayOutputWithContext ¶ added in v2.10.0
func (i GetEbsVolumesFilterArray) ToGetEbsVolumesFilterArrayOutputWithContext(ctx context.Context) GetEbsVolumesFilterArrayOutput
type GetEbsVolumesFilterArrayInput ¶ added in v2.10.0
type GetEbsVolumesFilterArrayInput interface { pulumi.Input ToGetEbsVolumesFilterArrayOutput() GetEbsVolumesFilterArrayOutput ToGetEbsVolumesFilterArrayOutputWithContext(context.Context) GetEbsVolumesFilterArrayOutput }
GetEbsVolumesFilterArrayInput is an input type that accepts GetEbsVolumesFilterArray and GetEbsVolumesFilterArrayOutput values. You can construct a concrete instance of `GetEbsVolumesFilterArrayInput` via:
GetEbsVolumesFilterArray{ GetEbsVolumesFilterArgs{...} }
type GetEbsVolumesFilterArrayOutput ¶ added in v2.10.0
type GetEbsVolumesFilterArrayOutput struct{ *pulumi.OutputState }
func (GetEbsVolumesFilterArrayOutput) ElementType ¶ added in v2.10.0
func (GetEbsVolumesFilterArrayOutput) ElementType() reflect.Type
func (GetEbsVolumesFilterArrayOutput) Index ¶ added in v2.10.0
func (o GetEbsVolumesFilterArrayOutput) Index(i pulumi.IntInput) GetEbsVolumesFilterOutput
func (GetEbsVolumesFilterArrayOutput) ToGetEbsVolumesFilterArrayOutput ¶ added in v2.10.0
func (o GetEbsVolumesFilterArrayOutput) ToGetEbsVolumesFilterArrayOutput() GetEbsVolumesFilterArrayOutput
func (GetEbsVolumesFilterArrayOutput) ToGetEbsVolumesFilterArrayOutputWithContext ¶ added in v2.10.0
func (o GetEbsVolumesFilterArrayOutput) ToGetEbsVolumesFilterArrayOutputWithContext(ctx context.Context) GetEbsVolumesFilterArrayOutput
type GetEbsVolumesFilterInput ¶ added in v2.10.0
type GetEbsVolumesFilterInput interface { pulumi.Input ToGetEbsVolumesFilterOutput() GetEbsVolumesFilterOutput ToGetEbsVolumesFilterOutputWithContext(context.Context) GetEbsVolumesFilterOutput }
GetEbsVolumesFilterInput is an input type that accepts GetEbsVolumesFilterArgs and GetEbsVolumesFilterOutput values. You can construct a concrete instance of `GetEbsVolumesFilterInput` via:
GetEbsVolumesFilterArgs{...}
type GetEbsVolumesFilterOutput ¶ added in v2.10.0
type GetEbsVolumesFilterOutput struct{ *pulumi.OutputState }
func (GetEbsVolumesFilterOutput) ElementType ¶ added in v2.10.0
func (GetEbsVolumesFilterOutput) ElementType() reflect.Type
func (GetEbsVolumesFilterOutput) Name ¶ added in v2.10.0
func (o GetEbsVolumesFilterOutput) Name() pulumi.StringOutput
The name of the field to filter by, as defined by [the underlying AWS API](https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_DescribeVolumes.html). For example, if matching against the `size` filter, use:
func (GetEbsVolumesFilterOutput) ToGetEbsVolumesFilterOutput ¶ added in v2.10.0
func (o GetEbsVolumesFilterOutput) ToGetEbsVolumesFilterOutput() GetEbsVolumesFilterOutput
func (GetEbsVolumesFilterOutput) ToGetEbsVolumesFilterOutputWithContext ¶ added in v2.10.0
func (o GetEbsVolumesFilterOutput) ToGetEbsVolumesFilterOutputWithContext(ctx context.Context) GetEbsVolumesFilterOutput
func (GetEbsVolumesFilterOutput) Values ¶ added in v2.10.0
func (o GetEbsVolumesFilterOutput) Values() pulumi.StringArrayOutput
Set of values that are accepted for the given field. EBS Volume IDs will be selected if any one of the given values match.
type GetEbsVolumesResult ¶ added in v2.10.0
type GetEbsVolumesResult struct { Filters []GetEbsVolumesFilter `pulumi:"filters"` // The provider-assigned unique ID for this managed resource. Id string `pulumi:"id"` // A set of all the EBS Volume IDs found. This data source will fail if // no volumes match the provided criteria. Ids []string `pulumi:"ids"` Tags map[string]string `pulumi:"tags"` }
A collection of values returned by getEbsVolumes.
func GetEbsVolumes ¶ added in v2.10.0
func GetEbsVolumes(ctx *pulumi.Context, args *GetEbsVolumesArgs, opts ...pulumi.InvokeOption) (*GetEbsVolumesResult, error)
`ebs.getEbsVolumes` provides identifying information for EBS volumes matching given criteria.
This data source can be useful for getting a list of volume IDs with (for example) matching tags.
type GetSnapshotFilter ¶
type GetSnapshotFilterArgs ¶
type GetSnapshotFilterArgs struct { Name pulumi.StringInput `pulumi:"name"` Values pulumi.StringArrayInput `pulumi:"values"` }
func (GetSnapshotFilterArgs) ElementType ¶
func (GetSnapshotFilterArgs) ElementType() reflect.Type
func (GetSnapshotFilterArgs) ToGetSnapshotFilterOutput ¶
func (i GetSnapshotFilterArgs) ToGetSnapshotFilterOutput() GetSnapshotFilterOutput
func (GetSnapshotFilterArgs) ToGetSnapshotFilterOutputWithContext ¶
func (i GetSnapshotFilterArgs) ToGetSnapshotFilterOutputWithContext(ctx context.Context) GetSnapshotFilterOutput
type GetSnapshotFilterArray ¶
type GetSnapshotFilterArray []GetSnapshotFilterInput
func (GetSnapshotFilterArray) ElementType ¶
func (GetSnapshotFilterArray) ElementType() reflect.Type
func (GetSnapshotFilterArray) ToGetSnapshotFilterArrayOutput ¶
func (i GetSnapshotFilterArray) ToGetSnapshotFilterArrayOutput() GetSnapshotFilterArrayOutput
func (GetSnapshotFilterArray) ToGetSnapshotFilterArrayOutputWithContext ¶
func (i GetSnapshotFilterArray) ToGetSnapshotFilterArrayOutputWithContext(ctx context.Context) GetSnapshotFilterArrayOutput
type GetSnapshotFilterArrayInput ¶
type GetSnapshotFilterArrayInput interface { pulumi.Input ToGetSnapshotFilterArrayOutput() GetSnapshotFilterArrayOutput ToGetSnapshotFilterArrayOutputWithContext(context.Context) GetSnapshotFilterArrayOutput }
GetSnapshotFilterArrayInput is an input type that accepts GetSnapshotFilterArray and GetSnapshotFilterArrayOutput values. You can construct a concrete instance of `GetSnapshotFilterArrayInput` via:
GetSnapshotFilterArray{ GetSnapshotFilterArgs{...} }
type GetSnapshotFilterArrayOutput ¶
type GetSnapshotFilterArrayOutput struct{ *pulumi.OutputState }
func (GetSnapshotFilterArrayOutput) ElementType ¶
func (GetSnapshotFilterArrayOutput) ElementType() reflect.Type
func (GetSnapshotFilterArrayOutput) Index ¶
func (o GetSnapshotFilterArrayOutput) Index(i pulumi.IntInput) GetSnapshotFilterOutput
func (GetSnapshotFilterArrayOutput) ToGetSnapshotFilterArrayOutput ¶
func (o GetSnapshotFilterArrayOutput) ToGetSnapshotFilterArrayOutput() GetSnapshotFilterArrayOutput
func (GetSnapshotFilterArrayOutput) ToGetSnapshotFilterArrayOutputWithContext ¶
func (o GetSnapshotFilterArrayOutput) ToGetSnapshotFilterArrayOutputWithContext(ctx context.Context) GetSnapshotFilterArrayOutput
type GetSnapshotFilterInput ¶
type GetSnapshotFilterInput interface { pulumi.Input ToGetSnapshotFilterOutput() GetSnapshotFilterOutput ToGetSnapshotFilterOutputWithContext(context.Context) GetSnapshotFilterOutput }
GetSnapshotFilterInput is an input type that accepts GetSnapshotFilterArgs and GetSnapshotFilterOutput values. You can construct a concrete instance of `GetSnapshotFilterInput` via:
GetSnapshotFilterArgs{...}
type GetSnapshotFilterOutput ¶
type GetSnapshotFilterOutput struct{ *pulumi.OutputState }
func (GetSnapshotFilterOutput) ElementType ¶
func (GetSnapshotFilterOutput) ElementType() reflect.Type
func (GetSnapshotFilterOutput) Name ¶
func (o GetSnapshotFilterOutput) Name() pulumi.StringOutput
func (GetSnapshotFilterOutput) ToGetSnapshotFilterOutput ¶
func (o GetSnapshotFilterOutput) ToGetSnapshotFilterOutput() GetSnapshotFilterOutput
func (GetSnapshotFilterOutput) ToGetSnapshotFilterOutputWithContext ¶
func (o GetSnapshotFilterOutput) ToGetSnapshotFilterOutputWithContext(ctx context.Context) GetSnapshotFilterOutput
func (GetSnapshotFilterOutput) Values ¶
func (o GetSnapshotFilterOutput) Values() pulumi.StringArrayOutput
type GetSnapshotIdsArgs ¶
type GetSnapshotIdsArgs struct { // One or more name/value pairs to filter off of. There are // several valid keys, for a full reference, check out // [describe-volumes in the AWS CLI reference][1]. Filters []GetSnapshotIdsFilter `pulumi:"filters"` // Returns the snapshots owned by the specified owner id. Multiple owners can be specified. Owners []string `pulumi:"owners"` // One or more AWS accounts IDs that can create volumes from the snapshot. RestorableByUserIds []string `pulumi:"restorableByUserIds"` }
A collection of arguments for invoking getSnapshotIds.
type GetSnapshotIdsFilter ¶
type GetSnapshotIdsFilterArgs ¶
type GetSnapshotIdsFilterArgs struct { Name pulumi.StringInput `pulumi:"name"` Values pulumi.StringArrayInput `pulumi:"values"` }
func (GetSnapshotIdsFilterArgs) ElementType ¶
func (GetSnapshotIdsFilterArgs) ElementType() reflect.Type
func (GetSnapshotIdsFilterArgs) ToGetSnapshotIdsFilterOutput ¶
func (i GetSnapshotIdsFilterArgs) ToGetSnapshotIdsFilterOutput() GetSnapshotIdsFilterOutput
func (GetSnapshotIdsFilterArgs) ToGetSnapshotIdsFilterOutputWithContext ¶
func (i GetSnapshotIdsFilterArgs) ToGetSnapshotIdsFilterOutputWithContext(ctx context.Context) GetSnapshotIdsFilterOutput
type GetSnapshotIdsFilterArray ¶
type GetSnapshotIdsFilterArray []GetSnapshotIdsFilterInput
func (GetSnapshotIdsFilterArray) ElementType ¶
func (GetSnapshotIdsFilterArray) ElementType() reflect.Type
func (GetSnapshotIdsFilterArray) ToGetSnapshotIdsFilterArrayOutput ¶
func (i GetSnapshotIdsFilterArray) ToGetSnapshotIdsFilterArrayOutput() GetSnapshotIdsFilterArrayOutput
func (GetSnapshotIdsFilterArray) ToGetSnapshotIdsFilterArrayOutputWithContext ¶
func (i GetSnapshotIdsFilterArray) ToGetSnapshotIdsFilterArrayOutputWithContext(ctx context.Context) GetSnapshotIdsFilterArrayOutput
type GetSnapshotIdsFilterArrayInput ¶
type GetSnapshotIdsFilterArrayInput interface { pulumi.Input ToGetSnapshotIdsFilterArrayOutput() GetSnapshotIdsFilterArrayOutput ToGetSnapshotIdsFilterArrayOutputWithContext(context.Context) GetSnapshotIdsFilterArrayOutput }
GetSnapshotIdsFilterArrayInput is an input type that accepts GetSnapshotIdsFilterArray and GetSnapshotIdsFilterArrayOutput values. You can construct a concrete instance of `GetSnapshotIdsFilterArrayInput` via:
GetSnapshotIdsFilterArray{ GetSnapshotIdsFilterArgs{...} }
type GetSnapshotIdsFilterArrayOutput ¶
type GetSnapshotIdsFilterArrayOutput struct{ *pulumi.OutputState }
func (GetSnapshotIdsFilterArrayOutput) ElementType ¶
func (GetSnapshotIdsFilterArrayOutput) ElementType() reflect.Type
func (GetSnapshotIdsFilterArrayOutput) Index ¶
func (o GetSnapshotIdsFilterArrayOutput) Index(i pulumi.IntInput) GetSnapshotIdsFilterOutput
func (GetSnapshotIdsFilterArrayOutput) ToGetSnapshotIdsFilterArrayOutput ¶
func (o GetSnapshotIdsFilterArrayOutput) ToGetSnapshotIdsFilterArrayOutput() GetSnapshotIdsFilterArrayOutput
func (GetSnapshotIdsFilterArrayOutput) ToGetSnapshotIdsFilterArrayOutputWithContext ¶
func (o GetSnapshotIdsFilterArrayOutput) ToGetSnapshotIdsFilterArrayOutputWithContext(ctx context.Context) GetSnapshotIdsFilterArrayOutput
type GetSnapshotIdsFilterInput ¶
type GetSnapshotIdsFilterInput interface { pulumi.Input ToGetSnapshotIdsFilterOutput() GetSnapshotIdsFilterOutput ToGetSnapshotIdsFilterOutputWithContext(context.Context) GetSnapshotIdsFilterOutput }
GetSnapshotIdsFilterInput is an input type that accepts GetSnapshotIdsFilterArgs and GetSnapshotIdsFilterOutput values. You can construct a concrete instance of `GetSnapshotIdsFilterInput` via:
GetSnapshotIdsFilterArgs{...}
type GetSnapshotIdsFilterOutput ¶
type GetSnapshotIdsFilterOutput struct{ *pulumi.OutputState }
func (GetSnapshotIdsFilterOutput) ElementType ¶
func (GetSnapshotIdsFilterOutput) ElementType() reflect.Type
func (GetSnapshotIdsFilterOutput) Name ¶
func (o GetSnapshotIdsFilterOutput) Name() pulumi.StringOutput
func (GetSnapshotIdsFilterOutput) ToGetSnapshotIdsFilterOutput ¶
func (o GetSnapshotIdsFilterOutput) ToGetSnapshotIdsFilterOutput() GetSnapshotIdsFilterOutput
func (GetSnapshotIdsFilterOutput) ToGetSnapshotIdsFilterOutputWithContext ¶
func (o GetSnapshotIdsFilterOutput) ToGetSnapshotIdsFilterOutputWithContext(ctx context.Context) GetSnapshotIdsFilterOutput
func (GetSnapshotIdsFilterOutput) Values ¶
func (o GetSnapshotIdsFilterOutput) Values() pulumi.StringArrayOutput
type GetSnapshotIdsResult ¶
type GetSnapshotIdsResult struct { Filters []GetSnapshotIdsFilter `pulumi:"filters"` // The provider-assigned unique ID for this managed resource. Id string `pulumi:"id"` Ids []string `pulumi:"ids"` Owners []string `pulumi:"owners"` RestorableByUserIds []string `pulumi:"restorableByUserIds"` }
A collection of values returned by getSnapshotIds.
func GetSnapshotIds ¶
func GetSnapshotIds(ctx *pulumi.Context, args *GetSnapshotIdsArgs, opts ...pulumi.InvokeOption) (*GetSnapshotIdsResult, error)
Use this data source to get a list of EBS Snapshot IDs matching the specified criteria.
## Example Usage
```go package main
import (
"github.com/pulumi/pulumi/sdk/v2/go/pulumi"
)
func main() { pulumi.Run(func(ctx *pulumi.Context) error { ebsVolumes, err := ebs.LookupSnapshotIds(ctx, &ebs.LookupSnapshotIdsArgs{ Filters: ebs.getSnapshotIdsFilterArray{ &ebs.LookupSnapshotIdsFilter{ Name: "volume-size", Values: []string{ "40", }, }, &ebs.LookupSnapshotIdsFilter{ Name: "tag:Name", Values: []string{ "Example", }, }, }, Owners: []string{ "self", }, }, nil) if err != nil { return err } return nil }) }
```
type GetVolumeFilter ¶
type GetVolumeFilterArgs ¶
type GetVolumeFilterArgs struct { Name pulumi.StringInput `pulumi:"name"` Values pulumi.StringArrayInput `pulumi:"values"` }
func (GetVolumeFilterArgs) ElementType ¶
func (GetVolumeFilterArgs) ElementType() reflect.Type
func (GetVolumeFilterArgs) ToGetVolumeFilterOutput ¶
func (i GetVolumeFilterArgs) ToGetVolumeFilterOutput() GetVolumeFilterOutput
func (GetVolumeFilterArgs) ToGetVolumeFilterOutputWithContext ¶
func (i GetVolumeFilterArgs) ToGetVolumeFilterOutputWithContext(ctx context.Context) GetVolumeFilterOutput
type GetVolumeFilterArray ¶
type GetVolumeFilterArray []GetVolumeFilterInput
func (GetVolumeFilterArray) ElementType ¶
func (GetVolumeFilterArray) ElementType() reflect.Type
func (GetVolumeFilterArray) ToGetVolumeFilterArrayOutput ¶
func (i GetVolumeFilterArray) ToGetVolumeFilterArrayOutput() GetVolumeFilterArrayOutput
func (GetVolumeFilterArray) ToGetVolumeFilterArrayOutputWithContext ¶
func (i GetVolumeFilterArray) ToGetVolumeFilterArrayOutputWithContext(ctx context.Context) GetVolumeFilterArrayOutput
type GetVolumeFilterArrayInput ¶
type GetVolumeFilterArrayInput interface { pulumi.Input ToGetVolumeFilterArrayOutput() GetVolumeFilterArrayOutput ToGetVolumeFilterArrayOutputWithContext(context.Context) GetVolumeFilterArrayOutput }
GetVolumeFilterArrayInput is an input type that accepts GetVolumeFilterArray and GetVolumeFilterArrayOutput values. You can construct a concrete instance of `GetVolumeFilterArrayInput` via:
GetVolumeFilterArray{ GetVolumeFilterArgs{...} }
type GetVolumeFilterArrayOutput ¶
type GetVolumeFilterArrayOutput struct{ *pulumi.OutputState }
func (GetVolumeFilterArrayOutput) ElementType ¶
func (GetVolumeFilterArrayOutput) ElementType() reflect.Type
func (GetVolumeFilterArrayOutput) Index ¶
func (o GetVolumeFilterArrayOutput) Index(i pulumi.IntInput) GetVolumeFilterOutput
func (GetVolumeFilterArrayOutput) ToGetVolumeFilterArrayOutput ¶
func (o GetVolumeFilterArrayOutput) ToGetVolumeFilterArrayOutput() GetVolumeFilterArrayOutput
func (GetVolumeFilterArrayOutput) ToGetVolumeFilterArrayOutputWithContext ¶
func (o GetVolumeFilterArrayOutput) ToGetVolumeFilterArrayOutputWithContext(ctx context.Context) GetVolumeFilterArrayOutput
type GetVolumeFilterInput ¶
type GetVolumeFilterInput interface { pulumi.Input ToGetVolumeFilterOutput() GetVolumeFilterOutput ToGetVolumeFilterOutputWithContext(context.Context) GetVolumeFilterOutput }
GetVolumeFilterInput is an input type that accepts GetVolumeFilterArgs and GetVolumeFilterOutput values. You can construct a concrete instance of `GetVolumeFilterInput` via:
GetVolumeFilterArgs{...}
type GetVolumeFilterOutput ¶
type GetVolumeFilterOutput struct{ *pulumi.OutputState }
func (GetVolumeFilterOutput) ElementType ¶
func (GetVolumeFilterOutput) ElementType() reflect.Type
func (GetVolumeFilterOutput) Name ¶
func (o GetVolumeFilterOutput) Name() pulumi.StringOutput
func (GetVolumeFilterOutput) ToGetVolumeFilterOutput ¶
func (o GetVolumeFilterOutput) ToGetVolumeFilterOutput() GetVolumeFilterOutput
func (GetVolumeFilterOutput) ToGetVolumeFilterOutputWithContext ¶
func (o GetVolumeFilterOutput) ToGetVolumeFilterOutputWithContext(ctx context.Context) GetVolumeFilterOutput
func (GetVolumeFilterOutput) Values ¶
func (o GetVolumeFilterOutput) Values() pulumi.StringArrayOutput
type LookupDefaultKmsKeyResult ¶
type LookupDefaultKmsKeyResult struct { // The provider-assigned unique ID for this managed resource. Id string `pulumi:"id"` // Amazon Resource Name (ARN) of the default KMS key uses to encrypt an EBS volume in this region when no key is specified in an API call that creates the volume and encryption by default is enabled. KeyArn string `pulumi:"keyArn"` }
A collection of values returned by getDefaultKmsKey.
func LookupDefaultKmsKey ¶
func LookupDefaultKmsKey(ctx *pulumi.Context, opts ...pulumi.InvokeOption) (*LookupDefaultKmsKeyResult, error)
Use this data source to get the default EBS encryption KMS key in the current region.
type LookupEncryptionByDefaultResult ¶
type LookupEncryptionByDefaultResult struct { // Whether or not default EBS encryption is enabled. Returns as `true` or `false`. Enabled bool `pulumi:"enabled"` // The provider-assigned unique ID for this managed resource. Id string `pulumi:"id"` }
A collection of values returned by getEncryptionByDefault.
func LookupEncryptionByDefault ¶
func LookupEncryptionByDefault(ctx *pulumi.Context, opts ...pulumi.InvokeOption) (*LookupEncryptionByDefaultResult, error)
Provides a way to check whether default EBS encryption is enabled for your AWS account in the current AWS region.
type LookupSnapshotArgs ¶
type LookupSnapshotArgs struct { // One or more name/value pairs to filter off of. There are // several valid keys, for a full reference, check out // [describe-snapshots in the AWS CLI reference][1]. Filters []GetSnapshotFilter `pulumi:"filters"` // If more than one result is returned, use the most recent snapshot. MostRecent *bool `pulumi:"mostRecent"` // Returns the snapshots owned by the specified owner id. Multiple owners can be specified. Owners []string `pulumi:"owners"` // One or more AWS accounts IDs that can create volumes from the snapshot. RestorableByUserIds []string `pulumi:"restorableByUserIds"` // Returns information on a specific snapshot_id. SnapshotIds []string `pulumi:"snapshotIds"` // A map of tags for the resource. Tags map[string]string `pulumi:"tags"` }
A collection of arguments for invoking getSnapshot.
type LookupSnapshotResult ¶
type LookupSnapshotResult struct { // The data encryption key identifier for the snapshot. DataEncryptionKeyId string `pulumi:"dataEncryptionKeyId"` // A description for the snapshot Description string `pulumi:"description"` // Whether the snapshot is encrypted. Encrypted bool `pulumi:"encrypted"` Filters []GetSnapshotFilter `pulumi:"filters"` // The provider-assigned unique ID for this managed resource. Id string `pulumi:"id"` // The ARN for the KMS encryption key. KmsKeyId string `pulumi:"kmsKeyId"` MostRecent *bool `pulumi:"mostRecent"` // Value from an Amazon-maintained list (`amazon`, `aws-marketplace`, `microsoft`) of snapshot owners. OwnerAlias string `pulumi:"ownerAlias"` // The AWS account ID of the EBS snapshot owner. OwnerId string `pulumi:"ownerId"` Owners []string `pulumi:"owners"` RestorableByUserIds []string `pulumi:"restorableByUserIds"` // The snapshot ID (e.g. snap-59fcb34e). SnapshotId string `pulumi:"snapshotId"` SnapshotIds []string `pulumi:"snapshotIds"` // The snapshot state. State string `pulumi:"state"` // A map of tags for the resource. Tags map[string]string `pulumi:"tags"` // The volume ID (e.g. vol-59fcb34e). VolumeId string `pulumi:"volumeId"` // The size of the drive in GiBs. VolumeSize int `pulumi:"volumeSize"` }
A collection of values returned by getSnapshot.
func LookupSnapshot ¶
func LookupSnapshot(ctx *pulumi.Context, args *LookupSnapshotArgs, opts ...pulumi.InvokeOption) (*LookupSnapshotResult, error)
Use this data source to get information about an EBS Snapshot for use when provisioning EBS Volumes
## Example Usage
```go package main
import (
"github.com/pulumi/pulumi/sdk/v2/go/pulumi"
)
func main() { pulumi.Run(func(ctx *pulumi.Context) error { ebsVolume, err := ebs.LookupSnapshot(ctx, &ebs.LookupSnapshotArgs{ Filters: ebs.getSnapshotFilterArray{ &ebs.LookupSnapshotFilter{ Name: "volume-size", Values: []string{ "40", }, }, &ebs.LookupSnapshotFilter{ Name: "tag:Name", Values: []string{ "Example", }, }, }, MostRecent: true, Owners: []string{ "self", }, }, nil) if err != nil { return err } return nil }) }
```
type LookupVolumeArgs ¶
type LookupVolumeArgs struct { // One or more name/value pairs to filter off of. There are // several valid keys, for a full reference, check out // [describe-volumes in the AWS CLI reference][1]. Filters []GetVolumeFilter `pulumi:"filters"` // If more than one result is returned, use the most // recent Volume. MostRecent *bool `pulumi:"mostRecent"` // A map of tags for the resource. Tags map[string]string `pulumi:"tags"` }
A collection of arguments for invoking getVolume.
type LookupVolumeResult ¶
type LookupVolumeResult struct { // The volume ARN (e.g. arn:aws:ec2:us-east-1:0123456789012:volume/vol-59fcb34e). Arn string `pulumi:"arn"` // The AZ where the EBS volume exists. AvailabilityZone string `pulumi:"availabilityZone"` // Whether the disk is encrypted. Encrypted bool `pulumi:"encrypted"` Filters []GetVolumeFilter `pulumi:"filters"` // The provider-assigned unique ID for this managed resource. Id string `pulumi:"id"` // The amount of IOPS for the disk. Iops int `pulumi:"iops"` // The ARN for the KMS encryption key. KmsKeyId string `pulumi:"kmsKeyId"` MostRecent *bool `pulumi:"mostRecent"` // (Optional) Specifies whether Amazon EBS Multi-Attach is enabled. MultiAttachEnabled bool `pulumi:"multiAttachEnabled"` // The Amazon Resource Name (ARN) of the Outpost. OutpostArn string `pulumi:"outpostArn"` // The size of the drive in GiBs. Size int `pulumi:"size"` // The snapshotId the EBS volume is based off. SnapshotId string `pulumi:"snapshotId"` // A map of tags for the resource. Tags map[string]string `pulumi:"tags"` // The volume ID (e.g. vol-59fcb34e). VolumeId string `pulumi:"volumeId"` // The type of EBS volume. VolumeType string `pulumi:"volumeType"` }
A collection of values returned by getVolume.
func LookupVolume ¶
func LookupVolume(ctx *pulumi.Context, args *LookupVolumeArgs, opts ...pulumi.InvokeOption) (*LookupVolumeResult, error)
Use this data source to get information about an EBS volume for use in other resources.
## Example Usage
```go package main
import (
"github.com/pulumi/pulumi/sdk/v2/go/pulumi"
)
func main() { pulumi.Run(func(ctx *pulumi.Context) error { ebsVolume, err := ebs.LookupVolume(ctx, &ebs.LookupVolumeArgs{ Filters: ebs.getVolumeFilterArray{ &ebs.LookupVolumeFilter{ Name: "volume-type", Values: []string{ "gp2", }, }, &ebs.LookupVolumeFilter{ Name: "tag:Name", Values: []string{ "Example", }, }, }, MostRecent: true, }, nil) if err != nil { return err } return nil }) }
```
type Snapshot ¶
type Snapshot struct { pulumi.CustomResourceState // The data encryption key identifier for the snapshot. DataEncryptionKeyId pulumi.StringOutput `pulumi:"dataEncryptionKeyId"` // A description of what the snapshot is. Description pulumi.StringPtrOutput `pulumi:"description"` // Whether the snapshot is encrypted. Encrypted pulumi.BoolOutput `pulumi:"encrypted"` // The ARN for the KMS encryption key. KmsKeyId pulumi.StringOutput `pulumi:"kmsKeyId"` // Value from an Amazon-maintained list (`amazon`, `aws-marketplace`, `microsoft`) of snapshot owners. OwnerAlias pulumi.StringOutput `pulumi:"ownerAlias"` // The AWS account ID of the EBS snapshot owner. OwnerId pulumi.StringOutput `pulumi:"ownerId"` // A map of tags to assign to the snapshot Tags pulumi.StringMapOutput `pulumi:"tags"` // The Volume ID of which to make a snapshot. VolumeId pulumi.StringOutput `pulumi:"volumeId"` // The size of the drive in GiBs. VolumeSize pulumi.IntOutput `pulumi:"volumeSize"` }
Creates a Snapshot of an EBS Volume.
## Example Usage
```go package main
import (
"github.com/pulumi/pulumi-aws/sdk/v2/go/aws/ebs" "github.com/pulumi/pulumi/sdk/v2/go/pulumi"
)
func main() { pulumi.Run(func(ctx *pulumi.Context) error { example, err := ebs.NewVolume(ctx, "example", &ebs.VolumeArgs{ AvailabilityZone: pulumi.String("us-west-2a"), Size: pulumi.Int(40), Tags: map[string]interface{}{ "Name": "HelloWorld", }, }) if err != nil { return err } exampleSnapshot, err := ebs.NewSnapshot(ctx, "exampleSnapshot", &ebs.SnapshotArgs{ Tags: map[string]interface{}{ "Name": "HelloWorld_snap", }, VolumeId: example.ID(), }) if err != nil { return err } return nil }) }
```
func GetSnapshot ¶
func GetSnapshot(ctx *pulumi.Context, name string, id pulumi.IDInput, state *SnapshotState, opts ...pulumi.ResourceOption) (*Snapshot, error)
GetSnapshot gets an existing Snapshot resource's state with the given name, ID, and optional state properties that are used to uniquely qualify the lookup (nil if not required).
func NewSnapshot ¶
func NewSnapshot(ctx *pulumi.Context, name string, args *SnapshotArgs, opts ...pulumi.ResourceOption) (*Snapshot, error)
NewSnapshot registers a new resource with the given unique name, arguments, and options.
type SnapshotArgs ¶
type SnapshotArgs struct { // A description of what the snapshot is. Description pulumi.StringPtrInput // A map of tags to assign to the snapshot Tags pulumi.StringMapInput // The Volume ID of which to make a snapshot. VolumeId pulumi.StringInput }
The set of arguments for constructing a Snapshot resource.
func (SnapshotArgs) ElementType ¶
func (SnapshotArgs) ElementType() reflect.Type
type SnapshotCopy ¶
type SnapshotCopy struct { pulumi.CustomResourceState // The data encryption key identifier for the snapshot. // * `sourceSnapshotId` The ARN of the copied snapshot. // * `sourceRegion` The region of the source snapshot. DataEncryptionKeyId pulumi.StringOutput `pulumi:"dataEncryptionKeyId"` // A description of what the snapshot is. Description pulumi.StringPtrOutput `pulumi:"description"` // Whether the snapshot is encrypted. Encrypted pulumi.BoolPtrOutput `pulumi:"encrypted"` // The ARN for the KMS encryption key. KmsKeyId pulumi.StringPtrOutput `pulumi:"kmsKeyId"` // Value from an Amazon-maintained list (`amazon`, `aws-marketplace`, `microsoft`) of snapshot owners. OwnerAlias pulumi.StringOutput `pulumi:"ownerAlias"` // The AWS account ID of the snapshot owner. OwnerId pulumi.StringOutput `pulumi:"ownerId"` // The region of the source snapshot. SourceRegion pulumi.StringOutput `pulumi:"sourceRegion"` // The ARN for the snapshot to be copied. SourceSnapshotId pulumi.StringOutput `pulumi:"sourceSnapshotId"` // A map of tags for the snapshot. Tags pulumi.StringMapOutput `pulumi:"tags"` VolumeId pulumi.StringOutput `pulumi:"volumeId"` // The size of the drive in GiBs. VolumeSize pulumi.IntOutput `pulumi:"volumeSize"` }
Creates a Snapshot of a snapshot.
## Example Usage
```go package main
import (
"github.com/pulumi/pulumi-aws/sdk/v2/go/aws/ebs" "github.com/pulumi/pulumi/sdk/v2/go/pulumi"
)
func main() { pulumi.Run(func(ctx *pulumi.Context) error { example, err := ebs.NewVolume(ctx, "example", &ebs.VolumeArgs{ AvailabilityZone: pulumi.String("us-west-2a"), Size: pulumi.Int(40), Tags: map[string]interface{}{ "Name": "HelloWorld", }, }) if err != nil { return err } exampleSnapshot, err := ebs.NewSnapshot(ctx, "exampleSnapshot", &ebs.SnapshotArgs{ Tags: map[string]interface{}{ "Name": "HelloWorld_snap", }, VolumeId: example.ID(), }) if err != nil { return err } exampleCopy, err := ebs.NewSnapshotCopy(ctx, "exampleCopy", &ebs.SnapshotCopyArgs{ SourceRegion: pulumi.String("us-west-2"), SourceSnapshotId: exampleSnapshot.ID(), Tags: map[string]interface{}{ "Name": "HelloWorld_copy_snap", }, }) if err != nil { return err } return nil }) }
```
func GetSnapshotCopy ¶
func GetSnapshotCopy(ctx *pulumi.Context, name string, id pulumi.IDInput, state *SnapshotCopyState, opts ...pulumi.ResourceOption) (*SnapshotCopy, error)
GetSnapshotCopy gets an existing SnapshotCopy resource's state with the given name, ID, and optional state properties that are used to uniquely qualify the lookup (nil if not required).
func NewSnapshotCopy ¶
func NewSnapshotCopy(ctx *pulumi.Context, name string, args *SnapshotCopyArgs, opts ...pulumi.ResourceOption) (*SnapshotCopy, error)
NewSnapshotCopy registers a new resource with the given unique name, arguments, and options.
type SnapshotCopyArgs ¶
type SnapshotCopyArgs struct { // A description of what the snapshot is. Description pulumi.StringPtrInput // Whether the snapshot is encrypted. Encrypted pulumi.BoolPtrInput // The ARN for the KMS encryption key. KmsKeyId pulumi.StringPtrInput // The region of the source snapshot. SourceRegion pulumi.StringInput // The ARN for the snapshot to be copied. SourceSnapshotId pulumi.StringInput // A map of tags for the snapshot. Tags pulumi.StringMapInput }
The set of arguments for constructing a SnapshotCopy resource.
func (SnapshotCopyArgs) ElementType ¶
func (SnapshotCopyArgs) ElementType() reflect.Type
type SnapshotCopyState ¶
type SnapshotCopyState struct { // The data encryption key identifier for the snapshot. // * `sourceSnapshotId` The ARN of the copied snapshot. // * `sourceRegion` The region of the source snapshot. DataEncryptionKeyId pulumi.StringPtrInput // A description of what the snapshot is. Description pulumi.StringPtrInput // Whether the snapshot is encrypted. Encrypted pulumi.BoolPtrInput // The ARN for the KMS encryption key. KmsKeyId pulumi.StringPtrInput // Value from an Amazon-maintained list (`amazon`, `aws-marketplace`, `microsoft`) of snapshot owners. OwnerAlias pulumi.StringPtrInput // The AWS account ID of the snapshot owner. OwnerId pulumi.StringPtrInput // The region of the source snapshot. SourceRegion pulumi.StringPtrInput // The ARN for the snapshot to be copied. SourceSnapshotId pulumi.StringPtrInput // A map of tags for the snapshot. Tags pulumi.StringMapInput VolumeId pulumi.StringPtrInput // The size of the drive in GiBs. VolumeSize pulumi.IntPtrInput }
func (SnapshotCopyState) ElementType ¶
func (SnapshotCopyState) ElementType() reflect.Type
type SnapshotState ¶
type SnapshotState struct { // The data encryption key identifier for the snapshot. DataEncryptionKeyId pulumi.StringPtrInput // A description of what the snapshot is. Description pulumi.StringPtrInput // Whether the snapshot is encrypted. Encrypted pulumi.BoolPtrInput // The ARN for the KMS encryption key. KmsKeyId pulumi.StringPtrInput // Value from an Amazon-maintained list (`amazon`, `aws-marketplace`, `microsoft`) of snapshot owners. OwnerAlias pulumi.StringPtrInput // The AWS account ID of the EBS snapshot owner. OwnerId pulumi.StringPtrInput // A map of tags to assign to the snapshot Tags pulumi.StringMapInput // The Volume ID of which to make a snapshot. VolumeId pulumi.StringPtrInput // The size of the drive in GiBs. VolumeSize pulumi.IntPtrInput }
func (SnapshotState) ElementType ¶
func (SnapshotState) ElementType() reflect.Type
type Volume ¶
type Volume struct { pulumi.CustomResourceState // The volume ARN (e.g. arn:aws:ec2:us-east-1:0123456789012:volume/vol-59fcb34e). Arn pulumi.StringOutput `pulumi:"arn"` // The AZ where the EBS volume will exist. AvailabilityZone pulumi.StringOutput `pulumi:"availabilityZone"` // If true, the disk will be encrypted. Encrypted pulumi.BoolOutput `pulumi:"encrypted"` // The amount of IOPS to provision for the disk. Iops pulumi.IntOutput `pulumi:"iops"` // The ARN for the KMS encryption key. When specifying `kmsKeyId`, `encrypted` needs to be set to true. KmsKeyId pulumi.StringOutput `pulumi:"kmsKeyId"` // Specifies whether to enable Amazon EBS Multi-Attach. Multi-Attach is supported exclusively on `io1` volumes. MultiAttachEnabled pulumi.BoolPtrOutput `pulumi:"multiAttachEnabled"` // The Amazon Resource Name (ARN) of the Outpost. OutpostArn pulumi.StringPtrOutput `pulumi:"outpostArn"` // The size of the drive in GiBs. Size pulumi.IntOutput `pulumi:"size"` // A snapshot to base the EBS volume off of. SnapshotId pulumi.StringOutput `pulumi:"snapshotId"` // A map of tags to assign to the resource. Tags pulumi.StringMapOutput `pulumi:"tags"` // The type of EBS volume. Can be "standard", "gp2", "io1", "sc1" or "st1" (Default: "gp2"). Type pulumi.StringOutput `pulumi:"type"` }
Manages a single EBS volume.
## Example Usage
```go package main
import (
"github.com/pulumi/pulumi-aws/sdk/v2/go/aws/ebs" "github.com/pulumi/pulumi/sdk/v2/go/pulumi"
)
func main() { pulumi.Run(func(ctx *pulumi.Context) error { example, err := ebs.NewVolume(ctx, "example", &ebs.VolumeArgs{ AvailabilityZone: pulumi.String("us-west-2a"), Size: pulumi.Int(40), Tags: map[string]interface{}{ "Name": "HelloWorld", }, }) if err != nil { return err } return nil }) }
```
func GetVolume ¶
func GetVolume(ctx *pulumi.Context, name string, id pulumi.IDInput, state *VolumeState, opts ...pulumi.ResourceOption) (*Volume, error)
GetVolume gets an existing Volume resource's state with the given name, ID, and optional state properties that are used to uniquely qualify the lookup (nil if not required).
func NewVolume ¶
func NewVolume(ctx *pulumi.Context, name string, args *VolumeArgs, opts ...pulumi.ResourceOption) (*Volume, error)
NewVolume registers a new resource with the given unique name, arguments, and options.
type VolumeArgs ¶
type VolumeArgs struct { // The AZ where the EBS volume will exist. AvailabilityZone pulumi.StringInput // If true, the disk will be encrypted. Encrypted pulumi.BoolPtrInput // The amount of IOPS to provision for the disk. Iops pulumi.IntPtrInput // The ARN for the KMS encryption key. When specifying `kmsKeyId`, `encrypted` needs to be set to true. KmsKeyId pulumi.StringPtrInput // Specifies whether to enable Amazon EBS Multi-Attach. Multi-Attach is supported exclusively on `io1` volumes. MultiAttachEnabled pulumi.BoolPtrInput // The Amazon Resource Name (ARN) of the Outpost. OutpostArn pulumi.StringPtrInput // The size of the drive in GiBs. Size pulumi.IntPtrInput // A snapshot to base the EBS volume off of. SnapshotId pulumi.StringPtrInput // A map of tags to assign to the resource. Tags pulumi.StringMapInput // The type of EBS volume. Can be "standard", "gp2", "io1", "sc1" or "st1" (Default: "gp2"). Type pulumi.StringPtrInput }
The set of arguments for constructing a Volume resource.
func (VolumeArgs) ElementType ¶
func (VolumeArgs) ElementType() reflect.Type
type VolumeState ¶
type VolumeState struct { // The volume ARN (e.g. arn:aws:ec2:us-east-1:0123456789012:volume/vol-59fcb34e). Arn pulumi.StringPtrInput // The AZ where the EBS volume will exist. AvailabilityZone pulumi.StringPtrInput // If true, the disk will be encrypted. Encrypted pulumi.BoolPtrInput // The amount of IOPS to provision for the disk. Iops pulumi.IntPtrInput // The ARN for the KMS encryption key. When specifying `kmsKeyId`, `encrypted` needs to be set to true. KmsKeyId pulumi.StringPtrInput // Specifies whether to enable Amazon EBS Multi-Attach. Multi-Attach is supported exclusively on `io1` volumes. MultiAttachEnabled pulumi.BoolPtrInput // The Amazon Resource Name (ARN) of the Outpost. OutpostArn pulumi.StringPtrInput // The size of the drive in GiBs. Size pulumi.IntPtrInput // A snapshot to base the EBS volume off of. SnapshotId pulumi.StringPtrInput // A map of tags to assign to the resource. Tags pulumi.StringMapInput // The type of EBS volume. Can be "standard", "gp2", "io1", "sc1" or "st1" (Default: "gp2"). Type pulumi.StringPtrInput }
func (VolumeState) ElementType ¶
func (VolumeState) ElementType() reflect.Type