We recommend new projects start with resources from the AWS provider.
aws-native.backup.getBackupVault
Explore with Pulumi AI
We recommend new projects start with resources from the AWS provider.
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)
public static Output<GetBackupVaultResult> getBackupVault(GetBackupVaultArgs args, InvokeOptions options)
fn::invoke:
  function: aws-native:backup:getBackupVault
  arguments:
    # arguments dictionaryThe following arguments are supported:
- BackupVault 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.
- BackupVault 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.
- backupVault 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.
- backupVault 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.
- backupVault 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:
- AccessPolicy 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::BackupVaultfor more information about the expected schema for this property.
- BackupVault 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.
- LockConfiguration 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.
- AccessPolicy 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::BackupVaultfor more information about the expected schema for this property.
- BackupVault 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.
- LockConfiguration BackupVault Lock Configuration Type 
- Configuration for AWS Backup Vault Lock .
- Notifications
BackupVault Notification Object Type 
- The SNS event notifications for the specified backup vault.
- accessPolicy 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::BackupVaultfor more information about the expected schema for this property.
- backupVault 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.
- lockConfiguration BackupVault Lock Configuration Type 
- Configuration for AWS Backup Vault Lock .
- notifications
BackupVault Notification Object Type 
- The SNS event notifications for the specified backup vault.
- accessPolicy 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::BackupVaultfor more information about the expected schema for this property.
- backupVault 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.
- lockConfiguration BackupVault Lock Configuration Type 
- Configuration for AWS Backup Vault Lock .
- notifications
BackupVault 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::BackupVaultfor 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
BackupVault Notification Object Type 
- The SNS event notifications for the specified backup vault.
- accessPolicy 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::BackupVaultfor more information about the expected schema for this property.
- backupVault 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.
- lockConfiguration Property Map
- Configuration for AWS Backup Vault Lock .
- notifications Property Map
- The SNS event notifications for the specified backup vault.
Supporting Types
BackupVaultLockConfigurationType    
- MinRetention 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. 
- ChangeableFor intDays 
- The AWS Backup Vault Lock configuration that specifies the number of days before the lock date. For example, setting - ChangeableForDaysto 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 - ChangeableForDaysto 3 or greater.- Before the lock date, you can delete Vault Lock from the vault using - DeleteBackupVaultLockConfigurationor change the Vault Lock configuration using- PutBackupVaultLockConfiguration. 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 - DeleteBackupVaultLockConfigurationor change the Vault Lock configuration using- PutBackupVaultLockConfigurationat any time.
- MaxRetention 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. 
- MinRetention 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. 
- ChangeableFor intDays 
- The AWS Backup Vault Lock configuration that specifies the number of days before the lock date. For example, setting - ChangeableForDaysto 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 - ChangeableForDaysto 3 or greater.- Before the lock date, you can delete Vault Lock from the vault using - DeleteBackupVaultLockConfigurationor change the Vault Lock configuration using- PutBackupVaultLockConfiguration. 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 - DeleteBackupVaultLockConfigurationor change the Vault Lock configuration using- PutBackupVaultLockConfigurationat any time.
- MaxRetention 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. 
- minRetention 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. 
- changeableFor IntegerDays 
- The AWS Backup Vault Lock configuration that specifies the number of days before the lock date. For example, setting - ChangeableForDaysto 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 - ChangeableForDaysto 3 or greater.- Before the lock date, you can delete Vault Lock from the vault using - DeleteBackupVaultLockConfigurationor change the Vault Lock configuration using- PutBackupVaultLockConfiguration. 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 - DeleteBackupVaultLockConfigurationor change the Vault Lock configuration using- PutBackupVaultLockConfigurationat any time.
- maxRetention 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. 
- minRetention 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. 
- changeableFor numberDays 
- The AWS Backup Vault Lock configuration that specifies the number of days before the lock date. For example, setting - ChangeableForDaysto 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 - ChangeableForDaysto 3 or greater.- Before the lock date, you can delete Vault Lock from the vault using - DeleteBackupVaultLockConfigurationor change the Vault Lock configuration using- PutBackupVaultLockConfiguration. 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 - DeleteBackupVaultLockConfigurationor change the Vault Lock configuration using- PutBackupVaultLockConfigurationat any time.
- maxRetention 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 - ChangeableForDaysto 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 - ChangeableForDaysto 3 or greater.- Before the lock date, you can delete Vault Lock from the vault using - DeleteBackupVaultLockConfigurationor change the Vault Lock configuration using- PutBackupVaultLockConfiguration. 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 - DeleteBackupVaultLockConfigurationor change the Vault Lock configuration using- PutBackupVaultLockConfigurationat 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. 
- minRetention 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. 
- changeableFor NumberDays 
- The AWS Backup Vault Lock configuration that specifies the number of days before the lock date. For example, setting - ChangeableForDaysto 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 - ChangeableForDaysto 3 or greater.- Before the lock date, you can delete Vault Lock from the vault using - DeleteBackupVaultLockConfigurationor change the Vault Lock configuration using- PutBackupVaultLockConfiguration. 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 - DeleteBackupVaultLockConfigurationor change the Vault Lock configuration using- PutBackupVaultLockConfigurationat any time.
- maxRetention 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    
- BackupVault 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 .
- SnsTopic stringArn 
- An ARN that uniquely identifies an Amazon Simple Notification Service (Amazon SNS) topic; for example, arn:aws:sns:us-west-2:111122223333:MyTopic.
- BackupVault []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 .
- SnsTopic stringArn 
- An ARN that uniquely identifies an Amazon Simple Notification Service (Amazon SNS) topic; for example, arn:aws:sns:us-west-2:111122223333:MyTopic.
- backupVault 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 .
- snsTopic StringArn 
- An ARN that uniquely identifies an Amazon Simple Notification Service (Amazon SNS) topic; for example, arn:aws:sns:us-west-2:111122223333:MyTopic.
- backupVault 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 .
- snsTopic 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.
- backupVault 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 .
- snsTopic 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
We recommend new projects start with resources from the AWS provider.