Skip to content

Creates a tiering configuration

Description

Creates a tiering configuration.

A tiering configuration enables automatic movement of backup data to a lower-cost storage tier based on the age of backed-up objects in the backup vault.

Each vault can only have one vault-specific tiering configuration, in addition to any global configuration that applies to all vaults.

Usage

backup_create_tiering_configuration(TieringConfiguration,
  TieringConfigurationTags, CreatorRequestId)

Arguments

  • TieringConfiguration

    [required] A tiering configuration must contain a unique TieringConfigurationName string you create and must contain a BackupVaultName and ResourceSelection. You may optionally include a CreatorRequestId string.

    The TieringConfigurationName is a unique string that is the name of the tiering configuration. This cannot be changed after creation, and it must consist of only alphanumeric characters and underscores.

  • TieringConfigurationTags

    The tags to assign to the tiering configuration.

  • CreatorRequestId

    This is a unique string that identifies the request and allows failed requests to be retried without the risk of running the operation twice. This parameter is optional. If used, this parameter must contain 1 to 50 alphanumeric or '-_.' characters.

Value

A list with the following syntax:

list(
  TieringConfigurationArn = "string",
  TieringConfigurationName = "string",
  CreationTime = as.POSIXct(
    "2015-01-01"
  )
)

Request syntax

svc$create_tiering_configuration(
  TieringConfiguration = list(
    TieringConfigurationName = "string",
    BackupVaultName = "string",
    ResourceSelection = list(
      list(
        Resources = list(
          "string"
        ),
        TieringDownSettingsInDays = 123,
        ResourceType = "string"
      )
    )
  ),
  TieringConfigurationTags = list(
    "string"
  ),
  CreatorRequestId = "string"
)