Amazon Relational Database Service 2014-10-31

AddRoleToDBCluster

$result = $client->addRoleToDBCluster([/* ... */]);
$promise = $client->addRoleToDBClusterAsync([/* ... */]);

Parameter Syntax

$result = $client->addRoleToDBCluster([
    'DBClusterIdentifier' => '<string>', // REQUIRED
    'FeatureName' => '<string>',
    'RoleArn' => '<string>', // REQUIRED
]);

Parameter Details

Result Syntax

[]

Result Details

Errors

• DBClusterNotFoundFault:

  DBClusterIdentifier doesn't refer to an existing DB cluster.

• DBClusterRoleAlreadyExistsFault:

  The specified IAM role Amazon Resource Name (ARN) is already associated with the specified DB cluster.

• InvalidDBClusterStateFault:

  The requested operation can't be performed while the cluster is in this state.

• DBClusterRoleQuotaExceededFault:

  You have exceeded the maximum number of IAM roles that can be associated with the specified DB cluster.

AddRoleToDBInstance

$result = $client->addRoleToDBInstance([/* ... */]);
$promise = $client->addRoleToDBInstanceAsync([/* ... */]);

Parameter Syntax

$result = $client->addRoleToDBInstance([
    'DBInstanceIdentifier' => '<string>', // REQUIRED
    'FeatureName' => '<string>', // REQUIRED
    'RoleArn' => '<string>', // REQUIRED
]);

Parameter Details

Result Syntax

[]

Result Details

Errors

• DBInstanceNotFoundFault:

  DBInstanceIdentifier doesn't refer to an existing DB instance.

• DBInstanceRoleAlreadyExistsFault:

  The specified RoleArn or FeatureName value is already associated with the DB instance.

• InvalidDBInstanceStateFault:

  The DB instance isn't in a valid state.

• DBInstanceRoleQuotaExceededFault:

  You can't associate any more AWS Identity and Access Management (IAM) roles with the DB instance because the quota has been reached.

AddSourceIdentifierToSubscription

$result = $client->addSourceIdentifierToSubscription([/* ... */]);
$promise = $client->addSourceIdentifierToSubscriptionAsync([/* ... */]);

Parameter Syntax

$result = $client->addSourceIdentifierToSubscription([
    'SourceIdentifier' => '<string>', // REQUIRED
    'SubscriptionName' => '<string>', // REQUIRED
]);

Parameter Details

Result Syntax

[
    'EventSubscription' => [
        'CustSubscriptionId' => '<string>',
        'CustomerAwsId' => '<string>',
        'Enabled' => true || false,
        'EventCategoriesList' => ['<string>', ...],
        'EventSubscriptionArn' => '<string>',
        'SnsTopicArn' => '<string>',
        'SourceIdsList' => ['<string>', ...],
        'SourceType' => '<string>',
        'Status' => '<string>',
        'SubscriptionCreationTime' => '<string>',
    ],
]

Result Details

Errors

• SubscriptionNotFoundFault:

  The subscription name does not exist.

• SourceNotFoundFault:

  The requested source could not be found.

Examples

Example 1: To add a source identifier to an event notification subscription

This example add a source identifier to an event notification subscription.

$result = $client->addSourceIdentifierToSubscription([
    'SourceIdentifier' => 'mymysqlinstance',
    'SubscriptionName' => 'mymysqleventsubscription',
]);

Result syntax:

[
    'EventSubscription' => [
    ],
]

AddTagsToResource

$result = $client->addTagsToResource([/* ... */]);
$promise = $client->addTagsToResourceAsync([/* ... */]);

Parameter Syntax

$result = $client->addTagsToResource([
    'ResourceName' => '<string>', // REQUIRED
    'Tags' => [ // REQUIRED
        [
            'Key' => '<string>',
            'Value' => '<string>',
        ],
        // ...
    ],
]);

Parameter Details

Result Syntax

[]

Result Details

Errors

• DBInstanceNotFoundFault:

  DBInstanceIdentifier doesn't refer to an existing DB instance.

• DBClusterNotFoundFault:

  DBClusterIdentifier doesn't refer to an existing DB cluster.

• DBSnapshotNotFoundFault:

  DBSnapshotIdentifier doesn't refer to an existing DB snapshot.

• DBProxyNotFoundFault:

  The specified proxy name doesn't correspond to a proxy owned by your AWS account in the specified AWS Region.

• DBProxyTargetGroupNotFoundFault:

  The specified target group isn't available for a proxy owned by your AWS account in the specified AWS Region.

Examples

Example 1: To add tags to a resource

This example adds a tag to an option group.

$result = $client->addTagsToResource([
    'ResourceName' => 'arn:aws:rds:us-east-1:992648334831:og:mymysqloptiongroup',
    'Tags' => [
        [
            'Key' => 'Staging',
            'Value' => 'LocationDB',
        ],
    ],
]);

ApplyPendingMaintenanceAction

$result = $client->applyPendingMaintenanceAction([/* ... */]);
$promise = $client->applyPendingMaintenanceActionAsync([/* ... */]);

Parameter Syntax

$result = $client->applyPendingMaintenanceAction([
    'ApplyAction' => '<string>', // REQUIRED
    'OptInType' => '<string>', // REQUIRED
    'ResourceIdentifier' => '<string>', // REQUIRED
]);

Parameter Details

Result Syntax

[
    'ResourcePendingMaintenanceActions' => [
        'PendingMaintenanceActionDetails' => [
            [
                'Action' => '<string>',
                'AutoAppliedAfterDate' => <DateTime>,
                'CurrentApplyDate' => <DateTime>,
                'Description' => '<string>',
                'ForcedApplyDate' => <DateTime>,
                'OptInStatus' => '<string>',
            ],
            // ...
        ],
        'ResourceIdentifier' => '<string>',
    ],
]

Result Details

Errors

• ResourceNotFoundFault:

  The specified resource ID was not found.

• InvalidDBClusterStateFault:

  The requested operation can't be performed while the cluster is in this state.

• InvalidDBInstanceStateFault:

  The DB instance isn't in a valid state.

Examples

Example 1: To apply a pending maintenance action

This example immediately applies a pending system update to a DB instance.

$result = $client->applyPendingMaintenanceAction([
    'ApplyAction' => 'system-update',
    'OptInType' => 'immediate',
    'ResourceIdentifier' => 'arn:aws:rds:us-east-1:992648334831:db:mymysqlinstance',
]);

Result syntax:

[
    'ResourcePendingMaintenanceActions' => [
    ],
]

AuthorizeDBSecurityGroupIngress

$result = $client->authorizeDBSecurityGroupIngress([/* ... */]);
$promise = $client->authorizeDBSecurityGroupIngressAsync([/* ... */]);

Parameter Syntax

$result = $client->authorizeDBSecurityGroupIngress([
    'CIDRIP' => '<string>',
    'DBSecurityGroupName' => '<string>', // REQUIRED
    'EC2SecurityGroupId' => '<string>',
    'EC2SecurityGroupName' => '<string>',
    'EC2SecurityGroupOwnerId' => '<string>',
]);

Parameter Details

Result Syntax

[
    'DBSecurityGroup' => [
        'DBSecurityGroupArn' => '<string>',
        'DBSecurityGroupDescription' => '<string>',
        'DBSecurityGroupName' => '<string>',
        'EC2SecurityGroups' => [
            [
                'EC2SecurityGroupId' => '<string>',
                'EC2SecurityGroupName' => '<string>',
                'EC2SecurityGroupOwnerId' => '<string>',
                'Status' => '<string>',
            ],
            // ...
        ],
        'IPRanges' => [
            [
                'CIDRIP' => '<string>',
                'Status' => '<string>',
            ],
            // ...
        ],
        'OwnerId' => '<string>',
        'VpcId' => '<string>',
    ],
]

Result Details

Errors

• DBSecurityGroupNotFoundFault:

  DBSecurityGroupName doesn't refer to an existing DB security group.

• InvalidDBSecurityGroupStateFault:

  The state of the DB security group doesn't allow deletion.

• AuthorizationAlreadyExistsFault:

  The specified CIDR IP range or Amazon EC2 security group is already authorized for the specified DB security group.

• AuthorizationQuotaExceededFault:

  The DB security group authorization quota has been reached.

Examples

Example 1: To authorize DB security group integress

This example authorizes access to the specified security group by the specified CIDR block.

$result = $client->authorizeDBSecurityGroupIngress([
    'CIDRIP' => '203.0.113.5/32',
    'DBSecurityGroupName' => 'mydbsecuritygroup',
]);

Result syntax:

[
    'DBSecurityGroup' => [
    ],
]

BacktrackDBCluster

$result = $client->backtrackDBCluster([/* ... */]);
$promise = $client->backtrackDBClusterAsync([/* ... */]);

Parameter Syntax

$result = $client->backtrackDBCluster([
    'BacktrackTo' => <integer || string || DateTime>, // REQUIRED
    'DBClusterIdentifier' => '<string>', // REQUIRED
    'Force' => true || false,
    'UseEarliestTimeOnPointInTimeUnavailable' => true || false,
]);

Parameter Details

Result Syntax

[
    'BacktrackIdentifier' => '<string>',
    'BacktrackRequestCreationTime' => <DateTime>,
    'BacktrackTo' => <DateTime>,
    'BacktrackedFrom' => <DateTime>,
    'DBClusterIdentifier' => '<string>',
    'Status' => '<string>',
]

Result Details

Errors

• DBClusterNotFoundFault:

  DBClusterIdentifier doesn't refer to an existing DB cluster.

• InvalidDBClusterStateFault:

  The requested operation can't be performed while the cluster is in this state.

CancelExportTask

$result = $client->cancelExportTask([/* ... */]);
$promise = $client->cancelExportTaskAsync([/* ... */]);

Parameter Syntax

$result = $client->cancelExportTask([
    'ExportTaskIdentifier' => '<string>', // REQUIRED
]);

Parameter Details

Result Syntax

[
    'ExportOnly' => ['<string>', ...],
    'ExportTaskIdentifier' => '<string>',
    'FailureCause' => '<string>',
    'IamRoleArn' => '<string>',
    'KmsKeyId' => '<string>',
    'PercentProgress' => <integer>,
    'S3Bucket' => '<string>',
    'S3Prefix' => '<string>',
    'SnapshotTime' => <DateTime>,
    'SourceArn' => '<string>',
    'Status' => '<string>',
    'TaskEndTime' => <DateTime>,
    'TaskStartTime' => <DateTime>,
    'TotalExtractedDataInGB' => <integer>,
    'WarningMessage' => '<string>',
]

Result Details

Errors

• ExportTaskNotFoundFault:

  The export task doesn't exist.

• InvalidExportTaskStateFault:

  You can't cancel an export task that has completed.

CopyDBClusterParameterGroup

$result = $client->copyDBClusterParameterGroup([/* ... */]);
$promise = $client->copyDBClusterParameterGroupAsync([/* ... */]);

Parameter Syntax

$result = $client->copyDBClusterParameterGroup([
    'SourceDBClusterParameterGroupIdentifier' => '<string>', // REQUIRED
    'Tags' => [
        [
            'Key' => '<string>',
            'Value' => '<string>',
        ],
        // ...
    ],
    'TargetDBClusterParameterGroupDescription' => '<string>', // REQUIRED
    'TargetDBClusterParameterGroupIdentifier' => '<string>', // REQUIRED
]);

Parameter Details

Result Syntax

[
    'DBClusterParameterGroup' => [
        'DBClusterParameterGroupArn' => '<string>',
        'DBClusterParameterGroupName' => '<string>',
        'DBParameterGroupFamily' => '<string>',
        'Description' => '<string>',
    ],
]

Result Details

Errors

• DBParameterGroupNotFoundFault:

  DBParameterGroupName doesn't refer to an existing DB parameter group.

• DBParameterGroupQuotaExceededFault:

  The request would result in the user exceeding the allowed number of DB parameter groups.

• DBParameterGroupAlreadyExistsFault:

  A DB parameter group with the same name exists.

Examples

Example 1: To copy a DB cluster parameter group

This example copies a DB cluster parameter group.

$result = $client->copyDBClusterParameterGroup([
    'SourceDBClusterParameterGroupIdentifier' => 'mydbclusterparametergroup',
    'TargetDBClusterParameterGroupDescription' => 'My DB cluster parameter group copy',
    'TargetDBClusterParameterGroupIdentifier' => 'mydbclusterparametergroup-copy',
]);

Result syntax:

[
    'DBClusterParameterGroup' => [
    ],
]

CopyDBClusterSnapshot

$result = $client->copyDBClusterSnapshot([/* ... */]);
$promise = $client->copyDBClusterSnapshotAsync([/* ... */]);

Parameter Syntax

$result = $client->copyDBClusterSnapshot([
    'CopyTags' => true || false,
    'DestinationRegion' => '<string>',
    'KmsKeyId' => '<string>',
    'PreSignedUrl' => '<string>',
    'SourceDBClusterSnapshotIdentifier' => '<string>', // REQUIRED
    'SourceRegion' => '<string>',
    'Tags' => [
        [
            'Key' => '<string>',
            'Value' => '<string>',
        ],
        // ...
    ],
    'TargetDBClusterSnapshotIdentifier' => '<string>', // REQUIRED
]);

Parameter Details

Result Syntax

[
    'DBClusterSnapshot' => [
        'AllocatedStorage' => <integer>,
        'AvailabilityZones' => ['<string>', ...],
        'ClusterCreateTime' => <DateTime>,
        'DBClusterIdentifier' => '<string>',
        'DBClusterSnapshotArn' => '<string>',
        'DBClusterSnapshotIdentifier' => '<string>',
        'Engine' => '<string>',
        'EngineVersion' => '<string>',
        'IAMDatabaseAuthenticationEnabled' => true || false,
        'KmsKeyId' => '<string>',
        'LicenseModel' => '<string>',
        'MasterUsername' => '<string>',
        'PercentProgress' => <integer>,
        'Port' => <integer>,
        'SnapshotCreateTime' => <DateTime>,
        'SnapshotType' => '<string>',
        'SourceDBClusterSnapshotArn' => '<string>',
        'Status' => '<string>',
        'StorageEncrypted' => true || false,
        'TagList' => [
            [
                'Key' => '<string>',
                'Value' => '<string>',
            ],
            // ...
        ],
        'VpcId' => '<string>',
    ],
]

Result Details

Errors

• DBClusterSnapshotAlreadyExistsFault:

  The user already has a DB cluster snapshot with the given identifier.

• DBClusterSnapshotNotFoundFault:

  DBClusterSnapshotIdentifier doesn't refer to an existing DB cluster snapshot.

• InvalidDBClusterStateFault:

  The requested operation can't be performed while the cluster is in this state.

• InvalidDBClusterSnapshotStateFault:

  The supplied value isn't a valid DB cluster snapshot state.

• SnapshotQuotaExceededFault:

  The request would result in the user exceeding the allowed number of DB snapshots.

• KMSKeyNotAccessibleFault:

  An error occurred accessing an AWS KMS key.

Examples

Example 1: To copy a DB cluster snapshot

The following example copies an automated snapshot of a DB cluster to a new DB cluster snapshot.

$result = $client->copyDBClusterSnapshot([
    'SourceDBClusterSnapshotIdentifier' => 'rds:sample-cluster-2016-09-14-10-38',
    'TargetDBClusterSnapshotIdentifier' => 'cluster-snapshot-copy-1',
]);

Result syntax:

[
    'DBClusterSnapshot' => [
    ],
]

CopyDBParameterGroup

$result = $client->copyDBParameterGroup([/* ... */]);
$promise = $client->copyDBParameterGroupAsync([/* ... */]);

Parameter Syntax

$result = $client->copyDBParameterGroup([
    'SourceDBParameterGroupIdentifier' => '<string>', // REQUIRED
    'Tags' => [
        [
            'Key' => '<string>',
            'Value' => '<string>',
        ],
        // ...
    ],
    'TargetDBParameterGroupDescription' => '<string>', // REQUIRED
    'TargetDBParameterGroupIdentifier' => '<string>', // REQUIRED
]);

Parameter Details

Result Syntax

[
    'DBParameterGroup' => [
        'DBParameterGroupArn' => '<string>',
        'DBParameterGroupFamily' => '<string>',
        'DBParameterGroupName' => '<string>',
        'Description' => '<string>',
    ],
]

Result Details

Errors

• DBParameterGroupNotFoundFault:

  DBParameterGroupName doesn't refer to an existing DB parameter group.

• DBParameterGroupAlreadyExistsFault:

  A DB parameter group with the same name exists.

• DBParameterGroupQuotaExceededFault:

  The request would result in the user exceeding the allowed number of DB parameter groups.

Examples

Example 1: To copy a DB parameter group

This example copies a DB parameter group.

$result = $client->copyDBParameterGroup([
    'SourceDBParameterGroupIdentifier' => 'mymysqlparametergroup',
    'TargetDBParameterGroupDescription' => 'My MySQL parameter group copy',
    'TargetDBParameterGroupIdentifier' => 'mymysqlparametergroup-copy',
]);

Result syntax:

[
    'DBParameterGroup' => [
    ],
]

CopyDBSnapshot

$result = $client->copyDBSnapshot([/* ... */]);
$promise = $client->copyDBSnapshotAsync([/* ... */]);

Parameter Syntax

$result = $client->copyDBSnapshot([
    'CopyTags' => true || false,
    'DestinationRegion' => '<string>',
    'KmsKeyId' => '<string>',
    'OptionGroupName' => '<string>',
    'PreSignedUrl' => '<string>',
    'SourceDBSnapshotIdentifier' => '<string>', // REQUIRED
    'SourceRegion' => '<string>',
    'Tags' => [
        [
            'Key' => '<string>',
            'Value' => '<string>',
        ],
        // ...
    ],
    'TargetCustomAvailabilityZone' => '<string>',
    'TargetDBSnapshotIdentifier' => '<string>', // REQUIRED
]);

Parameter Details

Result Syntax

[
    'DBSnapshot' => [
        'AllocatedStorage' => <integer>,
        'AvailabilityZone' => '<string>',
        'DBInstanceIdentifier' => '<string>',
        'DBSnapshotArn' => '<string>',
        'DBSnapshotIdentifier' => '<string>',
        'DbiResourceId' => '<string>',
        'Encrypted' => true || false,
        'Engine' => '<string>',
        'EngineVersion' => '<string>',
        'IAMDatabaseAuthenticationEnabled' => true || false,
        'InstanceCreateTime' => <DateTime>,
        'Iops' => <integer>,
        'KmsKeyId' => '<string>',
        'LicenseModel' => '<string>',
        'MasterUsername' => '<string>',
        'OptionGroupName' => '<string>',
        'PercentProgress' => <integer>,
        'Port' => <integer>,
        'ProcessorFeatures' => [
            [
                'Name' => '<string>',
                'Value' => '<string>',
            ],
            // ...
        ],
        'SnapshotCreateTime' => <DateTime>,
        'SnapshotType' => '<string>',
        'SourceDBSnapshotIdentifier' => '<string>',
        'SourceRegion' => '<string>',
        'Status' => '<string>',
        'StorageType' => '<string>',
        'TagList' => [
            [
                'Key' => '<string>',
                'Value' => '<string>',
            ],
            // ...
        ],
        'TdeCredentialArn' => '<string>',
        'Timezone' => '<string>',
        'VpcId' => '<string>',
    ],
]

Result Details

Errors

• DBSnapshotAlreadyExistsFault:

  DBSnapshotIdentifier is already used by an existing snapshot.

• DBSnapshotNotFoundFault:

  DBSnapshotIdentifier doesn't refer to an existing DB snapshot.

• InvalidDBSnapshotStateFault:

  The state of the DB snapshot doesn't allow deletion.

• SnapshotQuotaExceededFault:

  The request would result in the user exceeding the allowed number of DB snapshots.

• KMSKeyNotAccessibleFault:

  An error occurred accessing an AWS KMS key.

• CustomAvailabilityZoneNotFoundFault:

  CustomAvailabilityZoneId doesn't refer to an existing custom Availability Zone identifier.

Examples

Example 1: To copy a DB snapshot

This example copies a DB snapshot.

$result = $client->copyDBSnapshot([
    'SourceDBSnapshotIdentifier' => 'mydbsnapshot',
    'TargetDBSnapshotIdentifier' => 'mydbsnapshot-copy',
]);

Result syntax:

[
    'DBSnapshot' => [
    ],
]

CopyOptionGroup

$result = $client->copyOptionGroup([/* ... */]);
$promise = $client->copyOptionGroupAsync([/* ... */]);

Parameter Syntax

$result = $client->copyOptionGroup([
    'SourceOptionGroupIdentifier' => '<string>', // REQUIRED
    'Tags' => [
        [
            'Key' => '<string>',
            'Value' => '<string>',
        ],
        // ...
    ],
    'TargetOptionGroupDescription' => '<string>', // REQUIRED
    'TargetOptionGroupIdentifier' => '<string>', // REQUIRED
]);

Parameter Details

Result Syntax

[
    'OptionGroup' => [
        'AllowsVpcAndNonVpcInstanceMemberships' => true || false,
        'EngineName' => '<string>',
        'MajorEngineVersion' => '<string>',
        'OptionGroupArn' => '<string>',
        'OptionGroupDescription' => '<string>',
        'OptionGroupName' => '<string>',
        'Options' => [
            [
                'DBSecurityGroupMemberships' => [
                    [
                        'DBSecurityGroupName' => '<string>',
                        'Status' => '<string>',
                    ],
                    // ...
                ],
                'OptionDescription' => '<string>',
                'OptionName' => '<string>',
                'OptionSettings' => [
                    [
                        'AllowedValues' => '<string>',
                        'ApplyType' => '<string>',
                        'DataType' => '<string>',
                        'DefaultValue' => '<string>',
                        'Description' => '<string>',
                        'IsCollection' => true || false,
                        'IsModifiable' => true || false,
                        'Name' => '<string>',
                        'Value' => '<string>',
                    ],
                    // ...
                ],
                'OptionVersion' => '<string>',
                'Permanent' => true || false,
                'Persistent' => true || false,
                'Port' => <integer>,
                'VpcSecurityGroupMemberships' => [
                    [
                        'Status' => '<string>',
                        'VpcSecurityGroupId' => '<string>',
                    ],
                    // ...
                ],
            ],
            // ...
        ],
        'VpcId' => '<string>',
    ],
]

Result Details

Errors

• OptionGroupAlreadyExistsFault:

  The option group you are trying to create already exists.

• OptionGroupNotFoundFault:

  The specified option group could not be found.

• OptionGroupQuotaExceededFault:

  The quota of 20 option groups was exceeded for this AWS account.

Examples

Example 1: To copy an option group

This example copies an option group.

$result = $client->copyOptionGroup([
    'SourceOptionGroupIdentifier' => 'mymysqloptiongroup',
    'TargetOptionGroupDescription' => 'My MySQL option group copy',
    'TargetOptionGroupIdentifier' => 'mymysqloptiongroup-copy',
]);

Result syntax:

[
    'OptionGroup' => [
    ],
]

CreateCustomAvailabilityZone

$result = $client->createCustomAvailabilityZone([/* ... */]);
$promise = $client->createCustomAvailabilityZoneAsync([/* ... */]);

Parameter Syntax

$result = $client->createCustomAvailabilityZone([
    'CustomAvailabilityZoneName' => '<string>', // REQUIRED
    'ExistingVpnId' => '<string>',
    'NewVpnTunnelName' => '<string>',
    'VpnTunnelOriginatorIP' => '<string>',
]);

Parameter Details

Result Syntax

[
    'CustomAvailabilityZone' => [
        'CustomAvailabilityZoneId' => '<string>',
        'CustomAvailabilityZoneName' => '<string>',
        'CustomAvailabilityZoneStatus' => '<string>',
        'VpnDetails' => [
            'VpnGatewayIp' => '<string>',
            'VpnId' => '<string>',
            'VpnName' => '<string>',
            'VpnPSK' => '<string>',
            'VpnState' => '<string>',
            'VpnTunnelOriginatorIP' => '<string>',
        ],
    ],
]

Result Details

Errors

• CustomAvailabilityZoneAlreadyExistsFault:

  CustomAvailabilityZoneName is already used by an existing custom Availability Zone.

• CustomAvailabilityZoneQuotaExceededFault:

  You have exceeded the maximum number of custom Availability Zones.

• KMSKeyNotAccessibleFault:

  An error occurred accessing an AWS KMS key.

CreateDBCluster

$result = $client->createDBCluster([/* ... */]);
$promise = $client->createDBClusterAsync([/* ... */]);

Parameter Syntax

$result = $client->createDBCluster([
    'AvailabilityZones' => ['<string>', ...],
    'BacktrackWindow' => <integer>,
    'BackupRetentionPeriod' => <integer>,
    'CharacterSetName' => '<string>',
    'CopyTagsToSnapshot' => true || false,
    'DBClusterIdentifier' => '<string>', // REQUIRED
    'DBClusterParameterGroupName' => '<string>',
    'DBSubnetGroupName' => '<string>',
    'DatabaseName' => '<string>',
    'DeletionProtection' => true || false,
    'DestinationRegion' => '<string>',
    'Domain' => '<string>',
    'DomainIAMRoleName' => '<string>',
    'EnableCloudwatchLogsExports' => ['<string>', ...],
    'EnableGlobalWriteForwarding' => true || false,
    'EnableHttpEndpoint' => true || false,
    'EnableIAMDatabaseAuthentication' => true || false,
    'Engine' => '<string>', // REQUIRED
    'EngineMode' => '<string>',
    'EngineVersion' => '<string>',
    'GlobalClusterIdentifier' => '<string>',
    'KmsKeyId' => '<string>',
    'MasterUserPassword' => '<string>',
    'MasterUsername' => '<string>',
    'OptionGroupName' => '<string>',
    'Port' => <integer>,
    'PreSignedUrl' => '<string>',
    'PreferredBackupWindow' => '<string>',
    'PreferredMaintenanceWindow' => '<string>',
    'ReplicationSourceIdentifier' => '<string>',
    'ScalingConfiguration' => [
        'AutoPause' => true || false,
        'MaxCapacity' => <integer>,
        'MinCapacity' => <integer>,
        'SecondsUntilAutoPause' => <integer>,
        'TimeoutAction' => '<string>',
    ],
    'SourceRegion' => '<string>',
    'StorageEncrypted' => true || false,
    'Tags' => [
        [
            'Key' => '<string>',
            'Value' => '<string>',
        ],
        // ...
    ],
    'VpcSecurityGroupIds' => ['<string>', ...],
]);

Parameter Details

Result Syntax

[
    'DBCluster' => [
        'ActivityStreamKinesisStreamName' => '<string>',
        'ActivityStreamKmsKeyId' => '<string>',
        'ActivityStreamMode' => 'sync|async',
        'ActivityStreamStatus' => 'stopped|starting|started|stopping',
        'AllocatedStorage' => <integer>,
        'AssociatedRoles' => [
            [
                'FeatureName' => '<string>',
                'RoleArn' => '<string>',
                'Status' => '<string>',
            ],
            // ...
        ],
        'AvailabilityZones' => ['<string>', ...],
        'BacktrackConsumedChangeRecords' => <integer>,
        'BacktrackWindow' => <integer>,
        'BackupRetentionPeriod' => <integer>,
        'Capacity' => <integer>,
        'CharacterSetName' => '<string>',
        'CloneGroupId' => '<string>',
        'ClusterCreateTime' => <DateTime>,
        'CopyTagsToSnapshot' => true || false,
        'CrossAccountClone' => true || false,
        'CustomEndpoints' => ['<string>', ...],
        'DBClusterArn' => '<string>',
        'DBClusterIdentifier' => '<string>',
        'DBClusterMembers' => [
            [
                'DBClusterParameterGroupStatus' => '<string>',
                'DBInstanceIdentifier' => '<string>',
                'IsClusterWriter' => true || false,
                'PromotionTier' => <integer>,
            ],
            // ...
        ],
        'DBClusterOptionGroupMemberships' => [
            [
                'DBClusterOptionGroupName' => '<string>',
                'Status' => '<string>',
            ],
            // ...
        ],
        'DBClusterParameterGroup' => '<string>',
        'DBSubnetGroup' => '<string>',
        'DatabaseName' => '<string>',
        'DbClusterResourceId' => '<string>',
        'DeletionProtection' => true || false,
        'DomainMemberships' => [
            [
                'Domain' => '<string>',
                'FQDN' => '<string>',
                'IAMRoleName' => '<string>',
                'Status' => '<string>',
            ],
            // ...
        ],
        'EarliestBacktrackTime' => <DateTime>,
        'EarliestRestorableTime' => <DateTime>,
        'EnabledCloudwatchLogsExports' => ['<string>', ...],
        'Endpoint' => '<string>',
        'Engine' => '<string>',
        'EngineMode' => '<string>',
        'EngineVersion' => '<string>',
        'GlobalWriteForwardingRequested' => true || false,
        'GlobalWriteForwardingStatus' => 'enabled|disabled|enabling|disabling|unknown',
        'HostedZoneId' => '<string>',
        'HttpEndpointEnabled' => true || false,
        'IAMDatabaseAuthenticationEnabled' => true || false,
        'KmsKeyId' => '<string>',
        'LatestRestorableTime' => <DateTime>,
        'MasterUsername' => '<string>',
        'MultiAZ' => true || false,
        'PercentProgress' => '<string>',
        'Port' => <integer>,
        'PreferredBackupWindow' => '<string>',
        'PreferredMaintenanceWindow' => '<string>',
        'ReadReplicaIdentifiers' => ['<string>', ...],
        'ReaderEndpoint' => '<string>',
        'ReplicationSourceIdentifier' => '<string>',
        'ScalingConfigurationInfo' => [
            'AutoPause' => true || false,
            'MaxCapacity' => <integer>,
            'MinCapacity' => <integer>,
            'SecondsUntilAutoPause' => <integer>,
            'TimeoutAction' => '<string>',
        ],
        'Status' => '<string>',
        'StorageEncrypted' => true || false,
        'TagList' => [
            [
                'Key' => '<string>',
                'Value' => '<string>',
            ],
            // ...
        ],
        'VpcSecurityGroups' => [
            [
                'Status' => '<string>',
                'VpcSecurityGroupId' => '<string>',
            ],
            // ...
        ],
    ],
]

Result Details

Errors

• DBClusterAlreadyExistsFault:

  The user already has a DB cluster with the given identifier.

• InsufficientStorageClusterCapacityFault:

  There is insufficient storage available for the current action. You might be able to resolve this error by updating your subnet group to use different Availability Zones that have more storage available.

• DBClusterQuotaExceededFault:

  The user attempted to create a new DB cluster and the user has already reached the maximum allowed DB cluster quota.

• StorageQuotaExceededFault:

  The request would result in the user exceeding the allowed amount of storage available across all DB instances.

• DBSubnetGroupNotFoundFault:

  DBSubnetGroupName doesn't refer to an existing DB subnet group.

• InvalidVPCNetworkStateFault:

  The DB subnet group doesn't cover all Availability Zones after it's created because of users' change.

• InvalidDBClusterStateFault:

  The requested operation can't be performed while the cluster is in this state.

• InvalidDBSubnetGroupStateFault:

  The DB subnet group cannot be deleted because it's in use.

• InvalidSubnet:

  The requested subnet is invalid, or multiple subnets were requested that are not all in a common VPC.

• InvalidDBInstanceStateFault:

  The DB instance isn't in a valid state.

• DBClusterParameterGroupNotFoundFault:

  DBClusterParameterGroupName doesn't refer to an existing DB cluster parameter group.

• KMSKeyNotAccessibleFault:

  An error occurred accessing an AWS KMS key.

• DBClusterNotFoundFault:

  DBClusterIdentifier doesn't refer to an existing DB cluster.

• DBInstanceNotFoundFault:

  DBInstanceIdentifier doesn't refer to an existing DB instance.

• DBSubnetGroupDoesNotCoverEnoughAZs:

  Subnets in the DB subnet group should cover at least two Availability Zones unless there is only one Availability Zone.

• GlobalClusterNotFoundFault:

• InvalidGlobalClusterStateFault:

• DomainNotFoundFault:

  Domain doesn't refer to an existing Active Directory domain.

Examples

Example 1: To create a DB cluster

This example creates a DB cluster.

$result = $client->createDBCluster([
    'AvailabilityZones' => [
        'us-east-1a',
    ],
    'BackupRetentionPeriod' => 1,
    'DBClusterIdentifier' => 'mydbcluster',
    'DBClusterParameterGroupName' => 'mydbclusterparametergroup',
    'DatabaseName' => 'myauroradb',
    'Engine' => 'aurora',
    'EngineVersion' => '5.6.10a',
    'MasterUserPassword' => 'mypassword',
    'MasterUsername' => 'myuser',
    'Port' => 3306,
    'StorageEncrypted' => 1,
]);

Result syntax:

[
    'DBCluster' => [
    ],
]

CreateDBClusterEndpoint

$result = $client->createDBClusterEndpoint([/* ... */]);
$promise = $client->createDBClusterEndpointAsync([/* ... */]);

Parameter Syntax

$result = $client->createDBClusterEndpoint([
    'DBClusterEndpointIdentifier' => '<string>', // REQUIRED
    'DBClusterIdentifier' => '<string>', // REQUIRED
    'EndpointType' => '<string>', // REQUIRED
    'ExcludedMembers' => ['<string>', ...],
    'StaticMembers' => ['<string>', ...],
    'Tags' => [
        [
            'Key' => '<string>',
            'Value' => '<string>',
        ],
        // ...
    ],
]);

Parameter Details

Result Syntax

[
    'CustomEndpointType' => '<string>',
    'DBClusterEndpointArn' => '<string>',
    'DBClusterEndpointIdentifier' => '<string>',
    'DBClusterEndpointResourceIdentifier' => '<string>',
    'DBClusterIdentifier' => '<string>',
    'Endpoint' => '<string>',
    'EndpointType' => '<string>',
    'ExcludedMembers' => ['<string>', ...],
    'StaticMembers' => ['<string>', ...],
    'Status' => '<string>',
]

Result Details

Errors

• DBClusterEndpointQuotaExceededFault:

  The cluster already has the maximum number of custom endpoints.

• DBClusterEndpointAlreadyExistsFault:

  The specified custom endpoint can't be created because it already exists.

• DBClusterNotFoundFault:

  DBClusterIdentifier doesn't refer to an existing DB cluster.

• InvalidDBClusterStateFault:

  The requested operation can't be performed while the cluster is in this state.

• DBInstanceNotFoundFault:

  DBInstanceIdentifier doesn't refer to an existing DB instance.

• InvalidDBInstanceStateFault:

  The DB instance isn't in a valid state.

CreateDBClusterParameterGroup

$result = $client->createDBClusterParameterGroup([/* ... */]);
$promise = $client->createDBClusterParameterGroupAsync([/* ... */]);

Parameter Syntax

$result = $client->createDBClusterParameterGroup([
    'DBClusterParameterGroupName' => '<string>', // REQUIRED
    'DBParameterGroupFamily' => '<string>', // REQUIRED
    'Description' => '<string>', // REQUIRED
    'Tags' => [
        [
            'Key' => '<string>',
            'Value' => '<string>',
        ],
        // ...
    ],
]);

Parameter Details

Result Syntax

[
    'DBClusterParameterGroup' => [
        'DBClusterParameterGroupArn' => '<string>',
        'DBClusterParameterGroupName' => '<string>',
        'DBParameterGroupFamily' => '<string>',
        'Description' => '<string>',
    ],
]

Result Details

Errors

• DBParameterGroupQuotaExceededFault:

  The request would result in the user exceeding the allowed number of DB parameter groups.

• DBParameterGroupAlreadyExistsFault:

  A DB parameter group with the same name exists.

Examples

Example 1: To create a DB cluster parameter group

This example creates a DB cluster parameter group.

$result = $client->createDBClusterParameterGroup([
    'DBClusterParameterGroupName' => 'mydbclusterparametergroup',
    'DBParameterGroupFamily' => 'aurora5.6',
    'Description' => 'My DB cluster parameter group',
]);

Result syntax:

[
    'DBClusterParameterGroup' => [
    ],
]

CreateDBClusterSnapshot

$result = $client->createDBClusterSnapshot([/* ... */]);
$promise = $client->createDBClusterSnapshotAsync([/* ... */]);

Parameter Syntax

$result = $client->createDBClusterSnapshot([
    'DBClusterIdentifier' => '<string>', // REQUIRED
    'DBClusterSnapshotIdentifier' => '<string>', // REQUIRED
    'Tags' => [
        [
            'Key' => '<string>',
            'Value' => '<string>',
        ],
        // ...
    ],
]);

Parameter Details

Result Syntax

[
    'DBClusterSnapshot' => [
        'AllocatedStorage' => <integer>,
        'AvailabilityZones' => ['<string>', ...],
        'ClusterCreateTime' => <DateTime>,
        'DBClusterIdentifier' => '<string>',
        'DBClusterSnapshotArn' => '<string>',
        'DBClusterSnapshotIdentifier' => '<string>',
        'Engine' => '<string>',
        'EngineVersion' => '<string>',
        'IAMDatabaseAuthenticationEnabled' => true || false,
        'KmsKeyId' => '<string>',
        'LicenseModel' => '<string>',
        'MasterUsername' => '<string>',
        'PercentProgress' => <integer>,
        'Port' => <integer>,
        'SnapshotCreateTime' => <DateTime>,
        'SnapshotType' => '<string>',
        'SourceDBClusterSnapshotArn' => '<string>',
        'Status' => '<string>',
        'StorageEncrypted' => true || false,
        'TagList' => [
            [
                'Key' => '<string>',
                'Value' => '<string>',
            ],
            // ...
        ],
        'VpcId' => '<string>',
    ],
]

Result Details

Errors

• DBClusterSnapshotAlreadyExistsFault:

  The user already has a DB cluster snapshot with the given identifier.

• InvalidDBClusterStateFault:

  The requested operation can't be performed while the cluster is in this state.

• DBClusterNotFoundFault:

  DBClusterIdentifier doesn't refer to an existing DB cluster.

• SnapshotQuotaExceededFault:

  The request would result in the user exceeding the allowed number of DB snapshots.

• InvalidDBClusterSnapshotStateFault:

  The supplied value isn't a valid DB cluster snapshot state.

Examples

Example 1: To create a DB cluster snapshot

This example creates a DB cluster snapshot.

$result = $client->createDBClusterSnapshot([
    'DBClusterIdentifier' => 'mydbcluster',
    'DBClusterSnapshotIdentifier' => 'mydbclustersnapshot',
]);

Result syntax:

[
    'DBClusterSnapshot' => [
    ],
]

CreateDBInstance

$result = $client->createDBInstance([/* ... */]);
$promise = $client->createDBInstanceAsync([/* ... */]);

Parameter Syntax

$result = $client->createDBInstance([
    'AllocatedStorage' => <integer>,
    'AutoMinorVersionUpgrade' => true || false,
    'AvailabilityZone' => '<string>',
    'BackupRetentionPeriod' => <integer>,
    'CharacterSetName' => '<string>',
    'CopyTagsToSnapshot' => true || false,
    'DBClusterIdentifier' => '<string>',
    'DBInstanceClass' => '<string>', // REQUIRED
    'DBInstanceIdentifier' => '<string>', // REQUIRED
    'DBName' => '<string>',
    'DBParameterGroupName' => '<string>',
    'DBSecurityGroups' => ['<string>', ...],
    'DBSubnetGroupName' => '<string>',
    'DeletionProtection' => true || false,
    'Domain' => '<string>',
    'DomainIAMRoleName' => '<string>',
    'EnableCloudwatchLogsExports' => ['<string>', ...],
    'EnableIAMDatabaseAuthentication' => true || false,
    'EnablePerformanceInsights' => true || false,
    'Engine' => '<string>', // REQUIRED
    'EngineVersion' => '<string>',
    'Iops' => <integer>,
    'KmsKeyId' => '<string>',
    'LicenseModel' => '<string>',
    'MasterUserPassword' => '<string>',
    'MasterUsername' => '<string>',
    'MaxAllocatedStorage' => <integer>,
    'MonitoringInterval' => <integer>,
    'MonitoringRoleArn' => '<string>',
    'MultiAZ' => true || false,
    'NcharCharacterSetName' => '<string>',
    'OptionGroupName' => '<string>',
    'PerformanceInsightsKMSKeyId' => '<string>',
    'PerformanceInsightsRetentionPeriod' => <integer>,
    'Port' => <integer>,
    'PreferredBackupWindow' => '<string>',
    'PreferredMaintenanceWindow' => '<string>',
    'ProcessorFeatures' => [
        [
            'Name' => '<string>',
            'Value' => '<string>',
        ],
        // ...
    ],
    'PromotionTier' => <integer>,
    'PubliclyAccessible' => true || false,
    'StorageEncrypted' => true || false,
    'StorageType' => '<string>',
    'Tags' => [
        [
            'Key' => '<string>',
            'Value' => '<string>',
        ],
        // ...
    ],
    'TdeCredentialArn' => '<string>',
    'TdeCredentialPassword' => '<string>',
    'Timezone' => '<string>',
    'VpcSecurityGroupIds' => ['<string>', ...],
]);

Parameter Details

Result Syntax

[
    'DBInstance' => [
        'AllocatedStorage' => <integer>,
        'AssociatedRoles' => [
            [
                'FeatureName' => '<string>',
                'RoleArn' => '<string>',
                'Status' => '<string>',
            ],
            // ...
        ],
        'AutoMinorVersionUpgrade' => true || false,
        'AvailabilityZone' => '<string>',
        'BackupRetentionPeriod' => <integer>,
        'CACertificateIdentifier' => '<string>',
        'CharacterSetName' => '<string>',
        'CopyTagsToSnapshot' => true || false,
        'DBClusterIdentifier' => '<string>',
        'DBInstanceArn' => '<string>',
        'DBInstanceClass' => '<string>',
        'DBInstanceIdentifier' => '<string>',
        'DBInstanceStatus' => '<string>',
        'DBName' => '<string>',
        'DBParameterGroups' => [
            [
                'DBParameterGroupName' => '<string>',
                'ParameterApplyStatus' => '<string>',
            ],
            // ...
        ],
        'DBSecurityGroups' => [
            [
                'DBSecurityGroupName' => '<string>',
                'Status' => '<string>',
            ],
            // ...
        ],
        'DBSubnetGroup' => [
            'DBSubnetGroupArn' => '<string>',
            'DBSubnetGroupDescription' => '<string>',
            'DBSubnetGroupName' => '<string>',
            'SubnetGroupStatus' => '<string>',
            'Subnets' => [
                [
                    'SubnetAvailabilityZone' => [
                        'Name' => '<string>',
                    ],
                    'SubnetIdentifier' => '<string>',
                    'SubnetOutpost' => [
                        'Arn' => '<string>',
                    ],
                    'SubnetStatus' => '<string>',
                ],
                // ...
            ],
            'VpcId' => '<string>',
        ],
        'DbInstancePort' => <integer>,
        'DbiResourceId' => '<string>',
        'DeletionProtection' => true || false,
        'DomainMemberships' => [
            [
                'Domain' => '<string>',
                'FQDN' => '<string>',
                'IAMRoleName' => '<string>',
                'Status' => '<string>',
            ],
            // ...
        ],
        'EnabledCloudwatchLogsExports' => ['<string>', ...],
        'Endpoint' => [
            'Address' => '<string>',
            'HostedZoneId' => '<string>',
            'Port' => <integer>,
        ],
        'Engine' => '<string>',
        'EngineVersion' => '<string>',
        'EnhancedMonitoringResourceArn' => '<string>',
        'IAMDatabaseAuthenticationEnabled' => true || false,
        'InstanceCreateTime' => <DateTime>,
        'Iops' => <integer>,
        'KmsKeyId' => '<string>',
        'LatestRestorableTime' => <DateTime>,
        'LicenseModel' => '<string>',
        'ListenerEndpoint' => [
            'Address' => '<string>',
            'HostedZoneId' => '<string>',
            'Port' => <integer>,
        ],
        'MasterUsername' => '<string>',
        'MaxAllocatedStorage' => <integer>,
        'MonitoringInterval' => <integer>,
        'MonitoringRoleArn' => '<string>',
        'MultiAZ' => true || false,
        'NcharCharacterSetName' => '<string>',
        'OptionGroupMemberships' => [
            [
                'OptionGroupName' => '<string>',
                'Status' => '<string>',
            ],
            // ...
        ],
        'PendingModifiedValues' => [
            'AllocatedStorage' => <integer>,
            'BackupRetentionPeriod' => <integer>,
            'CACertificateIdentifier' => '<string>',
            'DBInstanceClass' => '<string>',
            'DBInstanceIdentifier' => '<string>',
            'DBSubnetGroupName' => '<string>',
            'EngineVersion' => '<string>',
            'Iops' => <integer>,
            'LicenseModel' => '<string>',
            'MasterUserPassword' => '<string>',
            'MultiAZ' => true || false,
            'PendingCloudwatchLogsExports' => [
                'LogTypesToDisable' => ['<string>', ...],
                'LogTypesToEnable' => ['<string>', ...],
            ],
            'Port' => <integer>,
            'ProcessorFeatures' => [
                [
                    'Name' => '<string>',
                    'Value' => '<string>',
                ],
                // ...
            ],
            'StorageType' => '<string>',
        ],
        'PerformanceInsightsEnabled' => true || false,
        'PerformanceInsightsKMSKeyId' => '<string>',
        'PerformanceInsightsRetentionPeriod' => <integer>,
        'PreferredBackupWindow' => '<string>',
        'PreferredMaintenanceWindow' => '<string>',
        'ProcessorFeatures' => [
            [
                'Name' => '<string>',
                'Value' => '<string>',
            ],
            // ...
        ],
        'PromotionTier' => <integer>,
        'PubliclyAccessible' => true || false,
        'ReadReplicaDBClusterIdentifiers' => ['<string>', ...],
        'ReadReplicaDBInstanceIdentifiers' => ['<string>', ...],
        'ReadReplicaSourceDBInstanceIdentifier' => '<string>',
        'ReplicaMode' => 'open-read-only|mounted',
        'SecondaryAvailabilityZone' => '<string>',
        'StatusInfos' => [
            [
                'Message' => '<string>',
                'Normal' => true || false,
                'Status' => '<string>',
                'StatusType' => '<string>',
            ],
            // ...
        ],
        'StorageEncrypted' => true || false,
        'StorageType' => '<string>',
        'TagList' => [
            [
                'Key' => '<string>',
                'Value' => '<string>',
            ],
            // ...
        ],
        'TdeCredentialArn' => '<string>',
        'Timezone' => '<string>',
        'VpcSecurityGroups' => [
            [
                'Status' => '<string>',
                'VpcSecurityGroupId' => '<string>',
            ],
            // ...
        ],
    ],
]

Result Details

Errors

• DBInstanceAlreadyExistsFault:

  The user already has a DB instance with the given identifier.

• InsufficientDBInstanceCapacityFault:

  The specified DB instance class isn't available in the specified Availability Zone.

• DBParameterGroupNotFoundFault:

  DBParameterGroupName doesn't refer to an existing DB parameter group.

• DBSecurityGroupNotFoundFault:

  DBSecurityGroupName doesn't refer to an existing DB security group.

• InstanceQuotaExceededFault:

  The request would result in the user exceeding the allowed number of DB instances.

• StorageQuotaExceededFault:

  The request would result in the user exceeding the allowed amount of storage available across all DB instances.

• DBSubnetGroupNotFoundFault:

  DBSubnetGroupName doesn't refer to an existing DB subnet group.

• DBSubnetGroupDoesNotCoverEnoughAZs:

  Subnets in the DB subnet group should cover at least two Availability Zones unless there is only one Availability Zone.

• InvalidDBClusterStateFault:

  The requested operation can't be performed while the cluster is in this state.

• InvalidSubnet:

  The requested subnet is invalid, or multiple subnets were requested that are not all in a common VPC.

• InvalidVPCNetworkStateFault:

  The DB subnet group doesn't cover all Availability Zones after it's created because of users' change.

• ProvisionedIopsNotAvailableInAZFault:

  Provisioned IOPS not available in the specified Availability Zone.

• OptionGroupNotFoundFault:

  The specified option group could not be found.

• DBClusterNotFoundFault:

  DBClusterIdentifier doesn't refer to an existing DB cluster.

• StorageTypeNotSupportedFault:

  Storage of the StorageType specified can't be associated with the DB instance.

• AuthorizationNotFoundFault:

  The specified CIDR IP range or Amazon EC2 security group might not be authorized for the specified DB security group.

  Or, RDS might not be authorized to perform necessary actions using IAM on your behalf.

• KMSKeyNotAccessibleFault:

  An error occurred accessing an AWS KMS key.

• DomainNotFoundFault:

  Domain doesn't refer to an existing Active Directory domain.

• BackupPolicyNotFoundFault:

  This error does not currently have a description.

Examples

Example 1: To create a DB instance.

This example creates a DB instance.

$result = $client->createDBInstance([
    'AllocatedStorage' => 5,
    'DBInstanceClass' => 'db.t2.micro',
    'DBInstanceIdentifier' => 'mymysqlinstance',
    'Engine' => 'MySQL',
    'MasterUserPassword' => 'MyPassword',
    'MasterUsername' => 'MyUser',
]);

Result syntax:

[
    'DBInstance' => [
    ],
]

CreateDBInstanceReadReplica

$result = $client->createDBInstanceReadReplica([/* ... */]);
$promise = $client->createDBInstanceReadReplicaAsync([/* ... */]);