/AWS1/IF_BUP=>CRELOGICALLYAIRGAPPEDBACKU00()

About CreateLogicallyAirGappedBackupVault

Creates a logical container to where backups may be copied.

This request includes a name, the Region, the maximum number of retention days, the minimum number of retention days, and optionally can include tags and a creator request ID.

Do not include sensitive data, such as passport numbers, in the name of a backup vault.

Method Signature

METHODS /AWS1/IF_BUP~CRELOGICALLYAIRGAPPEDBACKU00
  IMPORTING
    !IV_BACKUPVAULTNAME TYPE /AWS1/BUPBACKUPVAULTNAME OPTIONAL
    !IT_BACKUPVAULTTAGS TYPE /AWS1/CL_BUPTAGS_W=>TT_TAGS OPTIONAL
    !IV_CREATORREQUESTID TYPE /AWS1/BUPSTRING OPTIONAL
    !IV_MINRETENTIONDAYS TYPE /AWS1/BUPLONG OPTIONAL
    !IV_MAXRETENTIONDAYS TYPE /AWS1/BUPLONG OPTIONAL
    !IV_ENCRYPTIONKEYARN TYPE /AWS1/BUPARN OPTIONAL
  RETURNING
    VALUE(OO_OUTPUT) TYPE REF TO /aws1/cl_bupcrelogicallyairg01
  RAISING
    /AWS1/CX_BUPALREADYEXISTSEX
    /AWS1/CX_BUPINVPARAMVALUEEX
    /AWS1/CX_BUPINVALIDREQUESTEX
    /AWS1/CX_BUPLIMITEXCEEDEDEX
    /AWS1/CX_BUPMISSINGPARAMVALEX
    /AWS1/CX_BUPSERVICEUNAVAILEX
    /AWS1/CX_BUPCLIENTEXC
    /AWS1/CX_BUPSERVEREXC
    /AWS1/CX_RT_TECHNICAL_GENERIC
    /AWS1/CX_RT_SERVICE_GENERIC.

IMPORTING

Required arguments:

iv_backupvaultname TYPE /AWS1/BUPBACKUPVAULTNAME /AWS1/BUPBACKUPVAULTNAME

The name of a logical container where backups are stored. Logically air-gapped backup vaults are identified by names that are unique to the account used to create them and the Region where they are created.

iv_minretentiondays TYPE /AWS1/BUPLONG /AWS1/BUPLONG

This setting specifies the minimum retention period that the vault retains its recovery points.

The minimum value accepted is 7 days.

iv_maxretentiondays TYPE /AWS1/BUPLONG /AWS1/BUPLONG

The maximum retention period that the vault retains its recovery points.

Optional arguments:

it_backupvaulttags TYPE /AWS1/CL_BUPTAGS_W=>TT_TAGS TT_TAGS

The tags to assign to the vault.

iv_creatorrequestid TYPE /AWS1/BUPSTRING /AWS1/BUPSTRING

The ID of the creation request.

This parameter is optional. If used, this parameter must contain 1 to 50 alphanumeric or '-_.' characters.

iv_encryptionkeyarn TYPE /AWS1/BUPARN /AWS1/BUPARN

The ARN of the customer-managed KMS key to use for encrypting the logically air-gapped backup vault. If not specified, the vault will be encrypted with an Amazon Web Services-owned key managed by Amazon Web Services Backup.

RETURNING

oo_output TYPE REF TO /aws1/cl_bupcrelogicallyairg01 /AWS1/CL_BUPCRELOGICALLYAIRG01

Examples

Syntax Example

This is an example of the syntax for calling the method. It includes every possible argument and initializes every possible value. The data provided is not necessarily semantically accurate (for example the value "string" may be provided for something that is intended to be an instance ID, or in some cases two arguments may be mutually exclusive). The syntax shows the ABAP syntax for creating the various data structures.

DATA(lo_result) = lo_client->crelogicallyairgappedbacku00(
  it_backupvaulttags = VALUE /aws1/cl_buptags_w=>tt_tags(
    (
      VALUE /aws1/cl_buptags_w=>ts_tags_maprow(
        key = |string|
        value = new /aws1/cl_buptags_w( |string| )
      )
    )
  )
  iv_backupvaultname = |string|
  iv_creatorrequestid = |string|
  iv_encryptionkeyarn = |string|
  iv_maxretentiondays = 123
  iv_minretentiondays = 123
).

This is an example of reading all possible response values

lo_result = lo_result.
IF lo_result IS NOT INITIAL.
  lv_backupvaultname = lo_result->get_backupvaultname( ).
  lv_arn = lo_result->get_backupvaultarn( ).
  lv_timestamp = lo_result->get_creationdate( ).
  lv_vaultstate = lo_result->get_vaultstate( ).
ENDIF.