AWS Native is in preview. AWS Classic is fully supported.
aws-native.backup.getBackupVault
Explore with Pulumi AI
AWS Native is in preview. AWS Classic is fully supported.
Resource Type definition for AWS::Backup::BackupVault
Using getBackupVault
Two invocation forms are available. The direct form accepts plain arguments and either blocks until the result value is available, or returns a Promise-wrapped result. The output form accepts Input-wrapped arguments and returns an Output-wrapped result.
function getBackupVault(args: GetBackupVaultArgs, opts?: InvokeOptions): Promise<GetBackupVaultResult>
function getBackupVaultOutput(args: GetBackupVaultOutputArgs, opts?: InvokeOptions): Output<GetBackupVaultResult>
def get_backup_vault(backup_vault_name: Optional[str] = None,
opts: Optional[InvokeOptions] = None) -> GetBackupVaultResult
def get_backup_vault_output(backup_vault_name: Optional[pulumi.Input[str]] = None,
opts: Optional[InvokeOptions] = None) -> Output[GetBackupVaultResult]
func LookupBackupVault(ctx *Context, args *LookupBackupVaultArgs, opts ...InvokeOption) (*LookupBackupVaultResult, error)
func LookupBackupVaultOutput(ctx *Context, args *LookupBackupVaultOutputArgs, opts ...InvokeOption) LookupBackupVaultResultOutput
> Note: This function is named LookupBackupVault
in the Go SDK.
public static class GetBackupVault
{
public static Task<GetBackupVaultResult> InvokeAsync(GetBackupVaultArgs args, InvokeOptions? opts = null)
public static Output<GetBackupVaultResult> Invoke(GetBackupVaultInvokeArgs args, InvokeOptions? opts = null)
}
public static CompletableFuture<GetBackupVaultResult> getBackupVault(GetBackupVaultArgs args, InvokeOptions options)
// Output-based functions aren't available in Java yet
fn::invoke:
function: aws-native:backup:getBackupVault
arguments:
# arguments dictionary
The following arguments are supported:
- Backup
Vault stringName - The name of a logical container where backups are stored. Backup vaults are identified by names that are unique to the account used to create them and the AWS Region where they are created.
- Backup
Vault stringName - The name of a logical container where backups are stored. Backup vaults are identified by names that are unique to the account used to create them and the AWS Region where they are created.
- backup
Vault StringName - The name of a logical container where backups are stored. Backup vaults are identified by names that are unique to the account used to create them and the AWS Region where they are created.
- backup
Vault stringName - The name of a logical container where backups are stored. Backup vaults are identified by names that are unique to the account used to create them and the AWS Region where they are created.
- backup_
vault_ strname - The name of a logical container where backups are stored. Backup vaults are identified by names that are unique to the account used to create them and the AWS Region where they are created.
- backup
Vault StringName - The name of a logical container where backups are stored. Backup vaults are identified by names that are unique to the account used to create them and the AWS Region where they are created.
getBackupVault Result
The following output properties are available:
- Access
Policy object A resource-based policy that is used to manage access permissions on the target backup vault.
Search the CloudFormation User Guide for
AWS::Backup::BackupVault
for more information about the expected schema for this property.- Backup
Vault stringArn - An Amazon Resource Name (ARN) that uniquely identifies a backup vault; for example,
arn:aws:backup:us-east-1:123456789012:backup-vault:aBackupVault
. - Dictionary<string, string>
- The tags to assign to the backup vault.
- Lock
Configuration Pulumi.Aws Native. Backup. Outputs. Backup Vault Lock Configuration Type - Configuration for AWS Backup Vault Lock .
- Notifications
Pulumi.
Aws Native. Backup. Outputs. Backup Vault Notification Object Type - The SNS event notifications for the specified backup vault.
- Access
Policy interface{} A resource-based policy that is used to manage access permissions on the target backup vault.
Search the CloudFormation User Guide for
AWS::Backup::BackupVault
for more information about the expected schema for this property.- Backup
Vault stringArn - An Amazon Resource Name (ARN) that uniquely identifies a backup vault; for example,
arn:aws:backup:us-east-1:123456789012:backup-vault:aBackupVault
. - map[string]string
- The tags to assign to the backup vault.
- Lock
Configuration BackupVault Lock Configuration Type - Configuration for AWS Backup Vault Lock .
- Notifications
Backup
Vault Notification Object Type - The SNS event notifications for the specified backup vault.
- access
Policy Object A resource-based policy that is used to manage access permissions on the target backup vault.
Search the CloudFormation User Guide for
AWS::Backup::BackupVault
for more information about the expected schema for this property.- backup
Vault StringArn - An Amazon Resource Name (ARN) that uniquely identifies a backup vault; for example,
arn:aws:backup:us-east-1:123456789012:backup-vault:aBackupVault
. - Map<String,String>
- The tags to assign to the backup vault.
- lock
Configuration BackupVault Lock Configuration Type - Configuration for AWS Backup Vault Lock .
- notifications
Backup
Vault Notification Object Type - The SNS event notifications for the specified backup vault.
- access
Policy any A resource-based policy that is used to manage access permissions on the target backup vault.
Search the CloudFormation User Guide for
AWS::Backup::BackupVault
for more information about the expected schema for this property.- backup
Vault stringArn - An Amazon Resource Name (ARN) that uniquely identifies a backup vault; for example,
arn:aws:backup:us-east-1:123456789012:backup-vault:aBackupVault
. - {[key: string]: string}
- The tags to assign to the backup vault.
- lock
Configuration BackupVault Lock Configuration Type - Configuration for AWS Backup Vault Lock .
- notifications
Backup
Vault Notification Object Type - The SNS event notifications for the specified backup vault.
- access_
policy Any A resource-based policy that is used to manage access permissions on the target backup vault.
Search the CloudFormation User Guide for
AWS::Backup::BackupVault
for more information about the expected schema for this property.- backup_
vault_ strarn - An Amazon Resource Name (ARN) that uniquely identifies a backup vault; for example,
arn:aws:backup:us-east-1:123456789012:backup-vault:aBackupVault
. - Mapping[str, str]
- The tags to assign to the backup vault.
- lock_
configuration BackupVault Lock Configuration Type - Configuration for AWS Backup Vault Lock .
- notifications
Backup
Vault Notification Object Type - The SNS event notifications for the specified backup vault.
- access
Policy Any A resource-based policy that is used to manage access permissions on the target backup vault.
Search the CloudFormation User Guide for
AWS::Backup::BackupVault
for more information about the expected schema for this property.- backup
Vault StringArn - An Amazon Resource Name (ARN) that uniquely identifies a backup vault; for example,
arn:aws:backup:us-east-1:123456789012:backup-vault:aBackupVault
. - Map<String>
- The tags to assign to the backup vault.
- lock
Configuration Property Map - Configuration for AWS Backup Vault Lock .
- notifications Property Map
- The SNS event notifications for the specified backup vault.
Supporting Types
BackupVaultLockConfigurationType
- Min
Retention intDays The AWS Backup Vault Lock configuration that specifies the minimum retention period that the vault retains its recovery points. This setting can be useful if, for example, your organization's policies require you to retain certain data for at least seven years (2555 days).
If this parameter is not specified, Vault Lock will not enforce a minimum retention period.
If this parameter is specified, any backup or copy job to the vault must have a lifecycle policy with a retention period equal to or longer than the minimum retention period. If the job's retention period is shorter than that minimum retention period, then the vault fails that backup or copy job, and you should either modify your lifecycle settings or use a different vault. Recovery points already saved in the vault prior to Vault Lock are not affected.
- Changeable
For intDays The AWS Backup Vault Lock configuration that specifies the number of days before the lock date. For example, setting
ChangeableForDays
to 30 on Jan. 1, 2022 at 8pm UTC will set the lock date to Jan. 31, 2022 at 8pm UTC.AWS Backup enforces a 72-hour cooling-off period before Vault Lock takes effect and becomes immutable. Therefore, you must set
ChangeableForDays
to 3 or greater.Before the lock date, you can delete Vault Lock from the vault using
DeleteBackupVaultLockConfiguration
or change the Vault Lock configuration usingPutBackupVaultLockConfiguration
. On and after the lock date, the Vault Lock becomes immutable and cannot be changed or deleted.If this parameter is not specified, you can delete Vault Lock from the vault using
DeleteBackupVaultLockConfiguration
or change the Vault Lock configuration usingPutBackupVaultLockConfiguration
at any time.- Max
Retention intDays The AWS Backup Vault Lock configuration that specifies the maximum retention period that the vault retains its recovery points. This setting can be useful if, for example, your organization's policies require you to destroy certain data after retaining it for four years (1460 days).
If this parameter is not included, Vault Lock does not enforce a maximum retention period on the recovery points in the vault. If this parameter is included without a value, Vault Lock will not enforce a maximum retention period.
If this parameter is specified, any backup or copy job to the vault must have a lifecycle policy with a retention period equal to or shorter than the maximum retention period. If the job's retention period is longer than that maximum retention period, then the vault fails the backup or copy job, and you should either modify your lifecycle settings or use a different vault. Recovery points already saved in the vault prior to Vault Lock are not affected.
- Min
Retention intDays The AWS Backup Vault Lock configuration that specifies the minimum retention period that the vault retains its recovery points. This setting can be useful if, for example, your organization's policies require you to retain certain data for at least seven years (2555 days).
If this parameter is not specified, Vault Lock will not enforce a minimum retention period.
If this parameter is specified, any backup or copy job to the vault must have a lifecycle policy with a retention period equal to or longer than the minimum retention period. If the job's retention period is shorter than that minimum retention period, then the vault fails that backup or copy job, and you should either modify your lifecycle settings or use a different vault. Recovery points already saved in the vault prior to Vault Lock are not affected.
- Changeable
For intDays The AWS Backup Vault Lock configuration that specifies the number of days before the lock date. For example, setting
ChangeableForDays
to 30 on Jan. 1, 2022 at 8pm UTC will set the lock date to Jan. 31, 2022 at 8pm UTC.AWS Backup enforces a 72-hour cooling-off period before Vault Lock takes effect and becomes immutable. Therefore, you must set
ChangeableForDays
to 3 or greater.Before the lock date, you can delete Vault Lock from the vault using
DeleteBackupVaultLockConfiguration
or change the Vault Lock configuration usingPutBackupVaultLockConfiguration
. On and after the lock date, the Vault Lock becomes immutable and cannot be changed or deleted.If this parameter is not specified, you can delete Vault Lock from the vault using
DeleteBackupVaultLockConfiguration
or change the Vault Lock configuration usingPutBackupVaultLockConfiguration
at any time.- Max
Retention intDays The AWS Backup Vault Lock configuration that specifies the maximum retention period that the vault retains its recovery points. This setting can be useful if, for example, your organization's policies require you to destroy certain data after retaining it for four years (1460 days).
If this parameter is not included, Vault Lock does not enforce a maximum retention period on the recovery points in the vault. If this parameter is included without a value, Vault Lock will not enforce a maximum retention period.
If this parameter is specified, any backup or copy job to the vault must have a lifecycle policy with a retention period equal to or shorter than the maximum retention period. If the job's retention period is longer than that maximum retention period, then the vault fails the backup or copy job, and you should either modify your lifecycle settings or use a different vault. Recovery points already saved in the vault prior to Vault Lock are not affected.
- min
Retention IntegerDays The AWS Backup Vault Lock configuration that specifies the minimum retention period that the vault retains its recovery points. This setting can be useful if, for example, your organization's policies require you to retain certain data for at least seven years (2555 days).
If this parameter is not specified, Vault Lock will not enforce a minimum retention period.
If this parameter is specified, any backup or copy job to the vault must have a lifecycle policy with a retention period equal to or longer than the minimum retention period. If the job's retention period is shorter than that minimum retention period, then the vault fails that backup or copy job, and you should either modify your lifecycle settings or use a different vault. Recovery points already saved in the vault prior to Vault Lock are not affected.
- changeable
For IntegerDays The AWS Backup Vault Lock configuration that specifies the number of days before the lock date. For example, setting
ChangeableForDays
to 30 on Jan. 1, 2022 at 8pm UTC will set the lock date to Jan. 31, 2022 at 8pm UTC.AWS Backup enforces a 72-hour cooling-off period before Vault Lock takes effect and becomes immutable. Therefore, you must set
ChangeableForDays
to 3 or greater.Before the lock date, you can delete Vault Lock from the vault using
DeleteBackupVaultLockConfiguration
or change the Vault Lock configuration usingPutBackupVaultLockConfiguration
. On and after the lock date, the Vault Lock becomes immutable and cannot be changed or deleted.If this parameter is not specified, you can delete Vault Lock from the vault using
DeleteBackupVaultLockConfiguration
or change the Vault Lock configuration usingPutBackupVaultLockConfiguration
at any time.- max
Retention IntegerDays The AWS Backup Vault Lock configuration that specifies the maximum retention period that the vault retains its recovery points. This setting can be useful if, for example, your organization's policies require you to destroy certain data after retaining it for four years (1460 days).
If this parameter is not included, Vault Lock does not enforce a maximum retention period on the recovery points in the vault. If this parameter is included without a value, Vault Lock will not enforce a maximum retention period.
If this parameter is specified, any backup or copy job to the vault must have a lifecycle policy with a retention period equal to or shorter than the maximum retention period. If the job's retention period is longer than that maximum retention period, then the vault fails the backup or copy job, and you should either modify your lifecycle settings or use a different vault. Recovery points already saved in the vault prior to Vault Lock are not affected.
- min
Retention numberDays The AWS Backup Vault Lock configuration that specifies the minimum retention period that the vault retains its recovery points. This setting can be useful if, for example, your organization's policies require you to retain certain data for at least seven years (2555 days).
If this parameter is not specified, Vault Lock will not enforce a minimum retention period.
If this parameter is specified, any backup or copy job to the vault must have a lifecycle policy with a retention period equal to or longer than the minimum retention period. If the job's retention period is shorter than that minimum retention period, then the vault fails that backup or copy job, and you should either modify your lifecycle settings or use a different vault. Recovery points already saved in the vault prior to Vault Lock are not affected.
- changeable
For numberDays The AWS Backup Vault Lock configuration that specifies the number of days before the lock date. For example, setting
ChangeableForDays
to 30 on Jan. 1, 2022 at 8pm UTC will set the lock date to Jan. 31, 2022 at 8pm UTC.AWS Backup enforces a 72-hour cooling-off period before Vault Lock takes effect and becomes immutable. Therefore, you must set
ChangeableForDays
to 3 or greater.Before the lock date, you can delete Vault Lock from the vault using
DeleteBackupVaultLockConfiguration
or change the Vault Lock configuration usingPutBackupVaultLockConfiguration
. On and after the lock date, the Vault Lock becomes immutable and cannot be changed or deleted.If this parameter is not specified, you can delete Vault Lock from the vault using
DeleteBackupVaultLockConfiguration
or change the Vault Lock configuration usingPutBackupVaultLockConfiguration
at any time.- max
Retention numberDays The AWS Backup Vault Lock configuration that specifies the maximum retention period that the vault retains its recovery points. This setting can be useful if, for example, your organization's policies require you to destroy certain data after retaining it for four years (1460 days).
If this parameter is not included, Vault Lock does not enforce a maximum retention period on the recovery points in the vault. If this parameter is included without a value, Vault Lock will not enforce a maximum retention period.
If this parameter is specified, any backup or copy job to the vault must have a lifecycle policy with a retention period equal to or shorter than the maximum retention period. If the job's retention period is longer than that maximum retention period, then the vault fails the backup or copy job, and you should either modify your lifecycle settings or use a different vault. Recovery points already saved in the vault prior to Vault Lock are not affected.
- min_
retention_ intdays The AWS Backup Vault Lock configuration that specifies the minimum retention period that the vault retains its recovery points. This setting can be useful if, for example, your organization's policies require you to retain certain data for at least seven years (2555 days).
If this parameter is not specified, Vault Lock will not enforce a minimum retention period.
If this parameter is specified, any backup or copy job to the vault must have a lifecycle policy with a retention period equal to or longer than the minimum retention period. If the job's retention period is shorter than that minimum retention period, then the vault fails that backup or copy job, and you should either modify your lifecycle settings or use a different vault. Recovery points already saved in the vault prior to Vault Lock are not affected.
- changeable_
for_ intdays The AWS Backup Vault Lock configuration that specifies the number of days before the lock date. For example, setting
ChangeableForDays
to 30 on Jan. 1, 2022 at 8pm UTC will set the lock date to Jan. 31, 2022 at 8pm UTC.AWS Backup enforces a 72-hour cooling-off period before Vault Lock takes effect and becomes immutable. Therefore, you must set
ChangeableForDays
to 3 or greater.Before the lock date, you can delete Vault Lock from the vault using
DeleteBackupVaultLockConfiguration
or change the Vault Lock configuration usingPutBackupVaultLockConfiguration
. On and after the lock date, the Vault Lock becomes immutable and cannot be changed or deleted.If this parameter is not specified, you can delete Vault Lock from the vault using
DeleteBackupVaultLockConfiguration
or change the Vault Lock configuration usingPutBackupVaultLockConfiguration
at any time.- max_
retention_ intdays The AWS Backup Vault Lock configuration that specifies the maximum retention period that the vault retains its recovery points. This setting can be useful if, for example, your organization's policies require you to destroy certain data after retaining it for four years (1460 days).
If this parameter is not included, Vault Lock does not enforce a maximum retention period on the recovery points in the vault. If this parameter is included without a value, Vault Lock will not enforce a maximum retention period.
If this parameter is specified, any backup or copy job to the vault must have a lifecycle policy with a retention period equal to or shorter than the maximum retention period. If the job's retention period is longer than that maximum retention period, then the vault fails the backup or copy job, and you should either modify your lifecycle settings or use a different vault. Recovery points already saved in the vault prior to Vault Lock are not affected.
- min
Retention NumberDays The AWS Backup Vault Lock configuration that specifies the minimum retention period that the vault retains its recovery points. This setting can be useful if, for example, your organization's policies require you to retain certain data for at least seven years (2555 days).
If this parameter is not specified, Vault Lock will not enforce a minimum retention period.
If this parameter is specified, any backup or copy job to the vault must have a lifecycle policy with a retention period equal to or longer than the minimum retention period. If the job's retention period is shorter than that minimum retention period, then the vault fails that backup or copy job, and you should either modify your lifecycle settings or use a different vault. Recovery points already saved in the vault prior to Vault Lock are not affected.
- changeable
For NumberDays The AWS Backup Vault Lock configuration that specifies the number of days before the lock date. For example, setting
ChangeableForDays
to 30 on Jan. 1, 2022 at 8pm UTC will set the lock date to Jan. 31, 2022 at 8pm UTC.AWS Backup enforces a 72-hour cooling-off period before Vault Lock takes effect and becomes immutable. Therefore, you must set
ChangeableForDays
to 3 or greater.Before the lock date, you can delete Vault Lock from the vault using
DeleteBackupVaultLockConfiguration
or change the Vault Lock configuration usingPutBackupVaultLockConfiguration
. On and after the lock date, the Vault Lock becomes immutable and cannot be changed or deleted.If this parameter is not specified, you can delete Vault Lock from the vault using
DeleteBackupVaultLockConfiguration
or change the Vault Lock configuration usingPutBackupVaultLockConfiguration
at any time.- max
Retention NumberDays The AWS Backup Vault Lock configuration that specifies the maximum retention period that the vault retains its recovery points. This setting can be useful if, for example, your organization's policies require you to destroy certain data after retaining it for four years (1460 days).
If this parameter is not included, Vault Lock does not enforce a maximum retention period on the recovery points in the vault. If this parameter is included without a value, Vault Lock will not enforce a maximum retention period.
If this parameter is specified, any backup or copy job to the vault must have a lifecycle policy with a retention period equal to or shorter than the maximum retention period. If the job's retention period is longer than that maximum retention period, then the vault fails the backup or copy job, and you should either modify your lifecycle settings or use a different vault. Recovery points already saved in the vault prior to Vault Lock are not affected.
BackupVaultNotificationObjectType
- Backup
Vault List<string>Events - An array of events that indicate the status of jobs to back up resources to the backup vault. For valid events, see BackupVaultEvents in the AWS Backup API Guide .
- Sns
Topic stringArn - An ARN that uniquely identifies an Amazon Simple Notification Service (Amazon SNS) topic; for example,
arn:aws:sns:us-west-2:111122223333:MyTopic
.
- Backup
Vault []stringEvents - An array of events that indicate the status of jobs to back up resources to the backup vault. For valid events, see BackupVaultEvents in the AWS Backup API Guide .
- Sns
Topic stringArn - An ARN that uniquely identifies an Amazon Simple Notification Service (Amazon SNS) topic; for example,
arn:aws:sns:us-west-2:111122223333:MyTopic
.
- backup
Vault List<String>Events - An array of events that indicate the status of jobs to back up resources to the backup vault. For valid events, see BackupVaultEvents in the AWS Backup API Guide .
- sns
Topic StringArn - An ARN that uniquely identifies an Amazon Simple Notification Service (Amazon SNS) topic; for example,
arn:aws:sns:us-west-2:111122223333:MyTopic
.
- backup
Vault string[]Events - An array of events that indicate the status of jobs to back up resources to the backup vault. For valid events, see BackupVaultEvents in the AWS Backup API Guide .
- sns
Topic stringArn - An ARN that uniquely identifies an Amazon Simple Notification Service (Amazon SNS) topic; for example,
arn:aws:sns:us-west-2:111122223333:MyTopic
.
- backup_
vault_ Sequence[str]events - An array of events that indicate the status of jobs to back up resources to the backup vault. For valid events, see BackupVaultEvents in the AWS Backup API Guide .
- sns_
topic_ strarn - An ARN that uniquely identifies an Amazon Simple Notification Service (Amazon SNS) topic; for example,
arn:aws:sns:us-west-2:111122223333:MyTopic
.
- backup
Vault List<String>Events - An array of events that indicate the status of jobs to back up resources to the backup vault. For valid events, see BackupVaultEvents in the AWS Backup API Guide .
- sns
Topic StringArn - An ARN that uniquely identifies an Amazon Simple Notification Service (Amazon SNS) topic; for example,
arn:aws:sns:us-west-2:111122223333:MyTopic
.
Package Details
- Repository
- AWS Native pulumi/pulumi-aws-native
- License
- Apache-2.0
AWS Native is in preview. AWS Classic is fully supported.