Lightsail / Client / get_relational_database_snapshot

get_relational_database_snapshot#

Lightsail.Client.get_relational_database_snapshot(**kwargs)#

Returns information about a specific database snapshot in Amazon Lightsail.

See also: AWS API Documentation

Request Syntax

response = client.get_relational_database_snapshot(
    relationalDatabaseSnapshotName='string'
)
Parameters:

relationalDatabaseSnapshotName (string) –

[REQUIRED]

The name of the database snapshot for which to get information.

Return type:

dict

Returns:

Response Syntax

{
    'relationalDatabaseSnapshot': {
        'name': 'string',
        'arn': 'string',
        'supportCode': 'string',
        'createdAt': datetime(2015, 1, 1),
        'location': {
            'availabilityZone': 'string',
            'regionName': 'us-east-1'|'us-east-2'|'us-west-1'|'us-west-2'|'eu-west-1'|'eu-west-2'|'eu-west-3'|'eu-central-1'|'ca-central-1'|'ap-south-1'|'ap-southeast-1'|'ap-southeast-2'|'ap-northeast-1'|'ap-northeast-2'|'eu-north-1'
        },
        'resourceType': 'ContainerService'|'Instance'|'StaticIp'|'KeyPair'|'InstanceSnapshot'|'Domain'|'PeeredVpc'|'LoadBalancer'|'LoadBalancerTlsCertificate'|'Disk'|'DiskSnapshot'|'RelationalDatabase'|'RelationalDatabaseSnapshot'|'ExportSnapshotRecord'|'CloudFormationStackRecord'|'Alarm'|'ContactMethod'|'Distribution'|'Certificate'|'Bucket',
        'tags': [
            {
                'key': 'string',
                'value': 'string'
            },
        ],
        'engine': 'string',
        'engineVersion': 'string',
        'sizeInGb': 123,
        'state': 'string',
        'fromRelationalDatabaseName': 'string',
        'fromRelationalDatabaseArn': 'string',
        'fromRelationalDatabaseBundleId': 'string',
        'fromRelationalDatabaseBlueprintId': 'string'
    }
}

Response Structure

  • (dict) –

    • relationalDatabaseSnapshot (dict) –

      An object describing the specified database snapshot.

      • name (string) –

        The name of the database snapshot.

      • arn (string) –

        The Amazon Resource Name (ARN) of the database snapshot.

      • supportCode (string) –

        The support code for the database snapshot. Include this code in your email to support when you have questions about a database snapshot in Lightsail. This code enables our support team to look up your Lightsail information more easily.

      • createdAt (datetime) –

        The timestamp when the database snapshot was created.

      • location (dict) –

        The Region name and Availability Zone where the database snapshot is located.

        • availabilityZone (string) –

          The Availability Zone. Follows the format us-east-2a (case-sensitive).

        • regionName (string) –

          The Amazon Web Services Region name.

      • resourceType (string) –

        The Lightsail resource type.

      • tags (list) –

        The tag keys and optional values for the resource. For more information about tags in Lightsail, see the Amazon Lightsail Developer Guide.

        • (dict) –

          Describes a tag key and optional value assigned to an Amazon Lightsail resource.

          For more information about tags in Lightsail, see the Amazon Lightsail Developer Guide.

          • key (string) –

            The key of the tag.

            Constraints: Tag keys accept a maximum of 128 letters, numbers, spaces in UTF-8, or the following characters: + - = . _ : / @

          • value (string) –

            The value of the tag.

            Constraints: Tag values accept a maximum of 256 letters, numbers, spaces in UTF-8, or the following characters: + - = . _ : / @

      • engine (string) –

        The software of the database snapshot (for example, MySQL)

      • engineVersion (string) –

        The database engine version for the database snapshot (for example, 5.7.23).

      • sizeInGb (integer) –

        The size of the disk in GB (for example, 32) for the database snapshot.

      • state (string) –

        The state of the database snapshot.

      • fromRelationalDatabaseName (string) –

        The name of the source database from which the database snapshot was created.

      • fromRelationalDatabaseArn (string) –

        The Amazon Resource Name (ARN) of the database from which the database snapshot was created.

      • fromRelationalDatabaseBundleId (string) –

        The bundle ID of the database from which the database snapshot was created.

      • fromRelationalDatabaseBlueprintId (string) –

        The blueprint ID of the database from which the database snapshot was created. A blueprint describes the major engine version of a database.

Exceptions

  • Lightsail.Client.exceptions.ServiceException

  • Lightsail.Client.exceptions.InvalidInputException

  • Lightsail.Client.exceptions.NotFoundException

  • Lightsail.Client.exceptions.OperationFailureException

  • Lightsail.Client.exceptions.AccessDeniedException

  • Lightsail.Client.exceptions.AccountSetupInProgressException

  • Lightsail.Client.exceptions.UnauthenticatedException