paws.management (version 0.1.8)

opsworkscm_create_backup: Creates an application-level backup of a server

Description

Creates an application-level backup of a server. While the server is in the BACKING_UP state, the server cannot be changed, and no additional backup can be created.

Usage

opsworkscm_create_backup(ServerName, Description, Tags)

Arguments

ServerName

[required] The name of the server that you want to back up.

Description

A user-defined description of the backup.

Tags

A map that contains tag keys and tag values to attach to an AWS OpsWorks-CM server backup.

• The key cannot be empty.

• The key can be a maximum of 127 characters, and can contain only Unicode letters, numbers, or separators, or the following special characters: + - = . _ : /

• The value can be a maximum 255 characters, and contain only Unicode letters, numbers, or separators, or the following special characters: + - = . _ : /

• Leading and trailing white spaces are trimmed from both the key and value.

• A maximum of 50 user-applied tags is allowed for tag-supported AWS OpsWorks-CM resources.

Request syntax

svc$create_backup(
  ServerName = "string",
  Description = "string",
  Tags = list(
    list(
      Key = "string",
      Value = "string"
    )
  )
)

Details

Backups can be created for servers in RUNNING, HEALTHY, and UNHEALTHY states. By default, you can create a maximum of 50 manual backups.

This operation is asynchronous.

A LimitExceededException is thrown when the maximum number of manual backups is reached. An InvalidStateException is thrown when the server is not in any of the following states: RUNNING, HEALTHY, or UNHEALTHY. A ResourceNotFoundException is thrown when the server is not found. A ValidationException is thrown when parameters of the request are not valid.