Skip to main content

Backup a DynamoDB table on demand​

Performs an on-demand backup for the specified DynamoDB table.

Query Parameters
  • embed string

    Embeds the details of each associated resource. Set the parameter to one of the following embeddable links to include additional details associated with the resource.

    Embeddable LinkDescription
    read-taskEmbeds the associated task in the response. For example, ?embed=read-task
    For more information about embedded links, refer to the Embedding Referenced Resources section of this guide.
Request Body required
  • settings object

    Settings for requesting on-demand backup directly.

  • advanced_settings object

    Additional operation-specific policy settings. For operation types which do not support additional settings, this field is null.

  • aws_ebs_volume_backup object

    Advanced settings for EBS backup.

  • backup_tier string

    Possible values: [standard, lite]

    Backup tier to store the backup in. Valid values are: (empty) equivalent to standard, standard, and lite.

  • aws_ec2_instance_backup object

    Advanced settings for EC2 backup.

  • backup_tier string

    Possible values: [standard, lite]

    Backup tier to store the backup in. Valid values are: (empty) equivalent to standard, standard, and lite.

  • aws_rds_config_sync object

    Advanced settings for RDS PITR configuration sync.

  • apply string

    Possible values: [immediate, maintenance_window]

    Syncs the configuration of RDS PITR in AWS. Valid values are: immediate, and maintenance_window. Note that applying the setting "immediately" may cause unexpected downtime.

  • aws_rds_resource_granular_backup object

    Settings for determining if a RDS policy is created with standard or archive tier.

  • backup_tier string

    Possible values: [standard, archive]

    Backup tier to store the backup in. Valid values are: standard, archive

  • ec2_mssql_database_backup object

    Additional policy configuration settings for the ec2_mssql_database_backup operation. If this operation is not of type ec2_mssql_database_backup, then this field is omitted from the response.

  • alternative_replica string

    Possible values: [primary, sync_secondary, stop]

    The alternative replica for MSSQL database backups. This setting only applies to Availability Group databases. Possible values include "primary", "sync_secondary", and "stop". If "stop" is provided, then backups will not attempt to switch to a different replica when the preferred replica is unavailable. Otherwise, recurring backups will attempt to use either the primary replica or the secondary replica accordingly.

  • preferred_replica string

    Possible values: [primary, sync_secondary]

    The primary preferred replica for MSSQL database backups. This setting only applies to Availability Group databases. Possible values include "primary" and "sync_secondary". Recurring backup will first attempt to use either the primary replica or the secondary replica accordingly.

  • ec2_mssql_log_backup object

    Additional policy configuration settings for the ec2_mssql_log_backup operation. If this operation is not of type ec2_mssql_log_backup, then this field is omitted from the response.

  • alternative_replica string

    Possible values: [primary, sync_secondary, stop]

    The alternative replica for MSSQL log backups. This setting only applies to Availability Group databases. Possible values include "primary", "sync_secondary", and "stop". If "stop" is provided, then backups will not attempt to switch to a different replica when the preferred replica is unavailable. Otherwise, recurring backups will attempt to use either the primary replica or the secondary replica accordingly.

  • preferred_replica string

    Possible values: [primary, sync_secondary]

    The primary preferred replica for MSSQL log backups. This setting only applies to Availability Group databases. Possible values include "primary" and "sync_secondary". Recurring backup will first attempt to use either the primary replica or the secondary replica accordingly.

  • mssql_database_backup object

    Additional policy configuration settings for the mssql_database_backup operation. If this operation is not of type mssql_database_backup, then this field is omitted from the response.

  • alternative_replica string

    Possible values: [primary, sync_secondary, stop]

    The alternative replica for MSSQL database backups. This setting only applies to Availability Group databases. Possible values include "primary", "sync_secondary", and "stop". If "stop" is provided, then backups will not attempt to switch to a different replica when the preferred replica is unavailable. Otherwise, recurring backups will attempt to use either the primary replica or the secondary replica accordingly.

  • preferred_replica string

    Possible values: [primary, sync_secondary]

    The primary preferred replica for MSSQL database backups. This setting only applies to Availability Group databases. Possible values include "primary" and "sync_secondary". Recurring backup will first attempt to use either the primary replica or the secondary replica accordingly.

  • mssql_log_backup object

    Additional policy configuration settings for the mssql_log_backup operation. If this operation is not of type mssql_log_backup, then this field is omitted from the response.

  • alternative_replica string

    Possible values: [primary, sync_secondary, stop]

    The alternative replica for MSSQL log backups. This setting only applies to Availability Group databases. Possible values include "primary", "sync_secondary", and "stop". If "stop" is provided, then backups will not attempt to switch to a different replica when the preferred replica is unavailable. Otherwise, recurring backups will attempt to use either the primary replica or the secondary replica accordingly.

  • preferred_replica string

    Possible values: [primary, sync_secondary]

    The primary preferred replica for MSSQL log backups. This setting only applies to Availability Group databases. Possible values include "primary" and "sync_secondary". Recurring backup will first attempt to use either the primary replica or the secondary replica accordingly.

  • oracle_database_backup object

    Additional policy configuration settings for the oracle_database_backup operation. If this operation is not of type oracle_database_backup, then this field is omitted from the response.

  • alternative_replica string

    Possible values: [primary, standby, stop]

    The alternative replica for Oracle database backups. This setting only applies to Data Guard databases. Valid values are: primary, standby, and stop. If "stop" is provided, then backups will not attempt to switch to a different replica when the preferred replica is unavailable.

  • preferred_replica string

    Possible values: [primary, standby]

    The primary preferred replica for Oracle database backups. This setting only applies to Data Guard databases. Valid values are: primary, and standby. Recurring backup will first attempt to use either the primary replica or the secondary replica accordingly.

  • oracle_log_backup object

    Additional policy configuration settings for the oracle_log_backup operation. If this operation is not of type oracle_log_backup, then this field is omitted from the response.

  • alternative_replica string

    Possible values: [primary, standby, stop]

    The alternative replica for Oracle database backups. This setting only applies to Data Guard databases. Valid values are: primary, standby, and stop. If "stop" is provided, then backups will not attempt to switch to a different replica when the preferred replica is unavailable.

  • preferred_replica string

    Possible values: [primary, standby]

    The primary preferred replica for Oracle database backups. This setting only applies to Data Guard databases. Valid values are: primary, and standby. Recurring backup will first attempt to use either the primary replica or the secondary replica accordingly.

  • protection_group_backup object

    Additional policy configuration settings for the protection_group_backup operation. If this operation is not of type protection_group_backup, then this field is omitted from the response.

  • backup_tier string

    Possible values: [standard, archive]

    Backup tier to store the backup in. Valid values are: standard, archive

  • protection_group_continuous_backup object

    Additional policy configuration settings for the protection_group_continuous_backup operation. If this operation is not of type protection_group_continuous_backup, then this field is omitted from the response.

  • disable_eventbridge_notification boolean

    Default value: true

    If true, tries to disable EventBridge notification for the given bucket, when continuous backup no longer conducts. It may override the existing bucket notification configuration in the customer's account. This takes effect only when event_bridge_enabled is set to false.

  • backup_aws_region string

    The region in which this backup is stored. This might be used for cross-region backup.

  • retention_duration object

    The retention time for this SLA. For example, to retain the backup for 1 month, set unit="months" and value=1.

  • unit string required

    Possible values: [hours, days, weeks, months, years]

    The measurement unit of the SLA parameter.

  • value int64 required

    The measurement value of the SLA parameter.

  • table_id uuid4 required

    Performs the operation on the DynamoDB table with the specified Clumio-assigned ID.

  • type string

    Possible values: [clumio_backup, aws_snapshot]

    Default value: aws_snapshot

    The type of the backup. Possible values - clumio_backup, aws_snapshot. The type will be assumed as aws_snapshot if the field is left empty.

Responses

Success

Schema
  • _embedded object

    Embedded responses related to the resource.

  • read-task Embeds the associated task of a resource in the response if requested using the `embed` query parameter.

    Embeds the associated task of a resource in the response if requested using the embed query parameter.

  • _links object

    URLs to pages related to the resource.

  • _self object

    The HATEOAS link to this resource.

  • href string

    The URI for the referenced operation.

  • templated boolean

    Determines whether the "href" link is a URI template. If set to true, the "href" link is a URI template.

  • type string

    The HTTP method to be used with the "href" link for the referenced operation.

  • read-task object

    A HATEOAS link to the task associated with this resource.

  • href string

    The URI for the referenced operation.

  • templated boolean

    Determines whether the "href" link is a URI template. If set to true, the "href" link is a URI template.

  • type string

    The HTTP method to be used with the "href" link for the referenced operation.

  • task_id string

    The Clumio-assigned ID of the task created for DynamoDB backup. The progress of the task can be monitored using the GET /tasks/{task_id} endpoint.

POST /backups/aws/dynamodb-tables

Authorization

Request

Click Edit to configure Base URL
https://us-west-2.api.clumio.com
Bearer Token
embed — query
Body required
{

  "settings": {

    "advanced_settings": {

      "aws_ebs_volume_backup": {

        "backup_tier": "standard"

      },

      "aws_ec2_instance_backup": {

        "backup_tier": "standard"

      },

      "aws_rds_config_sync": {

        "apply": "immediate"

      },

      "aws_rds_resource_granular_backup": {

        "backup_tier": "standard"

      },

      "ec2_mssql_database_backup": {

        "alternative_replica": "primary",

        "preferred_replica": "primary"

      },

      "ec2_mssql_log_backup": {

        "alternative_replica": "primary",

        "preferred_replica": "primary"

      },

      "mssql_database_backup": {

        "alternative_replica": "primary",

        "preferred_replica": "primary"

      },

      "mssql_log_backup": {

        "alternative_replica": "primary",

        "preferred_replica": "primary"

      },

      "oracle_database_backup": {

        "alternative_replica": "primary",

        "preferred_replica": "primary"

      },

      "oracle_log_backup": {

        "alternative_replica": "primary",

        "preferred_replica": "primary"

      },

      "protection_group_backup": {

        "backup_tier": "standard"

      },

      "protection_group_continuous_backup": {

        "disable_eventbridge_notification": true

      }

    },

    "backup_aws_region": "`us-east-1`, `us-west-2`, ...",

    "retention_duration": {

      "unit": "hours",

      "value": 0

    }

  },

  "table_id": "string",

  "type": "aws_snapshot"

}

curl -L -X POST 'https://us-west-2.api.clumio.com/backups/aws/dynamodb-tables' \
-H 'Content-Type: application/json' \
-H 'Accept: application/api.clumio.backup-aws-dynamodb-tables=v1+json' \
-H 'Authorization: Bearer <TOKEN>' \
--data-raw '{
  "settings": {
    "advanced_settings": {
      "aws_ebs_volume_backup": {
        "backup_tier": "standard"
      },
      "aws_ec2_instance_backup": {
        "backup_tier": "standard"
      },
      "aws_rds_config_sync": {
        "apply": "immediate"
      },
      "aws_rds_resource_granular_backup": {
        "backup_tier": "standard"
      },
      "ec2_mssql_database_backup": {
        "alternative_replica": "primary",
        "preferred_replica": "primary"
      },
      "ec2_mssql_log_backup": {
        "alternative_replica": "primary",
        "preferred_replica": "primary"
      },
      "mssql_database_backup": {
        "alternative_replica": "primary",
        "preferred_replica": "primary"
      },
      "mssql_log_backup": {
        "alternative_replica": "primary",
        "preferred_replica": "primary"
      },
      "oracle_database_backup": {
        "alternative_replica": "primary",
        "preferred_replica": "primary"
      },
      "oracle_log_backup": {
        "alternative_replica": "primary",
        "preferred_replica": "primary"
      },
      "protection_group_backup": {
        "backup_tier": "standard"
      },
      "protection_group_continuous_backup": {
        "disable_eventbridge_notification": true
      }
    },
    "backup_aws_region": "`us-east-1`, `us-west-2`, ...",
    "retention_duration": {
      "unit": "hours",
      "value": 0
    }
  },
  "table_id": "string",
  "type": "aws_snapshot"
}'