Lightsail / Client / get_relational_database

get_relational_database#

Lightsail.Client.get_relational_database(**kwargs)#

Returns information about a specific database in Amazon Lightsail.

Request Syntax

response = client.get_relational_database(
    relationalDatabaseName='string'
)

Parameters:

relationalDatabaseName (string) –

[REQUIRED]

The name of the database that you are looking up.

Return type:

dict

Returns:

Response Syntax

{
    'relationalDatabase': {
        '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'
            },
        ],
        'relationalDatabaseBlueprintId': 'string',
        'relationalDatabaseBundleId': 'string',
        'masterDatabaseName': 'string',
        'hardware': {
            'cpuCount': 123,
            'diskSizeInGb': 123,
            'ramSizeInGb': ...
        },
        'state': 'string',
        'secondaryAvailabilityZone': 'string',
        'backupRetentionEnabled': True|False,
        'pendingModifiedValues': {
            'masterUserPassword': 'string',
            'engineVersion': 'string',
            'backupRetentionEnabled': True|False
        },
        'engine': 'string',
        'engineVersion': 'string',
        'latestRestorableTime': datetime(2015, 1, 1),
        'masterUsername': 'string',
        'parameterApplyStatus': 'string',
        'preferredBackupWindow': 'string',
        'preferredMaintenanceWindow': 'string',
        'publiclyAccessible': True|False,
        'masterEndpoint': {
            'port': 123,
            'address': 'string'
        },
        'pendingMaintenanceActions': [
            {
                'action': 'string',
                'description': 'string',
                'currentApplyDate': datetime(2015, 1, 1)
            },
        ],
        'caCertificateIdentifier': 'string'
    }
}

Response Structure

(dict) –
- relationalDatabase (dict) –
  
  An object describing the specified database.
  - name (string) –
    
    The unique name of the database resource in Lightsail.
  - arn (string) –
    
    The Amazon Resource Name (ARN) of the database.
  - supportCode (string) –
    
    The support code for the database. Include this code in your email to support when you have questions about a database in Lightsail. This code enables our support team to look up your Lightsail information more easily.
  - createdAt (datetime) –
    
    The timestamp when the database was created. Formatted in Unix time.
  - location (dict) –
    
    The Region name and Availability Zone where the database 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 for the database (for example, RelationalDatabase).
  - 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: + - = . _ : / @
  - relationalDatabaseBlueprintId (string) –
    
    The blueprint ID for the database. A blueprint describes the major engine version of a database.
  - relationalDatabaseBundleId (string) –
    
    The bundle ID for the database. A bundle describes the performance specifications for your database.
  - masterDatabaseName (string) –
    
    The name of the master database created when the Lightsail database resource is created.
  - hardware (dict) –
    
    Describes the hardware of the database.
    - cpuCount (integer) –
      
      The number of vCPUs for the database.
    - diskSizeInGb (integer) –
      
      The size of the disk for the database.
    - ramSizeInGb (float) –
      
      The amount of RAM in GB for the database.
  - state (string) –
    
    Describes the current state of the database.
  - secondaryAvailabilityZone (string) –
    
    Describes the secondary Availability Zone of a high availability database.
    
    The secondary database is used for failover support of a high availability database.
  - backupRetentionEnabled (boolean) –
    
    A Boolean value indicating whether automated backup retention is enabled for the database.
  - pendingModifiedValues (dict) –
    
    Describes pending database value modifications.
    - masterUserPassword (string) –
      
      The password for the master user of the database.
    - engineVersion (string) –
      
      The database engine version.
    - backupRetentionEnabled (boolean) –
      
      A Boolean value indicating whether automated backup retention is enabled.
  - engine (string) –
    
    The database software (for example, MySQL).
  - engineVersion (string) –
    
    The database engine version (for example, 5.7.23).
  - latestRestorableTime (datetime) –
    
    The latest point in time to which the database can be restored. Formatted in Unix time.
  - masterUsername (string) –
    
    The master user name of the database.
  - parameterApplyStatus (string) –
    
    The status of parameter updates for the database.
  - preferredBackupWindow (string) –
    
    The daily time range during which automated backups are created for the database (for example, 16:00-16:30).
  - preferredMaintenanceWindow (string) –
    
    The weekly time range during which system maintenance can occur on the database.
    
    In the format ddd:hh24:mi-ddd:hh24:mi. For example, Tue:17:00-Tue:17:30.
  - publiclyAccessible (boolean) –
    
    A Boolean value indicating whether the database is publicly accessible.
  - masterEndpoint (dict) –
    
    The master endpoint for the database.
    - port (integer) –
      
      Specifies the port that the database is listening on.
    - address (string) –
      
      Specifies the DNS address of the database.
  - pendingMaintenanceActions (list) –
    
    Describes the pending maintenance actions for the database.
    - (dict) –
      
      Describes a pending database maintenance action.
      - action (string) –
        
        The type of pending database maintenance action.
      - description (string) –
        
        Additional detail about the pending database maintenance action.
      - currentApplyDate (datetime) –
        
        The effective date of the pending database maintenance action.
  - caCertificateIdentifier (string) –
    
    The certificate associated with the 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