/*
* Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
*
* Licensed under the Apache License, Version 2.0 (the "License").
* You may not use this file except in compliance with the License.
* A copy of the License is located at
*
* http://aws.amazon.com/apache2.0
*
* or in the "license" file accompanying this file. This file is distributed
* on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either
* express or implied. See the License for the specific language governing
* permissions and limitations under the License.
*/
/*
* Do not modify this file. This file is generated from the rds-2014-10-31.normal.json service model.
*/
using System;
using System.Collections.Generic;
using System.Xml.Serialization;
using System.Text;
using System.IO;
using System.Net;
using Amazon.Runtime;
using Amazon.Runtime.Internal;
namespace Amazon.RDS.Model
{
///
/// Container for the parameters to the DeleteDBInstance operation.
/// The DeleteDBInstance action deletes a previously provisioned DB instance. When you
/// delete a DB instance, all automated backups for that instance are deleted and can't
/// be recovered. Manual DB snapshots of the DB instance to be deleted by DeleteDBInstance
/// are not deleted.
///
///
///
/// If you request a final DB snapshot the status of the Amazon RDS DB instance is deleting
/// until the DB snapshot is created. The API action DescribeDBInstance
is
/// used to monitor the status of this operation. The action can't be canceled or reverted
/// once submitted.
///
///
///
/// When a DB instance is in a failure state and has a status of failed
,
/// incompatible-restore
, or incompatible-network
, you can only
/// delete it when you skip creation of the final snapshot with the SkipFinalSnapshot
/// parameter.
///
///
///
/// If the specified DB instance is part of an Amazon Aurora DB cluster, you can't delete
/// the DB instance if both of the following conditions are true:
///
/// -
///
/// The DB cluster is a read replica of another Amazon Aurora DB cluster.
///
///
-
///
/// The DB instance is the only instance in the DB cluster.
///
///
///
/// To delete a DB instance in this case, first call the PromoteReadReplicaDBCluster
/// API action to promote the DB cluster so it's no longer a read replica. After the promotion
/// completes, then call the DeleteDBInstance
API action to delete the final
/// instance in the DB cluster.
///
///
public partial class DeleteDBInstanceRequest : AmazonRDSRequest
{
private string _dbInstanceIdentifier;
private bool? _deleteAutomatedBackups;
private string _finalDBSnapshotIdentifier;
private bool? _skipFinalSnapshot;
///
/// Empty constructor used to set properties independently even when a simple constructor is available
///
public DeleteDBInstanceRequest() { }
///
/// Instantiates DeleteDBInstanceRequest with the parameterized properties
///
/// The DB instance identifier for the DB instance to be deleted. This parameter isn't case-sensitive. Constraints:
- Must match the name of an existing DB instance.
public DeleteDBInstanceRequest(string dbInstanceIdentifier)
{
_dbInstanceIdentifier = dbInstanceIdentifier;
}
///
/// Gets and sets the property DBInstanceIdentifier.
///
/// The DB instance identifier for the DB instance to be deleted. This parameter isn't
/// case-sensitive.
///
///
///
/// Constraints:
///
/// -
///
/// Must match the name of an existing DB instance.
///
///
///
[AWSProperty(Required=true)]
public string DBInstanceIdentifier
{
get { return this._dbInstanceIdentifier; }
set { this._dbInstanceIdentifier = value; }
}
// Check to see if DBInstanceIdentifier property is set
internal bool IsSetDBInstanceIdentifier()
{
return this._dbInstanceIdentifier != null;
}
///
/// Gets and sets the property DeleteAutomatedBackups.
///
/// A value that indicates whether to remove automated backups immediately after the DB
/// instance is deleted. This parameter isn't case-sensitive. The default is to remove
/// automated backups immediately after the DB instance is deleted.
///
///
public bool DeleteAutomatedBackups
{
get { return this._deleteAutomatedBackups.GetValueOrDefault(); }
set { this._deleteAutomatedBackups = value; }
}
// Check to see if DeleteAutomatedBackups property is set
internal bool IsSetDeleteAutomatedBackups()
{
return this._deleteAutomatedBackups.HasValue;
}
///
/// Gets and sets the property FinalDBSnapshotIdentifier.
///
/// The DBSnapshotIdentifier
of the new DBSnapshot
created when
/// the SkipFinalSnapshot
parameter is disabled.
///
///
///
/// If you enable this parameter and also enable SkipFinalShapshot, the command results
/// in an error.
///
///
///
/// This setting doesn't apply to RDS Custom.
///
///
///
/// Constraints:
///
/// -
///
/// Must be 1 to 255 letters or numbers.
///
///
-
///
/// First character must be a letter.
///
///
-
///
/// Can't end with a hyphen or contain two consecutive hyphens.
///
///
-
///
/// Can't be specified when deleting a read replica.
///
///
///
public string FinalDBSnapshotIdentifier
{
get { return this._finalDBSnapshotIdentifier; }
set { this._finalDBSnapshotIdentifier = value; }
}
// Check to see if FinalDBSnapshotIdentifier property is set
internal bool IsSetFinalDBSnapshotIdentifier()
{
return this._finalDBSnapshotIdentifier != null;
}
///
/// Gets and sets the property SkipFinalSnapshot.
///
/// A value that indicates whether to skip the creation of a final DB snapshot before
/// deleting the instance. If you enable this parameter, RDS doesn't create a DB snapshot.
/// If you don't enable this parameter, RDS creates a DB snapshot before the DB instance
/// is deleted. By default, skip isn't enabled, and the DB snapshot is created.
///
///
///
/// If you don't enable this parameter, you must specify the FinalDBSnapshotIdentifier
/// parameter.
///
///
///
/// When a DB instance is in a failure state and has a status of failed
,
/// incompatible-restore
, or incompatible-network
, RDS can delete
/// the instance only if you enable this parameter.
///
///
///
/// If you delete a read replica or an RDS Custom instance, you must enable this setting.
///
///
///
/// This setting is required for RDS Custom.
///
///
public bool SkipFinalSnapshot
{
get { return this._skipFinalSnapshot.GetValueOrDefault(); }
set { this._skipFinalSnapshot = value; }
}
// Check to see if SkipFinalSnapshot property is set
internal bool IsSetSkipFinalSnapshot()
{
return this._skipFinalSnapshot.HasValue;
}
}
}