{
"api_version": "2013-01-10",
"type": "query",
"result_wrapped": true,
"signature_version": "v2",
"service_full_name": "Amazon Relational Database Service",
"service_abbreviation": "Amazon RDS",
"endpoint_prefix": "rds",
"xmlnamespace": "http://rds.amazonaws.com/doc/2013-01-10/",
"documentation": " \n
\n Amazon Relational Database Service (Amazon RDS) is a web service\n that makes it easier to set up, operate, and scale a relational\n database in the cloud. It provides cost-efficient, resizable\n capacity for an industry-standard relational database and manages\n common database administration tasks, freeing up developers to focus\n on what makes their applications and businesses unique.\n
\n\n Amazon RDS gives you access to the capabilities of a familiar MySQL or Oracle \n database server. This means the code, applications, and tools you\n already use today with your existing MySQL or Oracle databases work with Amazon\n RDS without modification. Amazon RDS automatically backs up your database\n and maintains the database software that powers your DB Instance. Amazon\n RDS is flexible: you can scale your database instance's compute resources\n and storage capacity to meet your application's demand. As with all\n Amazon Web Services, there are no up-front investments, and you pay\n only for the resources you use.\n
\n \n\n This is the Amazon RDS API Reference. It contains a comprehensive description \n of all Amazon RDS Query APIs and data types. Note that this API is asynchronous and some\n actions may require polling to determine when an action has been applied. See the parameter description to determine if \n a change is applied immediately or on the next instance reboot or during the maintenance window. To get started with Amazon RDS, \n go to the \n Amazon RDS Getting Started Guide. \n For more information on Amazon RDS concepts and usage scenarios, go to the \n Amazon RDS User Guide.\n
\n ", "operations": { "AddSourceIdentifierToSubscription": { "name": "AddSourceIdentifierToSubscription", "input": { "shape_name": "AddSourceIdentifierToSubscriptionMessage", "type": "structure", "members": { "SubscriptionName": { "shape_name": "String", "type": "string", "documentation": "\nThe name of the RDS event notification subscription you want to add a source identifier to.
\n ", "required": true }, "SourceIdentifier": { "shape_name": "String", "type": "string", "documentation": "\n\n The identifier of the event source to be added. An identifier must begin with a letter and must contain only \n ASCII letters, digits, and hyphens; it cannot end with a hyphen or contain two consecutive hyphens.\n
\n \nConstraints:
\nNot used.
\n " }, "CustomerAwsId": { "shape_name": "String", "type": "string", "documentation": "\nThe AWS customer account associated with the RDS event notification subscription.
\n " }, "CustSubscriptionId": { "shape_name": "String", "type": "string", "documentation": "\nThe RDS event notification subscription Id.
\n " }, "SnsTopicArn": { "shape_name": "String", "type": "string", "documentation": "\nThe topic ARN of the RDS event notification subscription.
\n " }, "Status": { "shape_name": "String", "type": "string", "documentation": "\nThe status of the RDS event notification subscription.
\nConstraints:
\nCan be one of the following: creating | modifying | deleting | active | no-permission | topic-not-exist
\nThe status \"no-permission\" indicates that RDS no longer has permission to post to the SNS topic. The status \n \"topic-not-exist\" indicates that the topic was deleted after the subscription was created.
\n " }, "SubscriptionCreationTime": { "shape_name": "String", "type": "string", "documentation": "\nThe time the RDS event notification subscription was created.
\n " }, "SourceType": { "shape_name": "String", "type": "string", "documentation": "\nThe source type for the RDS event notification subscription.
\n " }, "SourceIdsList": { "shape_name": "SourceIdsList", "type": "list", "members": { "shape_name": "String", "type": "string", "documentation": null, "xmlname": "SourceId" }, "documentation": "\nA list of source Ids for the RDS event notification subscription.
\n " }, "EventCategoriesList": { "shape_name": "EventCategoriesList", "type": "list", "members": { "shape_name": "String", "type": "string", "documentation": null, "xmlname": "EventCategory" }, "documentation": "\nA list of event categories for the RDS event notification subscription.
\n " }, "Enabled": { "shape_name": "Boolean", "type": "boolean", "documentation": "\nA Boolean value indicating if the subscription is enabled. True indicates the subscription is enabled.
\n " } }, "wrapper": true, "documentation": "\nContains the results of a successful invocation of the DescribeEventSubscriptions action.
\n " } } }, "errors": [ { "shape_name": "SubscriptionNotFoundFault", "type": "structure", "members": {}, "documentation": "\nThe subscription name does not exist.
\n " }, { "shape_name": "SourceNotFoundFault", "type": "structure", "members": {}, "documentation": "\nThe requested source could not be found.
\n " } ], "documentation": "\nAdds a source identifier to an existing RDS event notification subscription.
\nThe DB Instance the tags will be added to.
\n ", "required": true }, "Tags": { "shape_name": "TagList", "type": "list", "members": { "shape_name": "Tag", "type": "structure", "members": { "Key": { "shape_name": "String", "type": "string", "documentation": "\nA key is the required name of the tag. The string value can be from \n 1 to 128 Unicode characters in length and cannot be prefixed with \"aws:\". \n The string may only contain only the set of Unicode letters, digits, \n white-space, '_', '.', '/', '=', '+', '-' (Java regex: \"^([\\\\p{L}\\\\p{Z}\\\\p{N}_.:/=+\\\\-]*)$\").
\n " }, "Value": { "shape_name": "String", "type": "string", "documentation": "\nA value is the optional value of the tag. The string value can be from \n 1 to 256 Unicode characters in length and cannot be prefixed with \"aws:\". \n The string may only contain only the set of Unicode letters, digits, \n white-space, '_', '.', '/', '=', '+', '-' (Java regex: \"^([\\\\p{L}\\\\p{Z}\\\\p{N}_.:/=+\\\\-]*)$\").
\n " } }, "documentation": "\nMetadata assigned to a DB Instance consisting of a key-value pair.
\n ", "xmlname": "Tag" }, "documentation": "\nThe tags to be assigned to the DB Instance.
\n ", "required": true } }, "documentation": "\n \n " }, "output": null, "errors": [ { "shape_name": "DBInstanceNotFoundFault", "type": "structure", "members": {}, "documentation": "\n\n DBInstanceIdentifier does not refer to an existing DB Instance.\n
\n " }, { "shape_name": "DBSnapshotNotFoundFault", "type": "structure", "members": {}, "documentation": "\n\n DBSnapshotIdentifier does not refer to an existing DB Snapshot.\n
\n " } ], "documentation": "\nAdds metadata tags to a DB Instance. These tags can also be used with cost allocation reporting to track cost associated with a DB Instance.
\nFor an overview on tagging DB Instances, see DB Instance Tags.
\n " }, "AuthorizeDBSecurityGroupIngress": { "name": "AuthorizeDBSecurityGroupIngress", "input": { "shape_name": "AuthorizeDBSecurityGroupIngressMessage", "type": "structure", "members": { "DBSecurityGroupName": { "shape_name": "String", "type": "string", "documentation": "\n\n The name of the DB Security Group to add authorization to.\n
\n ", "required": true }, "CIDRIP": { "shape_name": "String", "type": "string", "documentation": "\n\n The IP range to authorize.\n
\n " }, "EC2SecurityGroupName": { "shape_name": "String", "type": "string", "documentation": "\n\n Name of the EC2 Security Group to authorize.\n For VPC DB Security Groups, EC2SecurityGroupId
must be provided.\n Otherwise, EC2SecurityGroupOwnerId and either EC2SecurityGroupName
or EC2SecurityGroupId
must be provided.\n
\n Id of the EC2 Security Group to authorize.\n For VPC DB Security Groups, EC2SecurityGroupId
must be provided.\n Otherwise, EC2SecurityGroupOwnerId and either EC2SecurityGroupName
or EC2SecurityGroupId
must be provided.\n
\n AWS Account Number of the owner of the EC2 Security Group\n specified in the EC2SecurityGroupName parameter.\n The AWS Access Key ID is not an acceptable value.\n For VPC DB Security Groups, EC2SecurityGroupId
must be provided.\n Otherwise, EC2SecurityGroupOwnerId and either EC2SecurityGroupName
or EC2SecurityGroupId
must be provided.\n
\n\n
\n " }, "output": { "shape_name": "DBSecurityGroupWrapper", "type": "structure", "members": { "DBSecurityGroup": { "shape_name": "DBSecurityGroup", "type": "structure", "members": { "OwnerId": { "shape_name": "String", "type": "string", "documentation": "\n\n Provides the AWS ID of the owner of a specific DB Security Group.\n
\n " }, "DBSecurityGroupName": { "shape_name": "String", "type": "string", "documentation": "\n\n Specifies the name of the DB Security Group.\n
\n " }, "DBSecurityGroupDescription": { "shape_name": "String", "type": "string", "documentation": "\n\n Provides the description of the DB Security Group.\n
\n " }, "VpcId": { "shape_name": "String", "type": "string", "documentation": "\n\n Provides the VpcId of the DB Security Group.\n
\n " }, "EC2SecurityGroups": { "shape_name": "EC2SecurityGroupList", "type": "list", "members": { "shape_name": "EC2SecurityGroup", "type": "structure", "members": { "Status": { "shape_name": "String", "type": "string", "documentation": "\n\n Provides the status of the EC2 security group. Status can be \"authorizing\", \n \"authorized\", \"revoking\", and \"revoked\".\n
\n " }, "EC2SecurityGroupName": { "shape_name": "String", "type": "string", "documentation": "\n\n Specifies the name of the EC2 Security Group.\n
\n " }, "EC2SecurityGroupId": { "shape_name": "String", "type": "string", "documentation": "\n\n Specifies the id of the EC2 Security Group.\n
\n " }, "EC2SecurityGroupOwnerId": { "shape_name": "String", "type": "string", "documentation": "\n\n Specifies the AWS ID of the owner of the EC2 security group\n specified in the EC2SecurityGroupName
field.\n
\n This data type is used as a response element in the following actions:\n
\n \n ", "xmlname": "EC2SecurityGroup" }, "documentation": "\n\n Contains a list of EC2SecurityGroup elements.\n
\n " }, "IPRanges": { "shape_name": "IPRangeList", "type": "list", "members": { "shape_name": "IPRange", "type": "structure", "members": { "Status": { "shape_name": "String", "type": "string", "documentation": "\n\n Specifies the status of the IP range. Status can be \"authorizing\", \n \"authorized\", \"revoking\", and \"revoked\".\n
\n " }, "CIDRIP": { "shape_name": "String", "type": "string", "documentation": "\n\n Specifies the IP range.\n
\n " } }, "documentation": "\n\n This data type is used as a response element in the DescribeDBSecurityGroups action.\n
\n ", "xmlname": "IPRange" }, "documentation": "\n\n Contains a list of IPRange elements.\n
\n " } }, "wrapper": true, "documentation": "\n\n Contains the result of a successful invocation of the following actions:\n
\nThis data type is used as a response element in the DescribeDBSecurityGroups action.
\n \n " } } }, "errors": [ { "shape_name": "DBSecurityGroupNotFoundFault", "type": "structure", "members": {}, "documentation": "\n\n DBSecurityGroupName does not refer to an existing DB Security Group.\n
\n " }, { "shape_name": "InvalidDBSecurityGroupStateFault", "type": "structure", "members": {}, "documentation": "\n\n The state of the DB Security Group does not allow deletion.\n
\n " }, { "shape_name": "AuthorizationAlreadyExistsFault", "type": "structure", "members": {}, "documentation": "\n\n The specified CIDRIP or EC2 security group is already authorized for the specified DB security group.\n
\n " }, { "shape_name": "AuthorizationQuotaExceededFault", "type": "structure", "members": {}, "documentation": "\n\n Database security group authorization quota has been reached.\n
\n " } ], "documentation": "\n\n Enables ingress to a DBSecurityGroup using one of two forms of authorization. First,\n EC2 or VPC Security Groups can be added to the DBSecurityGroup if the application using the database\n is running on EC2 or VPC instances. Second, IP ranges are available if the application accessing your\n database is running on the Internet. Required parameters for this API are one of CIDR range, EC2SecurityGroupId for VPC, or\n (EC2SecurityGroupOwnerId and either EC2SecurityGroupName or EC2SecurityGroupId for non-VPC).\n
\nFor an overview of CIDR ranges, go to the \n Wikipedia Tutorial.\n
\n\n The identifier for the source DB snapshot.\n
\nConstraints:
\nExample: rds:mydb-2012-04-02-00-01
\n The identifier for the copied snapshot.\n
\nConstraints:
\nExample: my-db-snapshot
\n\n
\n " }, "output": { "shape_name": "DBSnapshotWrapper", "type": "structure", "members": { "DBSnapshot": { "shape_name": "DBSnapshot", "type": "structure", "members": { "DBSnapshotIdentifier": { "shape_name": "String", "type": "string", "documentation": "\n\n Specifies the identifier for the DB Snapshot.\n
\n " }, "DBInstanceIdentifier": { "shape_name": "String", "type": "string", "documentation": "\n\n Specifies the the DBInstanceIdentifier of the DB Instance\n this DB Snapshot was created from.\n
\n " }, "SnapshotCreateTime": { "shape_name": "TStamp", "type": "timestamp", "documentation": "\n\n Provides the time (UTC) when the snapshot was taken.\n
\n " }, "Engine": { "shape_name": "String", "type": "string", "documentation": "\n\n Specifies the name of the database engine.\n
\n " }, "AllocatedStorage": { "shape_name": "Integer", "type": "integer", "documentation": "\n\n Specifies the allocated storage size in gigabytes (GB).\n
\n " }, "Status": { "shape_name": "String", "type": "string", "documentation": "\n\n Specifies the status of this DB Snapshot.\n
\n " }, "Port": { "shape_name": "Integer", "type": "integer", "documentation": "\n\n Specifies the port that the database engine was\n listening on at the time of the snapshot.\n
\n " }, "AvailabilityZone": { "shape_name": "String", "type": "string", "documentation": "\n\n Specifies the name of the Availability Zone the DB\n Instance was located in at the time of the DB Snapshot.\n
\n " }, "VpcId": { "shape_name": "String", "type": "string", "documentation": "\n\n Provides the Vpc Id associated with the DB Snapshot.\n
\n " }, "InstanceCreateTime": { "shape_name": "TStamp", "type": "timestamp", "documentation": "\n\n Specifies the time (UTC) when the snapshot was taken.\n
\n " }, "MasterUsername": { "shape_name": "String", "type": "string", "documentation": "\n\n Provides the master username for the DB Instance.\n
\n " }, "EngineVersion": { "shape_name": "String", "type": "string", "documentation": "\n\n Specifies the version of the database engine.\n
\n " }, "LicenseModel": { "shape_name": "String", "type": "string", "documentation": "\n\n License model information for the restored DB Instance.\n
\n " }, "SnapshotType": { "shape_name": "String", "type": "string", "documentation": "\n\n Provides the type of the DB Snapshot.\n
\n " }, "Iops": { "shape_name": "IntegerOptional", "type": "integer", "documentation": "\n\n Specifies the Provisioned IOPS (I/O operations per second) value of the DB Instance at the time of the snapshot.\n
\n " } }, "wrapper": true, "documentation": "\n\n Contains the result of a successful invocation of the following actions:\n
\nThis data type is used as a response element in the DescribeDBSnapshots action.
\n " } } }, "errors": [ { "shape_name": "DBSnapshotAlreadyExistsFault", "type": "structure", "members": {}, "documentation": "\n\n DBSnapshotIdentifier is already used by an existing snapshot.\n
\n " }, { "shape_name": "DBSnapshotNotFoundFault", "type": "structure", "members": {}, "documentation": "\n\n DBSnapshotIdentifier does not refer to an existing DB Snapshot.\n
\n " }, { "shape_name": "InvalidDBSnapshotStateFault", "type": "structure", "members": {}, "documentation": "\n\n The state of the DB Security Snapshot does not allow deletion.\n
\n " }, { "shape_name": "SnapshotQuotaExceededFault", "type": "structure", "members": {}, "documentation": "\n\n Request would result in user exceeding the allowed number of DB Snapshots.\n
\n " } ], "documentation": "\n\n Copies the specified DBSnapshot. The source DBSnapshot must be in the \"available\" state.\n
\nThe meaning of this parameter\n differs according to the database\n engine you use.
\nMySQL
\nThe name of the database to create when the DB Instance\n is created. If this parameter is not specified,\n no database is created in the DB Instance.\n
\nConstraints:
\nType: String
\n \nOracle
\n\n The Oracle System ID (SID) of the created DB Instance. \n
\n \nDefault: ORCL
Constraints:
\nSQL Server
\nNot applicable. Must be null.
\n " }, "DBInstanceIdentifier": { "shape_name": "String", "type": "string", "documentation": "\n\n The DB Instance identifier.\n This parameter is stored as a lowercase string.\n
\nConstraints:
\nExample: mydbinstance
\n The amount of storage (in gigabytes) to be initially allocated for the\n database instance. \n
\nMySQL
\nConstraints: Must be an integer from 5 to 1024.
\nType: Integer
\nOracle
\nConstraints: Must be an integer from 10 to 1024.
\nSQL Server
\nConstraints: Must be an integer from 200 to 1024 (Standard Edition and Enterprise Edition) or \n from 30 to 1024 (Express Edition and Web Edition)
\n ", "required": true }, "DBInstanceClass": { "shape_name": "String", "type": "string", "documentation": "\n\n The compute and memory capacity of the DB Instance.\n
\n\n Valid Values: db.t1.micro | db.m1.small | db.m1.medium | db.m1.large | db.m1.xlarge | db.m2.xlarge |db.m2.2xlarge | db.m2.4xlarge
\n
\n The name of the database engine to be used for this instance.\n
\n\n Valid Values: MySQL
| oracle-se1
| oracle-se
| oracle-ee
| sqlserver-ee
| \n sqlserver-se
| sqlserver-ex
| sqlserver-web
\n
\n The name of master user for the client DB Instance.\n
\nMySQL
\nConstraints:
\nType: String
\nOracle
\nConstraints:
\nSQL Server
\nConstraints:
\n\n The password for the master database user. Can be any printable ASCII character except \"/\", \"\\\", or \"@\".\n
\nType: String
\nMySQL
\n\n Constraints: Must contain from 8 to 41 alphanumeric characters. \n
\n \nOracle
\n\n Constraints: Must contain from 8 to 30 alphanumeric characters. \n
\nSQL Server
\n\n Constraints: Must contain from 8 to 128 alphanumeric characters.\n
\n \n ", "required": true }, "DBSecurityGroups": { "shape_name": "DBSecurityGroupNameList", "type": "list", "members": { "shape_name": "String", "type": "string", "documentation": null, "xmlname": "DBSecurityGroupName" }, "documentation": "\n\n A list of DB Security Groups to associate\n with this DB Instance.\n
\n\n Default: The default DB Security Group for the database engine.\n
\n " }, "VpcSecurityGroupIds": { "shape_name": "VpcSecurityGroupIdList", "type": "list", "members": { "shape_name": "String", "type": "string", "documentation": null, "xmlname": "VpcSecurityGroupId" }, "documentation": "\n\n A list of EC2 VPC Security Groups to associate\n with this DB Instance.\n
\n\n Default: The default EC2 VPC Security Group for the DB Subnet group's\n VPC.\n
\n " }, "AvailabilityZone": { "shape_name": "String", "type": "string", "documentation": "\n\n The EC2 Availability Zone that the database instance will be created in.\n
\n\n Default: A random, system-chosen Availability Zone in the endpoint's region.\n
\n\n Example: us-east-1d
\n
\n Constraint: The AvailabilityZone parameter cannot be specified if the MultiAZ parameter is set to true
. \n The specified Availability Zone must be in the same region as the current endpoint.\n
\n A DB Subnet Group to associate with this DB Instance.\n
\n\n If there is no DB Subnet Group, then it is a non-VPC DB instance.\n
\n " }, "PreferredMaintenanceWindow": { "shape_name": "String", "type": "string", "documentation": "\n\n The weekly time range (in UTC) during which system maintenance can occur.\n
\n\n Format: ddd:hh24:mi-ddd:hh24:mi
\n
\n Default: A 30-minute window selected at random from an\n 8-hour block of time per region, occurring on a random day of the\n week. The following list shows the time blocks for each region \n from which the default maintenance windows are assigned.\n
\nValid Days: Mon, Tue, Wed, Thu, Fri, Sat, Sun
\nConstraints: Minimum 30-minute window.
\n " }, "DBParameterGroupName": { "shape_name": "String", "type": "string", "documentation": "\n\n The name of the DB Parameter Group to associate\n with this DB instance. If this argument is omitted, the default\n DBParameterGroup for the specified engine will be used.\n
\n\n Constraints:\n
\n\n The number of days for which automated backups are retained.\n Setting this parameter to a positive number enables backups.\n Setting this parameter to 0 disables automated backups.\n
\n\n Default: 1\n
\nConstraints:
\n\n The daily time range during which automated backups are created\n if automated backups are enabled,\n using the BackupRetentionPeriod
parameter.\n
\n Default: A 30-minute window selected at random from an\n 8-hour block of time per region. The following list shows \n the time blocks for each region from which the default \n backup windows are assigned.\n
\n\n Constraints: Must be in the format hh24:mi-hh24:mi
. \n Times should be Universal Time Coordinated (UTC). \n Must not conflict with the preferred maintenance window. Must be at least 30 minutes.\n
\n The port number on which the database accepts connections.\n
\nMySQL
\n\n Default: 3306
\n
\n Valid Values: 1150-65535
\n
Type: Integer
\n \nOracle
\n\n Default: 1521
\n
\n Valid Values: 1150-65535
\n
SQL Server
\n\n Default: 1433
\n
\n Valid Values: 1150-65535
except for 1434
and 3389
.\n
\n Specifies if the DB Instance is a Multi-AZ deployment. \n You cannot set the AvailabilityZone parameter if the MultiAZ parameter is set to true. \n
\n " }, "EngineVersion": { "shape_name": "String", "type": "string", "documentation": "\n\n The version number of the database engine to use.\n
\nMySQL
\nExample: 5.1.42
Type: String
\n \nOracle
\nExample: 11.2.0.2.v2
Type: String
\n \nSQL Server
\nExample: 10.50.2789.0.v1
\n Indicates that minor engine upgrades will be applied\n automatically to the DB Instance during the maintenance window.\n
\nDefault: true
\n License model information for this DB Instance.\n
\n\n Valid values: license-included
| bring-your-own-license
| general-public-license
\n
\n The amount of Provisioned IOPS (input/output operations per second) to be initially allocated for the\n DB Instance. \n
\nConstraints: Must be an integer greater than 1000.
\n \n " }, "OptionGroupName": { "shape_name": "String", "type": "string", "documentation": "\n\n Indicates that the DB Instance should be associated with the specified option group.\n
\n " }, "CharacterSetName": { "shape_name": "String", "type": "string", "documentation": "\n\n For supported engines, indicates that the DB Instance should be associated with the specified CharacterSet.\n
\n " }, "PubliclyAccessible": { "shape_name": "BooleanOptional", "type": "boolean", "documentation": null } }, "documentation": "\n\n\n
\n " }, "output": { "shape_name": "DBInstanceWrapper", "type": "structure", "members": { "DBInstance": { "shape_name": "DBInstance", "type": "structure", "members": { "DBInstanceIdentifier": { "shape_name": "String", "type": "string", "documentation": "\n\n Contains a user-supplied database identifier.\n This is the unique key that identifies a DB Instance.\n
\n " }, "DBInstanceClass": { "shape_name": "String", "type": "string", "documentation": "\n\n Contains the name of the compute and memory\n capacity class of the DB Instance.\n
\n " }, "Engine": { "shape_name": "String", "type": "string", "documentation": "\n\n Provides the name of the database engine to be used for this DB Instance.\n
\n " }, "DBInstanceStatus": { "shape_name": "String", "type": "string", "documentation": "\n\n Specifies the current state of this database.\n
\n " }, "MasterUsername": { "shape_name": "String", "type": "string", "documentation": "\n\n Contains the master username for the DB Instance.\n
\n " }, "DBName": { "shape_name": "String", "type": "string", "documentation": "\nThe meaning of this parameter differs according to the database engine you use.
\nMySQL
\n\n Contains the name of the initial database of this instance that was\n provided at create time, if one was specified when the\n DB Instance was created. This same name is returned for\n the life of the DB Instance.\n
\nType: String
\nOracle
\n\n Contains the Oracle System ID (SID) of the created DB Instance. \n
\n " }, "Endpoint": { "shape_name": "Endpoint", "type": "structure", "members": { "Address": { "shape_name": "String", "type": "string", "documentation": "\n\n Specifies the DNS address of the DB Instance.\n
\n " }, "Port": { "shape_name": "Integer", "type": "integer", "documentation": "\n\n Specifies the port that the database engine is listening on.\n
\n " } }, "documentation": "\n\n Specifies the connection endpoint.\n
\n " }, "AllocatedStorage": { "shape_name": "Integer", "type": "integer", "documentation": "\n\n Specifies the allocated storage size specified in gigabytes.\n
\n " }, "InstanceCreateTime": { "shape_name": "TStamp", "type": "timestamp", "documentation": "\n\n Provides the date and time the DB Instance was created.\n
\n " }, "PreferredBackupWindow": { "shape_name": "String", "type": "string", "documentation": "\n\n Specifies the daily time range during which automated backups are\n created if automated backups are enabled, as determined\n by the BackupRetentionPeriod
.\n
\n Specifies the number of days for which automatic DB Snapshots are retained.\n
\n " }, "DBSecurityGroups": { "shape_name": "DBSecurityGroupMembershipList", "type": "list", "members": { "shape_name": "DBSecurityGroupMembership", "type": "structure", "members": { "DBSecurityGroupName": { "shape_name": "String", "type": "string", "documentation": "\n\n The name of the DB Security Group.\n
\n " }, "Status": { "shape_name": "String", "type": "string", "documentation": "\n\n The status of the DB Security Group.\n
\n " } }, "documentation": "\n\n This data type is used as a response element in the following actions:\n
\n\n Provides List of DB Security Group elements containing only\n DBSecurityGroup.Name
and DBSecurityGroup.Status
subelements.\n
The name of the VPC security group.
\n " }, "Status": { "shape_name": "String", "type": "string", "documentation": "\n\n The status of the VPC Security Group.\n
\n " } }, "documentation": "\nThis data type is used as a response element for queries on VPC security group membership.
\n ", "xmlname": "VpcSecurityGroupMembership" }, "documentation": "\n\n Provides List of VPC security group elements \n that the DB Instance belongs to. \n
\n " }, "DBParameterGroups": { "shape_name": "DBParameterGroupStatusList", "type": "list", "members": { "shape_name": "DBParameterGroupStatus", "type": "structure", "members": { "DBParameterGroupName": { "shape_name": "String", "type": "string", "documentation": "\n\n The name of the DP Parameter Group.\n
\n " }, "ParameterApplyStatus": { "shape_name": "String", "type": "string", "documentation": "\n\n The status of parameter updates.\n
\n " } }, "documentation": "\n\n The status of the DB Parameter Group.\n
\nThis data type is used as a response element in the following actions:
\n\n Provides the list of DB Parameter Groups applied to this DB Instance.\n
\n " }, "AvailabilityZone": { "shape_name": "String", "type": "string", "documentation": "\n\n Specifies the name of the Availability Zone the DB Instance is located in.\n
\n " }, "DBSubnetGroup": { "shape_name": "DBSubnetGroup", "type": "structure", "members": { "DBSubnetGroupName": { "shape_name": "String", "type": "string", "documentation": "\n\n Specifies the name of the DB Subnet Group.\n
\n " }, "DBSubnetGroupDescription": { "shape_name": "String", "type": "string", "documentation": "\n\n Provides the description of the DB Subnet Group.\n
\n " }, "VpcId": { "shape_name": "String", "type": "string", "documentation": "\n\n Provides the VpcId of the DB Subnet Group.\n
\n " }, "SubnetGroupStatus": { "shape_name": "String", "type": "string", "documentation": "\n\n Provides the status of the DB Subnet Group.\n
\n " }, "Subnets": { "shape_name": "SubnetList", "type": "list", "members": { "shape_name": "Subnet", "type": "structure", "members": { "SubnetIdentifier": { "shape_name": "String", "type": "string", "documentation": "\n\n Specifies the identifier of the subnet.\n
\n " }, "SubnetAvailabilityZone": { "shape_name": "AvailabilityZone", "type": "structure", "members": { "Name": { "shape_name": "String", "type": "string", "documentation": "\n\n The name of the availability zone.\n
\n " }, "ProvisionedIopsCapable": { "shape_name": "Boolean", "type": "boolean", "documentation": "\n\n True indicates the availability zone is capable of provisioned IOPs.\n
\n " } }, "wrapper": true, "documentation": "\n\n Contains Availability Zone information. \n
\n\n This data type is used as an element in the following data type:\n
\n \n \n " }, "SubnetStatus": { "shape_name": "String", "type": "string", "documentation": "\n\n Specifies the status of the subnet.\n
\n " } }, "documentation": "\n\n This data type is used as a response element in the DescribeDBSubnetGroups action.\n
\n ", "xmlname": "Subnet" }, "documentation": "\n\n Contains a list of Subnet elements.\n
\n " } }, "wrapper": true, "documentation": "\n\n Provides the inforamtion of the subnet group associated with the DB instance, including the name, descrption and subnets in the subnet group.\n
\n " }, "PreferredMaintenanceWindow": { "shape_name": "String", "type": "string", "documentation": "\n\n Specifies the weekly time range (in UTC) during which\n system maintenance can occur.\n
\n " }, "PendingModifiedValues": { "shape_name": "PendingModifiedValues", "type": "structure", "members": { "DBInstanceClass": { "shape_name": "String", "type": "string", "documentation": "\n\n Contains the new DBInstanceClass
for the DB Instance\n that will be applied or is in progress.\n
\n Contains the new AllocatedStorage
size for the DB Instance\n that will be applied or is in progress.\n
\n Contains the pending or in-progress change of the master credentials for the DB Instance.\n
\n " }, "Port": { "shape_name": "IntegerOptional", "type": "integer", "documentation": "\n\n Specifies the pending port for the DB Instance.\n
\n " }, "BackupRetentionPeriod": { "shape_name": "IntegerOptional", "type": "integer", "documentation": "\n\n Specifies the pending number of days for which automated backups are retained.\n
\n " }, "MultiAZ": { "shape_name": "BooleanOptional", "type": "boolean", "documentation": "\n\n Indicates that the Single-AZ DB Instance is to change to a Multi-AZ deployment.\n
\n " }, "EngineVersion": { "shape_name": "String", "type": "string", "documentation": "\n\n Indicates the database engine version. \n
\n " }, "Iops": { "shape_name": "IntegerOptional", "type": "integer", "documentation": "\n\n Specifies the new Provisioned IOPS value for the DB Instance\n that will be applied or is being applied.\n
\n " }, "DBInstanceIdentifier": { "shape_name": "String", "type": "string", "documentation": "\n\n Contains the new DBInstanceIdentifier
for the DB Instance\n that will be applied or is in progress.\n
\n Specifies that changes to the DB Instance are pending.\n This element is only included when changes are pending.\n Specific changes are identified by subelements.\n
\n " }, "LatestRestorableTime": { "shape_name": "TStamp", "type": "timestamp", "documentation": "\n\n Specifies the latest time to which a database\n can be restored with point-in-time restore.\n
\n " }, "MultiAZ": { "shape_name": "Boolean", "type": "boolean", "documentation": "\n\n Specifies if the DB Instance is a Multi-AZ deployment.\n
\n " }, "EngineVersion": { "shape_name": "String", "type": "string", "documentation": "\n\n Indicates the database engine version.\n
\n " }, "AutoMinorVersionUpgrade": { "shape_name": "Boolean", "type": "boolean", "documentation": "\n\n Indicates that minor version patches are applied automatically.\n
\n " }, "ReadReplicaSourceDBInstanceIdentifier": { "shape_name": "String", "type": "string", "documentation": "\n\n Contains the identifier of the source DB Instance if this DB Instance is a Read Replica.\n
\n " }, "ReadReplicaDBInstanceIdentifiers": { "shape_name": "ReadReplicaDBInstanceIdentifierList", "type": "list", "members": { "shape_name": "String", "type": "string", "documentation": null, "xmlname": "ReadReplicaDBInstanceIdentifier" }, "documentation": "\n\n Contains one or more identifiers of the Read Replicas associated with this DB Instance.\n
\n " }, "LicenseModel": { "shape_name": "String", "type": "string", "documentation": "\n\n License model information for this DB Instance.\n
\n " }, "Iops": { "shape_name": "IntegerOptional", "type": "integer", "documentation": "\n\n Specifies the Provisioned IOPS (I/O operations per second) value.\n
\n " }, "OptionGroupMembership": { "shape_name": "OptionGroupMembership", "type": "structure", "members": { "OptionGroupName": { "shape_name": "String", "type": "string", "documentation": "\n\n The name of the option group that the instance belongs to.\n
\n " }, "Status": { "shape_name": "String", "type": "string", "documentation": "\n\n The status of the DB Instance's option group membership (e.g. in-sync, pending, pending-maintenance, applying).\n
\n " } }, "documentation": "\n\n Specifies the name and status of the option group that this instance belongs to. \n
\n " }, "CharacterSetName": { "shape_name": "String", "type": "string", "documentation": "\n\n If present, specifies the name of the character set that this instance is associated with. \n
\n " }, "SecondaryAvailabilityZone": { "shape_name": "String", "type": "string", "documentation": "\n\n If present, specifies the name of the secondary Availability Zone \n for a DB instance with multi-AZ support.\n
\n " }, "PubliclyAccessible": { "shape_name": "Boolean", "type": "boolean", "documentation": null } }, "wrapper": true, "documentation": "\n\n Contains the result of a successful invocation of the following actions:\n
\n \nThis data type is used as a response element in the DescribeDBInstances action.
\n " } } }, "errors": [ { "shape_name": "DBInstanceAlreadyExistsFault", "type": "structure", "members": {}, "documentation": "\n\n User already has a DB Instance with the given identifier.\n
\n " }, { "shape_name": "InsufficientDBInstanceCapacityFault", "type": "structure", "members": {}, "documentation": "\n\n Specified DB Instance class is not available in the specified Availability Zone.\n
\n " }, { "shape_name": "DBParameterGroupNotFoundFault", "type": "structure", "members": {}, "documentation": "\n\n DBParameterGroupName does not refer to an\n existing DB Parameter Group.\n
\n " }, { "shape_name": "DBSecurityGroupNotFoundFault", "type": "structure", "members": {}, "documentation": "\n\n DBSecurityGroupName does not refer to an existing DB Security Group.\n
\n " }, { "shape_name": "InstanceQuotaExceededFault", "type": "structure", "members": {}, "documentation": "\n\n Request would result in user exceeding the allowed number of DB Instances.\n
\n " }, { "shape_name": "StorageQuotaExceededFault", "type": "structure", "members": {}, "documentation": "\n\n Request would result in user exceeding the\n allowed amount of storage available across all DB Instances.\n
\n " }, { "shape_name": "DBSubnetGroupNotFoundFault", "type": "structure", "members": {}, "documentation": "\n\n DBSubnetGroupName does not refer to an existing DB Subnet Group.\n
\n " }, { "shape_name": "DBSubnetGroupDoesNotCoverEnoughAZs", "type": "structure", "members": {}, "documentation": "\n\n Subnets in the DB subnet group should cover at least 2 availability zones unless there's'only 1 available zone.\n
\n " }, { "shape_name": "InvalidSubnet", "type": "structure", "members": {}, "documentation": "\n\n Request subnet is valid, or all subnets are not in common Vpc. \n
\n " }, { "shape_name": "InvalidVPCNetworkStateFault", "type": "structure", "members": {}, "documentation": "\n\n DB Subnet Group does not cover all availability zones after it is created because users' change.\n
\n " }, { "shape_name": "ProvisionedIopsNotAvailableInAZFault", "type": "structure", "members": {}, "documentation": "\n\n Provisioned IOPS not available in the specified Availability Zone.\n
\n " }, { "shape_name": "OptionGroupNotFoundFault", "type": "structure", "members": {}, "documentation": " \n\n The specified option group could not be found. \n
\n " } ], "documentation": "\n\n Creates a new DB instance.\n
\n\n The DB Instance identifier of the Read Replica.\n This is the unique key that identifies a DB Instance.\n This parameter is stored as a lowercase string.\n
\n ", "required": true }, "SourceDBInstanceIdentifier": { "shape_name": "String", "type": "string", "documentation": "\n\n The identifier of the DB Instance that will act as the source for the Read Replica.\n Each DB Instance can have up to five Read Replicas.\n
\nConstraints: Must be the identifier of an existing DB Instance that is not already a Read Replica DB Instance.
\n ", "required": true }, "DBInstanceClass": { "shape_name": "String", "type": "string", "documentation": "\n\n The compute and memory capacity of the Read Replica.\n
\n\n Valid Values: db.m1.small | db.m1.medium | db.m1.large | db.m1.xlarge | db.m2.xlarge |db.m2.2xlarge | db.m2.4xlarge
\n
Default: Inherits from the source DB Instance.
\n " }, "AvailabilityZone": { "shape_name": "String", "type": "string", "documentation": "\n\n The Amazon EC2 Availability Zone that the Read Replica will be created in.\n
\n\n Default: A random, system-chosen Availability Zone in the endpoint's region.\n
\n\n Example: us-east-1d
\n
\n The port number that the DB Instance uses for connections.\n
\nDefault: Inherits from the source DB Instance
\nValid Values: 1150-65535
\n Indicates that minor engine upgrades will be applied automatically\n to the Read Replica during the maintenance window.\n
\nDefault: Inherits from the source DB Instance
\n " }, "Iops": { "shape_name": "IntegerOptional", "type": "integer", "documentation": "\n\n The amount of Provisioned IOPS (input/output operations per second) to be initially \n allocated for the DB Instance. \n
\n " }, "OptionGroupName": { "shape_name": "String", "type": "string", "documentation": "\n\n The option group the DB instance will be associated with. If omitted, the default Option Group\n for the engine specified will be used.\n
\n " }, "PubliclyAccessible": { "shape_name": "BooleanOptional", "type": "boolean", "documentation": null } }, "documentation": "\n " }, "output": { "shape_name": "DBInstanceWrapper", "type": "structure", "members": { "DBInstance": { "shape_name": "DBInstance", "type": "structure", "members": { "DBInstanceIdentifier": { "shape_name": "String", "type": "string", "documentation": "\n\n Contains a user-supplied database identifier.\n This is the unique key that identifies a DB Instance.\n
\n " }, "DBInstanceClass": { "shape_name": "String", "type": "string", "documentation": "\n\n Contains the name of the compute and memory\n capacity class of the DB Instance.\n
\n " }, "Engine": { "shape_name": "String", "type": "string", "documentation": "\n\n Provides the name of the database engine to be used for this DB Instance.\n
\n " }, "DBInstanceStatus": { "shape_name": "String", "type": "string", "documentation": "\n\n Specifies the current state of this database.\n
\n " }, "MasterUsername": { "shape_name": "String", "type": "string", "documentation": "\n\n Contains the master username for the DB Instance.\n
\n " }, "DBName": { "shape_name": "String", "type": "string", "documentation": "\nThe meaning of this parameter differs according to the database engine you use.
\nMySQL
\n\n Contains the name of the initial database of this instance that was\n provided at create time, if one was specified when the\n DB Instance was created. This same name is returned for\n the life of the DB Instance.\n
\nType: String
\nOracle
\n\n Contains the Oracle System ID (SID) of the created DB Instance. \n
\n " }, "Endpoint": { "shape_name": "Endpoint", "type": "structure", "members": { "Address": { "shape_name": "String", "type": "string", "documentation": "\n\n Specifies the DNS address of the DB Instance.\n
\n " }, "Port": { "shape_name": "Integer", "type": "integer", "documentation": "\n\n Specifies the port that the database engine is listening on.\n
\n " } }, "documentation": "\n\n Specifies the connection endpoint.\n
\n " }, "AllocatedStorage": { "shape_name": "Integer", "type": "integer", "documentation": "\n\n Specifies the allocated storage size specified in gigabytes.\n
\n " }, "InstanceCreateTime": { "shape_name": "TStamp", "type": "timestamp", "documentation": "\n\n Provides the date and time the DB Instance was created.\n
\n " }, "PreferredBackupWindow": { "shape_name": "String", "type": "string", "documentation": "\n\n Specifies the daily time range during which automated backups are\n created if automated backups are enabled, as determined\n by the BackupRetentionPeriod
.\n
\n Specifies the number of days for which automatic DB Snapshots are retained.\n
\n " }, "DBSecurityGroups": { "shape_name": "DBSecurityGroupMembershipList", "type": "list", "members": { "shape_name": "DBSecurityGroupMembership", "type": "structure", "members": { "DBSecurityGroupName": { "shape_name": "String", "type": "string", "documentation": "\n\n The name of the DB Security Group.\n
\n " }, "Status": { "shape_name": "String", "type": "string", "documentation": "\n\n The status of the DB Security Group.\n
\n " } }, "documentation": "\n\n This data type is used as a response element in the following actions:\n
\n\n Provides List of DB Security Group elements containing only\n DBSecurityGroup.Name
and DBSecurityGroup.Status
subelements.\n
The name of the VPC security group.
\n " }, "Status": { "shape_name": "String", "type": "string", "documentation": "\n\n The status of the VPC Security Group.\n
\n " } }, "documentation": "\nThis data type is used as a response element for queries on VPC security group membership.
\n ", "xmlname": "VpcSecurityGroupMembership" }, "documentation": "\n\n Provides List of VPC security group elements \n that the DB Instance belongs to. \n
\n " }, "DBParameterGroups": { "shape_name": "DBParameterGroupStatusList", "type": "list", "members": { "shape_name": "DBParameterGroupStatus", "type": "structure", "members": { "DBParameterGroupName": { "shape_name": "String", "type": "string", "documentation": "\n\n The name of the DP Parameter Group.\n
\n " }, "ParameterApplyStatus": { "shape_name": "String", "type": "string", "documentation": "\n\n The status of parameter updates.\n
\n " } }, "documentation": "\n\n The status of the DB Parameter Group.\n
\nThis data type is used as a response element in the following actions:
\n\n Provides the list of DB Parameter Groups applied to this DB Instance.\n
\n " }, "AvailabilityZone": { "shape_name": "String", "type": "string", "documentation": "\n\n Specifies the name of the Availability Zone the DB Instance is located in.\n
\n " }, "DBSubnetGroup": { "shape_name": "DBSubnetGroup", "type": "structure", "members": { "DBSubnetGroupName": { "shape_name": "String", "type": "string", "documentation": "\n\n Specifies the name of the DB Subnet Group.\n
\n " }, "DBSubnetGroupDescription": { "shape_name": "String", "type": "string", "documentation": "\n\n Provides the description of the DB Subnet Group.\n
\n " }, "VpcId": { "shape_name": "String", "type": "string", "documentation": "\n\n Provides the VpcId of the DB Subnet Group.\n
\n " }, "SubnetGroupStatus": { "shape_name": "String", "type": "string", "documentation": "\n\n Provides the status of the DB Subnet Group.\n
\n " }, "Subnets": { "shape_name": "SubnetList", "type": "list", "members": { "shape_name": "Subnet", "type": "structure", "members": { "SubnetIdentifier": { "shape_name": "String", "type": "string", "documentation": "\n\n Specifies the identifier of the subnet.\n
\n " }, "SubnetAvailabilityZone": { "shape_name": "AvailabilityZone", "type": "structure", "members": { "Name": { "shape_name": "String", "type": "string", "documentation": "\n\n The name of the availability zone.\n
\n " }, "ProvisionedIopsCapable": { "shape_name": "Boolean", "type": "boolean", "documentation": "\n\n True indicates the availability zone is capable of provisioned IOPs.\n
\n " } }, "wrapper": true, "documentation": "\n\n Contains Availability Zone information. \n
\n\n This data type is used as an element in the following data type:\n
\n \n \n " }, "SubnetStatus": { "shape_name": "String", "type": "string", "documentation": "\n\n Specifies the status of the subnet.\n
\n " } }, "documentation": "\n\n This data type is used as a response element in the DescribeDBSubnetGroups action.\n
\n ", "xmlname": "Subnet" }, "documentation": "\n\n Contains a list of Subnet elements.\n
\n " } }, "wrapper": true, "documentation": "\n\n Provides the inforamtion of the subnet group associated with the DB instance, including the name, descrption and subnets in the subnet group.\n
\n " }, "PreferredMaintenanceWindow": { "shape_name": "String", "type": "string", "documentation": "\n\n Specifies the weekly time range (in UTC) during which\n system maintenance can occur.\n
\n " }, "PendingModifiedValues": { "shape_name": "PendingModifiedValues", "type": "structure", "members": { "DBInstanceClass": { "shape_name": "String", "type": "string", "documentation": "\n\n Contains the new DBInstanceClass
for the DB Instance\n that will be applied or is in progress.\n
\n Contains the new AllocatedStorage
size for the DB Instance\n that will be applied or is in progress.\n
\n Contains the pending or in-progress change of the master credentials for the DB Instance.\n
\n " }, "Port": { "shape_name": "IntegerOptional", "type": "integer", "documentation": "\n\n Specifies the pending port for the DB Instance.\n
\n " }, "BackupRetentionPeriod": { "shape_name": "IntegerOptional", "type": "integer", "documentation": "\n\n Specifies the pending number of days for which automated backups are retained.\n
\n " }, "MultiAZ": { "shape_name": "BooleanOptional", "type": "boolean", "documentation": "\n\n Indicates that the Single-AZ DB Instance is to change to a Multi-AZ deployment.\n
\n " }, "EngineVersion": { "shape_name": "String", "type": "string", "documentation": "\n\n Indicates the database engine version. \n
\n " }, "Iops": { "shape_name": "IntegerOptional", "type": "integer", "documentation": "\n\n Specifies the new Provisioned IOPS value for the DB Instance\n that will be applied or is being applied.\n
\n " }, "DBInstanceIdentifier": { "shape_name": "String", "type": "string", "documentation": "\n\n Contains the new DBInstanceIdentifier
for the DB Instance\n that will be applied or is in progress.\n
\n Specifies that changes to the DB Instance are pending.\n This element is only included when changes are pending.\n Specific changes are identified by subelements.\n
\n " }, "LatestRestorableTime": { "shape_name": "TStamp", "type": "timestamp", "documentation": "\n\n Specifies the latest time to which a database\n can be restored with point-in-time restore.\n
\n " }, "MultiAZ": { "shape_name": "Boolean", "type": "boolean", "documentation": "\n\n Specifies if the DB Instance is a Multi-AZ deployment.\n
\n " }, "EngineVersion": { "shape_name": "String", "type": "string", "documentation": "\n\n Indicates the database engine version.\n
\n " }, "AutoMinorVersionUpgrade": { "shape_name": "Boolean", "type": "boolean", "documentation": "\n\n Indicates that minor version patches are applied automatically.\n
\n " }, "ReadReplicaSourceDBInstanceIdentifier": { "shape_name": "String", "type": "string", "documentation": "\n\n Contains the identifier of the source DB Instance if this DB Instance is a Read Replica.\n
\n " }, "ReadReplicaDBInstanceIdentifiers": { "shape_name": "ReadReplicaDBInstanceIdentifierList", "type": "list", "members": { "shape_name": "String", "type": "string", "documentation": null, "xmlname": "ReadReplicaDBInstanceIdentifier" }, "documentation": "\n\n Contains one or more identifiers of the Read Replicas associated with this DB Instance.\n
\n " }, "LicenseModel": { "shape_name": "String", "type": "string", "documentation": "\n\n License model information for this DB Instance.\n
\n " }, "Iops": { "shape_name": "IntegerOptional", "type": "integer", "documentation": "\n\n Specifies the Provisioned IOPS (I/O operations per second) value.\n
\n " }, "OptionGroupMembership": { "shape_name": "OptionGroupMembership", "type": "structure", "members": { "OptionGroupName": { "shape_name": "String", "type": "string", "documentation": "\n\n The name of the option group that the instance belongs to.\n
\n " }, "Status": { "shape_name": "String", "type": "string", "documentation": "\n\n The status of the DB Instance's option group membership (e.g. in-sync, pending, pending-maintenance, applying).\n
\n " } }, "documentation": "\n\n Specifies the name and status of the option group that this instance belongs to. \n
\n " }, "CharacterSetName": { "shape_name": "String", "type": "string", "documentation": "\n\n If present, specifies the name of the character set that this instance is associated with. \n
\n " }, "SecondaryAvailabilityZone": { "shape_name": "String", "type": "string", "documentation": "\n\n If present, specifies the name of the secondary Availability Zone \n for a DB instance with multi-AZ support.\n
\n " }, "PubliclyAccessible": { "shape_name": "Boolean", "type": "boolean", "documentation": null } }, "wrapper": true, "documentation": "\n\n Contains the result of a successful invocation of the following actions:\n
\n \nThis data type is used as a response element in the DescribeDBInstances action.
\n " } } }, "errors": [ { "shape_name": "DBInstanceAlreadyExistsFault", "type": "structure", "members": {}, "documentation": "\n\n User already has a DB Instance with the given identifier.\n
\n " }, { "shape_name": "InsufficientDBInstanceCapacityFault", "type": "structure", "members": {}, "documentation": "\n\n Specified DB Instance class is not available in the specified Availability Zone.\n
\n " }, { "shape_name": "DBParameterGroupNotFoundFault", "type": "structure", "members": {}, "documentation": "\n\n DBParameterGroupName does not refer to an\n existing DB Parameter Group.\n
\n " }, { "shape_name": "DBSecurityGroupNotFoundFault", "type": "structure", "members": {}, "documentation": "\n\n DBSecurityGroupName does not refer to an existing DB Security Group.\n
\n " }, { "shape_name": "InstanceQuotaExceededFault", "type": "structure", "members": {}, "documentation": "\n\n Request would result in user exceeding the allowed number of DB Instances.\n
\n " }, { "shape_name": "StorageQuotaExceededFault", "type": "structure", "members": {}, "documentation": "\n\n Request would result in user exceeding the\n allowed amount of storage available across all DB Instances.\n
\n " }, { "shape_name": "DBInstanceNotFoundFault", "type": "structure", "members": {}, "documentation": "\n\n DBInstanceIdentifier does not refer to an existing DB Instance.\n
\n " }, { "shape_name": "InvalidDBInstanceStateFault", "type": "structure", "members": {}, "documentation": "\n\n The specified DB Instance is not in the available state.\n
\n " }, { "shape_name": "DBSubnetGroupNotFoundFault", "type": "structure", "members": {}, "documentation": "\n\n DBSubnetGroupName does not refer to an existing DB Subnet Group.\n
\n " }, { "shape_name": "DBSubnetGroupDoesNotCoverEnoughAZs", "type": "structure", "members": {}, "documentation": "\n\n Subnets in the DB subnet group should cover at least 2 availability zones unless there's'only 1 available zone.\n
\n " }, { "shape_name": "InvalidSubnet", "type": "structure", "members": {}, "documentation": "\n\n Request subnet is valid, or all subnets are not in common Vpc. \n
\n " }, { "shape_name": "InvalidVPCNetworkStateFault", "type": "structure", "members": {}, "documentation": "\n\n DB Subnet Group does not cover all availability zones after it is created because users' change.\n
\n " }, { "shape_name": "ProvisionedIopsNotAvailableInAZFault", "type": "structure", "members": {}, "documentation": "\n\n Provisioned IOPS not available in the specified Availability Zone.\n
\n " }, { "shape_name": "OptionGroupNotFoundFault", "type": "structure", "members": {}, "documentation": " \n\n The specified option group could not be found. \n
\n " } ], "documentation": "\n\n Creates a DB Instance that acts as a Read Replica of a source DB Instance.\n
\n\n All Read Replica DB Instances are created as Single-AZ deployments with backups disabled.\n All other DB Instance attributes (including DB Security Groups and DB Parameter Groups)\n are inherited from the source DB Instance, except as specified below.\n
\n\n The source DB Instance must have backup retention enabled.\n
\n\n The name of the DB Parameter Group.\n
\n\n Constraints:\n
\n\n The DB Parameter Group Family name. A DB Parameter Group can be \n associated with one and only one DB Parameter Group Family, and \n can be applied only to a DB Instance running a database engine and engine version \n compatible with that DB Parameter Group Family.\n
\n\n ", "required": true }, "Description": { "shape_name": "String", "type": "string", "documentation": "\n\n The description for the DB Parameter Group.\n
\n ", "required": true } }, "documentation": "\n\n\n
\n " }, "output": { "shape_name": "DBParameterGroupWrapper", "type": "structure", "members": { "DBParameterGroup": { "shape_name": "DBParameterGroup", "type": "structure", "members": { "DBParameterGroupName": { "shape_name": "String", "type": "string", "documentation": "\n\n Provides the name of the DB Parameter Group.\n
\n " }, "DBParameterGroupFamily": { "shape_name": "String", "type": "string", "documentation": "\n\n Provides the name of the DB Parameter Group Family that\n this DB Parameter Group is compatible with.\n
\n " }, "Description": { "shape_name": "String", "type": "string", "documentation": "\n\n Provides the customer-specified description for this DB Parameter Group.\n
\n " } }, "wrapper": true, "documentation": "\n\n Contains the result of a successful invocation of the CreateDBParameterGroup action.\n
\n\n This data type is used as a request parameter in the DeleteDBParameterGroup action,\n and as a response element in the DescribeDBParameterGroups action.\n
\n " } } }, "errors": [ { "shape_name": "DBParameterGroupQuotaExceededFault", "type": "structure", "members": {}, "documentation": "\n\n Request would result in user exceeding the allowed\n number of DB Parameter Groups.\n
\n " }, { "shape_name": "DBParameterGroupAlreadyExistsFault", "type": "structure", "members": {}, "documentation": "\n\n A DB Parameter Group with the same name exists.\n
\n " } ], "documentation": "\n\n Creates a new DB Parameter Group.\n
\n\n A DB Parameter Group is initially created with the default parameters for the\n database engine used by the DB Instance. To provide custom values for any of the\n parameters, you must modify the group after creating it using\n ModifyDBParameterGroup. Once you've created a DB Parameter Group, you need to\n associate it with your DB Instance using ModifyDBInstance. When you associate\n a new DB Parameter Group with a running DB Instance, you need to reboot the DB\n Instance for the new DB Parameter Group and associated settings to take effect. \n
\n\n The name for the DB Security Group.\n This value is stored as a lowercase string.\n
\nConstraints: Must contain no more than 255 alphanumeric characters or hyphens. Must not be \"Default\".
\n \nExample: mysecuritygroup
\n The description for the DB Security Group.\n
\n ", "required": true } }, "documentation": "\n\n\n
\n " }, "output": { "shape_name": "DBSecurityGroupWrapper", "type": "structure", "members": { "DBSecurityGroup": { "shape_name": "DBSecurityGroup", "type": "structure", "members": { "OwnerId": { "shape_name": "String", "type": "string", "documentation": "\n\n Provides the AWS ID of the owner of a specific DB Security Group.\n
\n " }, "DBSecurityGroupName": { "shape_name": "String", "type": "string", "documentation": "\n\n Specifies the name of the DB Security Group.\n
\n " }, "DBSecurityGroupDescription": { "shape_name": "String", "type": "string", "documentation": "\n\n Provides the description of the DB Security Group.\n
\n " }, "VpcId": { "shape_name": "String", "type": "string", "documentation": "\n\n Provides the VpcId of the DB Security Group.\n
\n " }, "EC2SecurityGroups": { "shape_name": "EC2SecurityGroupList", "type": "list", "members": { "shape_name": "EC2SecurityGroup", "type": "structure", "members": { "Status": { "shape_name": "String", "type": "string", "documentation": "\n\n Provides the status of the EC2 security group. Status can be \"authorizing\", \n \"authorized\", \"revoking\", and \"revoked\".\n
\n " }, "EC2SecurityGroupName": { "shape_name": "String", "type": "string", "documentation": "\n\n Specifies the name of the EC2 Security Group.\n
\n " }, "EC2SecurityGroupId": { "shape_name": "String", "type": "string", "documentation": "\n\n Specifies the id of the EC2 Security Group.\n
\n " }, "EC2SecurityGroupOwnerId": { "shape_name": "String", "type": "string", "documentation": "\n\n Specifies the AWS ID of the owner of the EC2 security group\n specified in the EC2SecurityGroupName
field.\n
\n This data type is used as a response element in the following actions:\n
\n \n ", "xmlname": "EC2SecurityGroup" }, "documentation": "\n\n Contains a list of EC2SecurityGroup elements.\n
\n " }, "IPRanges": { "shape_name": "IPRangeList", "type": "list", "members": { "shape_name": "IPRange", "type": "structure", "members": { "Status": { "shape_name": "String", "type": "string", "documentation": "\n\n Specifies the status of the IP range. Status can be \"authorizing\", \n \"authorized\", \"revoking\", and \"revoked\".\n
\n " }, "CIDRIP": { "shape_name": "String", "type": "string", "documentation": "\n\n Specifies the IP range.\n
\n " } }, "documentation": "\n\n This data type is used as a response element in the DescribeDBSecurityGroups action.\n
\n ", "xmlname": "IPRange" }, "documentation": "\n\n Contains a list of IPRange elements.\n
\n " } }, "wrapper": true, "documentation": "\n\n Contains the result of a successful invocation of the following actions:\n
\nThis data type is used as a response element in the DescribeDBSecurityGroups action.
\n \n " } } }, "errors": [ { "shape_name": "DBSecurityGroupAlreadyExistsFault", "type": "structure", "members": {}, "documentation": "\n\n A database security group with the name specified in\n DBSecurityGroupName already exists.\n
\n " }, { "shape_name": "DBSecurityGroupQuotaExceededFault", "type": "structure", "members": {}, "documentation": "\n\n Request would result in user exceeding the allowed number of DB Security Groups.\n
\n " }, { "shape_name": "DBSecurityGroupNotSupportedFault", "type": "structure", "members": {}, "documentation": "\n\n A DB security group is not allowed for this action.\n
\n " } ], "documentation": "\n\n Creates a new DB Security Group. DB Security Groups control access to a DB Instance.\n
\n\n The identifier for the DB Snapshot.\n
\nConstraints:
\nExample: my-snapshot-id
\n The DB Instance identifier. This is the unique key\n that identifies a DB Instance. This parameter isn't case sensitive.\n
\nConstraints:
\n\n\n
\n " }, "output": { "shape_name": "DBSnapshotWrapper", "type": "structure", "members": { "DBSnapshot": { "shape_name": "DBSnapshot", "type": "structure", "members": { "DBSnapshotIdentifier": { "shape_name": "String", "type": "string", "documentation": "\n\n Specifies the identifier for the DB Snapshot.\n
\n " }, "DBInstanceIdentifier": { "shape_name": "String", "type": "string", "documentation": "\n\n Specifies the the DBInstanceIdentifier of the DB Instance\n this DB Snapshot was created from.\n
\n " }, "SnapshotCreateTime": { "shape_name": "TStamp", "type": "timestamp", "documentation": "\n\n Provides the time (UTC) when the snapshot was taken.\n
\n " }, "Engine": { "shape_name": "String", "type": "string", "documentation": "\n\n Specifies the name of the database engine.\n
\n " }, "AllocatedStorage": { "shape_name": "Integer", "type": "integer", "documentation": "\n\n Specifies the allocated storage size in gigabytes (GB).\n
\n " }, "Status": { "shape_name": "String", "type": "string", "documentation": "\n\n Specifies the status of this DB Snapshot.\n
\n " }, "Port": { "shape_name": "Integer", "type": "integer", "documentation": "\n\n Specifies the port that the database engine was\n listening on at the time of the snapshot.\n
\n " }, "AvailabilityZone": { "shape_name": "String", "type": "string", "documentation": "\n\n Specifies the name of the Availability Zone the DB\n Instance was located in at the time of the DB Snapshot.\n
\n " }, "VpcId": { "shape_name": "String", "type": "string", "documentation": "\n\n Provides the Vpc Id associated with the DB Snapshot.\n
\n " }, "InstanceCreateTime": { "shape_name": "TStamp", "type": "timestamp", "documentation": "\n\n Specifies the time (UTC) when the snapshot was taken.\n
\n " }, "MasterUsername": { "shape_name": "String", "type": "string", "documentation": "\n\n Provides the master username for the DB Instance.\n
\n " }, "EngineVersion": { "shape_name": "String", "type": "string", "documentation": "\n\n Specifies the version of the database engine.\n
\n " }, "LicenseModel": { "shape_name": "String", "type": "string", "documentation": "\n\n License model information for the restored DB Instance.\n
\n " }, "SnapshotType": { "shape_name": "String", "type": "string", "documentation": "\n\n Provides the type of the DB Snapshot.\n
\n " }, "Iops": { "shape_name": "IntegerOptional", "type": "integer", "documentation": "\n\n Specifies the Provisioned IOPS (I/O operations per second) value of the DB Instance at the time of the snapshot.\n
\n " } }, "wrapper": true, "documentation": "\n\n Contains the result of a successful invocation of the following actions:\n
\nThis data type is used as a response element in the DescribeDBSnapshots action.
\n " } } }, "errors": [ { "shape_name": "DBSnapshotAlreadyExistsFault", "type": "structure", "members": {}, "documentation": "\n\n DBSnapshotIdentifier is already used by an existing snapshot.\n
\n " }, { "shape_name": "InvalidDBInstanceStateFault", "type": "structure", "members": {}, "documentation": "\n\n The specified DB Instance is not in the available state.\n
\n " }, { "shape_name": "DBInstanceNotFoundFault", "type": "structure", "members": {}, "documentation": "\n\n DBInstanceIdentifier does not refer to an existing DB Instance.\n
\n " }, { "shape_name": "SnapshotQuotaExceededFault", "type": "structure", "members": {}, "documentation": "\n\n Request would result in user exceeding the allowed number of DB Snapshots.\n
\n " } ], "documentation": "\n\n Creates a DBSnapshot. The source DBInstance must be in \"available\" state.\n
\n\n The name for the DB Subnet Group.\n This value is stored as a lowercase string.\n
\nConstraints: Must contain no more than 255 alphanumeric characters or hyphens. Must not be \"Default\".
\n \nExample: mySubnetgroup
\n The description for the DB Subnet Group.\n
\n ", "required": true }, "SubnetIds": { "shape_name": "SubnetIdentifierList", "type": "list", "members": { "shape_name": "String", "type": "string", "documentation": null, "xmlname": "SubnetIdentifier" }, "documentation": "\n\n The EC2 Subnet IDs for the DB Subnet Group.\n
\n ", "required": true } }, "documentation": "\n\n\n
\n " }, "output": { "shape_name": "DBSubnetGroupWrapper", "type": "structure", "members": { "DBSubnetGroup": { "shape_name": "DBSubnetGroup", "type": "structure", "members": { "DBSubnetGroupName": { "shape_name": "String", "type": "string", "documentation": "\n\n Specifies the name of the DB Subnet Group.\n
\n " }, "DBSubnetGroupDescription": { "shape_name": "String", "type": "string", "documentation": "\n\n Provides the description of the DB Subnet Group.\n
\n " }, "VpcId": { "shape_name": "String", "type": "string", "documentation": "\n\n Provides the VpcId of the DB Subnet Group.\n
\n " }, "SubnetGroupStatus": { "shape_name": "String", "type": "string", "documentation": "\n\n Provides the status of the DB Subnet Group.\n
\n " }, "Subnets": { "shape_name": "SubnetList", "type": "list", "members": { "shape_name": "Subnet", "type": "structure", "members": { "SubnetIdentifier": { "shape_name": "String", "type": "string", "documentation": "\n\n Specifies the identifier of the subnet.\n
\n " }, "SubnetAvailabilityZone": { "shape_name": "AvailabilityZone", "type": "structure", "members": { "Name": { "shape_name": "String", "type": "string", "documentation": "\n\n The name of the availability zone.\n
\n " }, "ProvisionedIopsCapable": { "shape_name": "Boolean", "type": "boolean", "documentation": "\n\n True indicates the availability zone is capable of provisioned IOPs.\n
\n " } }, "wrapper": true, "documentation": "\n\n Contains Availability Zone information. \n
\n\n This data type is used as an element in the following data type:\n
\n \n \n " }, "SubnetStatus": { "shape_name": "String", "type": "string", "documentation": "\n\n Specifies the status of the subnet.\n
\n " } }, "documentation": "\n\n This data type is used as a response element in the DescribeDBSubnetGroups action.\n
\n ", "xmlname": "Subnet" }, "documentation": "\n\n Contains a list of Subnet elements.\n
\n " } }, "wrapper": true, "documentation": "\n\n Contains the result of a successful invocation of the following actions:\n
\n \nThis data type is used as a response element in the DescribeDBSubnetGroups action.
\n " } } }, "errors": [ { "shape_name": "DBSubnetGroupAlreadyExistsFault", "type": "structure", "members": {}, "documentation": "\n\n DBSubnetGroupName is already used by an existing DBSubnetGroup.\n
\n " }, { "shape_name": "DBSubnetGroupQuotaExceededFault", "type": "structure", "members": {}, "documentation": "\n\n Request would result in user exceeding the allowed number of DB Subnet Groups.\n
\n " }, { "shape_name": "DBSubnetQuotaExceededFault", "type": "structure", "members": {}, "documentation": "\n\n Request would result in user exceeding the allowed number of subnets in a DB subnet Groups.\n
\n " }, { "shape_name": "DBSubnetGroupDoesNotCoverEnoughAZs", "type": "structure", "members": {}, "documentation": "\n\n Subnets in the DB subnet group should cover at least 2 availability zones unless there's'only 1 available zone.\n
\n " }, { "shape_name": "InvalidSubnet", "type": "structure", "members": {}, "documentation": "\n\n Request subnet is valid, or all subnets are not in common Vpc. \n
\n " } ], "documentation": "\n\n Creates a new DB subnet group. DB subnet groups must contain at least one subnet in at least two AZs in the region.\n
\nThe name of the subscription.
\nConstraints: The name must be less than 255 characters.
\n ", "required": true }, "SnsTopicArn": { "shape_name": "String", "type": "string", "documentation": "\n\n The Amazon Resource Name (ARN) of the SNS topic created for event notification. The ARN is created by Amazon SNS when you create \n a topic and subscribe to it.\n
\n ", "required": true }, "SourceType": { "shape_name": "String", "type": "string", "documentation": "\n\n The type of source that will be generating the events. For example, if you want to be notified of events generated by a DB instance, \n you would set this parameter to db-instance. if this value is not specified, all events are returned.\n
\nValid values: db-instance | db-parameter-group | db-security-group | db-snapshot
\n " }, "EventCategories": { "shape_name": "EventCategoriesList", "type": "list", "members": { "shape_name": "String", "type": "string", "documentation": null, "xmlname": "EventCategory" }, "documentation": "\n\n A list of event categories for a SourceType that you want to subscribe to. You can see a list of the categories for a given SourceType \n in the Events topic in the Amazon RDS User Guide \n or by using the DescribeEventCategories action.\n
\n " }, "SourceIds": { "shape_name": "SourceIdsList", "type": "list", "members": { "shape_name": "String", "type": "string", "documentation": null, "xmlname": "SourceId" }, "documentation": "\n\n The list of identifiers of the event sources for which events will be returned. If not specified,\n then all sources are included in the response. An identifier must begin with a letter and must contain only \n ASCII letters, digits, and hyphens; it cannot end with a hyphen or contain two consecutive hyphens.\n
\nConstraints:
\n\n A Boolean value; set to true to activate the subscription, set to false to create the subscription but not active it.\n
\n " } }, "documentation": " \n \n " }, "output": { "shape_name": "EventSubscriptionWrapper", "type": "structure", "members": { "EventSubscription": { "shape_name": "EventSubscription", "type": "structure", "members": { "Id": { "shape_name": "String", "type": "string", "documentation": "\nNot used.
\n " }, "CustomerAwsId": { "shape_name": "String", "type": "string", "documentation": "\nThe AWS customer account associated with the RDS event notification subscription.
\n " }, "CustSubscriptionId": { "shape_name": "String", "type": "string", "documentation": "\nThe RDS event notification subscription Id.
\n " }, "SnsTopicArn": { "shape_name": "String", "type": "string", "documentation": "\nThe topic ARN of the RDS event notification subscription.
\n " }, "Status": { "shape_name": "String", "type": "string", "documentation": "\nThe status of the RDS event notification subscription.
\nConstraints:
\nCan be one of the following: creating | modifying | deleting | active | no-permission | topic-not-exist
\nThe status \"no-permission\" indicates that RDS no longer has permission to post to the SNS topic. The status \n \"topic-not-exist\" indicates that the topic was deleted after the subscription was created.
\n " }, "SubscriptionCreationTime": { "shape_name": "String", "type": "string", "documentation": "\nThe time the RDS event notification subscription was created.
\n " }, "SourceType": { "shape_name": "String", "type": "string", "documentation": "\nThe source type for the RDS event notification subscription.
\n " }, "SourceIdsList": { "shape_name": "SourceIdsList", "type": "list", "members": { "shape_name": "String", "type": "string", "documentation": null, "xmlname": "SourceId" }, "documentation": "\nA list of source Ids for the RDS event notification subscription.
\n " }, "EventCategoriesList": { "shape_name": "EventCategoriesList", "type": "list", "members": { "shape_name": "String", "type": "string", "documentation": null, "xmlname": "EventCategory" }, "documentation": "\nA list of event categories for the RDS event notification subscription.
\n " }, "Enabled": { "shape_name": "Boolean", "type": "boolean", "documentation": "\nA Boolean value indicating if the subscription is enabled. True indicates the subscription is enabled.
\n " } }, "wrapper": true, "documentation": "\nContains the results of a successful invocation of the DescribeEventSubscriptions action.
\n " } } }, "errors": [ { "shape_name": "EventSubscriptionQuotaExceededFault", "type": "structure", "members": {}, "documentation": "\nYou have reached the maximum number of event subscriptions.
\n " }, { "shape_name": "SubscriptionAlreadyExistFault", "type": "structure", "members": {}, "documentation": "\nThe supplied subscription name already exists.
\n " }, { "shape_name": "SNSInvalidTopicFault", "type": "structure", "members": {}, "documentation": "\nSNS has responded that there is a problem with the SND topic specified.
\n " }, { "shape_name": "SNSNoAuthorizationFault", "type": "structure", "members": {}, "documentation": "\nYou do not have permission to publish to the SNS topic ARN.
\n " }, { "shape_name": "SNSTopicArnNotFoundFault", "type": "structure", "members": {}, "documentation": "\nThe SNS topic ARN does not exist.
\n " }, { "shape_name": "SubscriptionCategoryNotFoundFault", "type": "structure", "members": {}, "documentation": "\nThe supplied category does not exist.
\n " }, { "shape_name": "SourceNotFoundFault", "type": "structure", "members": {}, "documentation": "\nThe requested source could not be found.
\n " } ], "documentation": "\nCreates an RDS event notification subscription. This action requires a topic ARN \n (Amazon Resource Name) created by either \n the RDS console, the SNS console, or the SNS API. To obtain an ARN with SNS, you must create a topic in \n Amazon SNS and subscribe to the topic. The ARN is displayed in the SNS console.
\nYou can specify the type of source (SourceType) you want to be notified of, provide a list of RDS \n sources (SourceIds) that triggers the events, and provide a list of event categories (EventCategories) \n for events you want to be notified of. For example, you can specify SourceType = db-instance, SourceIds = mydbinstance1, mydbinstance2 and \n EventCategories = Availability, Backup.
\nIf you specify both the SourceType and SourceIds, such as \n SourceType = db-instance and SourceIdentifier = myDBInstance1, you will be notified of all the db-instance \n events for the specified source. If you specify a SourceType but do not specify a SourceIdentifier, \n you will receive notice of the events for that source type for all your RDS sources. If you \n do not specify either the SourceType nor the SourceIdentifier, you will be notified of events \n generated from all RDS sources belonging to your customer account.
\n\n Specifies the name of the option group to be created.\n
\n\n Constraints:\n
\nExample: myOptiongroup
\n Specifies the name of the engine that this option group should be associated with.\n
\n ", "required": true }, "MajorEngineVersion": { "shape_name": "String", "type": "string", "documentation": "\n\n Specifies the major version of the engine that this option group should be associated with.\n
\n ", "required": true }, "OptionGroupDescription": { "shape_name": "String", "type": "string", "documentation": "\n\n The description of the option group.\n
\n ", "required": true } }, "documentation": "\n \n " }, "output": { "shape_name": "OptionGroupWrapper", "type": "structure", "members": { "OptionGroup": { "shape_name": "OptionGroup", "type": "structure", "members": { "OptionGroupName": { "shape_name": "String", "type": "string", "documentation": "\n\n Specifies the name of the option group.\n
\n " }, "OptionGroupDescription": { "shape_name": "String", "type": "string", "documentation": "\n\n Provides the description of the option group.\n
\n " }, "EngineName": { "shape_name": "String", "type": "string", "documentation": "\n\n Engine name that this option group can be applied to.\n
\n " }, "MajorEngineVersion": { "shape_name": "String", "type": "string", "documentation": "\n\n Indicates the major engine version associated with this option group.\n
\n " }, "Options": { "shape_name": "OptionsList", "type": "list", "members": { "shape_name": "Option", "type": "structure", "members": { "OptionName": { "shape_name": "String", "type": "string", "documentation": "\n\n The name of the option.\n
\n " }, "OptionDescription": { "shape_name": "String", "type": "string", "documentation": "\n\n The description of the option.\n
\n " }, "Port": { "shape_name": "IntegerOptional", "type": "integer", "documentation": "\n\n If required, the port configured for this option to use.\n
\n " }, "DBSecurityGroupMemberships": { "shape_name": "DBSecurityGroupMembershipList", "type": "list", "members": { "shape_name": "DBSecurityGroupMembership", "type": "structure", "members": { "DBSecurityGroupName": { "shape_name": "String", "type": "string", "documentation": "\n\n The name of the DB Security Group.\n
\n " }, "Status": { "shape_name": "String", "type": "string", "documentation": "\n\n The status of the DB Security Group.\n
\n " } }, "documentation": "\n\n This data type is used as a response element in the following actions:\n
\n\n If the Option requires access to a port, then this DB Security Group allows access to the port. \n
\n " }, "VpcSecurityGroupMemberships": { "shape_name": "VpcSecurityGroupMembershipList", "type": "list", "members": { "shape_name": "VpcSecurityGroupMembership", "type": "structure", "members": { "VpcSecurityGroupId": { "shape_name": "String", "type": "string", "documentation": "\nThe name of the VPC security group.
\n " }, "Status": { "shape_name": "String", "type": "string", "documentation": "\n\n The status of the VPC Security Group.\n
\n " } }, "documentation": "\nThis data type is used as a response element for queries on VPC security group membership.
\n ", "xmlname": "VpcSecurityGroupMembership" }, "documentation": "\n\n If the Option requires access to a port, then this VPC Security Group allows access to the port.\n
\n " } }, "documentation": "\n\n Option details.\n
\n", "xmlname": "Option" }, "documentation": "\n\n Indicates what options are available in the option group.\n
\n " }, "AllowsVpcAndNonVpcInstanceMemberships": { "shape_name": "Boolean", "type": "boolean", "documentation": "\n\n Indicates whether this option group can be applied to both VPC \n and non-VPC instances. The value 'true' indicates the option group \n can be applied to both VPC and non-VPC instances.\n
\n " }, "VpcId": { "shape_name": "String", "type": "string", "documentation": "\n\n If AllowsVpcAndNonVpcInstanceMemberships is 'false', this field is blank.\n If AllowsVpcAndNonVpcInstanceMemberships is 'true' and this field is blank, \n then this option group can be applied to both VPC and non-VPC instances.\n If this field contains a value, then this option group can only be \n applied to instances that are in the VPC indicated by this field.\n
\n " } }, "wrapper": true, "documentation": "\n\n
\n " } } }, "errors": [ { "shape_name": "OptionGroupAlreadyExistsFault", "type": "structure", "members": {}, "documentation": " \n\n The option group you are trying to create already exists.\n
\n " }, { "shape_name": "OptionGroupQuotaExceededFault", "type": "structure", "members": {}, "documentation": " \n\n The quota of 20 option groups was exceeded for this AWS account.\n
\n " } ], "documentation": "\n\n Creates a new Option Group. \n
\n\n The DB Instance identifier for the DB Instance to be deleted.\n This parameter isn't case sensitive.\n
\nConstraints:
\n\n Determines whether a final DB Snapshot is created before the DB Instance is deleted. \n If true
is specified, no DBSnapshot is created. If false is specified, a DB Snapshot \n is created before the DB Instance is deleted.\n
false
.Default: false
\n The DBSnapshotIdentifier of the new DBSnapshot created when SkipFinalSnapshot\n is set to false
.\n
Constraints:
\n\n\n
\n " }, "output": { "shape_name": "DBInstanceWrapper", "type": "structure", "members": { "DBInstance": { "shape_name": "DBInstance", "type": "structure", "members": { "DBInstanceIdentifier": { "shape_name": "String", "type": "string", "documentation": "\n\n Contains a user-supplied database identifier.\n This is the unique key that identifies a DB Instance.\n
\n " }, "DBInstanceClass": { "shape_name": "String", "type": "string", "documentation": "\n\n Contains the name of the compute and memory\n capacity class of the DB Instance.\n
\n " }, "Engine": { "shape_name": "String", "type": "string", "documentation": "\n\n Provides the name of the database engine to be used for this DB Instance.\n
\n " }, "DBInstanceStatus": { "shape_name": "String", "type": "string", "documentation": "\n\n Specifies the current state of this database.\n
\n " }, "MasterUsername": { "shape_name": "String", "type": "string", "documentation": "\n\n Contains the master username for the DB Instance.\n
\n " }, "DBName": { "shape_name": "String", "type": "string", "documentation": "\nThe meaning of this parameter differs according to the database engine you use.
\nMySQL
\n\n Contains the name of the initial database of this instance that was\n provided at create time, if one was specified when the\n DB Instance was created. This same name is returned for\n the life of the DB Instance.\n
\nType: String
\nOracle
\n\n Contains the Oracle System ID (SID) of the created DB Instance. \n
\n " }, "Endpoint": { "shape_name": "Endpoint", "type": "structure", "members": { "Address": { "shape_name": "String", "type": "string", "documentation": "\n\n Specifies the DNS address of the DB Instance.\n
\n " }, "Port": { "shape_name": "Integer", "type": "integer", "documentation": "\n\n Specifies the port that the database engine is listening on.\n
\n " } }, "documentation": "\n\n Specifies the connection endpoint.\n
\n " }, "AllocatedStorage": { "shape_name": "Integer", "type": "integer", "documentation": "\n\n Specifies the allocated storage size specified in gigabytes.\n
\n " }, "InstanceCreateTime": { "shape_name": "TStamp", "type": "timestamp", "documentation": "\n\n Provides the date and time the DB Instance was created.\n
\n " }, "PreferredBackupWindow": { "shape_name": "String", "type": "string", "documentation": "\n\n Specifies the daily time range during which automated backups are\n created if automated backups are enabled, as determined\n by the BackupRetentionPeriod
.\n
\n Specifies the number of days for which automatic DB Snapshots are retained.\n
\n " }, "DBSecurityGroups": { "shape_name": "DBSecurityGroupMembershipList", "type": "list", "members": { "shape_name": "DBSecurityGroupMembership", "type": "structure", "members": { "DBSecurityGroupName": { "shape_name": "String", "type": "string", "documentation": "\n\n The name of the DB Security Group.\n
\n " }, "Status": { "shape_name": "String", "type": "string", "documentation": "\n\n The status of the DB Security Group.\n
\n " } }, "documentation": "\n\n This data type is used as a response element in the following actions:\n
\n\n Provides List of DB Security Group elements containing only\n DBSecurityGroup.Name
and DBSecurityGroup.Status
subelements.\n
The name of the VPC security group.
\n " }, "Status": { "shape_name": "String", "type": "string", "documentation": "\n\n The status of the VPC Security Group.\n
\n " } }, "documentation": "\nThis data type is used as a response element for queries on VPC security group membership.
\n ", "xmlname": "VpcSecurityGroupMembership" }, "documentation": "\n\n Provides List of VPC security group elements \n that the DB Instance belongs to. \n
\n " }, "DBParameterGroups": { "shape_name": "DBParameterGroupStatusList", "type": "list", "members": { "shape_name": "DBParameterGroupStatus", "type": "structure", "members": { "DBParameterGroupName": { "shape_name": "String", "type": "string", "documentation": "\n\n The name of the DP Parameter Group.\n
\n " }, "ParameterApplyStatus": { "shape_name": "String", "type": "string", "documentation": "\n\n The status of parameter updates.\n
\n " } }, "documentation": "\n\n The status of the DB Parameter Group.\n
\nThis data type is used as a response element in the following actions:
\n\n Provides the list of DB Parameter Groups applied to this DB Instance.\n
\n " }, "AvailabilityZone": { "shape_name": "String", "type": "string", "documentation": "\n\n Specifies the name of the Availability Zone the DB Instance is located in.\n
\n " }, "DBSubnetGroup": { "shape_name": "DBSubnetGroup", "type": "structure", "members": { "DBSubnetGroupName": { "shape_name": "String", "type": "string", "documentation": "\n\n Specifies the name of the DB Subnet Group.\n
\n " }, "DBSubnetGroupDescription": { "shape_name": "String", "type": "string", "documentation": "\n\n Provides the description of the DB Subnet Group.\n
\n " }, "VpcId": { "shape_name": "String", "type": "string", "documentation": "\n\n Provides the VpcId of the DB Subnet Group.\n
\n " }, "SubnetGroupStatus": { "shape_name": "String", "type": "string", "documentation": "\n\n Provides the status of the DB Subnet Group.\n
\n " }, "Subnets": { "shape_name": "SubnetList", "type": "list", "members": { "shape_name": "Subnet", "type": "structure", "members": { "SubnetIdentifier": { "shape_name": "String", "type": "string", "documentation": "\n\n Specifies the identifier of the subnet.\n
\n " }, "SubnetAvailabilityZone": { "shape_name": "AvailabilityZone", "type": "structure", "members": { "Name": { "shape_name": "String", "type": "string", "documentation": "\n\n The name of the availability zone.\n
\n " }, "ProvisionedIopsCapable": { "shape_name": "Boolean", "type": "boolean", "documentation": "\n\n True indicates the availability zone is capable of provisioned IOPs.\n
\n " } }, "wrapper": true, "documentation": "\n\n Contains Availability Zone information. \n
\n\n This data type is used as an element in the following data type:\n
\n \n \n " }, "SubnetStatus": { "shape_name": "String", "type": "string", "documentation": "\n\n Specifies the status of the subnet.\n
\n " } }, "documentation": "\n\n This data type is used as a response element in the DescribeDBSubnetGroups action.\n
\n ", "xmlname": "Subnet" }, "documentation": "\n\n Contains a list of Subnet elements.\n
\n " } }, "wrapper": true, "documentation": "\n\n Provides the inforamtion of the subnet group associated with the DB instance, including the name, descrption and subnets in the subnet group.\n
\n " }, "PreferredMaintenanceWindow": { "shape_name": "String", "type": "string", "documentation": "\n\n Specifies the weekly time range (in UTC) during which\n system maintenance can occur.\n
\n " }, "PendingModifiedValues": { "shape_name": "PendingModifiedValues", "type": "structure", "members": { "DBInstanceClass": { "shape_name": "String", "type": "string", "documentation": "\n\n Contains the new DBInstanceClass
for the DB Instance\n that will be applied or is in progress.\n
\n Contains the new AllocatedStorage
size for the DB Instance\n that will be applied or is in progress.\n
\n Contains the pending or in-progress change of the master credentials for the DB Instance.\n
\n " }, "Port": { "shape_name": "IntegerOptional", "type": "integer", "documentation": "\n\n Specifies the pending port for the DB Instance.\n
\n " }, "BackupRetentionPeriod": { "shape_name": "IntegerOptional", "type": "integer", "documentation": "\n\n Specifies the pending number of days for which automated backups are retained.\n
\n " }, "MultiAZ": { "shape_name": "BooleanOptional", "type": "boolean", "documentation": "\n\n Indicates that the Single-AZ DB Instance is to change to a Multi-AZ deployment.\n
\n " }, "EngineVersion": { "shape_name": "String", "type": "string", "documentation": "\n\n Indicates the database engine version. \n
\n " }, "Iops": { "shape_name": "IntegerOptional", "type": "integer", "documentation": "\n\n Specifies the new Provisioned IOPS value for the DB Instance\n that will be applied or is being applied.\n
\n " }, "DBInstanceIdentifier": { "shape_name": "String", "type": "string", "documentation": "\n\n Contains the new DBInstanceIdentifier
for the DB Instance\n that will be applied or is in progress.\n
\n Specifies that changes to the DB Instance are pending.\n This element is only included when changes are pending.\n Specific changes are identified by subelements.\n
\n " }, "LatestRestorableTime": { "shape_name": "TStamp", "type": "timestamp", "documentation": "\n\n Specifies the latest time to which a database\n can be restored with point-in-time restore.\n
\n " }, "MultiAZ": { "shape_name": "Boolean", "type": "boolean", "documentation": "\n\n Specifies if the DB Instance is a Multi-AZ deployment.\n
\n " }, "EngineVersion": { "shape_name": "String", "type": "string", "documentation": "\n\n Indicates the database engine version.\n
\n " }, "AutoMinorVersionUpgrade": { "shape_name": "Boolean", "type": "boolean", "documentation": "\n\n Indicates that minor version patches are applied automatically.\n
\n " }, "ReadReplicaSourceDBInstanceIdentifier": { "shape_name": "String", "type": "string", "documentation": "\n\n Contains the identifier of the source DB Instance if this DB Instance is a Read Replica.\n
\n " }, "ReadReplicaDBInstanceIdentifiers": { "shape_name": "ReadReplicaDBInstanceIdentifierList", "type": "list", "members": { "shape_name": "String", "type": "string", "documentation": null, "xmlname": "ReadReplicaDBInstanceIdentifier" }, "documentation": "\n\n Contains one or more identifiers of the Read Replicas associated with this DB Instance.\n
\n " }, "LicenseModel": { "shape_name": "String", "type": "string", "documentation": "\n\n License model information for this DB Instance.\n
\n " }, "Iops": { "shape_name": "IntegerOptional", "type": "integer", "documentation": "\n\n Specifies the Provisioned IOPS (I/O operations per second) value.\n
\n " }, "OptionGroupMembership": { "shape_name": "OptionGroupMembership", "type": "structure", "members": { "OptionGroupName": { "shape_name": "String", "type": "string", "documentation": "\n\n The name of the option group that the instance belongs to.\n
\n " }, "Status": { "shape_name": "String", "type": "string", "documentation": "\n\n The status of the DB Instance's option group membership (e.g. in-sync, pending, pending-maintenance, applying).\n
\n " } }, "documentation": "\n\n Specifies the name and status of the option group that this instance belongs to. \n
\n " }, "CharacterSetName": { "shape_name": "String", "type": "string", "documentation": "\n\n If present, specifies the name of the character set that this instance is associated with. \n
\n " }, "SecondaryAvailabilityZone": { "shape_name": "String", "type": "string", "documentation": "\n\n If present, specifies the name of the secondary Availability Zone \n for a DB instance with multi-AZ support.\n
\n " }, "PubliclyAccessible": { "shape_name": "Boolean", "type": "boolean", "documentation": null } }, "wrapper": true, "documentation": "\n\n Contains the result of a successful invocation of the following actions:\n
\n \nThis data type is used as a response element in the DescribeDBInstances action.
\n " } } }, "errors": [ { "shape_name": "DBInstanceNotFoundFault", "type": "structure", "members": {}, "documentation": "\n\n DBInstanceIdentifier does not refer to an existing DB Instance.\n
\n " }, { "shape_name": "InvalidDBInstanceStateFault", "type": "structure", "members": {}, "documentation": "\n\n The specified DB Instance is not in the available state.\n
\n " }, { "shape_name": "DBSnapshotAlreadyExistsFault", "type": "structure", "members": {}, "documentation": "\n\n DBSnapshotIdentifier is already used by an existing snapshot.\n
\n " }, { "shape_name": "SnapshotQuotaExceededFault", "type": "structure", "members": {}, "documentation": "\n\n Request would result in user exceeding the allowed number of DB Snapshots.\n
\n " } ], "documentation": "\n\n The DeleteDBInstance API deletes a previously provisioned RDS instance. A successful response\n from the web service indicates the request was received correctly. If a final DBSnapshot is requested\n the status of the RDS instance will be \"deleting\" until the DBSnapshot is created. DescribeDBInstance\n is used to monitor the status of this operation. This cannot be canceled or reverted once submitted.\n
\n\n The name of the DB Parameter Group.\n
\nConstraints:
\n\n\n
\n " }, "output": null, "errors": [ { "shape_name": "InvalidDBParameterGroupStateFault", "type": "structure", "members": {}, "documentation": "\n\n The DB Parameter Group cannot be deleted because it is in use.\n
\n " }, { "shape_name": "DBParameterGroupNotFoundFault", "type": "structure", "members": {}, "documentation": "\n\n DBParameterGroupName does not refer to an\n existing DB Parameter Group.\n
\n " } ], "documentation": "\n\n Deletes a specified DBParameterGroup. The DBParameterGroup cannot be associated with\n any RDS instances to be deleted.\n
\n\n The name of the DB Security Group to delete.\n
\n\n Constraints:\n
\n\n\n
\n " }, "output": null, "errors": [ { "shape_name": "InvalidDBSecurityGroupStateFault", "type": "structure", "members": {}, "documentation": "\n\n The state of the DB Security Group does not allow deletion.\n
\n " }, { "shape_name": "DBSecurityGroupNotFoundFault", "type": "structure", "members": {}, "documentation": "\n\n DBSecurityGroupName does not refer to an existing DB Security Group.\n
\n " } ], "documentation": "\n\n Deletes a DB Security Group. \n
\n\n The DBSnapshot identifier.\n
\nConstraints: Must be the name of an existing DB Snapshot in the available
state.
\n\n
\n " }, "output": { "shape_name": "DBSnapshotWrapper", "type": "structure", "members": { "DBSnapshot": { "shape_name": "DBSnapshot", "type": "structure", "members": { "DBSnapshotIdentifier": { "shape_name": "String", "type": "string", "documentation": "\n\n Specifies the identifier for the DB Snapshot.\n
\n " }, "DBInstanceIdentifier": { "shape_name": "String", "type": "string", "documentation": "\n\n Specifies the the DBInstanceIdentifier of the DB Instance\n this DB Snapshot was created from.\n
\n " }, "SnapshotCreateTime": { "shape_name": "TStamp", "type": "timestamp", "documentation": "\n\n Provides the time (UTC) when the snapshot was taken.\n
\n " }, "Engine": { "shape_name": "String", "type": "string", "documentation": "\n\n Specifies the name of the database engine.\n
\n " }, "AllocatedStorage": { "shape_name": "Integer", "type": "integer", "documentation": "\n\n Specifies the allocated storage size in gigabytes (GB).\n
\n " }, "Status": { "shape_name": "String", "type": "string", "documentation": "\n\n Specifies the status of this DB Snapshot.\n
\n " }, "Port": { "shape_name": "Integer", "type": "integer", "documentation": "\n\n Specifies the port that the database engine was\n listening on at the time of the snapshot.\n
\n " }, "AvailabilityZone": { "shape_name": "String", "type": "string", "documentation": "\n\n Specifies the name of the Availability Zone the DB\n Instance was located in at the time of the DB Snapshot.\n
\n " }, "VpcId": { "shape_name": "String", "type": "string", "documentation": "\n\n Provides the Vpc Id associated with the DB Snapshot.\n
\n " }, "InstanceCreateTime": { "shape_name": "TStamp", "type": "timestamp", "documentation": "\n\n Specifies the time (UTC) when the snapshot was taken.\n
\n " }, "MasterUsername": { "shape_name": "String", "type": "string", "documentation": "\n\n Provides the master username for the DB Instance.\n
\n " }, "EngineVersion": { "shape_name": "String", "type": "string", "documentation": "\n\n Specifies the version of the database engine.\n
\n " }, "LicenseModel": { "shape_name": "String", "type": "string", "documentation": "\n\n License model information for the restored DB Instance.\n
\n " }, "SnapshotType": { "shape_name": "String", "type": "string", "documentation": "\n\n Provides the type of the DB Snapshot.\n
\n " }, "Iops": { "shape_name": "IntegerOptional", "type": "integer", "documentation": "\n\n Specifies the Provisioned IOPS (I/O operations per second) value of the DB Instance at the time of the snapshot.\n
\n " } }, "wrapper": true, "documentation": "\n\n Contains the result of a successful invocation of the following actions:\n
\nThis data type is used as a response element in the DescribeDBSnapshots action.
\n " } } }, "errors": [ { "shape_name": "InvalidDBSnapshotStateFault", "type": "structure", "members": {}, "documentation": "\n\n The state of the DB Security Snapshot does not allow deletion.\n
\n " }, { "shape_name": "DBSnapshotNotFoundFault", "type": "structure", "members": {}, "documentation": "\n\n DBSnapshotIdentifier does not refer to an existing DB Snapshot.\n
\n " } ], "documentation": "\n\n Deletes a DBSnapshot. \n
\navailable
state to be\n deleted.\n The name of the database subnet group to delete.\n
\n\n Constraints:\n
\n\n\n
\n " }, "output": null, "errors": [ { "shape_name": "InvalidDBSubnetGroupStateFault", "type": "structure", "members": {}, "documentation": "\n\n The DB Subnet Group cannot be deleted because it is in use.\n
\n " }, { "shape_name": "InvalidDBSubnetStateFault", "type": "structure", "members": {}, "documentation": "\n\n The DB subnet is not in the available state.\n
\n " }, { "shape_name": "DBSubnetGroupNotFoundFault", "type": "structure", "members": {}, "documentation": "\n\n DBSubnetGroupName does not refer to an existing DB Subnet Group.\n
\n " } ], "documentation": "\n\n Deletes a DB subnet group. \n
\nThe name of the RDS event notification subscription you want to delete.
\n ", "required": true } }, "documentation": "\n \n " }, "output": { "shape_name": "EventSubscriptionWrapper", "type": "structure", "members": { "EventSubscription": { "shape_name": "EventSubscription", "type": "structure", "members": { "Id": { "shape_name": "String", "type": "string", "documentation": "\nNot used.
\n " }, "CustomerAwsId": { "shape_name": "String", "type": "string", "documentation": "\nThe AWS customer account associated with the RDS event notification subscription.
\n " }, "CustSubscriptionId": { "shape_name": "String", "type": "string", "documentation": "\nThe RDS event notification subscription Id.
\n " }, "SnsTopicArn": { "shape_name": "String", "type": "string", "documentation": "\nThe topic ARN of the RDS event notification subscription.
\n " }, "Status": { "shape_name": "String", "type": "string", "documentation": "\nThe status of the RDS event notification subscription.
\nConstraints:
\nCan be one of the following: creating | modifying | deleting | active | no-permission | topic-not-exist
\nThe status \"no-permission\" indicates that RDS no longer has permission to post to the SNS topic. The status \n \"topic-not-exist\" indicates that the topic was deleted after the subscription was created.
\n " }, "SubscriptionCreationTime": { "shape_name": "String", "type": "string", "documentation": "\nThe time the RDS event notification subscription was created.
\n " }, "SourceType": { "shape_name": "String", "type": "string", "documentation": "\nThe source type for the RDS event notification subscription.
\n " }, "SourceIdsList": { "shape_name": "SourceIdsList", "type": "list", "members": { "shape_name": "String", "type": "string", "documentation": null, "xmlname": "SourceId" }, "documentation": "\nA list of source Ids for the RDS event notification subscription.
\n " }, "EventCategoriesList": { "shape_name": "EventCategoriesList", "type": "list", "members": { "shape_name": "String", "type": "string", "documentation": null, "xmlname": "EventCategory" }, "documentation": "\nA list of event categories for the RDS event notification subscription.
\n " }, "Enabled": { "shape_name": "Boolean", "type": "boolean", "documentation": "\nA Boolean value indicating if the subscription is enabled. True indicates the subscription is enabled.
\n " } }, "wrapper": true, "documentation": "\nContains the results of a successful invocation of the DescribeEventSubscriptions action.
\n " } } }, "errors": [ { "shape_name": "SubscriptionNotFoundFault", "type": "structure", "members": {}, "documentation": "\nThe subscription name does not exist.
\n " }, { "shape_name": "InvalidEventSubscriptionStateFault", "type": "structure", "members": {}, "documentation": "\nThis error can occur if someone else is modifying a subscription. You should retry the action.
\n " } ], "documentation": "\nDeletes an RDS event notification subscription.
\n\n The name of the option group to be deleted.\n
\n\n
\n " }, "output": null, "errors": [ { "shape_name": "OptionGroupNotFoundFault", "type": "structure", "members": {}, "documentation": " \n\n The specified option group could not be found. \n
\n " }, { "shape_name": "InvalidOptionGroupStateFault", "type": "structure", "members": {}, "documentation": "\n\n The Option Group is not in the available state.\n
\n " } ], "documentation": "\n\n Deletes an existing Option Group.\n
\n\n The database engine to return.\n
\n " }, "EngineVersion": { "shape_name": "String", "type": "string", "documentation": "\n\n The database engine version to return.\n
\nExample: 5.1.49
\n The name of a specific DB Parameter Group family to return details for.\n
\nConstraints:
\n\n The maximum number of records to include in the response.\n If more than the MaxRecords
value is available, a pagination token called a marker is\n included in the response so that the following results can be retrieved.\n
Default: 100
\nConstraints: minimum 20, maximum 100
\n " }, "Marker": { "shape_name": "String", "type": "string", "documentation": "\n\n An optional pagination token provided by a previous request.\n If this parameter is specified, the response includes\n only records beyond the marker,\n up to the value specified by MaxRecords
.\n
\n Indicates that only the default version of the specified engine\n or engine and major version combination is returned.\n
\n " }, "ListSupportedCharacterSets": { "shape_name": "BooleanOptional", "type": "boolean", "documentation": "\n\n If this parameter is specified, and if the requested engine supports the \n CharacterSetName parameter for CreateDBInstance, the response includes a\n list of supported character sets for each engine version.\n
\n " } }, "documentation": "\n " }, "output": { "shape_name": "DBEngineVersionMessage", "type": "structure", "members": { "Marker": { "shape_name": "String", "type": "string", "documentation": "\n\n An optional pagination token provided by a previous request.\n If this parameter is specified, the response includes\n only records beyond the marker,\n up to the value specified by MaxRecords
.\n
\n The name of the database engine.\n
\n " }, "EngineVersion": { "shape_name": "String", "type": "string", "documentation": "\n\n The version number of the database engine.\n
\n " }, "DBParameterGroupFamily": { "shape_name": "String", "type": "string", "documentation": "\n\n The name of the DBParameterGroupFamily for the database engine.\n
\n " }, "DBEngineDescription": { "shape_name": "String", "type": "string", "documentation": "\n\n The description of the database engine.\n
\n " }, "DBEngineVersionDescription": { "shape_name": "String", "type": "string", "documentation": "\n\n The description of the database engine version.\n
\n " }, "DefaultCharacterSet": { "shape_name": "CharacterSet", "type": "structure", "members": { "CharacterSetName": { "shape_name": "String", "type": "string", "documentation": "\n\n The name of the character set.\n
\n " }, "CharacterSetDescription": { "shape_name": "String", "type": "string", "documentation": "\n\n The description of the character set.\n
\n " } }, "documentation": "\n\n The default character set for new instances of this engine version,\n if the CharacterSetName
parameter of the CreateDBInstance API\n is not specified.\n
\n The name of the character set.\n
\n " }, "CharacterSetDescription": { "shape_name": "String", "type": "string", "documentation": "\n\n The description of the character set.\n
\n " } }, "documentation": "\n\n This data type is used as a response element in the action DescribeDBEngineVersions. \n
\n ", "xmlname": "CharacterSet" }, "documentation": "\n\n A list of the character sets supported by this engine for the\n CharacterSetName
parameter of the CreateDBInstance API. \n
\n This data type is used as a response element in the action DescribeDBEngineVersions.\n
\n ", "xmlname": "DBEngineVersion" }, "documentation": "\n\n A list of DBEngineVersion
elements.\n
\n Contains the result of a successful invocation of the DescribeDBEngineVersions action.\n
\n " }, "errors": [], "documentation": "\n\n Returns a list of the available DB engines.\n
\n\n The user-supplied instance identifier.\n If this parameter is specified, information from only the\n specific DB Instance is returned.\n This parameter isn't case sensitive.\n
\nConstraints:
\n\n The maximum number of records to include in the response.\n If more records exist than the specified MaxRecords
value,\n a pagination token called a marker is included in the response so that the remaining\n results may be retrieved.\n
Default: 100
\nConstraints: minimum 20, maximum 100
\n " }, "Marker": { "shape_name": "String", "type": "string", "documentation": "\n\n An optional pagination token provided by a previous\n DescribeDBInstances request.\n If this parameter is specified, the response includes\n only records beyond the marker,\n up to the value specified by MaxRecords
.\n
\n\n
\n " }, "output": { "shape_name": "DBInstanceMessage", "type": "structure", "members": { "Marker": { "shape_name": "String", "type": "string", "documentation": "\n\n An optional pagination token provided by a previous request.\n If this parameter is specified, the response includes\n only records beyond the marker,\n up to the value specified by MaxRecords
.\n
\n Contains a user-supplied database identifier.\n This is the unique key that identifies a DB Instance.\n
\n " }, "DBInstanceClass": { "shape_name": "String", "type": "string", "documentation": "\n\n Contains the name of the compute and memory\n capacity class of the DB Instance.\n
\n " }, "Engine": { "shape_name": "String", "type": "string", "documentation": "\n\n Provides the name of the database engine to be used for this DB Instance.\n
\n " }, "DBInstanceStatus": { "shape_name": "String", "type": "string", "documentation": "\n\n Specifies the current state of this database.\n
\n " }, "MasterUsername": { "shape_name": "String", "type": "string", "documentation": "\n\n Contains the master username for the DB Instance.\n
\n " }, "DBName": { "shape_name": "String", "type": "string", "documentation": "\nThe meaning of this parameter differs according to the database engine you use.
\nMySQL
\n\n Contains the name of the initial database of this instance that was\n provided at create time, if one was specified when the\n DB Instance was created. This same name is returned for\n the life of the DB Instance.\n
\nType: String
\nOracle
\n\n Contains the Oracle System ID (SID) of the created DB Instance. \n
\n " }, "Endpoint": { "shape_name": "Endpoint", "type": "structure", "members": { "Address": { "shape_name": "String", "type": "string", "documentation": "\n\n Specifies the DNS address of the DB Instance.\n
\n " }, "Port": { "shape_name": "Integer", "type": "integer", "documentation": "\n\n Specifies the port that the database engine is listening on.\n
\n " } }, "documentation": "\n\n Specifies the connection endpoint.\n
\n " }, "AllocatedStorage": { "shape_name": "Integer", "type": "integer", "documentation": "\n\n Specifies the allocated storage size specified in gigabytes.\n
\n " }, "InstanceCreateTime": { "shape_name": "TStamp", "type": "timestamp", "documentation": "\n\n Provides the date and time the DB Instance was created.\n
\n " }, "PreferredBackupWindow": { "shape_name": "String", "type": "string", "documentation": "\n\n Specifies the daily time range during which automated backups are\n created if automated backups are enabled, as determined\n by the BackupRetentionPeriod
.\n
\n Specifies the number of days for which automatic DB Snapshots are retained.\n
\n " }, "DBSecurityGroups": { "shape_name": "DBSecurityGroupMembershipList", "type": "list", "members": { "shape_name": "DBSecurityGroupMembership", "type": "structure", "members": { "DBSecurityGroupName": { "shape_name": "String", "type": "string", "documentation": "\n\n The name of the DB Security Group.\n
\n " }, "Status": { "shape_name": "String", "type": "string", "documentation": "\n\n The status of the DB Security Group.\n
\n " } }, "documentation": "\n\n This data type is used as a response element in the following actions:\n
\n\n Provides List of DB Security Group elements containing only\n DBSecurityGroup.Name
and DBSecurityGroup.Status
subelements.\n
The name of the VPC security group.
\n " }, "Status": { "shape_name": "String", "type": "string", "documentation": "\n\n The status of the VPC Security Group.\n
\n " } }, "documentation": "\nThis data type is used as a response element for queries on VPC security group membership.
\n ", "xmlname": "VpcSecurityGroupMembership" }, "documentation": "\n\n Provides List of VPC security group elements \n that the DB Instance belongs to. \n
\n " }, "DBParameterGroups": { "shape_name": "DBParameterGroupStatusList", "type": "list", "members": { "shape_name": "DBParameterGroupStatus", "type": "structure", "members": { "DBParameterGroupName": { "shape_name": "String", "type": "string", "documentation": "\n\n The name of the DP Parameter Group.\n
\n " }, "ParameterApplyStatus": { "shape_name": "String", "type": "string", "documentation": "\n\n The status of parameter updates.\n
\n " } }, "documentation": "\n\n The status of the DB Parameter Group.\n
\nThis data type is used as a response element in the following actions:
\n\n Provides the list of DB Parameter Groups applied to this DB Instance.\n
\n " }, "AvailabilityZone": { "shape_name": "String", "type": "string", "documentation": "\n\n Specifies the name of the Availability Zone the DB Instance is located in.\n
\n " }, "DBSubnetGroup": { "shape_name": "DBSubnetGroup", "type": "structure", "members": { "DBSubnetGroupName": { "shape_name": "String", "type": "string", "documentation": "\n\n Specifies the name of the DB Subnet Group.\n
\n " }, "DBSubnetGroupDescription": { "shape_name": "String", "type": "string", "documentation": "\n\n Provides the description of the DB Subnet Group.\n
\n " }, "VpcId": { "shape_name": "String", "type": "string", "documentation": "\n\n Provides the VpcId of the DB Subnet Group.\n
\n " }, "SubnetGroupStatus": { "shape_name": "String", "type": "string", "documentation": "\n\n Provides the status of the DB Subnet Group.\n
\n " }, "Subnets": { "shape_name": "SubnetList", "type": "list", "members": { "shape_name": "Subnet", "type": "structure", "members": { "SubnetIdentifier": { "shape_name": "String", "type": "string", "documentation": "\n\n Specifies the identifier of the subnet.\n
\n " }, "SubnetAvailabilityZone": { "shape_name": "AvailabilityZone", "type": "structure", "members": { "Name": { "shape_name": "String", "type": "string", "documentation": "\n\n The name of the availability zone.\n
\n " }, "ProvisionedIopsCapable": { "shape_name": "Boolean", "type": "boolean", "documentation": "\n\n True indicates the availability zone is capable of provisioned IOPs.\n
\n " } }, "wrapper": true, "documentation": "\n\n Contains Availability Zone information. \n
\n\n This data type is used as an element in the following data type:\n
\n \n \n " }, "SubnetStatus": { "shape_name": "String", "type": "string", "documentation": "\n\n Specifies the status of the subnet.\n
\n " } }, "documentation": "\n\n This data type is used as a response element in the DescribeDBSubnetGroups action.\n
\n ", "xmlname": "Subnet" }, "documentation": "\n\n Contains a list of Subnet elements.\n
\n " } }, "wrapper": true, "documentation": "\n\n Provides the inforamtion of the subnet group associated with the DB instance, including the name, descrption and subnets in the subnet group.\n
\n " }, "PreferredMaintenanceWindow": { "shape_name": "String", "type": "string", "documentation": "\n\n Specifies the weekly time range (in UTC) during which\n system maintenance can occur.\n
\n " }, "PendingModifiedValues": { "shape_name": "PendingModifiedValues", "type": "structure", "members": { "DBInstanceClass": { "shape_name": "String", "type": "string", "documentation": "\n\n Contains the new DBInstanceClass
for the DB Instance\n that will be applied or is in progress.\n
\n Contains the new AllocatedStorage
size for the DB Instance\n that will be applied or is in progress.\n
\n Contains the pending or in-progress change of the master credentials for the DB Instance.\n
\n " }, "Port": { "shape_name": "IntegerOptional", "type": "integer", "documentation": "\n\n Specifies the pending port for the DB Instance.\n
\n " }, "BackupRetentionPeriod": { "shape_name": "IntegerOptional", "type": "integer", "documentation": "\n\n Specifies the pending number of days for which automated backups are retained.\n
\n " }, "MultiAZ": { "shape_name": "BooleanOptional", "type": "boolean", "documentation": "\n\n Indicates that the Single-AZ DB Instance is to change to a Multi-AZ deployment.\n
\n " }, "EngineVersion": { "shape_name": "String", "type": "string", "documentation": "\n\n Indicates the database engine version. \n
\n " }, "Iops": { "shape_name": "IntegerOptional", "type": "integer", "documentation": "\n\n Specifies the new Provisioned IOPS value for the DB Instance\n that will be applied or is being applied.\n
\n " }, "DBInstanceIdentifier": { "shape_name": "String", "type": "string", "documentation": "\n\n Contains the new DBInstanceIdentifier
for the DB Instance\n that will be applied or is in progress.\n
\n Specifies that changes to the DB Instance are pending.\n This element is only included when changes are pending.\n Specific changes are identified by subelements.\n
\n " }, "LatestRestorableTime": { "shape_name": "TStamp", "type": "timestamp", "documentation": "\n\n Specifies the latest time to which a database\n can be restored with point-in-time restore.\n
\n " }, "MultiAZ": { "shape_name": "Boolean", "type": "boolean", "documentation": "\n\n Specifies if the DB Instance is a Multi-AZ deployment.\n
\n " }, "EngineVersion": { "shape_name": "String", "type": "string", "documentation": "\n\n Indicates the database engine version.\n
\n " }, "AutoMinorVersionUpgrade": { "shape_name": "Boolean", "type": "boolean", "documentation": "\n\n Indicates that minor version patches are applied automatically.\n
\n " }, "ReadReplicaSourceDBInstanceIdentifier": { "shape_name": "String", "type": "string", "documentation": "\n\n Contains the identifier of the source DB Instance if this DB Instance is a Read Replica.\n
\n " }, "ReadReplicaDBInstanceIdentifiers": { "shape_name": "ReadReplicaDBInstanceIdentifierList", "type": "list", "members": { "shape_name": "String", "type": "string", "documentation": null, "xmlname": "ReadReplicaDBInstanceIdentifier" }, "documentation": "\n\n Contains one or more identifiers of the Read Replicas associated with this DB Instance.\n
\n " }, "LicenseModel": { "shape_name": "String", "type": "string", "documentation": "\n\n License model information for this DB Instance.\n
\n " }, "Iops": { "shape_name": "IntegerOptional", "type": "integer", "documentation": "\n\n Specifies the Provisioned IOPS (I/O operations per second) value.\n
\n " }, "OptionGroupMembership": { "shape_name": "OptionGroupMembership", "type": "structure", "members": { "OptionGroupName": { "shape_name": "String", "type": "string", "documentation": "\n\n The name of the option group that the instance belongs to.\n
\n " }, "Status": { "shape_name": "String", "type": "string", "documentation": "\n\n The status of the DB Instance's option group membership (e.g. in-sync, pending, pending-maintenance, applying).\n
\n " } }, "documentation": "\n\n Specifies the name and status of the option group that this instance belongs to. \n
\n " }, "CharacterSetName": { "shape_name": "String", "type": "string", "documentation": "\n\n If present, specifies the name of the character set that this instance is associated with. \n
\n " }, "SecondaryAvailabilityZone": { "shape_name": "String", "type": "string", "documentation": "\n\n If present, specifies the name of the secondary Availability Zone \n for a DB instance with multi-AZ support.\n
\n " }, "PubliclyAccessible": { "shape_name": "Boolean", "type": "boolean", "documentation": null } }, "wrapper": true, "documentation": "\n\n Contains the result of a successful invocation of the following actions:\n
\n \nThis data type is used as a response element in the DescribeDBInstances action.
\n ", "xmlname": "DBInstance" }, "documentation": "\n\n A list of DBInstance instances.\n
\n " } }, "documentation": "\n\n Contains the result of a successful invocation of the DescribeDBInstances action.\n
\n " }, "errors": [ { "shape_name": "DBInstanceNotFoundFault", "type": "structure", "members": {}, "documentation": "\n\n DBInstanceIdentifier does not refer to an existing DB Instance.\n
\n " } ], "documentation": "\n\n Returns information about provisioned RDS instances. This API supports pagination.\n
\n\n The name of a specific DB Parameter Group to return details for.\n
\nConstraints:
\n\n The maximum number of records to include in the response.\n If more records exist than the specified MaxRecords
value,\n a pagination token called a marker is included in the response so that the remaining\n results may be retrieved.\n
Default: 100
\nConstraints: minimum 20, maximum 100
\n " }, "Marker": { "shape_name": "String", "type": "string", "documentation": "\n\n An optional pagination token provided by a previous\n DescribeDBParameterGroups request.\n If this parameter is specified, the response includes\n only records beyond the marker,\n up to the value specified by MaxRecords
.\n
\n\n
\n " }, "output": { "shape_name": "DBParameterGroupsMessage", "type": "structure", "members": { "Marker": { "shape_name": "String", "type": "string", "documentation": "\n\n An optional pagination token provided by a previous request.\n If this parameter is specified, the response includes\n only records beyond the marker,\n up to the value specified by MaxRecords
.\n
\n Provides the name of the DB Parameter Group.\n
\n " }, "DBParameterGroupFamily": { "shape_name": "String", "type": "string", "documentation": "\n\n Provides the name of the DB Parameter Group Family that\n this DB Parameter Group is compatible with.\n
\n " }, "Description": { "shape_name": "String", "type": "string", "documentation": "\n\n Provides the customer-specified description for this DB Parameter Group.\n
\n " } }, "wrapper": true, "documentation": "\n\n Contains the result of a successful invocation of the CreateDBParameterGroup action.\n
\n\n This data type is used as a request parameter in the DeleteDBParameterGroup action,\n and as a response element in the DescribeDBParameterGroups action.\n
\n ", "xmlname": "DBParameterGroup" }, "documentation": "\n\n A list of DBParameterGroup instances.\n
\n " } }, "documentation": "\n\n Contains the result of a successful invocation of the DescribeDBParameterGroups action.\n
\n " }, "errors": [ { "shape_name": "DBParameterGroupNotFoundFault", "type": "structure", "members": {}, "documentation": "\n\n DBParameterGroupName does not refer to an\n existing DB Parameter Group.\n
\n " } ], "documentation": "\n\n Returns a list of DBParameterGroup descriptions. If a DBParameterGroupName is specified,\n the list will contain only the description of the specified DBParameterGroup.\n
\n\n The name of a specific DB Parameter Group to return details for.\n
\nConstraints:
\n\n The parameter types to return.\n
\nDefault: All parameter types returned
\n \nValid Values: user | system | engine-default
\n The maximum number of records to include in the response.\n If more records exist than the specified MaxRecords
value,\n a pagination token called a marker is included in the response so that the remaining\n results may be retrieved.\n
Default: 100
\nConstraints: minimum 20, maximum 100
\n " }, "Marker": { "shape_name": "String", "type": "string", "documentation": "\n\n An optional pagination token provided by a previous\n DescribeDBParameters request.\n If this parameter is specified, the response includes\n only records beyond the marker,\n up to the value specified by MaxRecords
.\n
\n Specifies the name of the parameter.\n
\n " }, "ParameterValue": { "shape_name": "String", "type": "string", "documentation": "\n\n Specifies the value of the parameter.\n
\n " }, "Description": { "shape_name": "String", "type": "string", "documentation": "\n\n Provides a description of the parameter.\n
\n " }, "Source": { "shape_name": "String", "type": "string", "documentation": "\n\n Indicates the source of the parameter value.\n
\n " }, "ApplyType": { "shape_name": "String", "type": "string", "documentation": "\n\n Specifies the engine specific parameters type.\n
\n " }, "DataType": { "shape_name": "String", "type": "string", "documentation": "\n\n Specifies the valid data type for the parameter.\n
\n " }, "AllowedValues": { "shape_name": "String", "type": "string", "documentation": "\n\n Specifies the valid range of values for the parameter.\n
\n " }, "IsModifiable": { "shape_name": "Boolean", "type": "boolean", "documentation": "\n\n Indicates whether (true
) or not (false
) the parameter can be modified.\n Some parameters have security or operational implications\n that prevent them from being changed.\n
\n The earliest engine version to which the parameter can apply.\n
\n " }, "ApplyMethod": { "shape_name": "ApplyMethod", "type": "string", "enum": [ "immediate", "pending-reboot" ], "documentation": "\n\n Indicates when to apply parameter updates.\n
\n " } }, "documentation": "\n\n This data type is used as a request parameter in the\n ModifyDBParameterGroup and ResetDBParameterGroup actions.\n
\nThis data type is used as a response element in the \n DescribeEngineDefaultParameters and DescribeDBParameters actions.
\n ", "xmlname": "Parameter" }, "documentation": "\n\n A list of Parameter instances.\n
\n " }, "Marker": { "shape_name": "String", "type": "string", "documentation": "\n\n An optional pagination token provided by a previous request.\n If this parameter is specified, the response includes\n only records beyond the marker,\n up to the value specified by MaxRecords
.\n
\n Contains the result of a successful invocation of the DescribeDBParameters action.\n
\n " }, "errors": [ { "shape_name": "DBParameterGroupNotFoundFault", "type": "structure", "members": {}, "documentation": "\n\n DBParameterGroupName does not refer to an\n existing DB Parameter Group.\n
\n " } ], "documentation": "\n\n Returns the detailed parameter list for a particular DBParameterGroup.\n
\n\n The name of the DB Security Group to return details for.\n
\n " }, "MaxRecords": { "shape_name": "IntegerOptional", "type": "integer", "documentation": "\n\n The maximum number of records to include in the response.\n If more records exist than the specified MaxRecords
value,\n a pagination token called a marker is included in the response so that the remaining\n results may be retrieved.\n
Default: 100
\nConstraints: minimum 20, maximum 100
\n " }, "Marker": { "shape_name": "String", "type": "string", "documentation": "\n\n An optional pagination token provided by a previous\n DescribeDBSecurityGroups request.\n If this parameter is specified, the response includes\n only records beyond the marker,\n up to the value specified by MaxRecords
.\n
\n\n
\n " }, "output": { "shape_name": "DBSecurityGroupMessage", "type": "structure", "members": { "Marker": { "shape_name": "String", "type": "string", "documentation": "\n\n An optional pagination token provided by a previous request.\n If this parameter is specified, the response includes\n only records beyond the marker,\n up to the value specified by MaxRecords
.\n
\n Provides the AWS ID of the owner of a specific DB Security Group.\n
\n " }, "DBSecurityGroupName": { "shape_name": "String", "type": "string", "documentation": "\n\n Specifies the name of the DB Security Group.\n
\n " }, "DBSecurityGroupDescription": { "shape_name": "String", "type": "string", "documentation": "\n\n Provides the description of the DB Security Group.\n
\n " }, "VpcId": { "shape_name": "String", "type": "string", "documentation": "\n\n Provides the VpcId of the DB Security Group.\n
\n " }, "EC2SecurityGroups": { "shape_name": "EC2SecurityGroupList", "type": "list", "members": { "shape_name": "EC2SecurityGroup", "type": "structure", "members": { "Status": { "shape_name": "String", "type": "string", "documentation": "\n\n Provides the status of the EC2 security group. Status can be \"authorizing\", \n \"authorized\", \"revoking\", and \"revoked\".\n
\n " }, "EC2SecurityGroupName": { "shape_name": "String", "type": "string", "documentation": "\n\n Specifies the name of the EC2 Security Group.\n
\n " }, "EC2SecurityGroupId": { "shape_name": "String", "type": "string", "documentation": "\n\n Specifies the id of the EC2 Security Group.\n
\n " }, "EC2SecurityGroupOwnerId": { "shape_name": "String", "type": "string", "documentation": "\n\n Specifies the AWS ID of the owner of the EC2 security group\n specified in the EC2SecurityGroupName
field.\n
\n This data type is used as a response element in the following actions:\n
\n \n ", "xmlname": "EC2SecurityGroup" }, "documentation": "\n\n Contains a list of EC2SecurityGroup elements.\n
\n " }, "IPRanges": { "shape_name": "IPRangeList", "type": "list", "members": { "shape_name": "IPRange", "type": "structure", "members": { "Status": { "shape_name": "String", "type": "string", "documentation": "\n\n Specifies the status of the IP range. Status can be \"authorizing\", \n \"authorized\", \"revoking\", and \"revoked\".\n
\n " }, "CIDRIP": { "shape_name": "String", "type": "string", "documentation": "\n\n Specifies the IP range.\n
\n " } }, "documentation": "\n\n This data type is used as a response element in the DescribeDBSecurityGroups action.\n
\n ", "xmlname": "IPRange" }, "documentation": "\n\n Contains a list of IPRange elements.\n
\n " } }, "wrapper": true, "documentation": "\n\n Contains the result of a successful invocation of the following actions:\n
\nThis data type is used as a response element in the DescribeDBSecurityGroups action.
\n \n ", "xmlname": "DBSecurityGroup" }, "documentation": "\n\n A list of DBSecurityGroup instances.\n
\n " } }, "documentation": "\n\n Contains the result of a successful invocation of the DescribeDBSecurityGroups action.\n
\n " }, "errors": [ { "shape_name": "DBSecurityGroupNotFoundFault", "type": "structure", "members": {}, "documentation": "\n\n DBSecurityGroupName does not refer to an existing DB Security Group.\n
\n " } ], "documentation": "\n\n Returns a list of DBSecurityGroup descriptions. If a DBSecurityGroupName is specified,\n the list will contain only the descriptions of the specified DBSecurityGroup.\n
\nFor an overview of CIDR ranges, go to the \n Wikipedia Tutorial.\n
\n \n\n A DB Instance Identifier to retrieve the list of DB Snapshots for. Cannot be used in conjunction with DBSnapshotIdentifier.\n This parameter isn't case sensitive.\n
\nConstraints:
\n\n A specific DB Snapshot Identifier to describe. Cannot be used in conjunction with DBInstanceIdentifier. \n This value is stored as a lowercase string.\n
\nConstraints:
\nSnapshotType
parameter must also be specified.\n An optional snapshot type for which snapshots will be returned.\n If not specified, the returned results will include snapshots of all types.\n
\n " }, "MaxRecords": { "shape_name": "IntegerOptional", "type": "integer", "documentation": "\n\n The maximum number of records to include in the response.\n If more records exist than the specified MaxRecords
value,\n a pagination token called a marker is included in the response so that the remaining\n results may be retrieved.\n
Default: 100
\nConstraints: minimum 20, maximum 100
\n " }, "Marker": { "shape_name": "String", "type": "string", "documentation": "\n\n An optional pagination token provided by a previous\n DescribeDBSnapshots request.\n If this parameter is specified, the response includes\n only records beyond the marker,\n up to the value specified by MaxRecords
.\n
\n\n
\n " }, "output": { "shape_name": "DBSnapshotMessage", "type": "structure", "members": { "Marker": { "shape_name": "String", "type": "string", "documentation": "\n\n An optional pagination token provided by a previous request.\n If this parameter is specified, the response includes\n only records beyond the marker,\n up to the value specified by MaxRecords
.\n
\n Specifies the identifier for the DB Snapshot.\n
\n " }, "DBInstanceIdentifier": { "shape_name": "String", "type": "string", "documentation": "\n\n Specifies the the DBInstanceIdentifier of the DB Instance\n this DB Snapshot was created from.\n
\n " }, "SnapshotCreateTime": { "shape_name": "TStamp", "type": "timestamp", "documentation": "\n\n Provides the time (UTC) when the snapshot was taken.\n
\n " }, "Engine": { "shape_name": "String", "type": "string", "documentation": "\n\n Specifies the name of the database engine.\n
\n " }, "AllocatedStorage": { "shape_name": "Integer", "type": "integer", "documentation": "\n\n Specifies the allocated storage size in gigabytes (GB).\n
\n " }, "Status": { "shape_name": "String", "type": "string", "documentation": "\n\n Specifies the status of this DB Snapshot.\n
\n " }, "Port": { "shape_name": "Integer", "type": "integer", "documentation": "\n\n Specifies the port that the database engine was\n listening on at the time of the snapshot.\n
\n " }, "AvailabilityZone": { "shape_name": "String", "type": "string", "documentation": "\n\n Specifies the name of the Availability Zone the DB\n Instance was located in at the time of the DB Snapshot.\n
\n " }, "VpcId": { "shape_name": "String", "type": "string", "documentation": "\n\n Provides the Vpc Id associated with the DB Snapshot.\n
\n " }, "InstanceCreateTime": { "shape_name": "TStamp", "type": "timestamp", "documentation": "\n\n Specifies the time (UTC) when the snapshot was taken.\n
\n " }, "MasterUsername": { "shape_name": "String", "type": "string", "documentation": "\n\n Provides the master username for the DB Instance.\n
\n " }, "EngineVersion": { "shape_name": "String", "type": "string", "documentation": "\n\n Specifies the version of the database engine.\n
\n " }, "LicenseModel": { "shape_name": "String", "type": "string", "documentation": "\n\n License model information for the restored DB Instance.\n
\n " }, "SnapshotType": { "shape_name": "String", "type": "string", "documentation": "\n\n Provides the type of the DB Snapshot.\n
\n " }, "Iops": { "shape_name": "IntegerOptional", "type": "integer", "documentation": "\n\n Specifies the Provisioned IOPS (I/O operations per second) value of the DB Instance at the time of the snapshot.\n
\n " } }, "wrapper": true, "documentation": "\n\n Contains the result of a successful invocation of the following actions:\n
\nThis data type is used as a response element in the DescribeDBSnapshots action.
\n ", "xmlname": "DBSnapshot" }, "documentation": "\n\n A list of DBSnapshot instances.\n
\n " } }, "documentation": "\n\n Contains the result of a successful invocation of the DescribeDBSnapshots action.\n
\n " }, "errors": [ { "shape_name": "DBSnapshotNotFoundFault", "type": "structure", "members": {}, "documentation": "\n\n DBSnapshotIdentifier does not refer to an existing DB Snapshot.\n
\n " } ], "documentation": "\n\n Returns information about DBSnapshots. This API supports pagination.\n
\n\n The name of the DB Subnet Group to return details for.\n
\n " }, "MaxRecords": { "shape_name": "IntegerOptional", "type": "integer", "documentation": "\n\n The maximum number of records to include in the response.\n If more records exist than the specified MaxRecords
value,\n a pagination token called a marker is included in the response so that the remaining\n results may be retrieved.\n
Default: 100
\nConstraints: minimum 20, maximum 100
\n " }, "Marker": { "shape_name": "String", "type": "string", "documentation": "\n\n An optional pagination token provided by a previous DescribeDBSubnetGroups request.\n If this parameter is specified, the response includes\n only records beyond the marker,\n up to the value specified by MaxRecords
.\n
\n\n
\n " }, "output": { "shape_name": "DBSubnetGroupMessage", "type": "structure", "members": { "Marker": { "shape_name": "String", "type": "string", "documentation": "\n\n An optional pagination token provided by a previous request.\n If this parameter is specified, the response includes\n only records beyond the marker,\n up to the value specified by MaxRecords
.\n
\n Specifies the name of the DB Subnet Group.\n
\n " }, "DBSubnetGroupDescription": { "shape_name": "String", "type": "string", "documentation": "\n\n Provides the description of the DB Subnet Group.\n
\n " }, "VpcId": { "shape_name": "String", "type": "string", "documentation": "\n\n Provides the VpcId of the DB Subnet Group.\n
\n " }, "SubnetGroupStatus": { "shape_name": "String", "type": "string", "documentation": "\n\n Provides the status of the DB Subnet Group.\n
\n " }, "Subnets": { "shape_name": "SubnetList", "type": "list", "members": { "shape_name": "Subnet", "type": "structure", "members": { "SubnetIdentifier": { "shape_name": "String", "type": "string", "documentation": "\n\n Specifies the identifier of the subnet.\n
\n " }, "SubnetAvailabilityZone": { "shape_name": "AvailabilityZone", "type": "structure", "members": { "Name": { "shape_name": "String", "type": "string", "documentation": "\n\n The name of the availability zone.\n
\n " }, "ProvisionedIopsCapable": { "shape_name": "Boolean", "type": "boolean", "documentation": "\n\n True indicates the availability zone is capable of provisioned IOPs.\n
\n " } }, "wrapper": true, "documentation": "\n\n Contains Availability Zone information. \n
\n\n This data type is used as an element in the following data type:\n
\n \n \n " }, "SubnetStatus": { "shape_name": "String", "type": "string", "documentation": "\n\n Specifies the status of the subnet.\n
\n " } }, "documentation": "\n\n This data type is used as a response element in the DescribeDBSubnetGroups action.\n
\n ", "xmlname": "Subnet" }, "documentation": "\n\n Contains a list of Subnet elements.\n
\n " } }, "wrapper": true, "documentation": "\n\n Contains the result of a successful invocation of the following actions:\n
\n \nThis data type is used as a response element in the DescribeDBSubnetGroups action.
\n ", "xmlname": "DBSubnetGroup" }, "documentation": "\n\n A list of DBSubnetGroup instances.\n
\n " } }, "documentation": "\n\n Contains the result of a successful invocation of the DescribeDBSubnetGroups action.\n
\n " }, "errors": [ { "shape_name": "DBSubnetGroupNotFoundFault", "type": "structure", "members": {}, "documentation": "\n\n DBSubnetGroupName does not refer to an existing DB Subnet Group.\n
\n " } ], "documentation": "\n\n Returns a list of DBSubnetGroup descriptions. If a DBSubnetGroupName is specified,\n the list will contain only the descriptions of the specified DBSubnetGroup.\n
\nFor an overview of CIDR ranges, go to the \n Wikipedia Tutorial.\n
\n \n\n The name of the DB Parameter Group Family.\n
\n ", "required": true }, "MaxRecords": { "shape_name": "IntegerOptional", "type": "integer", "documentation": "\n\n The maximum number of records to include in the response.\n If more records exist than the specified MaxRecords
value,\n a pagination token called a marker is included in the response so that the remaining\n results may be retrieved.\n
Default: 100
\nConstraints: minimum 20, maximum 100
\n " }, "Marker": { "shape_name": "String", "type": "string", "documentation": "\n\n An optional pagination token provided by a previous\n DescribeEngineDefaultParameters request.\n If this parameter is specified, the response includes\n only records beyond the marker,\n up to the value specified by MaxRecords
.\n
\n\n
\n " }, "output": { "shape_name": "EngineDefaultsWrapper", "type": "structure", "members": { "EngineDefaults": { "shape_name": "EngineDefaults", "type": "structure", "members": { "DBParameterGroupFamily": { "shape_name": "String", "type": "string", "documentation": "\n\n Specifies the name of the DB Parameter Group Family which the\n engine default parameters apply to.\n
\n " }, "Marker": { "shape_name": "String", "type": "string", "documentation": "\n\n An optional pagination token provided by a previous \n EngineDefaults request.\n If this parameter is specified, the response includes\n only records beyond the marker,\n up to the value specified by MaxRecords
.\n
\n Specifies the name of the parameter.\n
\n " }, "ParameterValue": { "shape_name": "String", "type": "string", "documentation": "\n\n Specifies the value of the parameter.\n
\n " }, "Description": { "shape_name": "String", "type": "string", "documentation": "\n\n Provides a description of the parameter.\n
\n " }, "Source": { "shape_name": "String", "type": "string", "documentation": "\n\n Indicates the source of the parameter value.\n
\n " }, "ApplyType": { "shape_name": "String", "type": "string", "documentation": "\n\n Specifies the engine specific parameters type.\n
\n " }, "DataType": { "shape_name": "String", "type": "string", "documentation": "\n\n Specifies the valid data type for the parameter.\n
\n " }, "AllowedValues": { "shape_name": "String", "type": "string", "documentation": "\n\n Specifies the valid range of values for the parameter.\n
\n " }, "IsModifiable": { "shape_name": "Boolean", "type": "boolean", "documentation": "\n\n Indicates whether (true
) or not (false
) the parameter can be modified.\n Some parameters have security or operational implications\n that prevent them from being changed.\n
\n The earliest engine version to which the parameter can apply.\n
\n " }, "ApplyMethod": { "shape_name": "ApplyMethod", "type": "string", "enum": [ "immediate", "pending-reboot" ], "documentation": "\n\n Indicates when to apply parameter updates.\n
\n " } }, "documentation": "\n\n This data type is used as a request parameter in the\n ModifyDBParameterGroup and ResetDBParameterGroup actions.\n
\nThis data type is used as a response element in the \n DescribeEngineDefaultParameters and DescribeDBParameters actions.
\n ", "xmlname": "Parameter" }, "documentation": "\n\n Contains a list of engine default parameters.\n
\n " } }, "wrapper": true, "documentation": "\n\n Contains the result of a successful invocation of the DescribeEngineDefaultParameters action.\n
\n " } } }, "errors": [], "documentation": "\n\n Returns the default engine and system parameter information for the specified database engine.\n
\n\n The type of source that will be generating the events.\n
\nValid values: db-instance | db-parameter-group | db-security-group | db-snapshot
\n " } }, "documentation": "\n \n " }, "output": { "shape_name": "EventCategoriesMessage", "type": "structure", "members": { "EventCategoriesMapList": { "shape_name": "EventCategoriesMapList", "type": "list", "members": { "shape_name": "EventCategoriesMap", "type": "structure", "members": { "SourceType": { "shape_name": "String", "type": "string", "documentation": "\nThe source type that the returned categories belong to
\n " }, "EventCategories": { "shape_name": "EventCategoriesList", "type": "list", "members": { "shape_name": "String", "type": "string", "documentation": null, "xmlname": "EventCategory" }, "documentation": "\nThe event categories for the specified source type
\n " } }, "wrapper": true, "documentation": " \nContains the results of a successful invocation of the DescribeEventCategories action.
\n ", "xmlname": "EventCategoriesMap" }, "documentation": "\nA list of EventCategoriesMap data types.
\n " } }, "documentation": " \nData returned from the DescribeEventCategories action.
\n " }, "errors": [], "documentation": "\nDisplays a list of categories for all event source types, or, if specified, for a specified source type.\n You can see a list of the event categories and source types \n in the \n Events topic in the Amazon RDS User Guide.
\nThe name of the RDS event notification subscription you want to describe.
\n " }, "MaxRecords": { "shape_name": "IntegerOptional", "type": "integer", "documentation": "\n\n The maximum number of records to include in the response.\n If more records exist than the specified MaxRecords
value,\n a pagination token called a marker is included in the response so that the remaining\n results can be retrieved.\n
Default: 100
\nConstraints: minimum 20, maximum 100
\n " }, "Marker": { "shape_name": "String", "type": "string", "documentation": "\n\n An optional pagination token provided by a previous\n DescribeOrderableDBInstanceOptions request.\n If this parameter is specified, the response includes\n only records beyond the marker,\n up to the value specified by MaxRecords
.\n
\n An optional pagination token provided by a previous\n DescribeOrderableDBInstanceOptions request.\n If this parameter is specified, the response includes\n only records beyond the marker,\n up to the value specified by MaxRecords
.\n
Not used.
\n " }, "CustomerAwsId": { "shape_name": "String", "type": "string", "documentation": "\nThe AWS customer account associated with the RDS event notification subscription.
\n " }, "CustSubscriptionId": { "shape_name": "String", "type": "string", "documentation": "\nThe RDS event notification subscription Id.
\n " }, "SnsTopicArn": { "shape_name": "String", "type": "string", "documentation": "\nThe topic ARN of the RDS event notification subscription.
\n " }, "Status": { "shape_name": "String", "type": "string", "documentation": "\nThe status of the RDS event notification subscription.
\nConstraints:
\nCan be one of the following: creating | modifying | deleting | active | no-permission | topic-not-exist
\nThe status \"no-permission\" indicates that RDS no longer has permission to post to the SNS topic. The status \n \"topic-not-exist\" indicates that the topic was deleted after the subscription was created.
\n " }, "SubscriptionCreationTime": { "shape_name": "String", "type": "string", "documentation": "\nThe time the RDS event notification subscription was created.
\n " }, "SourceType": { "shape_name": "String", "type": "string", "documentation": "\nThe source type for the RDS event notification subscription.
\n " }, "SourceIdsList": { "shape_name": "SourceIdsList", "type": "list", "members": { "shape_name": "String", "type": "string", "documentation": null, "xmlname": "SourceId" }, "documentation": "\nA list of source Ids for the RDS event notification subscription.
\n " }, "EventCategoriesList": { "shape_name": "EventCategoriesList", "type": "list", "members": { "shape_name": "String", "type": "string", "documentation": null, "xmlname": "EventCategory" }, "documentation": "\nA list of event categories for the RDS event notification subscription.
\n " }, "Enabled": { "shape_name": "Boolean", "type": "boolean", "documentation": "\nA Boolean value indicating if the subscription is enabled. True indicates the subscription is enabled.
\n " } }, "wrapper": true, "documentation": "\nContains the results of a successful invocation of the DescribeEventSubscriptions action.
\n ", "xmlname": "EventSubscription" }, "documentation": "\nA list of EventSubscriptions data types.
\n " } }, "documentation": " \nData returned by the DescribeEventSubscriptions action.
\n " }, "errors": [ { "shape_name": "SubscriptionNotFoundFault", "type": "structure", "members": {}, "documentation": "\nThe subscription name does not exist.
\n " } ], "documentation": "\nLists all the subscription descriptions for a customer account. The description for a subscription includes\n SubscriptionName, SNSTopicARN, CustomerID, SourceType, SourceID, CreationTime, and Status.\n
\nIf you specify a SubscriptionName, lists the description for that subscription.
\n\n The identifier of the event source for which events\n will be returned. If not specified,\n then all sources are included in the response.\n
\nConstraints:
\n\n The event source to retrieve events for.\n If no value is specified, all events are returned.\n
\n " }, "StartTime": { "shape_name": "TStamp", "type": "timestamp", "documentation": "\n\n The beginning of the time interval to retrieve events for,\n specified in ISO 8601 format. For more information about ISO 8601, \n go to the ISO8601 Wikipedia page.\n
\nExample: 2009-07-08T18:00Z
\n " }, "EndTime": { "shape_name": "TStamp", "type": "timestamp", "documentation": "\n\n The end of the time interval for which to retrieve events,\n specified in ISO 8601 format. For more information about ISO 8601, \n go to the ISO8601 Wikipedia page.\n
\nExample: 2009-07-08T18:00Z
\n " }, "Duration": { "shape_name": "IntegerOptional", "type": "integer", "documentation": "\n\n The number of minutes to retrieve events for.\n
\nDefault: 60
\n " }, "EventCategories": { "shape_name": "EventCategoriesList", "type": "list", "members": { "shape_name": "String", "type": "string", "documentation": null, "xmlname": "EventCategory" }, "documentation": "\n\n A list of event categories that trigger notifications for a event notification subscription.\n
\n \n " }, "MaxRecords": { "shape_name": "IntegerOptional", "type": "integer", "documentation": "\n\n The maximum number of records to include in the response.\n If more records exist than the specified MaxRecords
value,\n a pagination token called a marker is included in the response so that the remaining\n results may be retrieved.\n
Default: 100
\nConstraints: minimum 20, maximum 100
\n " }, "Marker": { "shape_name": "String", "type": "string", "documentation": "\n\n An optional pagination token provided by a previous\n DescribeEvents request.\n If this parameter is specified, the response includes\n only records beyond the marker,\n up to the value specified by MaxRecords
.\n
\n\n
\n " }, "output": { "shape_name": "EventsMessage", "type": "structure", "members": { "Marker": { "shape_name": "String", "type": "string", "documentation": "\n\n An optional pagination token provided by a previous \n Events request.\n If this parameter is specified, the response includes\n only records beyond the marker, \n up to the value specified by MaxRecords
.\n
\n Provides the identifier for the source of the event.\n
\n " }, "SourceType": { "shape_name": "SourceType", "type": "string", "enum": [ "db-instance", "db-parameter-group", "db-security-group", "db-snapshot" ], "documentation": "\n\n Specifies the source type for this event.\n
\n " }, "Message": { "shape_name": "String", "type": "string", "documentation": "\n\n Provides the text of this event.\n
\n " }, "EventCategories": { "shape_name": "EventCategoriesList", "type": "list", "members": { "shape_name": "String", "type": "string", "documentation": null, "xmlname": "EventCategory" }, "documentation": "\n\n Specifies the category for the event.\n
\n " }, "Date": { "shape_name": "TStamp", "type": "timestamp", "documentation": "\n\n Specifies the date and time of the event.\n
\n " } }, "documentation": "\n\n This data type is used as a response element in the DescribeEvents action.\n
\n ", "xmlname": "Event" }, "documentation": "\n\n A list of Event instances.\n
\n " } }, "documentation": "\n\n Contains the result of a successful invocation of the DescribeEvents action.\n
\n " }, "errors": [], "documentation": "\n\n Returns events related to DB instances, DB security groups, DB Snapshots, and DB parameter\n groups for the past 14 days. Events specific to a particular DB Iinstance, DB security group,\n DB Snapshot, or DB parameter group can be obtained by providing the source identifier as a parameter.\n By default, the past hour of events are returned.\n
\nYou can see a list of event categories and source types \n in the Events\n topic in the Amazon RDS User Guide.
\n\n Options available for the given DB engine name to be described.\n
\n ", "required": true }, "MajorEngineVersion": { "shape_name": "String", "type": "string", "documentation": "\n\n If specified, filters the results to include only options for the specified major engine version.\n
\n " }, "MaxRecords": { "shape_name": "IntegerOptional", "type": "integer", "documentation": "\n\n The maximum number of records to include in the response.\n If more records exist than the specified MaxRecords
value,\n a pagination token called a marker is included in the response so that the remaining\n results can be retrieved.\n
Default: 100
\nConstraints: minimum 20, maximum 100
\n \n " }, "Marker": { "shape_name": "String", "type": "string", "documentation": "\nAn optional pagination token provided by a previous request.\n If this parameter is specified, the response includes\n only records beyond the marker,\n up to the value specified by MaxRecords
.
\n
\n " }, "output": { "shape_name": "OptionGroupOptionsMessage", "type": "structure", "members": { "OptionGroupOptions": { "shape_name": "OptionGroupOptionsList", "type": "list", "members": { "shape_name": "OptionGroupOption", "type": "structure", "members": { "Name": { "shape_name": "String", "type": "string", "documentation": "\n\n The name of the option.\n
\n " }, "Description": { "shape_name": "String", "type": "string", "documentation": "\n\n The description of the option.\n
\n " }, "EngineName": { "shape_name": "String", "type": "string", "documentation": "\n\n Engine name that this option can be applied to.\n
\n " }, "MajorEngineVersion": { "shape_name": "String", "type": "string", "documentation": "\n\n Indicates the major engine version that the option is available for.\n
\n " }, "MinimumRequiredMinorEngineVersion": { "shape_name": "String", "type": "string", "documentation": "\n\n The minimum required engine version for the option to be applied.\n
\n " }, "PortRequired": { "shape_name": "Boolean", "type": "boolean", "documentation": "\n\n Specifies whether the option requires a port.\n
\n " }, "DefaultPort": { "shape_name": "IntegerOptional", "type": "integer", "documentation": "\n\n If the option requires a port, specifies the default port for the option.\n
\n " }, "OptionsDependedOn": { "shape_name": "OptionsDependedOn", "type": "list", "members": { "shape_name": "String", "type": "string", "documentation": null, "xmlname": "OptionName" }, "documentation": "\n\n List of all options that are prerequisites for this option.\n
\n " } }, "documentation": "\n\n Available option.\n
\n ", "xmlname": "OptionGroupOption" }, "documentation": "\n\n List of available options.\n
\n " }, "Marker": { "shape_name": "String", "type": "string", "documentation": "\nAn optional pagination token provided by a previous request.\n If this parameter is specified, the response includes\n only records beyond the marker,\n up to the value specified by MaxRecords
.
\n
\n " }, "errors": [], "documentation": "\n\n Describes all available options. \n
\n\n The name of the option group to describe. Cannot be supplied together with EngineName or MajorEngineVersion.\n
\n " }, "Marker": { "shape_name": "String", "type": "string", "documentation": "\n\n An optional pagination token provided by a previous DescribeOptionGroups request.\n If this parameter is specified, the response includes\n only records beyond the marker,\n up to the value specified by MaxRecords
.\n
\n The maximum number of records to include in the response.\n If more records exist than the specified MaxRecords
value,\n a pagination token called a marker is included in the response so that the remaining\n results can be retrieved.\n
Default: 100
\nConstraints: minimum 20, maximum 100
\n \n " }, "EngineName": { "shape_name": "String", "type": "string", "documentation": "\n\n Filters the list of option groups to only include groups associated with a specific database engine.\n
\n " }, "MajorEngineVersion": { "shape_name": "String", "type": "string", "documentation": "\n\n Filters the list of option groups to only include groups associated with a specific database engine version. If specified, then EngineName must also be specified.\n
\n " } }, "documentation": "\n\n
\n " }, "output": { "shape_name": "OptionGroups", "type": "structure", "members": { "OptionGroupsList": { "shape_name": "OptionGroupsList", "type": "list", "members": { "shape_name": "OptionGroup", "type": "structure", "members": { "OptionGroupName": { "shape_name": "String", "type": "string", "documentation": "\n\n Specifies the name of the option group.\n
\n " }, "OptionGroupDescription": { "shape_name": "String", "type": "string", "documentation": "\n\n Provides the description of the option group.\n
\n " }, "EngineName": { "shape_name": "String", "type": "string", "documentation": "\n\n Engine name that this option group can be applied to.\n
\n " }, "MajorEngineVersion": { "shape_name": "String", "type": "string", "documentation": "\n\n Indicates the major engine version associated with this option group.\n
\n " }, "Options": { "shape_name": "OptionsList", "type": "list", "members": { "shape_name": "Option", "type": "structure", "members": { "OptionName": { "shape_name": "String", "type": "string", "documentation": "\n\n The name of the option.\n
\n " }, "OptionDescription": { "shape_name": "String", "type": "string", "documentation": "\n\n The description of the option.\n
\n " }, "Port": { "shape_name": "IntegerOptional", "type": "integer", "documentation": "\n\n If required, the port configured for this option to use.\n
\n " }, "DBSecurityGroupMemberships": { "shape_name": "DBSecurityGroupMembershipList", "type": "list", "members": { "shape_name": "DBSecurityGroupMembership", "type": "structure", "members": { "DBSecurityGroupName": { "shape_name": "String", "type": "string", "documentation": "\n\n The name of the DB Security Group.\n
\n " }, "Status": { "shape_name": "String", "type": "string", "documentation": "\n\n The status of the DB Security Group.\n
\n " } }, "documentation": "\n\n This data type is used as a response element in the following actions:\n
\n\n If the Option requires access to a port, then this DB Security Group allows access to the port. \n
\n " }, "VpcSecurityGroupMemberships": { "shape_name": "VpcSecurityGroupMembershipList", "type": "list", "members": { "shape_name": "VpcSecurityGroupMembership", "type": "structure", "members": { "VpcSecurityGroupId": { "shape_name": "String", "type": "string", "documentation": "\nThe name of the VPC security group.
\n " }, "Status": { "shape_name": "String", "type": "string", "documentation": "\n\n The status of the VPC Security Group.\n
\n " } }, "documentation": "\nThis data type is used as a response element for queries on VPC security group membership.
\n ", "xmlname": "VpcSecurityGroupMembership" }, "documentation": "\n\n If the Option requires access to a port, then this VPC Security Group allows access to the port.\n
\n " } }, "documentation": "\n\n Option details.\n
\n", "xmlname": "Option" }, "documentation": "\n\n Indicates what options are available in the option group.\n
\n " }, "AllowsVpcAndNonVpcInstanceMemberships": { "shape_name": "Boolean", "type": "boolean", "documentation": "\n\n Indicates whether this option group can be applied to both VPC \n and non-VPC instances. The value 'true' indicates the option group \n can be applied to both VPC and non-VPC instances.\n
\n " }, "VpcId": { "shape_name": "String", "type": "string", "documentation": "\n\n If AllowsVpcAndNonVpcInstanceMemberships is 'false', this field is blank.\n If AllowsVpcAndNonVpcInstanceMemberships is 'true' and this field is blank, \n then this option group can be applied to both VPC and non-VPC instances.\n If this field contains a value, then this option group can only be \n applied to instances that are in the VPC indicated by this field.\n
\n " } }, "wrapper": true, "documentation": "\n\n
\n ", "xmlname": "OptionGroup" }, "documentation": "\n\n List of option groups.\n
\n " }, "Marker": { "shape_name": "String", "type": "string", "documentation": null } }, "documentation": "\n\n List of option groups.\n
\n " }, "errors": [ { "shape_name": "OptionGroupNotFoundFault", "type": "structure", "members": {}, "documentation": " \n\n The specified option group could not be found. \n
\n " } ], "documentation": "\n\n Describes the available option groups.\n
\nThe name of the engine to retrieve DB Instance options for.
\n ", "required": true }, "EngineVersion": { "shape_name": "String", "type": "string", "documentation": "\nThe engine version filter value. Specify this parameter to show only the available offerings matching the specified engine version.
\n " }, "DBInstanceClass": { "shape_name": "String", "type": "string", "documentation": "\nThe DB Instance class filter value. Specify this parameter to show only the available offerings matching the specified DB Instance class.
\n " }, "LicenseModel": { "shape_name": "String", "type": "string", "documentation": "\nThe license model filter value. Specify this parameter to show only the available offerings matching the specified license model.
\n " }, "Vpc": { "shape_name": "BooleanOptional", "type": "boolean", "documentation": "\nThe VPC filter value. Specify this parameter to show only the available VPC or non-VPC offerings.
\n " }, "MaxRecords": { "shape_name": "IntegerOptional", "type": "integer", "documentation": "\n\n The maximum number of records to include in the response.\n If more records exist than the specified MaxRecords
value,\n a pagination token called a marker is included in the response so that the remaining\n results can be retrieved.\n
Default: 100
\nConstraints: minimum 20, maximum 100
\n " }, "Marker": { "shape_name": "String", "type": "string", "documentation": "\n\n An optional pagination token provided by a previous\n DescribeOrderableDBInstanceOptions request.\n If this parameter is specified, the response includes\n only records beyond the marker,\n up to the value specified by MaxRecords
.\n
\n " }, "output": { "shape_name": "OrderableDBInstanceOptionsMessage", "type": "structure", "members": { "OrderableDBInstanceOptions": { "shape_name": "OrderableDBInstanceOptionsList", "type": "list", "members": { "shape_name": "OrderableDBInstanceOption", "type": "structure", "members": { "Engine": { "shape_name": "String", "type": "string", "documentation": "\n
\n The engine type of the orderable DB Instance.\n
\n " }, "EngineVersion": { "shape_name": "String", "type": "string", "documentation": "\n\n The engine version of the orderable DB Instance.\n
\n " }, "DBInstanceClass": { "shape_name": "String", "type": "string", "documentation": "\n\n The DB Instance Class for the orderable DB Instance \n
\n " }, "LicenseModel": { "shape_name": "String", "type": "string", "documentation": "\n\n The license model for the orderable DB Instance. \n
\n " }, "AvailabilityZones": { "shape_name": "AvailabilityZoneList", "type": "list", "members": { "shape_name": "AvailabilityZone", "type": "structure", "members": { "Name": { "shape_name": "String", "type": "string", "documentation": "\n\n The name of the availability zone.\n
\n " }, "ProvisionedIopsCapable": { "shape_name": "Boolean", "type": "boolean", "documentation": "\n\n True indicates the availability zone is capable of provisioned IOPs.\n
\n " } }, "wrapper": true, "documentation": "\n\n Contains Availability Zone information. \n
\n\n This data type is used as an element in the following data type:\n
\n \n \n ", "xmlname": "AvailabilityZone" }, "documentation": "\n\n A list of availability zones for the orderable DB Instance. \n
\n " }, "MultiAZCapable": { "shape_name": "Boolean", "type": "boolean", "documentation": "\n\n Indicates whether this orderable DB Instance is multi-AZ capable. \n
\n " }, "ReadReplicaCapable": { "shape_name": "Boolean", "type": "boolean", "documentation": "\n\n Indicates whether this orderable DB Instance can have a read replica.\n
\n " }, "Vpc": { "shape_name": "Boolean", "type": "boolean", "documentation": "\n\n Indicates whether this is a VPC orderable DB Instance.\n
\n " } }, "wrapper": true, "documentation": "\n\n Contains a list of available options for a DB Instance \n
\n\n This data type is used as a response element in the DescribeOrderableDBInstanceOptions action.\n
\n ", "xmlname": "OrderableDBInstanceOption" }, "documentation": "\nAn OrderableDBInstanceOption structure containing information about orderable options for the DB Instance.
\n " }, "Marker": { "shape_name": "String", "type": "string", "documentation": "\n\n An optional pagination token provided by a previous \n OrderableDBInstanceOptions request.\n If this parameter is specified, the response includes\n only records beyond the marker,\n \n up to the value specified by MaxRecords
.\n
\n Contains the result of a successful invocation of the DescribeOrderableDBInstanceOptions action. \n
\n " }, "errors": [], "documentation": "\nReturns a list of orderable DB Instance options for the specified engine.
\n\n The reserved DB Instance identifier filter value.\n Specify this parameter to show only the reservation\n that matches the specified reservation ID.\n
\n " }, "ReservedDBInstancesOfferingId": { "shape_name": "String", "type": "string", "documentation": "\n\n The offering identifier filter value.\n Specify this parameter to show only purchased reservations\n matching the specified offering identifier.\n
\n " }, "DBInstanceClass": { "shape_name": "String", "type": "string", "documentation": "\n\n The DB Instance class filter value.\n Specify this parameter to show only those reservations\n matching the specified DB Instances class.\n
\n " }, "Duration": { "shape_name": "String", "type": "string", "documentation": "\n\n The duration filter value, specified in years or seconds.\n Specify this parameter to show only reservations for this duration.\n
\nValid Values: 1 | 3 | 31536000 | 94608000
\n The product description filter value.\n Specify this parameter to show only those reservations\n matching the specified product description.\n
\n " }, "OfferingType": { "shape_name": "String", "type": "string", "documentation": "\n\n The offering type filter value.\n Specify this parameter to show only the available\n offerings matching the specified offering type.\n
\nValid Values: \"Light Utilization\" | \"Medium Utilization\" | \"Heavy Utilization\"
\n The Multi-AZ filter value. Specify this parameter to show only\n those reservations matching the specified Multi-AZ parameter.\n
\n " }, "MaxRecords": { "shape_name": "IntegerOptional", "type": "integer", "documentation": "\n\n The maximum number of records to include in the response.\n If more than the MaxRecords
value is available, a pagination token called a marker is\n included in the response so that the following results can be retrieved.\n
Default: 100
\nConstraints: minimum 20, maximum 100
" }, "Marker": { "shape_name": "String", "type": "string", "documentation": "\n\n An optional pagination token provided by a previous request.\n If this parameter is specified, the response includes\n only records beyond the marker,\n up to the value specified by MaxRecords
.\n
\n \n
\n " }, "output": { "shape_name": "ReservedDBInstanceMessage", "type": "structure", "members": { "Marker": { "shape_name": "String", "type": "string", "documentation": "\n\n An optional pagination token provided by a previous request.\n If this parameter is specified, the response includes\n only records beyond the marker,\n up to the value specified by MaxRecords
.\n
\n The unique identifier for the reservation.\n
\n " }, "ReservedDBInstancesOfferingId": { "shape_name": "String", "type": "string", "documentation": "\n\n The offering identifier.\n
\n " }, "DBInstanceClass": { "shape_name": "String", "type": "string", "documentation": "\n\n The DB instance class for the reserved DB Instance.\n
\n " }, "StartTime": { "shape_name": "TStamp", "type": "timestamp", "documentation": "\n\n The time the reservation started.\n
\n " }, "Duration": { "shape_name": "Integer", "type": "integer", "documentation": "\n\n The duration of the reservation in seconds.\n
\n " }, "FixedPrice": { "shape_name": "Double", "type": "double", "documentation": "\n\n The fixed price charged for this reserved DB Instance.\n
\n " }, "UsagePrice": { "shape_name": "Double", "type": "double", "documentation": "\n\n The hourly price charged for this reserved DB Instance.\n
\n " }, "CurrencyCode": { "shape_name": "String", "type": "string", "documentation": "\n\n The currency code for the reserved DB Instance.\n
\n " }, "DBInstanceCount": { "shape_name": "Integer", "type": "integer", "documentation": "\n\n The number of reserved DB Instances.\n
\n " }, "ProductDescription": { "shape_name": "String", "type": "string", "documentation": "\n\n The description of the reserved DB Instance.\n
\n " }, "OfferingType": { "shape_name": "String", "type": "string", "documentation": " \n\n The offering type of this reserved DB Instance. \n
\n " }, "MultiAZ": { "shape_name": "Boolean", "type": "boolean", "documentation": "\n\n Indicates if the reservation applies to Multi-AZ deployments.\n
\n " }, "State": { "shape_name": "String", "type": "string", "documentation": "\n\n The state of the reserved DB Instance.\n
\n " }, "RecurringCharges": { "shape_name": "RecurringChargeList", "type": "list", "members": { "shape_name": "RecurringCharge", "type": "structure", "members": { "RecurringChargeAmount": { "shape_name": "Double", "type": "double", "documentation": "\n\n The amount of the recurring charge.\n
\n " }, "RecurringChargeFrequency": { "shape_name": "String", "type": "string", "documentation": "\n\n The frequency of the recurring charge.\n
\n " } }, "wrapper": true, "documentation": "\n\n This data type is used as a response element in the \n DescribeReservedDBInstances and DescribeReservedDBInstancesOfferings actions.\n
\n ", "xmlname": "RecurringCharge" }, "documentation": " \n\n The recurring price charged to run this reserved DB Instance. \n
\n " } }, "wrapper": true, "documentation": "\n\n This data type is used as a response element in the \n DescribeReservedDBInstances and \n PurchaseReservedDBInstancesOffering actions.\n
\n ", "xmlname": "ReservedDBInstance" }, "documentation": "\n\n A list of of reserved DB Instances.\n
\n " } }, "documentation": "\n\n Contains the result of a successful invocation of the DescribeReservedDBInstances action.\n
\n " }, "errors": [ { "shape_name": "ReservedDBInstanceNotFoundFault", "type": "structure", "members": {}, "documentation": "\n\n The specified reserved DB Instance not found.\n
\n " } ], "documentation": "\n\n Returns information about reserved DB Instances for this account,\n or about a specified reserved DB Instance.\n
\n\n The offering identifier filter value.\n Specify this parameter to show only the available offering\n that matches the specified reservation identifier.\n
\nExample: 438012d3-4052-4cc7-b2e3-8d3372e0e706
\n The DB Instance class filter value.\n Specify this parameter to show only the available offerings\n matching the specified DB Instance class.\n
\n " }, "Duration": { "shape_name": "String", "type": "string", "documentation": "\n\n Duration filter value, specified in years or seconds.\n Specify this parameter to show only reservations for this duration.\n
\nValid Values: 1 | 3 | 31536000 | 94608000
\n Product description filter value.\n Specify this parameter to show only the available\n offerings matching the specified product description.\n
\n " }, "OfferingType": { "shape_name": "String", "type": "string", "documentation": "\n\n The offering type filter value.\n Specify this parameter to show only the available\n offerings matching the specified offering type.\n
\nValid Values: \"Light Utilization\" | \"Medium Utilization\" | \"Heavy Utilization\"
\n The Multi-AZ filter value.\n Specify this parameter to show only the available\n offerings matching the specified Multi-AZ parameter.\n
\n " }, "MaxRecords": { "shape_name": "IntegerOptional", "type": "integer", "documentation": "\n\n The maximum number of records to include in the response.\n If more than the MaxRecords
value is available, a pagination token called a marker is\n included in the response so that the following results can be retrieved.\n
Default: 100
\nConstraints: minimum 20, maximum 100
" }, "Marker": { "shape_name": "String", "type": "string", "documentation": "\n\n An optional pagination token provided by a previous request.\n If this parameter is specified, the response includes\n only records beyond the marker,\n up to the value specified by MaxRecords
.\n
\n \n
\n " }, "output": { "shape_name": "ReservedDBInstancesOfferingMessage", "type": "structure", "members": { "Marker": { "shape_name": "String", "type": "string", "documentation": "\n\n An optional pagination token provided by a previous request.\n If this parameter is specified, the response includes\n only records beyond the marker,\n up to the value specified by MaxRecords
.\n
\n The offering identifier.\n
\n " }, "DBInstanceClass": { "shape_name": "String", "type": "string", "documentation": "\n\n The DB instance class for the reserved DB Instance.\n
\n " }, "Duration": { "shape_name": "Integer", "type": "integer", "documentation": "\n\n The duration of the offering in seconds.\n
\n " }, "FixedPrice": { "shape_name": "Double", "type": "double", "documentation": "\n\n The fixed price charged for this offering.\n
\n " }, "UsagePrice": { "shape_name": "Double", "type": "double", "documentation": "\n\n The hourly price charged for this offering.\n
\n " }, "CurrencyCode": { "shape_name": "String", "type": "string", "documentation": "\n\n The currency code for the reserved DB Instance offering.\n
\n " }, "ProductDescription": { "shape_name": "String", "type": "string", "documentation": "\n\n The database engine used by the offering.\n
\n " }, "OfferingType": { "shape_name": "String", "type": "string", "documentation": " \n\n The offering type. \n
\n " }, "MultiAZ": { "shape_name": "Boolean", "type": "boolean", "documentation": "\n\n Indicates if the offering applies to Multi-AZ deployments.\n
\n " }, "RecurringCharges": { "shape_name": "RecurringChargeList", "type": "list", "members": { "shape_name": "RecurringCharge", "type": "structure", "members": { "RecurringChargeAmount": { "shape_name": "Double", "type": "double", "documentation": "\n\n The amount of the recurring charge.\n
\n " }, "RecurringChargeFrequency": { "shape_name": "String", "type": "string", "documentation": "\n\n The frequency of the recurring charge.\n
\n " } }, "wrapper": true, "documentation": "\n\n This data type is used as a response element in the \n DescribeReservedDBInstances and DescribeReservedDBInstancesOfferings actions.\n
\n ", "xmlname": "RecurringCharge" }, "documentation": " \n\n The recurring price charged to run this reserved DB Instance. \n
\n " } }, "wrapper": true, "documentation": "\n\n This data type is used as a response element in the DescribeReservedDBInstancesOfferings action.\n
\n\n ", "xmlname": "ReservedDBInstancesOffering" }, "documentation": "\n\n A list of reserved DB Instance offerings.\n
\n " } }, "documentation": "\n\n Contains the result of a successful invocation of the DescribeReservedDBInstancesOfferings action. \n
\n " }, "errors": [ { "shape_name": "ReservedDBInstancesOfferingNotFoundFault", "type": "structure", "members": {}, "documentation": "\n\n Specified offering does not exist.\n
\n " } ], "documentation": "\n\n Lists available reserved DB Instance offerings.\n
\nThe DB Instance with tags to be listed.
\n ", "required": true } }, "documentation": "\n \n " }, "output": { "shape_name": "TagListMessage", "type": "structure", "members": { "TagList": { "shape_name": "TagList", "type": "list", "members": { "shape_name": "Tag", "type": "structure", "members": { "Key": { "shape_name": "String", "type": "string", "documentation": "\nA key is the required name of the tag. The string value can be from \n 1 to 128 Unicode characters in length and cannot be prefixed with \"aws:\". \n The string may only contain only the set of Unicode letters, digits, \n white-space, '_', '.', '/', '=', '+', '-' (Java regex: \"^([\\\\p{L}\\\\p{Z}\\\\p{N}_.:/=+\\\\-]*)$\").
\n " }, "Value": { "shape_name": "String", "type": "string", "documentation": "\nA value is the optional value of the tag. The string value can be from \n 1 to 256 Unicode characters in length and cannot be prefixed with \"aws:\". \n The string may only contain only the set of Unicode letters, digits, \n white-space, '_', '.', '/', '=', '+', '-' (Java regex: \"^([\\\\p{L}\\\\p{Z}\\\\p{N}_.:/=+\\\\-]*)$\").
\n " } }, "documentation": "\nMetadata assigned to a DB Instance consisting of a key-value pair.
\n ", "xmlname": "Tag" }, "documentation": "\nList of tags returned by the ListTagsForResource operation.
\n " } }, "documentation": "\n \n " }, "errors": [ { "shape_name": "DBInstanceNotFoundFault", "type": "structure", "members": {}, "documentation": "\n\n DBInstanceIdentifier does not refer to an existing DB Instance.\n
\n " }, { "shape_name": "DBSnapshotNotFoundFault", "type": "structure", "members": {}, "documentation": "\n\n DBSnapshotIdentifier does not refer to an existing DB Snapshot.\n
\n " } ], "documentation": "\nLists all tags on a DB Instance.
\nFor an overview on tagging DB Instances, see DB Instance Tags.
\n " }, "ModifyDBInstance": { "name": "ModifyDBInstance", "input": { "shape_name": "ModifyDBInstanceMessage", "type": "structure", "members": { "DBInstanceIdentifier": { "shape_name": "String", "type": "string", "documentation": "\n\n The DB Instance identifier.\n This value is stored as a lowercase string. \n
\nConstraints:
\n\n The new storage capacity of the RDS instance.\n Changing this parameter does not result in an outage and\n the change is applied during the next maintenance window\n unless the ApplyImmediately
parameter is set\n to true
for this request.\n
MySQL
\nDefault: Uses existing setting
\nValid Values: 5-1024
\nConstraints: Value supplied must be at least 10% greater than the current value. \n Values that are not at least 10% greater than the existing value are rounded up \n so that they are 10% greater than the current value.
\nType: Integer
\nOracle
\nDefault: Uses existing setting
\nValid Values: 10-1024
\nConstraints: Value supplied must be at least 10% greater than the current value. \n Values that are not at least 10% greater than the existing value are rounded up \n so that they are 10% greater than the current value.
\nSQL Server
\nCannot be modified.
\n " }, "DBInstanceClass": { "shape_name": "String", "type": "string", "documentation": "\n\n The new compute and memory capacity of the DB Instance. To determine the instance classes that are available for a particular \n DB engine, use the DescribeOrderableDBInstanceOptions action.\n
\n\n Passing a value for this parameter causes an outage during the change and\n is applied during the next maintenance window,\n unless the ApplyImmediately
parameter is specified\n as true
for this request.\n
Default: Uses existing setting
\nValid Values: db.t1.micro | db.m1.small | db.m1.medium | db.m1.large | db.m1.xlarge | db.m2.xlarge | db.m2.2xlarge | db.m2.4xlarge
\n A list of DB Security Groups to authorize on this DB Instance.\n Changing this parameter does not result in an outage and the change is asynchronously applied as soon as possible.\n
\nConstraints:
\n\n A list of EC2 VPC Security Groups to authorize on this DB Instance.\n This change is asynchronously applied as soon as possible.\n
\nConstraints:
\n\n Specifies whether or not the modifications in this request and\n any pending modifications are asynchronously applied\n as soon as possible, regardless of the\n PreferredMaintenanceWindow
setting for the DB Instance.\n
\n If this parameter is passed as false
, changes to the\n DB Instance are applied on the next call to\n RebootDBInstance,\n the next maintenance reboot, or the next failure reboot,\n whichever occurs first. See each parameter to determine when a change is applied.\n
Default: false
\n The new password for the DB Instance master user. Can be any printable ASCII character except \"/\", \"\\\", or \"@\".
\n\n Changing this parameter does not result in an outage and the change is asynchronously applied as soon as possible. \n Between the time of the request and the completion of the request,\n the MasterUserPassword
element exists in the\n PendingModifiedValues
element of the operation response.\n
Default: Uses existing setting
\nConstraints: Must be 8 to 41 alphanumeric characters (MySQL), 8 to 30 \n alphanumeric characters (Oracle), or 8 to 128 alphanumeric characters (SQL Server).
\n\n The name of the DB Parameter Group to apply to this DB Instance. \n Changing this parameter does not result in an outage and the change \n is applied during the next maintenance window\n unless the ApplyImmediately
parameter is set\n to true
for this request.\n
Default: Uses existing setting
\nConstraints: The DB Parameter Group must be in the same DB \n Parameter Group family as this DB Instance.
\n " }, "BackupRetentionPeriod": { "shape_name": "IntegerOptional", "type": "integer", "documentation": "\n\n The number of days to retain automated backups.\n Setting this parameter to a positive number enables backups.\n Setting this parameter to 0 disables automated backups.\n
\nChanging this parameter can result in an outage if you change from 0 to a non-zero value or from a non-zero value to 0. \n These changes are applied during the next maintenance window\n unless the ApplyImmediately
parameter is set\n to true
for this request. If you change the parameter from one non-zero value to another \n non-zero value, the change is asynchronously applied as soon as possible.
Default: Uses existing setting
\nConstraints:
\n\n The daily time range during which automated backups are created\n if automated backups are enabled,\n as determined by the BackupRetentionPeriod
. \n Changing this parameter does not result in an outage and the change is asynchronously applied as soon as possible.\n
Constraints:
\n\n The weekly time range (in UTC) during which system maintenance can occur,\n which may result in an outage. Changing this parameter does not result in an outage, except in the following situation,\n and the change is asynchronously applied as soon as possible.\n If there are pending actions that cause a reboot, and the maintenance window is changed to include the current time, then changing this\n parameter will cause a reboot of the DB Instance.\n If moving this window to the current time,\n there must be at least 30 minutes between the current time and\n end of the window to ensure pending changes are applied.\n
\nDefault: Uses existing setting
\nFormat: ddd:hh24:mi-ddd:hh24:mi
\nValid Days: Mon | Tue | Wed | Thu | Fri | Sat | Sun
\nConstraints: Must be at least 30 minutes
\n " }, "MultiAZ": { "shape_name": "BooleanOptional", "type": "boolean", "documentation": "\n\n Specifies if the DB Instance is a Multi-AZ deployment. \n Changing this parameter does not result in an outage and the change \n is applied during the next maintenance window\n unless the ApplyImmediately
parameter is set\n to true
for this request.\n
Constraints: Cannot be specified if the DB Instance is a read replica.
\n " }, "EngineVersion": { "shape_name": "String", "type": "string", "documentation": "\n\n The version number of the database engine to upgrade to. \n Changing this parameter results in an outage and the change \n is applied during the next maintenance window\n unless the ApplyImmediately
parameter is set\n to true
for this request.\n
\n For major version upgrades, if a nondefault DB Parameter Group is currently in use,\n a new DB Parameter Group in the DB Parameter Group Family\n for the new engine version must be specified.\n The new DB Parameter Group can be the default for that DB Parameter Group Family.\n
\nExample: 5.1.42
\n Indicates that major version upgrades are allowed. \n Changing this parameter does not result in an outage and the change is asynchronously applied as soon as possible.\n
\nConstraints: This parameter must be set to true when \n specifying a value for the EngineVersion parameter that is \n a different major version than the DB Instance's current version.
\n " }, "AutoMinorVersionUpgrade": { "shape_name": "BooleanOptional", "type": "boolean", "documentation": "\n\n Indicates that minor version upgrades will be applied automatically\n to the DB Instance during the maintenance window. \n Changing this parameter does not result in an outage except in the following case \n and the change is asynchronously applied as soon as possible.\n An outage will result if this parameter is set to true
during the maintenance window, \n and a newer minor version is available, and RDS has enabled auto patching for that engine version.\n
\n The new Provisioned IOPS (I/O operations per second) value for the RDS instance. \n Changing this parameter does not result in an outage and\n the change is applied during the next maintenance window\n unless the ApplyImmediately
parameter is set\n to true
for this request.\n
Default: Uses existing setting
\nConstraints: Value supplied must be at least 10% greater than the current value. \n Values that are not at least 10% greater than the existing value are rounded up \n so that they are 10% greater than the current value.
\nType: Integer
\n " }, "OptionGroupName": { "shape_name": "String", "type": "string", "documentation": "\n\n Indicates that the DB Instance should be associated with the specified option group. \n Changing this parameter does not result in an outage except in the following case and the change \n is applied during the next maintenance window\n unless the ApplyImmediately
parameter is set\n to true
for this request. If the parameter change results in an option group that \n enables OEM, this change can cause a brief (sub-second) period during which new connections \n are rejected but existing connections are not interrupted.\n
\n The new DB Instance identifier for the DB Instance when renaming a DB\n Instance.\n This value is stored as a lowercase string. \n
\nConstraints:
\n\n\n
\n " }, "output": { "shape_name": "DBInstanceWrapper", "type": "structure", "members": { "DBInstance": { "shape_name": "DBInstance", "type": "structure", "members": { "DBInstanceIdentifier": { "shape_name": "String", "type": "string", "documentation": "\n\n Contains a user-supplied database identifier.\n This is the unique key that identifies a DB Instance.\n
\n " }, "DBInstanceClass": { "shape_name": "String", "type": "string", "documentation": "\n\n Contains the name of the compute and memory\n capacity class of the DB Instance.\n
\n " }, "Engine": { "shape_name": "String", "type": "string", "documentation": "\n\n Provides the name of the database engine to be used for this DB Instance.\n
\n " }, "DBInstanceStatus": { "shape_name": "String", "type": "string", "documentation": "\n\n Specifies the current state of this database.\n
\n " }, "MasterUsername": { "shape_name": "String", "type": "string", "documentation": "\n\n Contains the master username for the DB Instance.\n
\n " }, "DBName": { "shape_name": "String", "type": "string", "documentation": "\nThe meaning of this parameter differs according to the database engine you use.
\nMySQL
\n\n Contains the name of the initial database of this instance that was\n provided at create time, if one was specified when the\n DB Instance was created. This same name is returned for\n the life of the DB Instance.\n
\nType: String
\nOracle
\n\n Contains the Oracle System ID (SID) of the created DB Instance. \n
\n " }, "Endpoint": { "shape_name": "Endpoint", "type": "structure", "members": { "Address": { "shape_name": "String", "type": "string", "documentation": "\n\n Specifies the DNS address of the DB Instance.\n
\n " }, "Port": { "shape_name": "Integer", "type": "integer", "documentation": "\n\n Specifies the port that the database engine is listening on.\n
\n " } }, "documentation": "\n\n Specifies the connection endpoint.\n
\n " }, "AllocatedStorage": { "shape_name": "Integer", "type": "integer", "documentation": "\n\n Specifies the allocated storage size specified in gigabytes.\n
\n " }, "InstanceCreateTime": { "shape_name": "TStamp", "type": "timestamp", "documentation": "\n\n Provides the date and time the DB Instance was created.\n
\n " }, "PreferredBackupWindow": { "shape_name": "String", "type": "string", "documentation": "\n\n Specifies the daily time range during which automated backups are\n created if automated backups are enabled, as determined\n by the BackupRetentionPeriod
.\n
\n Specifies the number of days for which automatic DB Snapshots are retained.\n
\n " }, "DBSecurityGroups": { "shape_name": "DBSecurityGroupMembershipList", "type": "list", "members": { "shape_name": "DBSecurityGroupMembership", "type": "structure", "members": { "DBSecurityGroupName": { "shape_name": "String", "type": "string", "documentation": "\n\n The name of the DB Security Group.\n
\n " }, "Status": { "shape_name": "String", "type": "string", "documentation": "\n\n The status of the DB Security Group.\n
\n " } }, "documentation": "\n\n This data type is used as a response element in the following actions:\n
\n\n Provides List of DB Security Group elements containing only\n DBSecurityGroup.Name
and DBSecurityGroup.Status
subelements.\n
The name of the VPC security group.
\n " }, "Status": { "shape_name": "String", "type": "string", "documentation": "\n\n The status of the VPC Security Group.\n
\n " } }, "documentation": "\nThis data type is used as a response element for queries on VPC security group membership.
\n ", "xmlname": "VpcSecurityGroupMembership" }, "documentation": "\n\n Provides List of VPC security group elements \n that the DB Instance belongs to. \n
\n " }, "DBParameterGroups": { "shape_name": "DBParameterGroupStatusList", "type": "list", "members": { "shape_name": "DBParameterGroupStatus", "type": "structure", "members": { "DBParameterGroupName": { "shape_name": "String", "type": "string", "documentation": "\n\n The name of the DP Parameter Group.\n
\n " }, "ParameterApplyStatus": { "shape_name": "String", "type": "string", "documentation": "\n\n The status of parameter updates.\n
\n " } }, "documentation": "\n\n The status of the DB Parameter Group.\n
\nThis data type is used as a response element in the following actions:
\n\n Provides the list of DB Parameter Groups applied to this DB Instance.\n
\n " }, "AvailabilityZone": { "shape_name": "String", "type": "string", "documentation": "\n\n Specifies the name of the Availability Zone the DB Instance is located in.\n
\n " }, "DBSubnetGroup": { "shape_name": "DBSubnetGroup", "type": "structure", "members": { "DBSubnetGroupName": { "shape_name": "String", "type": "string", "documentation": "\n\n Specifies the name of the DB Subnet Group.\n
\n " }, "DBSubnetGroupDescription": { "shape_name": "String", "type": "string", "documentation": "\n\n Provides the description of the DB Subnet Group.\n
\n " }, "VpcId": { "shape_name": "String", "type": "string", "documentation": "\n\n Provides the VpcId of the DB Subnet Group.\n
\n " }, "SubnetGroupStatus": { "shape_name": "String", "type": "string", "documentation": "\n\n Provides the status of the DB Subnet Group.\n
\n " }, "Subnets": { "shape_name": "SubnetList", "type": "list", "members": { "shape_name": "Subnet", "type": "structure", "members": { "SubnetIdentifier": { "shape_name": "String", "type": "string", "documentation": "\n\n Specifies the identifier of the subnet.\n
\n " }, "SubnetAvailabilityZone": { "shape_name": "AvailabilityZone", "type": "structure", "members": { "Name": { "shape_name": "String", "type": "string", "documentation": "\n\n The name of the availability zone.\n
\n " }, "ProvisionedIopsCapable": { "shape_name": "Boolean", "type": "boolean", "documentation": "\n\n True indicates the availability zone is capable of provisioned IOPs.\n
\n " } }, "wrapper": true, "documentation": "\n\n Contains Availability Zone information. \n
\n\n This data type is used as an element in the following data type:\n
\n \n \n " }, "SubnetStatus": { "shape_name": "String", "type": "string", "documentation": "\n\n Specifies the status of the subnet.\n
\n " } }, "documentation": "\n\n This data type is used as a response element in the DescribeDBSubnetGroups action.\n
\n ", "xmlname": "Subnet" }, "documentation": "\n\n Contains a list of Subnet elements.\n
\n " } }, "wrapper": true, "documentation": "\n\n Provides the inforamtion of the subnet group associated with the DB instance, including the name, descrption and subnets in the subnet group.\n
\n " }, "PreferredMaintenanceWindow": { "shape_name": "String", "type": "string", "documentation": "\n\n Specifies the weekly time range (in UTC) during which\n system maintenance can occur.\n
\n " }, "PendingModifiedValues": { "shape_name": "PendingModifiedValues", "type": "structure", "members": { "DBInstanceClass": { "shape_name": "String", "type": "string", "documentation": "\n\n Contains the new DBInstanceClass
for the DB Instance\n that will be applied or is in progress.\n
\n Contains the new AllocatedStorage
size for the DB Instance\n that will be applied or is in progress.\n
\n Contains the pending or in-progress change of the master credentials for the DB Instance.\n
\n " }, "Port": { "shape_name": "IntegerOptional", "type": "integer", "documentation": "\n\n Specifies the pending port for the DB Instance.\n
\n " }, "BackupRetentionPeriod": { "shape_name": "IntegerOptional", "type": "integer", "documentation": "\n\n Specifies the pending number of days for which automated backups are retained.\n
\n " }, "MultiAZ": { "shape_name": "BooleanOptional", "type": "boolean", "documentation": "\n\n Indicates that the Single-AZ DB Instance is to change to a Multi-AZ deployment.\n
\n " }, "EngineVersion": { "shape_name": "String", "type": "string", "documentation": "\n\n Indicates the database engine version. \n
\n " }, "Iops": { "shape_name": "IntegerOptional", "type": "integer", "documentation": "\n\n Specifies the new Provisioned IOPS value for the DB Instance\n that will be applied or is being applied.\n
\n " }, "DBInstanceIdentifier": { "shape_name": "String", "type": "string", "documentation": "\n\n Contains the new DBInstanceIdentifier
for the DB Instance\n that will be applied or is in progress.\n
\n Specifies that changes to the DB Instance are pending.\n This element is only included when changes are pending.\n Specific changes are identified by subelements.\n
\n " }, "LatestRestorableTime": { "shape_name": "TStamp", "type": "timestamp", "documentation": "\n\n Specifies the latest time to which a database\n can be restored with point-in-time restore.\n
\n " }, "MultiAZ": { "shape_name": "Boolean", "type": "boolean", "documentation": "\n\n Specifies if the DB Instance is a Multi-AZ deployment.\n
\n " }, "EngineVersion": { "shape_name": "String", "type": "string", "documentation": "\n\n Indicates the database engine version.\n
\n " }, "AutoMinorVersionUpgrade": { "shape_name": "Boolean", "type": "boolean", "documentation": "\n\n Indicates that minor version patches are applied automatically.\n
\n " }, "ReadReplicaSourceDBInstanceIdentifier": { "shape_name": "String", "type": "string", "documentation": "\n\n Contains the identifier of the source DB Instance if this DB Instance is a Read Replica.\n
\n " }, "ReadReplicaDBInstanceIdentifiers": { "shape_name": "ReadReplicaDBInstanceIdentifierList", "type": "list", "members": { "shape_name": "String", "type": "string", "documentation": null, "xmlname": "ReadReplicaDBInstanceIdentifier" }, "documentation": "\n\n Contains one or more identifiers of the Read Replicas associated with this DB Instance.\n
\n " }, "LicenseModel": { "shape_name": "String", "type": "string", "documentation": "\n\n License model information for this DB Instance.\n
\n " }, "Iops": { "shape_name": "IntegerOptional", "type": "integer", "documentation": "\n\n Specifies the Provisioned IOPS (I/O operations per second) value.\n
\n " }, "OptionGroupMembership": { "shape_name": "OptionGroupMembership", "type": "structure", "members": { "OptionGroupName": { "shape_name": "String", "type": "string", "documentation": "\n\n The name of the option group that the instance belongs to.\n
\n " }, "Status": { "shape_name": "String", "type": "string", "documentation": "\n\n The status of the DB Instance's option group membership (e.g. in-sync, pending, pending-maintenance, applying).\n
\n " } }, "documentation": "\n\n Specifies the name and status of the option group that this instance belongs to. \n
\n " }, "CharacterSetName": { "shape_name": "String", "type": "string", "documentation": "\n\n If present, specifies the name of the character set that this instance is associated with. \n
\n " }, "SecondaryAvailabilityZone": { "shape_name": "String", "type": "string", "documentation": "\n\n If present, specifies the name of the secondary Availability Zone \n for a DB instance with multi-AZ support.\n
\n " }, "PubliclyAccessible": { "shape_name": "Boolean", "type": "boolean", "documentation": null } }, "wrapper": true, "documentation": "\n\n Contains the result of a successful invocation of the following actions:\n
\n \nThis data type is used as a response element in the DescribeDBInstances action.
\n " } } }, "errors": [ { "shape_name": "InvalidDBInstanceStateFault", "type": "structure", "members": {}, "documentation": "\n\n The specified DB Instance is not in the available state.\n
\n " }, { "shape_name": "InvalidDBSecurityGroupStateFault", "type": "structure", "members": {}, "documentation": "\n\n The state of the DB Security Group does not allow deletion.\n
\n " }, { "shape_name": "DBInstanceAlreadyExistsFault", "type": "structure", "members": {}, "documentation": "\n\n User already has a DB Instance with the given identifier.\n
\n " }, { "shape_name": "DBInstanceNotFoundFault", "type": "structure", "members": {}, "documentation": "\n\n DBInstanceIdentifier does not refer to an existing DB Instance.\n
\n " }, { "shape_name": "DBSecurityGroupNotFoundFault", "type": "structure", "members": {}, "documentation": "\n\n DBSecurityGroupName does not refer to an existing DB Security Group.\n
\n " }, { "shape_name": "DBParameterGroupNotFoundFault", "type": "structure", "members": {}, "documentation": "\n\n DBParameterGroupName does not refer to an\n existing DB Parameter Group.\n
\n " }, { "shape_name": "InsufficientDBInstanceCapacityFault", "type": "structure", "members": {}, "documentation": "\n\n Specified DB Instance class is not available in the specified Availability Zone.\n
\n " }, { "shape_name": "StorageQuotaExceededFault", "type": "structure", "members": {}, "documentation": "\n\n Request would result in user exceeding the\n allowed amount of storage available across all DB Instances.\n
\n " }, { "shape_name": "InvalidVPCNetworkStateFault", "type": "structure", "members": {}, "documentation": "\n\n DB Subnet Group does not cover all availability zones after it is created because users' change.\n
\n " }, { "shape_name": "ProvisionedIopsNotAvailableInAZFault", "type": "structure", "members": {}, "documentation": "\n\n Provisioned IOPS not available in the specified Availability Zone.\n
\n " }, { "shape_name": "OptionGroupNotFoundFault", "type": "structure", "members": {}, "documentation": " \n\n The specified option group could not be found. \n
\n " }, { "shape_name": "DBUpgradeDependencyFailureFault", "type": "structure", "members": {}, "documentation": null } ], "documentation": "\n\n Modify settings for a DB Instance. You can change one\n or more database configuration parameters by specifying these parameters and the new values in the\n request.\n
\n\n The name of the DB Parameter Group.\n
\nConstraints:
\n\n Specifies the name of the parameter.\n
\n " }, "ParameterValue": { "shape_name": "String", "type": "string", "documentation": "\n\n Specifies the value of the parameter.\n
\n " }, "Description": { "shape_name": "String", "type": "string", "documentation": "\n\n Provides a description of the parameter.\n
\n " }, "Source": { "shape_name": "String", "type": "string", "documentation": "\n\n Indicates the source of the parameter value.\n
\n " }, "ApplyType": { "shape_name": "String", "type": "string", "documentation": "\n\n Specifies the engine specific parameters type.\n
\n " }, "DataType": { "shape_name": "String", "type": "string", "documentation": "\n\n Specifies the valid data type for the parameter.\n
\n " }, "AllowedValues": { "shape_name": "String", "type": "string", "documentation": "\n\n Specifies the valid range of values for the parameter.\n
\n " }, "IsModifiable": { "shape_name": "Boolean", "type": "boolean", "documentation": "\n\n Indicates whether (true
) or not (false
) the parameter can be modified.\n Some parameters have security or operational implications\n that prevent them from being changed.\n
\n The earliest engine version to which the parameter can apply.\n
\n " }, "ApplyMethod": { "shape_name": "ApplyMethod", "type": "string", "enum": [ "immediate", "pending-reboot" ], "documentation": "\n\n Indicates when to apply parameter updates.\n
\n " } }, "documentation": "\n\n This data type is used as a request parameter in the\n ModifyDBParameterGroup and ResetDBParameterGroup actions.\n
\nThis data type is used as a response element in the \n DescribeEngineDefaultParameters and DescribeDBParameters actions.
\n ", "xmlname": "Parameter" }, "documentation": "\n\n An array of parameter names, values, and the apply method\n for the parameter update. At least one parameter name,\n value, and apply method must be supplied; subsequent arguments are optional.\n A maximum of 20 parameters may be modified in a single request.\n
\nValid Values (for the application method): immediate | pending-reboot
\n\n
\n " }, "output": { "shape_name": "DBParameterGroupNameMessage", "type": "structure", "members": { "DBParameterGroupName": { "shape_name": "String", "type": "string", "documentation": "\n\n The name of the DB Parameter Group.\n
\n " } }, "documentation": "\n\n Contains the result of a successful invocation of the \n ModifyDBParameterGroup or ResetDBParameterGroup action.\n
\n " }, "errors": [ { "shape_name": "DBParameterGroupNotFoundFault", "type": "structure", "members": {}, "documentation": "\n\n DBParameterGroupName does not refer to an\n existing DB Parameter Group.\n
\n " }, { "shape_name": "InvalidDBParameterGroupStateFault", "type": "structure", "members": {}, "documentation": "\n\n The DB Parameter Group cannot be deleted because it is in use.\n
\n " } ], "documentation": "\n\n Modifies the parameters of a DBParameterGroup. To modify more than one parameter\n submit a list of the following: ParameterName, ParameterValue, and ApplyMethod. A maximum of 20\n parameters can be modified in a single request.\n
\n\n The apply-immediate
method can be used only for\n dynamic parameters; the pending-reboot
method can be used\n with MySQL and Oracle DB Instances for either dynamic or static parameters. For \n Microsoft SQL Server DB Instances, the pending-reboot
method can \n be used only for static parameters. \n
\n The name for the DB Subnet Group.\n This value is stored as a lowercase string.\n
\nConstraints: Must contain no more than 255 alphanumeric characters or hyphens. Must not be \"Default\".
\n \nExample: mySubnetgroup
\n The description for the DB Subnet Group.\n
\n " }, "SubnetIds": { "shape_name": "SubnetIdentifierList", "type": "list", "members": { "shape_name": "String", "type": "string", "documentation": null, "xmlname": "SubnetIdentifier" }, "documentation": "\n\n The EC2 Subnet IDs for the DB Subnet Group.\n
\n ", "required": true } }, "documentation": "\n\n\n
\n " }, "output": { "shape_name": "DBSubnetGroupWrapper", "type": "structure", "members": { "DBSubnetGroup": { "shape_name": "DBSubnetGroup", "type": "structure", "members": { "DBSubnetGroupName": { "shape_name": "String", "type": "string", "documentation": "\n\n Specifies the name of the DB Subnet Group.\n
\n " }, "DBSubnetGroupDescription": { "shape_name": "String", "type": "string", "documentation": "\n\n Provides the description of the DB Subnet Group.\n
\n " }, "VpcId": { "shape_name": "String", "type": "string", "documentation": "\n\n Provides the VpcId of the DB Subnet Group.\n
\n " }, "SubnetGroupStatus": { "shape_name": "String", "type": "string", "documentation": "\n\n Provides the status of the DB Subnet Group.\n
\n " }, "Subnets": { "shape_name": "SubnetList", "type": "list", "members": { "shape_name": "Subnet", "type": "structure", "members": { "SubnetIdentifier": { "shape_name": "String", "type": "string", "documentation": "\n\n Specifies the identifier of the subnet.\n
\n " }, "SubnetAvailabilityZone": { "shape_name": "AvailabilityZone", "type": "structure", "members": { "Name": { "shape_name": "String", "type": "string", "documentation": "\n\n The name of the availability zone.\n
\n " }, "ProvisionedIopsCapable": { "shape_name": "Boolean", "type": "boolean", "documentation": "\n\n True indicates the availability zone is capable of provisioned IOPs.\n
\n " } }, "wrapper": true, "documentation": "\n\n Contains Availability Zone information. \n
\n\n This data type is used as an element in the following data type:\n
\n \n \n " }, "SubnetStatus": { "shape_name": "String", "type": "string", "documentation": "\n\n Specifies the status of the subnet.\n
\n " } }, "documentation": "\n\n This data type is used as a response element in the DescribeDBSubnetGroups action.\n
\n ", "xmlname": "Subnet" }, "documentation": "\n\n Contains a list of Subnet elements.\n
\n " } }, "wrapper": true, "documentation": "\n\n Contains the result of a successful invocation of the following actions:\n
\n \nThis data type is used as a response element in the DescribeDBSubnetGroups action.
\n " } } }, "errors": [ { "shape_name": "DBSubnetGroupNotFoundFault", "type": "structure", "members": {}, "documentation": "\n\n DBSubnetGroupName does not refer to an existing DB Subnet Group.\n
\n " }, { "shape_name": "DBSubnetQuotaExceededFault", "type": "structure", "members": {}, "documentation": "\n\n Request would result in user exceeding the allowed number of subnets in a DB subnet Groups.\n
\n " }, { "shape_name": "SubnetAlreadyInUse", "type": "structure", "members": {}, "documentation": "\n\n The DB subnet is already in use in the availability zone.\n
\n " }, { "shape_name": "DBSubnetGroupDoesNotCoverEnoughAZs", "type": "structure", "members": {}, "documentation": "\n\n Subnets in the DB subnet group should cover at least 2 availability zones unless there's'only 1 available zone.\n
\n " }, { "shape_name": "InvalidSubnet", "type": "structure", "members": {}, "documentation": "\n\n Request subnet is valid, or all subnets are not in common Vpc. \n
\n " } ], "documentation": "\n\n Modifies an existing DB subnet group. DB subnet groups must contain at least one subnet in at least two AZs in the region.\n
\nThe name of the RDS event notification subscription.
\n ", "required": true }, "SnsTopicArn": { "shape_name": "String", "type": "string", "documentation": "\n\n The Amazon Resource Name (ARN) of the SNS topic created for event notification. The ARN is created by Amazon SNS when you create \n a topic and subscribe to it.\n
\n " }, "SourceType": { "shape_name": "String", "type": "string", "documentation": "\n\n The type of source that will be generating the events. For example, if you want to be notified of events generated by a DB instance, \n you would set this parameter to db-instance. if this value is not specified, all events are returned.\n
\nValid values: db-instance | db-parameter-group | db-security-group | db-snapshot
\n " }, "EventCategories": { "shape_name": "EventCategoriesList", "type": "list", "members": { "shape_name": "String", "type": "string", "documentation": null, "xmlname": "EventCategory" }, "documentation": "\n\n A list of event categories for a SourceType that you want to subscribe to. You can see a list of the categories for a given SourceType \n in the Events topic in the Amazon RDS User Guide \n or by using the DescribeEventCategories action.\n
\n " }, "Enabled": { "shape_name": "BooleanOptional", "type": "boolean", "documentation": "\n\n A Boolean value; set to true to activate the subscription.\n
\n " } }, "documentation": " \n \n " }, "output": { "shape_name": "EventSubscriptionWrapper", "type": "structure", "members": { "EventSubscription": { "shape_name": "EventSubscription", "type": "structure", "members": { "Id": { "shape_name": "String", "type": "string", "documentation": "\nNot used.
\n " }, "CustomerAwsId": { "shape_name": "String", "type": "string", "documentation": "\nThe AWS customer account associated with the RDS event notification subscription.
\n " }, "CustSubscriptionId": { "shape_name": "String", "type": "string", "documentation": "\nThe RDS event notification subscription Id.
\n " }, "SnsTopicArn": { "shape_name": "String", "type": "string", "documentation": "\nThe topic ARN of the RDS event notification subscription.
\n " }, "Status": { "shape_name": "String", "type": "string", "documentation": "\nThe status of the RDS event notification subscription.
\nConstraints:
\nCan be one of the following: creating | modifying | deleting | active | no-permission | topic-not-exist
\nThe status \"no-permission\" indicates that RDS no longer has permission to post to the SNS topic. The status \n \"topic-not-exist\" indicates that the topic was deleted after the subscription was created.
\n " }, "SubscriptionCreationTime": { "shape_name": "String", "type": "string", "documentation": "\nThe time the RDS event notification subscription was created.
\n " }, "SourceType": { "shape_name": "String", "type": "string", "documentation": "\nThe source type for the RDS event notification subscription.
\n " }, "SourceIdsList": { "shape_name": "SourceIdsList", "type": "list", "members": { "shape_name": "String", "type": "string", "documentation": null, "xmlname": "SourceId" }, "documentation": "\nA list of source Ids for the RDS event notification subscription.
\n " }, "EventCategoriesList": { "shape_name": "EventCategoriesList", "type": "list", "members": { "shape_name": "String", "type": "string", "documentation": null, "xmlname": "EventCategory" }, "documentation": "\nA list of event categories for the RDS event notification subscription.
\n " }, "Enabled": { "shape_name": "Boolean", "type": "boolean", "documentation": "\nA Boolean value indicating if the subscription is enabled. True indicates the subscription is enabled.
\n " } }, "wrapper": true, "documentation": "\nContains the results of a successful invocation of the DescribeEventSubscriptions action.
\n " } } }, "errors": [ { "shape_name": "EventSubscriptionQuotaExceededFault", "type": "structure", "members": {}, "documentation": "\nYou have reached the maximum number of event subscriptions.
\n " }, { "shape_name": "SubscriptionNotFoundFault", "type": "structure", "members": {}, "documentation": "\nThe subscription name does not exist.
\n " }, { "shape_name": "SNSInvalidTopicFault", "type": "structure", "members": {}, "documentation": "\nSNS has responded that there is a problem with the SND topic specified.
\n " }, { "shape_name": "SNSNoAuthorizationFault", "type": "structure", "members": {}, "documentation": "\nYou do not have permission to publish to the SNS topic ARN.
\n " }, { "shape_name": "SNSTopicArnNotFoundFault", "type": "structure", "members": {}, "documentation": "\nThe SNS topic ARN does not exist.
\n " }, { "shape_name": "SubscriptionCategoryNotFoundFault", "type": "structure", "members": {}, "documentation": "\nThe supplied category does not exist.
\n " } ], "documentation": "\nModifies an existing RDS event notification subscription. Note that you cannot modify the source identifiers using this call; to change \n source identifiers for a subscription, use the AddSourceIdentifierToSubscription and RemoveSourceIdentifierFromSubscription calls.
\nYou can see a list of the event categories for a given SourceType \n in the Events topic in the Amazon RDS User Guide \n or by using the DescribeEventCategories action.
\n\n The name of the option group to be modified.\n
\n ", "required": true }, "OptionsToInclude": { "shape_name": "OptionConfigurationList", "type": "list", "members": { "shape_name": "OptionConfiguration", "type": "structure", "members": { "OptionName": { "shape_name": "String", "type": "string", "documentation": "\n\n The configuration of options to include in a group. \n
\n ", "required": true }, "Port": { "shape_name": "IntegerOptional", "type": "integer", "documentation": "\n\n The optional port for the option.\n
\n " }, "DBSecurityGroupMemberships": { "shape_name": "DBSecurityGroupNameList", "type": "list", "members": { "shape_name": "String", "type": "string", "documentation": null, "xmlname": "DBSecurityGroupName" }, "documentation": "\n\n A list of DBSecurityGroupMemebrship name strings used for this option. \n
\n " }, "VpcSecurityGroupMemberships": { "shape_name": "VpcSecurityGroupIdList", "type": "list", "members": { "shape_name": "String", "type": "string", "documentation": null, "xmlname": "VpcSecurityGroupId" }, "documentation": "\n\n A list of VpcSecurityGroupMemebrship name strings used for this option. \n
\n " } }, "documentation": " \n\n A list of all available options\n
\n ", "xmlname": "OptionConfiguration" }, "documentation": "\n\n Options in this list are added to the Option Group or, if already present,\n the specified configuration is used to update the existing configuration.\n
\n " }, "OptionsToRemove": { "shape_name": "OptionNamesList", "type": "list", "members": { "shape_name": "String", "type": "string", "documentation": null }, "documentation": "\n\n Options in this list are removed from the Option Group.\n
\n " }, "ApplyImmediately": { "shape_name": "Boolean", "type": "boolean", "documentation": "\n\n Indicates whether the changes should be applied immediately,\n or during the next maintenance window for each instance associated with the Option Group.\n
\n " } }, "documentation": "\n\n
\n " }, "output": { "shape_name": "OptionGroupWrapper", "type": "structure", "members": { "OptionGroup": { "shape_name": "OptionGroup", "type": "structure", "members": { "OptionGroupName": { "shape_name": "String", "type": "string", "documentation": "\n\n Specifies the name of the option group.\n
\n " }, "OptionGroupDescription": { "shape_name": "String", "type": "string", "documentation": "\n\n Provides the description of the option group.\n
\n " }, "EngineName": { "shape_name": "String", "type": "string", "documentation": "\n\n Engine name that this option group can be applied to.\n
\n " }, "MajorEngineVersion": { "shape_name": "String", "type": "string", "documentation": "\n\n Indicates the major engine version associated with this option group.\n
\n " }, "Options": { "shape_name": "OptionsList", "type": "list", "members": { "shape_name": "Option", "type": "structure", "members": { "OptionName": { "shape_name": "String", "type": "string", "documentation": "\n\n The name of the option.\n
\n " }, "OptionDescription": { "shape_name": "String", "type": "string", "documentation": "\n\n The description of the option.\n
\n " }, "Port": { "shape_name": "IntegerOptional", "type": "integer", "documentation": "\n\n If required, the port configured for this option to use.\n
\n " }, "DBSecurityGroupMemberships": { "shape_name": "DBSecurityGroupMembershipList", "type": "list", "members": { "shape_name": "DBSecurityGroupMembership", "type": "structure", "members": { "DBSecurityGroupName": { "shape_name": "String", "type": "string", "documentation": "\n\n The name of the DB Security Group.\n
\n " }, "Status": { "shape_name": "String", "type": "string", "documentation": "\n\n The status of the DB Security Group.\n
\n " } }, "documentation": "\n\n This data type is used as a response element in the following actions:\n
\n\n If the Option requires access to a port, then this DB Security Group allows access to the port. \n
\n " }, "VpcSecurityGroupMemberships": { "shape_name": "VpcSecurityGroupMembershipList", "type": "list", "members": { "shape_name": "VpcSecurityGroupMembership", "type": "structure", "members": { "VpcSecurityGroupId": { "shape_name": "String", "type": "string", "documentation": "\nThe name of the VPC security group.
\n " }, "Status": { "shape_name": "String", "type": "string", "documentation": "\n\n The status of the VPC Security Group.\n
\n " } }, "documentation": "\nThis data type is used as a response element for queries on VPC security group membership.
\n ", "xmlname": "VpcSecurityGroupMembership" }, "documentation": "\n\n If the Option requires access to a port, then this VPC Security Group allows access to the port.\n
\n " } }, "documentation": "\n\n Option details.\n
\n", "xmlname": "Option" }, "documentation": "\n\n Indicates what options are available in the option group.\n
\n " }, "AllowsVpcAndNonVpcInstanceMemberships": { "shape_name": "Boolean", "type": "boolean", "documentation": "\n\n Indicates whether this option group can be applied to both VPC \n and non-VPC instances. The value 'true' indicates the option group \n can be applied to both VPC and non-VPC instances.\n
\n " }, "VpcId": { "shape_name": "String", "type": "string", "documentation": "\n\n If AllowsVpcAndNonVpcInstanceMemberships is 'false', this field is blank.\n If AllowsVpcAndNonVpcInstanceMemberships is 'true' and this field is blank, \n then this option group can be applied to both VPC and non-VPC instances.\n If this field contains a value, then this option group can only be \n applied to instances that are in the VPC indicated by this field.\n
\n " } }, "wrapper": true, "documentation": "\n\n
\n " } } }, "errors": [ { "shape_name": "InvalidOptionGroupStateFault", "type": "structure", "members": {}, "documentation": "\n\n The Option Group is not in the available state.\n
\n " }, { "shape_name": "OptionGroupNotFoundFault", "type": "structure", "members": {}, "documentation": " \n\n The specified option group could not be found. \n
\n " } ], "documentation": "\n\n Modifies an existing Option Group. \n
\n\n The DB Instance identifier.\n This value is stored as a lowercase string.\n
\nConstraints:
\nExample:
\n The number of days to retain automated backups.\n Setting this parameter to a positive number enables backups.\n Setting this parameter to 0 disables automated backups.\n
\n\n Default: 1\n
\nConstraints:
\n\n The daily time range during which automated backups are created\n if automated backups are enabled,\n using the BackupRetentionPeriod
parameter.\n
\n Default: A 30-minute window selected at random from an\n 8-hour block of time per region. The following list shows \n the time blocks for each region from which the default \n backup windows are assigned.\n
\n\n Constraints: Must be in the format hh24:mi-hh24:mi
. \n Times should be Universal Time Coordinated (UTC). \n Must not conflict with the preferred maintenance window. Must be at least 30 minutes.\n
\n\n
\n " }, "output": { "shape_name": "DBInstanceWrapper", "type": "structure", "members": { "DBInstance": { "shape_name": "DBInstance", "type": "structure", "members": { "DBInstanceIdentifier": { "shape_name": "String", "type": "string", "documentation": "\n\n Contains a user-supplied database identifier.\n This is the unique key that identifies a DB Instance.\n
\n " }, "DBInstanceClass": { "shape_name": "String", "type": "string", "documentation": "\n\n Contains the name of the compute and memory\n capacity class of the DB Instance.\n
\n " }, "Engine": { "shape_name": "String", "type": "string", "documentation": "\n\n Provides the name of the database engine to be used for this DB Instance.\n
\n " }, "DBInstanceStatus": { "shape_name": "String", "type": "string", "documentation": "\n\n Specifies the current state of this database.\n
\n " }, "MasterUsername": { "shape_name": "String", "type": "string", "documentation": "\n\n Contains the master username for the DB Instance.\n
\n " }, "DBName": { "shape_name": "String", "type": "string", "documentation": "\nThe meaning of this parameter differs according to the database engine you use.
\nMySQL
\n\n Contains the name of the initial database of this instance that was\n provided at create time, if one was specified when the\n DB Instance was created. This same name is returned for\n the life of the DB Instance.\n
\nType: String
\nOracle
\n\n Contains the Oracle System ID (SID) of the created DB Instance. \n
\n " }, "Endpoint": { "shape_name": "Endpoint", "type": "structure", "members": { "Address": { "shape_name": "String", "type": "string", "documentation": "\n\n Specifies the DNS address of the DB Instance.\n
\n " }, "Port": { "shape_name": "Integer", "type": "integer", "documentation": "\n\n Specifies the port that the database engine is listening on.\n
\n " } }, "documentation": "\n\n Specifies the connection endpoint.\n
\n " }, "AllocatedStorage": { "shape_name": "Integer", "type": "integer", "documentation": "\n\n Specifies the allocated storage size specified in gigabytes.\n
\n " }, "InstanceCreateTime": { "shape_name": "TStamp", "type": "timestamp", "documentation": "\n\n Provides the date and time the DB Instance was created.\n
\n " }, "PreferredBackupWindow": { "shape_name": "String", "type": "string", "documentation": "\n\n Specifies the daily time range during which automated backups are\n created if automated backups are enabled, as determined\n by the BackupRetentionPeriod
.\n
\n Specifies the number of days for which automatic DB Snapshots are retained.\n
\n " }, "DBSecurityGroups": { "shape_name": "DBSecurityGroupMembershipList", "type": "list", "members": { "shape_name": "DBSecurityGroupMembership", "type": "structure", "members": { "DBSecurityGroupName": { "shape_name": "String", "type": "string", "documentation": "\n\n The name of the DB Security Group.\n
\n " }, "Status": { "shape_name": "String", "type": "string", "documentation": "\n\n The status of the DB Security Group.\n
\n " } }, "documentation": "\n\n This data type is used as a response element in the following actions:\n
\n\n Provides List of DB Security Group elements containing only\n DBSecurityGroup.Name
and DBSecurityGroup.Status
subelements.\n
The name of the VPC security group.
\n " }, "Status": { "shape_name": "String", "type": "string", "documentation": "\n\n The status of the VPC Security Group.\n
\n " } }, "documentation": "\nThis data type is used as a response element for queries on VPC security group membership.
\n ", "xmlname": "VpcSecurityGroupMembership" }, "documentation": "\n\n Provides List of VPC security group elements \n that the DB Instance belongs to. \n
\n " }, "DBParameterGroups": { "shape_name": "DBParameterGroupStatusList", "type": "list", "members": { "shape_name": "DBParameterGroupStatus", "type": "structure", "members": { "DBParameterGroupName": { "shape_name": "String", "type": "string", "documentation": "\n\n The name of the DP Parameter Group.\n
\n " }, "ParameterApplyStatus": { "shape_name": "String", "type": "string", "documentation": "\n\n The status of parameter updates.\n
\n " } }, "documentation": "\n\n The status of the DB Parameter Group.\n
\nThis data type is used as a response element in the following actions:
\n\n Provides the list of DB Parameter Groups applied to this DB Instance.\n
\n " }, "AvailabilityZone": { "shape_name": "String", "type": "string", "documentation": "\n\n Specifies the name of the Availability Zone the DB Instance is located in.\n
\n " }, "DBSubnetGroup": { "shape_name": "DBSubnetGroup", "type": "structure", "members": { "DBSubnetGroupName": { "shape_name": "String", "type": "string", "documentation": "\n\n Specifies the name of the DB Subnet Group.\n
\n " }, "DBSubnetGroupDescription": { "shape_name": "String", "type": "string", "documentation": "\n\n Provides the description of the DB Subnet Group.\n
\n " }, "VpcId": { "shape_name": "String", "type": "string", "documentation": "\n\n Provides the VpcId of the DB Subnet Group.\n
\n " }, "SubnetGroupStatus": { "shape_name": "String", "type": "string", "documentation": "\n\n Provides the status of the DB Subnet Group.\n
\n " }, "Subnets": { "shape_name": "SubnetList", "type": "list", "members": { "shape_name": "Subnet", "type": "structure", "members": { "SubnetIdentifier": { "shape_name": "String", "type": "string", "documentation": "\n\n Specifies the identifier of the subnet.\n
\n " }, "SubnetAvailabilityZone": { "shape_name": "AvailabilityZone", "type": "structure", "members": { "Name": { "shape_name": "String", "type": "string", "documentation": "\n\n The name of the availability zone.\n
\n " }, "ProvisionedIopsCapable": { "shape_name": "Boolean", "type": "boolean", "documentation": "\n\n True indicates the availability zone is capable of provisioned IOPs.\n
\n " } }, "wrapper": true, "documentation": "\n\n Contains Availability Zone information. \n
\n\n This data type is used as an element in the following data type:\n
\n \n \n " }, "SubnetStatus": { "shape_name": "String", "type": "string", "documentation": "\n\n Specifies the status of the subnet.\n
\n " } }, "documentation": "\n\n This data type is used as a response element in the DescribeDBSubnetGroups action.\n
\n ", "xmlname": "Subnet" }, "documentation": "\n\n Contains a list of Subnet elements.\n
\n " } }, "wrapper": true, "documentation": "\n\n Provides the inforamtion of the subnet group associated with the DB instance, including the name, descrption and subnets in the subnet group.\n
\n " }, "PreferredMaintenanceWindow": { "shape_name": "String", "type": "string", "documentation": "\n\n Specifies the weekly time range (in UTC) during which\n system maintenance can occur.\n
\n " }, "PendingModifiedValues": { "shape_name": "PendingModifiedValues", "type": "structure", "members": { "DBInstanceClass": { "shape_name": "String", "type": "string", "documentation": "\n\n Contains the new DBInstanceClass
for the DB Instance\n that will be applied or is in progress.\n
\n Contains the new AllocatedStorage
size for the DB Instance\n that will be applied or is in progress.\n
\n Contains the pending or in-progress change of the master credentials for the DB Instance.\n
\n " }, "Port": { "shape_name": "IntegerOptional", "type": "integer", "documentation": "\n\n Specifies the pending port for the DB Instance.\n
\n " }, "BackupRetentionPeriod": { "shape_name": "IntegerOptional", "type": "integer", "documentation": "\n\n Specifies the pending number of days for which automated backups are retained.\n
\n " }, "MultiAZ": { "shape_name": "BooleanOptional", "type": "boolean", "documentation": "\n\n Indicates that the Single-AZ DB Instance is to change to a Multi-AZ deployment.\n
\n " }, "EngineVersion": { "shape_name": "String", "type": "string", "documentation": "\n\n Indicates the database engine version. \n
\n " }, "Iops": { "shape_name": "IntegerOptional", "type": "integer", "documentation": "\n\n Specifies the new Provisioned IOPS value for the DB Instance\n that will be applied or is being applied.\n
\n " }, "DBInstanceIdentifier": { "shape_name": "String", "type": "string", "documentation": "\n\n Contains the new DBInstanceIdentifier
for the DB Instance\n that will be applied or is in progress.\n
\n Specifies that changes to the DB Instance are pending.\n This element is only included when changes are pending.\n Specific changes are identified by subelements.\n
\n " }, "LatestRestorableTime": { "shape_name": "TStamp", "type": "timestamp", "documentation": "\n\n Specifies the latest time to which a database\n can be restored with point-in-time restore.\n
\n " }, "MultiAZ": { "shape_name": "Boolean", "type": "boolean", "documentation": "\n\n Specifies if the DB Instance is a Multi-AZ deployment.\n
\n " }, "EngineVersion": { "shape_name": "String", "type": "string", "documentation": "\n\n Indicates the database engine version.\n
\n " }, "AutoMinorVersionUpgrade": { "shape_name": "Boolean", "type": "boolean", "documentation": "\n\n Indicates that minor version patches are applied automatically.\n
\n " }, "ReadReplicaSourceDBInstanceIdentifier": { "shape_name": "String", "type": "string", "documentation": "\n\n Contains the identifier of the source DB Instance if this DB Instance is a Read Replica.\n
\n " }, "ReadReplicaDBInstanceIdentifiers": { "shape_name": "ReadReplicaDBInstanceIdentifierList", "type": "list", "members": { "shape_name": "String", "type": "string", "documentation": null, "xmlname": "ReadReplicaDBInstanceIdentifier" }, "documentation": "\n\n Contains one or more identifiers of the Read Replicas associated with this DB Instance.\n
\n " }, "LicenseModel": { "shape_name": "String", "type": "string", "documentation": "\n\n License model information for this DB Instance.\n
\n " }, "Iops": { "shape_name": "IntegerOptional", "type": "integer", "documentation": "\n\n Specifies the Provisioned IOPS (I/O operations per second) value.\n
\n " }, "OptionGroupMembership": { "shape_name": "OptionGroupMembership", "type": "structure", "members": { "OptionGroupName": { "shape_name": "String", "type": "string", "documentation": "\n\n The name of the option group that the instance belongs to.\n
\n " }, "Status": { "shape_name": "String", "type": "string", "documentation": "\n\n The status of the DB Instance's option group membership (e.g. in-sync, pending, pending-maintenance, applying).\n
\n " } }, "documentation": "\n\n Specifies the name and status of the option group that this instance belongs to. \n
\n " }, "CharacterSetName": { "shape_name": "String", "type": "string", "documentation": "\n\n If present, specifies the name of the character set that this instance is associated with. \n
\n " }, "SecondaryAvailabilityZone": { "shape_name": "String", "type": "string", "documentation": "\n\n If present, specifies the name of the secondary Availability Zone \n for a DB instance with multi-AZ support.\n
\n " }, "PubliclyAccessible": { "shape_name": "Boolean", "type": "boolean", "documentation": null } }, "wrapper": true, "documentation": "\n\n Contains the result of a successful invocation of the following actions:\n
\n \nThis data type is used as a response element in the DescribeDBInstances action.
\n " } } }, "errors": [ { "shape_name": "InvalidDBInstanceStateFault", "type": "structure", "members": {}, "documentation": "\n\n The specified DB Instance is not in the available state.\n
\n " }, { "shape_name": "DBInstanceNotFoundFault", "type": "structure", "members": {}, "documentation": "\n\n DBInstanceIdentifier does not refer to an existing DB Instance.\n
\n " } ], "documentation": "\n\n Promotes a Read Replica DB Instance to a standalone DB Instance.\n
\n\n The ID of the Reserved DB Instance offering to purchase.\n
\nExample: 438012d3-4052-4cc7-b2e3-8d3372e0e706
\n ", "required": true }, "ReservedDBInstanceId": { "shape_name": "String", "type": "string", "documentation": "\n\n Customer-specified identifier to track this reservation.\n
\nExample: myreservationID
\n " }, "DBInstanceCount": { "shape_name": "IntegerOptional", "type": "integer", "documentation": "\n\n The number of instances to reserve.\n
\nDefault: 1
\n \n
\n " }, "output": { "shape_name": "ReservedDBInstanceWrapper", "type": "structure", "members": { "ReservedDBInstance": { "shape_name": "ReservedDBInstance", "type": "structure", "members": { "ReservedDBInstanceId": { "shape_name": "String", "type": "string", "documentation": "\n\n The unique identifier for the reservation.\n
\n " }, "ReservedDBInstancesOfferingId": { "shape_name": "String", "type": "string", "documentation": "\n\n The offering identifier.\n
\n " }, "DBInstanceClass": { "shape_name": "String", "type": "string", "documentation": "\n\n The DB instance class for the reserved DB Instance.\n
\n " }, "StartTime": { "shape_name": "TStamp", "type": "timestamp", "documentation": "\n\n The time the reservation started.\n
\n " }, "Duration": { "shape_name": "Integer", "type": "integer", "documentation": "\n\n The duration of the reservation in seconds.\n
\n " }, "FixedPrice": { "shape_name": "Double", "type": "double", "documentation": "\n\n The fixed price charged for this reserved DB Instance.\n
\n " }, "UsagePrice": { "shape_name": "Double", "type": "double", "documentation": "\n\n The hourly price charged for this reserved DB Instance.\n
\n " }, "CurrencyCode": { "shape_name": "String", "type": "string", "documentation": "\n\n The currency code for the reserved DB Instance.\n
\n " }, "DBInstanceCount": { "shape_name": "Integer", "type": "integer", "documentation": "\n\n The number of reserved DB Instances.\n
\n " }, "ProductDescription": { "shape_name": "String", "type": "string", "documentation": "\n\n The description of the reserved DB Instance.\n
\n " }, "OfferingType": { "shape_name": "String", "type": "string", "documentation": " \n\n The offering type of this reserved DB Instance. \n
\n " }, "MultiAZ": { "shape_name": "Boolean", "type": "boolean", "documentation": "\n\n Indicates if the reservation applies to Multi-AZ deployments.\n
\n " }, "State": { "shape_name": "String", "type": "string", "documentation": "\n\n The state of the reserved DB Instance.\n
\n " }, "RecurringCharges": { "shape_name": "RecurringChargeList", "type": "list", "members": { "shape_name": "RecurringCharge", "type": "structure", "members": { "RecurringChargeAmount": { "shape_name": "Double", "type": "double", "documentation": "\n\n The amount of the recurring charge.\n
\n " }, "RecurringChargeFrequency": { "shape_name": "String", "type": "string", "documentation": "\n\n The frequency of the recurring charge.\n
\n " } }, "wrapper": true, "documentation": "\n\n This data type is used as a response element in the \n DescribeReservedDBInstances and DescribeReservedDBInstancesOfferings actions.\n
\n ", "xmlname": "RecurringCharge" }, "documentation": " \n\n The recurring price charged to run this reserved DB Instance. \n
\n " } }, "wrapper": true, "documentation": "\n\n This data type is used as a response element in the \n DescribeReservedDBInstances and \n PurchaseReservedDBInstancesOffering actions.\n
\n " } } }, "errors": [ { "shape_name": "ReservedDBInstancesOfferingNotFoundFault", "type": "structure", "members": {}, "documentation": "\n\n Specified offering does not exist.\n
\n " }, { "shape_name": "ReservedDBInstanceAlreadyExistsFault", "type": "structure", "members": {}, "documentation": "\n\n User already has a reservation with the given identifier.\n
\n " }, { "shape_name": "ReservedDBInstanceQuotaExceededFault", "type": "structure", "members": {}, "documentation": "\n\n Request would exceed the user's DB Instance quota.\n
\n " } ], "documentation": "\n\n Purchases a reserved DB Instance offering.\n
\n\n The DB Instance identifier.\n This parameter is stored as a lowercase string.\n
\nConstraints:
\n\n When true
, the reboot will be conducted through a MultiAZ failover.\n
Constraint: You cannot specify true
if the instance is not configured for MultiAZ.
\n\n
\n " }, "output": { "shape_name": "DBInstanceWrapper", "type": "structure", "members": { "DBInstance": { "shape_name": "DBInstance", "type": "structure", "members": { "DBInstanceIdentifier": { "shape_name": "String", "type": "string", "documentation": "\n\n Contains a user-supplied database identifier.\n This is the unique key that identifies a DB Instance.\n
\n " }, "DBInstanceClass": { "shape_name": "String", "type": "string", "documentation": "\n\n Contains the name of the compute and memory\n capacity class of the DB Instance.\n
\n " }, "Engine": { "shape_name": "String", "type": "string", "documentation": "\n\n Provides the name of the database engine to be used for this DB Instance.\n
\n " }, "DBInstanceStatus": { "shape_name": "String", "type": "string", "documentation": "\n\n Specifies the current state of this database.\n
\n " }, "MasterUsername": { "shape_name": "String", "type": "string", "documentation": "\n\n Contains the master username for the DB Instance.\n
\n " }, "DBName": { "shape_name": "String", "type": "string", "documentation": "\nThe meaning of this parameter differs according to the database engine you use.
\nMySQL
\n\n Contains the name of the initial database of this instance that was\n provided at create time, if one was specified when the\n DB Instance was created. This same name is returned for\n the life of the DB Instance.\n
\nType: String
\nOracle
\n\n Contains the Oracle System ID (SID) of the created DB Instance. \n
\n " }, "Endpoint": { "shape_name": "Endpoint", "type": "structure", "members": { "Address": { "shape_name": "String", "type": "string", "documentation": "\n\n Specifies the DNS address of the DB Instance.\n
\n " }, "Port": { "shape_name": "Integer", "type": "integer", "documentation": "\n\n Specifies the port that the database engine is listening on.\n
\n " } }, "documentation": "\n\n Specifies the connection endpoint.\n
\n " }, "AllocatedStorage": { "shape_name": "Integer", "type": "integer", "documentation": "\n\n Specifies the allocated storage size specified in gigabytes.\n
\n " }, "InstanceCreateTime": { "shape_name": "TStamp", "type": "timestamp", "documentation": "\n\n Provides the date and time the DB Instance was created.\n
\n " }, "PreferredBackupWindow": { "shape_name": "String", "type": "string", "documentation": "\n\n Specifies the daily time range during which automated backups are\n created if automated backups are enabled, as determined\n by the BackupRetentionPeriod
.\n
\n Specifies the number of days for which automatic DB Snapshots are retained.\n
\n " }, "DBSecurityGroups": { "shape_name": "DBSecurityGroupMembershipList", "type": "list", "members": { "shape_name": "DBSecurityGroupMembership", "type": "structure", "members": { "DBSecurityGroupName": { "shape_name": "String", "type": "string", "documentation": "\n\n The name of the DB Security Group.\n
\n " }, "Status": { "shape_name": "String", "type": "string", "documentation": "\n\n The status of the DB Security Group.\n
\n " } }, "documentation": "\n\n This data type is used as a response element in the following actions:\n
\n\n Provides List of DB Security Group elements containing only\n DBSecurityGroup.Name
and DBSecurityGroup.Status
subelements.\n
The name of the VPC security group.
\n " }, "Status": { "shape_name": "String", "type": "string", "documentation": "\n\n The status of the VPC Security Group.\n
\n " } }, "documentation": "\nThis data type is used as a response element for queries on VPC security group membership.
\n ", "xmlname": "VpcSecurityGroupMembership" }, "documentation": "\n\n Provides List of VPC security group elements \n that the DB Instance belongs to. \n
\n " }, "DBParameterGroups": { "shape_name": "DBParameterGroupStatusList", "type": "list", "members": { "shape_name": "DBParameterGroupStatus", "type": "structure", "members": { "DBParameterGroupName": { "shape_name": "String", "type": "string", "documentation": "\n\n The name of the DP Parameter Group.\n
\n " }, "ParameterApplyStatus": { "shape_name": "String", "type": "string", "documentation": "\n\n The status of parameter updates.\n
\n " } }, "documentation": "\n\n The status of the DB Parameter Group.\n
\nThis data type is used as a response element in the following actions:
\n\n Provides the list of DB Parameter Groups applied to this DB Instance.\n
\n " }, "AvailabilityZone": { "shape_name": "String", "type": "string", "documentation": "\n\n Specifies the name of the Availability Zone the DB Instance is located in.\n
\n " }, "DBSubnetGroup": { "shape_name": "DBSubnetGroup", "type": "structure", "members": { "DBSubnetGroupName": { "shape_name": "String", "type": "string", "documentation": "\n\n Specifies the name of the DB Subnet Group.\n
\n " }, "DBSubnetGroupDescription": { "shape_name": "String", "type": "string", "documentation": "\n\n Provides the description of the DB Subnet Group.\n
\n " }, "VpcId": { "shape_name": "String", "type": "string", "documentation": "\n\n Provides the VpcId of the DB Subnet Group.\n
\n " }, "SubnetGroupStatus": { "shape_name": "String", "type": "string", "documentation": "\n\n Provides the status of the DB Subnet Group.\n
\n " }, "Subnets": { "shape_name": "SubnetList", "type": "list", "members": { "shape_name": "Subnet", "type": "structure", "members": { "SubnetIdentifier": { "shape_name": "String", "type": "string", "documentation": "\n\n Specifies the identifier of the subnet.\n
\n " }, "SubnetAvailabilityZone": { "shape_name": "AvailabilityZone", "type": "structure", "members": { "Name": { "shape_name": "String", "type": "string", "documentation": "\n\n The name of the availability zone.\n
\n " }, "ProvisionedIopsCapable": { "shape_name": "Boolean", "type": "boolean", "documentation": "\n\n True indicates the availability zone is capable of provisioned IOPs.\n
\n " } }, "wrapper": true, "documentation": "\n\n Contains Availability Zone information. \n
\n\n This data type is used as an element in the following data type:\n
\n \n \n " }, "SubnetStatus": { "shape_name": "String", "type": "string", "documentation": "\n\n Specifies the status of the subnet.\n
\n " } }, "documentation": "\n\n This data type is used as a response element in the DescribeDBSubnetGroups action.\n
\n ", "xmlname": "Subnet" }, "documentation": "\n\n Contains a list of Subnet elements.\n
\n " } }, "wrapper": true, "documentation": "\n\n Provides the inforamtion of the subnet group associated with the DB instance, including the name, descrption and subnets in the subnet group.\n
\n " }, "PreferredMaintenanceWindow": { "shape_name": "String", "type": "string", "documentation": "\n\n Specifies the weekly time range (in UTC) during which\n system maintenance can occur.\n
\n " }, "PendingModifiedValues": { "shape_name": "PendingModifiedValues", "type": "structure", "members": { "DBInstanceClass": { "shape_name": "String", "type": "string", "documentation": "\n\n Contains the new DBInstanceClass
for the DB Instance\n that will be applied or is in progress.\n
\n Contains the new AllocatedStorage
size for the DB Instance\n that will be applied or is in progress.\n
\n Contains the pending or in-progress change of the master credentials for the DB Instance.\n
\n " }, "Port": { "shape_name": "IntegerOptional", "type": "integer", "documentation": "\n\n Specifies the pending port for the DB Instance.\n
\n " }, "BackupRetentionPeriod": { "shape_name": "IntegerOptional", "type": "integer", "documentation": "\n\n Specifies the pending number of days for which automated backups are retained.\n
\n " }, "MultiAZ": { "shape_name": "BooleanOptional", "type": "boolean", "documentation": "\n\n Indicates that the Single-AZ DB Instance is to change to a Multi-AZ deployment.\n
\n " }, "EngineVersion": { "shape_name": "String", "type": "string", "documentation": "\n\n Indicates the database engine version. \n
\n " }, "Iops": { "shape_name": "IntegerOptional", "type": "integer", "documentation": "\n\n Specifies the new Provisioned IOPS value for the DB Instance\n that will be applied or is being applied.\n
\n " }, "DBInstanceIdentifier": { "shape_name": "String", "type": "string", "documentation": "\n\n Contains the new DBInstanceIdentifier
for the DB Instance\n that will be applied or is in progress.\n
\n Specifies that changes to the DB Instance are pending.\n This element is only included when changes are pending.\n Specific changes are identified by subelements.\n
\n " }, "LatestRestorableTime": { "shape_name": "TStamp", "type": "timestamp", "documentation": "\n\n Specifies the latest time to which a database\n can be restored with point-in-time restore.\n
\n " }, "MultiAZ": { "shape_name": "Boolean", "type": "boolean", "documentation": "\n\n Specifies if the DB Instance is a Multi-AZ deployment.\n
\n " }, "EngineVersion": { "shape_name": "String", "type": "string", "documentation": "\n\n Indicates the database engine version.\n
\n " }, "AutoMinorVersionUpgrade": { "shape_name": "Boolean", "type": "boolean", "documentation": "\n\n Indicates that minor version patches are applied automatically.\n
\n " }, "ReadReplicaSourceDBInstanceIdentifier": { "shape_name": "String", "type": "string", "documentation": "\n\n Contains the identifier of the source DB Instance if this DB Instance is a Read Replica.\n
\n " }, "ReadReplicaDBInstanceIdentifiers": { "shape_name": "ReadReplicaDBInstanceIdentifierList", "type": "list", "members": { "shape_name": "String", "type": "string", "documentation": null, "xmlname": "ReadReplicaDBInstanceIdentifier" }, "documentation": "\n\n Contains one or more identifiers of the Read Replicas associated with this DB Instance.\n
\n " }, "LicenseModel": { "shape_name": "String", "type": "string", "documentation": "\n\n License model information for this DB Instance.\n
\n " }, "Iops": { "shape_name": "IntegerOptional", "type": "integer", "documentation": "\n\n Specifies the Provisioned IOPS (I/O operations per second) value.\n
\n " }, "OptionGroupMembership": { "shape_name": "OptionGroupMembership", "type": "structure", "members": { "OptionGroupName": { "shape_name": "String", "type": "string", "documentation": "\n\n The name of the option group that the instance belongs to.\n
\n " }, "Status": { "shape_name": "String", "type": "string", "documentation": "\n\n The status of the DB Instance's option group membership (e.g. in-sync, pending, pending-maintenance, applying).\n
\n " } }, "documentation": "\n\n Specifies the name and status of the option group that this instance belongs to. \n
\n " }, "CharacterSetName": { "shape_name": "String", "type": "string", "documentation": "\n\n If present, specifies the name of the character set that this instance is associated with. \n
\n " }, "SecondaryAvailabilityZone": { "shape_name": "String", "type": "string", "documentation": "\n\n If present, specifies the name of the secondary Availability Zone \n for a DB instance with multi-AZ support.\n
\n " }, "PubliclyAccessible": { "shape_name": "Boolean", "type": "boolean", "documentation": null } }, "wrapper": true, "documentation": "\n\n Contains the result of a successful invocation of the following actions:\n
\n \nThis data type is used as a response element in the DescribeDBInstances action.
\n " } } }, "errors": [ { "shape_name": "InvalidDBInstanceStateFault", "type": "structure", "members": {}, "documentation": "\n\n The specified DB Instance is not in the available state.\n
\n " }, { "shape_name": "DBInstanceNotFoundFault", "type": "structure", "members": {}, "documentation": "\n\n DBInstanceIdentifier does not refer to an existing DB Instance.\n
\n " } ], "documentation": "\n\n Reboots a previously provisioned RDS instance. This API results in the\n application of modified DBParameterGroup parameters with ApplyStatus of pending-reboot to the\n RDS instance. This action is taken as soon as possible, and results in a momentary outage to the RDS\n instance during which the RDS instance status is set to rebooting. If the RDS instance is configured \n for MultiAZ, it is possible that the reboot will be conducted through a failover. A DBInstance event \n is created when the reboot is completed.\n
\nThe name of the RDS event notification subscription you want to remove a source identifier from.
\n ", "required": true }, "SourceIdentifier": { "shape_name": "String", "type": "string", "documentation": "\n\n The source identifier to be removed from the subscription, such as the DB instance identifier \n for a DB instance or the name of a security group.\n
\n\n ", "required": true } }, "documentation": " \n \n " }, "output": { "shape_name": "EventSubscriptionWrapper", "type": "structure", "members": { "EventSubscription": { "shape_name": "EventSubscription", "type": "structure", "members": { "Id": { "shape_name": "String", "type": "string", "documentation": "\nNot used.
\n " }, "CustomerAwsId": { "shape_name": "String", "type": "string", "documentation": "\nThe AWS customer account associated with the RDS event notification subscription.
\n " }, "CustSubscriptionId": { "shape_name": "String", "type": "string", "documentation": "\nThe RDS event notification subscription Id.
\n " }, "SnsTopicArn": { "shape_name": "String", "type": "string", "documentation": "\nThe topic ARN of the RDS event notification subscription.
\n " }, "Status": { "shape_name": "String", "type": "string", "documentation": "\nThe status of the RDS event notification subscription.
\nConstraints:
\nCan be one of the following: creating | modifying | deleting | active | no-permission | topic-not-exist
\nThe status \"no-permission\" indicates that RDS no longer has permission to post to the SNS topic. The status \n \"topic-not-exist\" indicates that the topic was deleted after the subscription was created.
\n " }, "SubscriptionCreationTime": { "shape_name": "String", "type": "string", "documentation": "\nThe time the RDS event notification subscription was created.
\n " }, "SourceType": { "shape_name": "String", "type": "string", "documentation": "\nThe source type for the RDS event notification subscription.
\n " }, "SourceIdsList": { "shape_name": "SourceIdsList", "type": "list", "members": { "shape_name": "String", "type": "string", "documentation": null, "xmlname": "SourceId" }, "documentation": "\nA list of source Ids for the RDS event notification subscription.
\n " }, "EventCategoriesList": { "shape_name": "EventCategoriesList", "type": "list", "members": { "shape_name": "String", "type": "string", "documentation": null, "xmlname": "EventCategory" }, "documentation": "\nA list of event categories for the RDS event notification subscription.
\n " }, "Enabled": { "shape_name": "Boolean", "type": "boolean", "documentation": "\nA Boolean value indicating if the subscription is enabled. True indicates the subscription is enabled.
\n " } }, "wrapper": true, "documentation": "\nContains the results of a successful invocation of the DescribeEventSubscriptions action.
\n " } } }, "errors": [ { "shape_name": "SubscriptionNotFoundFault", "type": "structure", "members": {}, "documentation": "\nThe subscription name does not exist.
\n " }, { "shape_name": "SourceNotFoundFault", "type": "structure", "members": {}, "documentation": "\nThe requested source could not be found.
\n " } ], "documentation": "\nRemoves a source identifier from an existing RDS event notification subscription.
\nThe DB Instance the tags will be removed from.
\n ", "required": true }, "TagKeys": { "shape_name": "KeyList", "type": "list", "members": { "shape_name": "String", "type": "string", "documentation": null }, "documentation": "\nThe tag key (name) of the tag to be removed.
\n ", "required": true } }, "documentation": "\n \n " }, "output": null, "errors": [ { "shape_name": "DBInstanceNotFoundFault", "type": "structure", "members": {}, "documentation": "\n\n DBInstanceIdentifier does not refer to an existing DB Instance.\n
\n " }, { "shape_name": "DBSnapshotNotFoundFault", "type": "structure", "members": {}, "documentation": "\n\n DBSnapshotIdentifier does not refer to an existing DB Snapshot.\n
\n " } ], "documentation": "\nRemoves metadata tags from a DB Instance.
\nFor an overview on tagging DB Instances, see DB Instance Tags.
\n " }, "ResetDBParameterGroup": { "name": "ResetDBParameterGroup", "input": { "shape_name": "ResetDBParameterGroupMessage", "type": "structure", "members": { "DBParameterGroupName": { "shape_name": "String", "type": "string", "documentation": "\n\n The name of the DB Parameter Group.\n
\nConstraints:
\n\n Specifies whether (true
) or not (false
) to reset all parameters\n in the DB Parameter Group to default values.\n
Default: true
\n Specifies the name of the parameter.\n
\n " }, "ParameterValue": { "shape_name": "String", "type": "string", "documentation": "\n\n Specifies the value of the parameter.\n
\n " }, "Description": { "shape_name": "String", "type": "string", "documentation": "\n\n Provides a description of the parameter.\n
\n " }, "Source": { "shape_name": "String", "type": "string", "documentation": "\n\n Indicates the source of the parameter value.\n
\n " }, "ApplyType": { "shape_name": "String", "type": "string", "documentation": "\n\n Specifies the engine specific parameters type.\n
\n " }, "DataType": { "shape_name": "String", "type": "string", "documentation": "\n\n Specifies the valid data type for the parameter.\n
\n " }, "AllowedValues": { "shape_name": "String", "type": "string", "documentation": "\n\n Specifies the valid range of values for the parameter.\n
\n " }, "IsModifiable": { "shape_name": "Boolean", "type": "boolean", "documentation": "\n\n Indicates whether (true
) or not (false
) the parameter can be modified.\n Some parameters have security or operational implications\n that prevent them from being changed.\n
\n The earliest engine version to which the parameter can apply.\n
\n " }, "ApplyMethod": { "shape_name": "ApplyMethod", "type": "string", "enum": [ "immediate", "pending-reboot" ], "documentation": "\n\n Indicates when to apply parameter updates.\n
\n " } }, "documentation": "\n\n This data type is used as a request parameter in the\n ModifyDBParameterGroup and ResetDBParameterGroup actions.\n
\nThis data type is used as a response element in the \n DescribeEngineDefaultParameters and DescribeDBParameters actions.
\n ", "xmlname": "Parameter" }, "documentation": "\n\n An array of parameter names, values, and the apply method\n for the parameter update. At least one parameter name,\n value, and apply method must be supplied; subsequent arguments are optional.\n A maximum of 20 parameters may be modified in a single request.\n
\nMySQL
\nValid Values (for Apply method): immediate
| pending-reboot
You can use the immediate value with dynamic parameters only. You can use \n the pending-reboot
value for both dynamic and static parameters, and changes \n are applied when DB Instance reboots.
Oracle
\nValid Values (for Apply method): pending-reboot
\n\n
\n " }, "output": { "shape_name": "DBParameterGroupNameMessage", "type": "structure", "members": { "DBParameterGroupName": { "shape_name": "String", "type": "string", "documentation": "\n\n The name of the DB Parameter Group.\n
\n " } }, "documentation": "\n\n Contains the result of a successful invocation of the \n ModifyDBParameterGroup or ResetDBParameterGroup action.\n
\n " }, "errors": [ { "shape_name": "InvalidDBParameterGroupStateFault", "type": "structure", "members": {}, "documentation": "\n\n The DB Parameter Group cannot be deleted because it is in use.\n
\n " }, { "shape_name": "DBParameterGroupNotFoundFault", "type": "structure", "members": {}, "documentation": "\n\n DBParameterGroupName does not refer to an\n existing DB Parameter Group.\n
\n " } ], "documentation": "\n\n Modifies the parameters of a DBParameterGroup to the engine/system default value. To\n reset specific parameters submit a list of the following: ParameterName and ApplyMethod. To reset the\n entire DBParameterGroup specify the DBParameterGroup name and ResetAllParameters parameters.\n When resetting the entire group, dynamic parameters are updated immediately and static parameters\n are set to pending-reboot to take effect on the next DB instance restart or RebootDBInstance request.\n
\n\n The identifier for the DB Snapshot to restore from.\n
\nConstraints:
\n\n Name of the DB Instance to create from the DB Snapshot.\n This parameter isn't case sensitive.\n
\nConstraints:
\nExample: my-snapshot-id
\n The compute and memory capacity of the Amazon RDS DB instance.\n
\nValid Values: db.t1.micro | db.m1.small | db.m1.medium | db.m1.large | db.m1.xlarge | db.m2.2xlarge | db.m2.4xlarge
\n The port number on which the database accepts connections.\n
\nDefault: The same port as the original DB Instance
\nConstraints: Value must be 1150-65535
\n The EC2 Availability Zone that the database instance will be created in.\n
\nDefault: A random, system-chosen Availability Zone.
\nConstraint: You cannot specify the AvailabilityZone parameter if the MultiAZ parameter is set to true
.
Example: us-east-1a
\n The DB Subnet Group name to use for the new instance.\n
\n " }, "MultiAZ": { "shape_name": "BooleanOptional", "type": "boolean", "documentation": "\n\n Specifies if the DB Instance is a Multi-AZ deployment.\n
\nConstraint: You cannot specify the AvailabilityZone parameter if the MultiAZ parameter is set to true
.
\n Indicates that minor version upgrades will be applied\n automatically to the DB Instance during the maintenance window.\n
\n " }, "LicenseModel": { "shape_name": "String", "type": "string", "documentation": "\n\n License model information for the restored DB Instance.\n
\n\n Default: Same as source.\n
\n\n Valid values: license-included
| bring-your-own-license
| general-public-license
\n
\n The database name for the restored DB Instance.\n
\nThis parameter doesn't apply to the MySQL engine.
\n\n The database engine to use for the new instance.\n
\nDefault: The same as source
\nConstraint: Must be compatible with the engine of the source
\nExample: oracle-ee
\n The amount of Provisioned IOPS (input/output operations per second) to be initially allocated for the\n DB Instance. \n
\nConstraints: Must be an integer greater than 1000.
\n \n " }, "OptionGroupName": { "shape_name": "String", "type": "string", "documentation": null } }, "documentation": "\n\n\n
\n " }, "output": { "shape_name": "DBInstanceWrapper", "type": "structure", "members": { "DBInstance": { "shape_name": "DBInstance", "type": "structure", "members": { "DBInstanceIdentifier": { "shape_name": "String", "type": "string", "documentation": "\n\n Contains a user-supplied database identifier.\n This is the unique key that identifies a DB Instance.\n
\n " }, "DBInstanceClass": { "shape_name": "String", "type": "string", "documentation": "\n\n Contains the name of the compute and memory\n capacity class of the DB Instance.\n
\n " }, "Engine": { "shape_name": "String", "type": "string", "documentation": "\n\n Provides the name of the database engine to be used for this DB Instance.\n
\n " }, "DBInstanceStatus": { "shape_name": "String", "type": "string", "documentation": "\n\n Specifies the current state of this database.\n
\n " }, "MasterUsername": { "shape_name": "String", "type": "string", "documentation": "\n\n Contains the master username for the DB Instance.\n
\n " }, "DBName": { "shape_name": "String", "type": "string", "documentation": "\nThe meaning of this parameter differs according to the database engine you use.
\nMySQL
\n\n Contains the name of the initial database of this instance that was\n provided at create time, if one was specified when the\n DB Instance was created. This same name is returned for\n the life of the DB Instance.\n
\nType: String
\nOracle
\n\n Contains the Oracle System ID (SID) of the created DB Instance. \n
\n " }, "Endpoint": { "shape_name": "Endpoint", "type": "structure", "members": { "Address": { "shape_name": "String", "type": "string", "documentation": "\n\n Specifies the DNS address of the DB Instance.\n
\n " }, "Port": { "shape_name": "Integer", "type": "integer", "documentation": "\n\n Specifies the port that the database engine is listening on.\n
\n " } }, "documentation": "\n\n Specifies the connection endpoint.\n
\n " }, "AllocatedStorage": { "shape_name": "Integer", "type": "integer", "documentation": "\n\n Specifies the allocated storage size specified in gigabytes.\n
\n " }, "InstanceCreateTime": { "shape_name": "TStamp", "type": "timestamp", "documentation": "\n\n Provides the date and time the DB Instance was created.\n
\n " }, "PreferredBackupWindow": { "shape_name": "String", "type": "string", "documentation": "\n\n Specifies the daily time range during which automated backups are\n created if automated backups are enabled, as determined\n by the BackupRetentionPeriod
.\n
\n Specifies the number of days for which automatic DB Snapshots are retained.\n
\n " }, "DBSecurityGroups": { "shape_name": "DBSecurityGroupMembershipList", "type": "list", "members": { "shape_name": "DBSecurityGroupMembership", "type": "structure", "members": { "DBSecurityGroupName": { "shape_name": "String", "type": "string", "documentation": "\n\n The name of the DB Security Group.\n
\n " }, "Status": { "shape_name": "String", "type": "string", "documentation": "\n\n The status of the DB Security Group.\n
\n " } }, "documentation": "\n\n This data type is used as a response element in the following actions:\n
\n\n Provides List of DB Security Group elements containing only\n DBSecurityGroup.Name
and DBSecurityGroup.Status
subelements.\n
The name of the VPC security group.
\n " }, "Status": { "shape_name": "String", "type": "string", "documentation": "\n\n The status of the VPC Security Group.\n
\n " } }, "documentation": "\nThis data type is used as a response element for queries on VPC security group membership.
\n ", "xmlname": "VpcSecurityGroupMembership" }, "documentation": "\n\n Provides List of VPC security group elements \n that the DB Instance belongs to. \n
\n " }, "DBParameterGroups": { "shape_name": "DBParameterGroupStatusList", "type": "list", "members": { "shape_name": "DBParameterGroupStatus", "type": "structure", "members": { "DBParameterGroupName": { "shape_name": "String", "type": "string", "documentation": "\n\n The name of the DP Parameter Group.\n
\n " }, "ParameterApplyStatus": { "shape_name": "String", "type": "string", "documentation": "\n\n The status of parameter updates.\n
\n " } }, "documentation": "\n\n The status of the DB Parameter Group.\n
\nThis data type is used as a response element in the following actions:
\n\n Provides the list of DB Parameter Groups applied to this DB Instance.\n
\n " }, "AvailabilityZone": { "shape_name": "String", "type": "string", "documentation": "\n\n Specifies the name of the Availability Zone the DB Instance is located in.\n
\n " }, "DBSubnetGroup": { "shape_name": "DBSubnetGroup", "type": "structure", "members": { "DBSubnetGroupName": { "shape_name": "String", "type": "string", "documentation": "\n\n Specifies the name of the DB Subnet Group.\n
\n " }, "DBSubnetGroupDescription": { "shape_name": "String", "type": "string", "documentation": "\n\n Provides the description of the DB Subnet Group.\n
\n " }, "VpcId": { "shape_name": "String", "type": "string", "documentation": "\n\n Provides the VpcId of the DB Subnet Group.\n
\n " }, "SubnetGroupStatus": { "shape_name": "String", "type": "string", "documentation": "\n\n Provides the status of the DB Subnet Group.\n
\n " }, "Subnets": { "shape_name": "SubnetList", "type": "list", "members": { "shape_name": "Subnet", "type": "structure", "members": { "SubnetIdentifier": { "shape_name": "String", "type": "string", "documentation": "\n\n Specifies the identifier of the subnet.\n
\n " }, "SubnetAvailabilityZone": { "shape_name": "AvailabilityZone", "type": "structure", "members": { "Name": { "shape_name": "String", "type": "string", "documentation": "\n\n The name of the availability zone.\n
\n " }, "ProvisionedIopsCapable": { "shape_name": "Boolean", "type": "boolean", "documentation": "\n\n True indicates the availability zone is capable of provisioned IOPs.\n
\n " } }, "wrapper": true, "documentation": "\n\n Contains Availability Zone information. \n
\n\n This data type is used as an element in the following data type:\n
\n \n \n " }, "SubnetStatus": { "shape_name": "String", "type": "string", "documentation": "\n\n Specifies the status of the subnet.\n
\n " } }, "documentation": "\n\n This data type is used as a response element in the DescribeDBSubnetGroups action.\n
\n ", "xmlname": "Subnet" }, "documentation": "\n\n Contains a list of Subnet elements.\n
\n " } }, "wrapper": true, "documentation": "\n\n Provides the inforamtion of the subnet group associated with the DB instance, including the name, descrption and subnets in the subnet group.\n
\n " }, "PreferredMaintenanceWindow": { "shape_name": "String", "type": "string", "documentation": "\n\n Specifies the weekly time range (in UTC) during which\n system maintenance can occur.\n
\n " }, "PendingModifiedValues": { "shape_name": "PendingModifiedValues", "type": "structure", "members": { "DBInstanceClass": { "shape_name": "String", "type": "string", "documentation": "\n\n Contains the new DBInstanceClass
for the DB Instance\n that will be applied or is in progress.\n
\n Contains the new AllocatedStorage
size for the DB Instance\n that will be applied or is in progress.\n
\n Contains the pending or in-progress change of the master credentials for the DB Instance.\n
\n " }, "Port": { "shape_name": "IntegerOptional", "type": "integer", "documentation": "\n\n Specifies the pending port for the DB Instance.\n
\n " }, "BackupRetentionPeriod": { "shape_name": "IntegerOptional", "type": "integer", "documentation": "\n\n Specifies the pending number of days for which automated backups are retained.\n
\n " }, "MultiAZ": { "shape_name": "BooleanOptional", "type": "boolean", "documentation": "\n\n Indicates that the Single-AZ DB Instance is to change to a Multi-AZ deployment.\n
\n " }, "EngineVersion": { "shape_name": "String", "type": "string", "documentation": "\n\n Indicates the database engine version. \n
\n " }, "Iops": { "shape_name": "IntegerOptional", "type": "integer", "documentation": "\n\n Specifies the new Provisioned IOPS value for the DB Instance\n that will be applied or is being applied.\n
\n " }, "DBInstanceIdentifier": { "shape_name": "String", "type": "string", "documentation": "\n\n Contains the new DBInstanceIdentifier
for the DB Instance\n that will be applied or is in progress.\n
\n Specifies that changes to the DB Instance are pending.\n This element is only included when changes are pending.\n Specific changes are identified by subelements.\n
\n " }, "LatestRestorableTime": { "shape_name": "TStamp", "type": "timestamp", "documentation": "\n\n Specifies the latest time to which a database\n can be restored with point-in-time restore.\n
\n " }, "MultiAZ": { "shape_name": "Boolean", "type": "boolean", "documentation": "\n\n Specifies if the DB Instance is a Multi-AZ deployment.\n
\n " }, "EngineVersion": { "shape_name": "String", "type": "string", "documentation": "\n\n Indicates the database engine version.\n
\n " }, "AutoMinorVersionUpgrade": { "shape_name": "Boolean", "type": "boolean", "documentation": "\n\n Indicates that minor version patches are applied automatically.\n
\n " }, "ReadReplicaSourceDBInstanceIdentifier": { "shape_name": "String", "type": "string", "documentation": "\n\n Contains the identifier of the source DB Instance if this DB Instance is a Read Replica.\n
\n " }, "ReadReplicaDBInstanceIdentifiers": { "shape_name": "ReadReplicaDBInstanceIdentifierList", "type": "list", "members": { "shape_name": "String", "type": "string", "documentation": null, "xmlname": "ReadReplicaDBInstanceIdentifier" }, "documentation": "\n\n Contains one or more identifiers of the Read Replicas associated with this DB Instance.\n
\n " }, "LicenseModel": { "shape_name": "String", "type": "string", "documentation": "\n\n License model information for this DB Instance.\n
\n " }, "Iops": { "shape_name": "IntegerOptional", "type": "integer", "documentation": "\n\n Specifies the Provisioned IOPS (I/O operations per second) value.\n
\n " }, "OptionGroupMembership": { "shape_name": "OptionGroupMembership", "type": "structure", "members": { "OptionGroupName": { "shape_name": "String", "type": "string", "documentation": "\n\n The name of the option group that the instance belongs to.\n
\n " }, "Status": { "shape_name": "String", "type": "string", "documentation": "\n\n The status of the DB Instance's option group membership (e.g. in-sync, pending, pending-maintenance, applying).\n
\n " } }, "documentation": "\n\n Specifies the name and status of the option group that this instance belongs to. \n
\n " }, "CharacterSetName": { "shape_name": "String", "type": "string", "documentation": "\n\n If present, specifies the name of the character set that this instance is associated with. \n
\n " }, "SecondaryAvailabilityZone": { "shape_name": "String", "type": "string", "documentation": "\n\n If present, specifies the name of the secondary Availability Zone \n for a DB instance with multi-AZ support.\n
\n " }, "PubliclyAccessible": { "shape_name": "Boolean", "type": "boolean", "documentation": null } }, "wrapper": true, "documentation": "\n\n Contains the result of a successful invocation of the following actions:\n
\n \nThis data type is used as a response element in the DescribeDBInstances action.
\n " } } }, "errors": [ { "shape_name": "DBInstanceAlreadyExistsFault", "type": "structure", "members": {}, "documentation": "\n\n User already has a DB Instance with the given identifier.\n
\n " }, { "shape_name": "DBSnapshotNotFoundFault", "type": "structure", "members": {}, "documentation": "\n\n DBSnapshotIdentifier does not refer to an existing DB Snapshot.\n
\n " }, { "shape_name": "InstanceQuotaExceededFault", "type": "structure", "members": {}, "documentation": "\n\n Request would result in user exceeding the allowed number of DB Instances.\n
\n " }, { "shape_name": "InsufficientDBInstanceCapacityFault", "type": "structure", "members": {}, "documentation": "\n\n Specified DB Instance class is not available in the specified Availability Zone.\n
\n " }, { "shape_name": "InvalidDBSnapshotStateFault", "type": "structure", "members": {}, "documentation": "\n\n The state of the DB Security Snapshot does not allow deletion.\n
\n " }, { "shape_name": "StorageQuotaExceededFault", "type": "structure", "members": {}, "documentation": "\n\n Request would result in user exceeding the\n allowed amount of storage available across all DB Instances.\n
\n " }, { "shape_name": "InvalidVPCNetworkStateFault", "type": "structure", "members": {}, "documentation": "\n\n DB Subnet Group does not cover all availability zones after it is created because users' change.\n
\n " }, { "shape_name": "InvalidRestoreFault", "type": "structure", "members": {}, "documentation": "\n\n Cannot restore from vpc backup to non-vpc DB instance.\n
\n " }, { "shape_name": "DBSubnetGroupNotFoundFault", "type": "structure", "members": {}, "documentation": "\n\n DBSubnetGroupName does not refer to an existing DB Subnet Group.\n
\n " }, { "shape_name": "DBSubnetGroupDoesNotCoverEnoughAZs", "type": "structure", "members": {}, "documentation": "\n\n Subnets in the DB subnet group should cover at least 2 availability zones unless there's'only 1 available zone.\n
\n " }, { "shape_name": "InvalidSubnet", "type": "structure", "members": {}, "documentation": "\n\n Request subnet is valid, or all subnets are not in common Vpc. \n
\n " }, { "shape_name": "ProvisionedIopsNotAvailableInAZFault", "type": "structure", "members": {}, "documentation": "\n\n Provisioned IOPS not available in the specified Availability Zone.\n
\n " }, { "shape_name": "OptionGroupNotFoundFault", "type": "structure", "members": {}, "documentation": " \n\n The specified option group could not be found. \n
\n " } ], "documentation": "\n\n Creates a new DB Instance from a DB snapshot. The target database is created\n from the source database restore point with the same configuration as the original source database,\n except that the new RDS instance is created with the default security group.\n
\n\n The identifier of the source DB Instance from which to restore.\n
\nConstraints:
\n\n The name of the new database instance to be created.\n
\nConstraints:
\n\n The date and time to restore from.\n
\nValid Values: Value must be a UTC time
\nConstraints:
\nExample: 2009-09-07T23:45:00Z
\n Specifies whether (true
) or not (false
) the\n DB Instance is restored from the latest backup time.\n
Default: false
Constraints: Cannot be specified if RestoreTime parameter is provided.
\n " }, "DBInstanceClass": { "shape_name": "String", "type": "string", "documentation": "\n\n The compute and memory capacity of the Amazon RDS DB instance.\n
\nValid Values: db.t1.micro | db.m1.small | db.m1.medium | db.m1.large | db.m1.xlarge | db.m2.2xlarge | db.m2.4xlarge
Default: The same DBInstanceClass as the original DB Instance.
\n " }, "Port": { "shape_name": "IntegerOptional", "type": "integer", "documentation": "\n\n The port number on which the database accepts connections.\n
\nConstraints: Value must be 1150-65535
Default: The same port as the original DB Instance.
\n " }, "AvailabilityZone": { "shape_name": "String", "type": "string", "documentation": "\n\n The EC2 Availability Zone that the database instance will be created in.\n
\nDefault: A random, system-chosen Availability Zone.
\nConstraint: You cannot specify the AvailabilityZone parameter if the MultiAZ parameter is set to true.
\nExample: us-east-1a
\n The DB subnet group name to use for the new instance.\n
\n " }, "MultiAZ": { "shape_name": "BooleanOptional", "type": "boolean", "documentation": "\n\n Specifies if the DB Instance is a Multi-AZ deployment.\n
\nConstraint: You cannot specify the AvailabilityZone parameter if the MultiAZ parameter is set to true
.
\n Indicates that minor version upgrades will be applied automatically to the DB Instance during the maintenance window.\n
\n " }, "LicenseModel": { "shape_name": "String", "type": "string", "documentation": "\n\n License model information for the restored DB Instance.\n
\n\n Default: Same as source.\n
\n\n Valid values: license-included
| bring-your-own-license
| general-public-license
\n
\n The database name for the restored DB Instance.\n
\nThis parameter is not used for the MySQL engine.
\n\n The database engine to use for the new instance.\n
\nDefault: The same as source
\nConstraint: Must be compatible with the engine of the source
\nExample: oracle-ee
\n The amount of Provisioned IOPS (input/output operations per second) to be initially allocated for the\n DB Instance. \n
\nConstraints: Must be an integer greater than 1000.
\n \n " }, "OptionGroupName": { "shape_name": "String", "type": "string", "documentation": null } }, "documentation": "\n\n\n
\n " }, "output": { "shape_name": "DBInstanceWrapper", "type": "structure", "members": { "DBInstance": { "shape_name": "DBInstance", "type": "structure", "members": { "DBInstanceIdentifier": { "shape_name": "String", "type": "string", "documentation": "\n\n Contains a user-supplied database identifier.\n This is the unique key that identifies a DB Instance.\n
\n " }, "DBInstanceClass": { "shape_name": "String", "type": "string", "documentation": "\n\n Contains the name of the compute and memory\n capacity class of the DB Instance.\n
\n " }, "Engine": { "shape_name": "String", "type": "string", "documentation": "\n\n Provides the name of the database engine to be used for this DB Instance.\n
\n " }, "DBInstanceStatus": { "shape_name": "String", "type": "string", "documentation": "\n\n Specifies the current state of this database.\n
\n " }, "MasterUsername": { "shape_name": "String", "type": "string", "documentation": "\n\n Contains the master username for the DB Instance.\n
\n " }, "DBName": { "shape_name": "String", "type": "string", "documentation": "\nThe meaning of this parameter differs according to the database engine you use.
\nMySQL
\n\n Contains the name of the initial database of this instance that was\n provided at create time, if one was specified when the\n DB Instance was created. This same name is returned for\n the life of the DB Instance.\n
\nType: String
\nOracle
\n\n Contains the Oracle System ID (SID) of the created DB Instance. \n
\n " }, "Endpoint": { "shape_name": "Endpoint", "type": "structure", "members": { "Address": { "shape_name": "String", "type": "string", "documentation": "\n\n Specifies the DNS address of the DB Instance.\n
\n " }, "Port": { "shape_name": "Integer", "type": "integer", "documentation": "\n\n Specifies the port that the database engine is listening on.\n
\n " } }, "documentation": "\n\n Specifies the connection endpoint.\n
\n " }, "AllocatedStorage": { "shape_name": "Integer", "type": "integer", "documentation": "\n\n Specifies the allocated storage size specified in gigabytes.\n
\n " }, "InstanceCreateTime": { "shape_name": "TStamp", "type": "timestamp", "documentation": "\n\n Provides the date and time the DB Instance was created.\n
\n " }, "PreferredBackupWindow": { "shape_name": "String", "type": "string", "documentation": "\n\n Specifies the daily time range during which automated backups are\n created if automated backups are enabled, as determined\n by the BackupRetentionPeriod
.\n
\n Specifies the number of days for which automatic DB Snapshots are retained.\n
\n " }, "DBSecurityGroups": { "shape_name": "DBSecurityGroupMembershipList", "type": "list", "members": { "shape_name": "DBSecurityGroupMembership", "type": "structure", "members": { "DBSecurityGroupName": { "shape_name": "String", "type": "string", "documentation": "\n\n The name of the DB Security Group.\n
\n " }, "Status": { "shape_name": "String", "type": "string", "documentation": "\n\n The status of the DB Security Group.\n
\n " } }, "documentation": "\n\n This data type is used as a response element in the following actions:\n
\n\n Provides List of DB Security Group elements containing only\n DBSecurityGroup.Name
and DBSecurityGroup.Status
subelements.\n
The name of the VPC security group.
\n " }, "Status": { "shape_name": "String", "type": "string", "documentation": "\n\n The status of the VPC Security Group.\n
\n " } }, "documentation": "\nThis data type is used as a response element for queries on VPC security group membership.
\n ", "xmlname": "VpcSecurityGroupMembership" }, "documentation": "\n\n Provides List of VPC security group elements \n that the DB Instance belongs to. \n
\n " }, "DBParameterGroups": { "shape_name": "DBParameterGroupStatusList", "type": "list", "members": { "shape_name": "DBParameterGroupStatus", "type": "structure", "members": { "DBParameterGroupName": { "shape_name": "String", "type": "string", "documentation": "\n\n The name of the DP Parameter Group.\n
\n " }, "ParameterApplyStatus": { "shape_name": "String", "type": "string", "documentation": "\n\n The status of parameter updates.\n
\n " } }, "documentation": "\n\n The status of the DB Parameter Group.\n
\nThis data type is used as a response element in the following actions:
\n\n Provides the list of DB Parameter Groups applied to this DB Instance.\n
\n " }, "AvailabilityZone": { "shape_name": "String", "type": "string", "documentation": "\n\n Specifies the name of the Availability Zone the DB Instance is located in.\n
\n " }, "DBSubnetGroup": { "shape_name": "DBSubnetGroup", "type": "structure", "members": { "DBSubnetGroupName": { "shape_name": "String", "type": "string", "documentation": "\n\n Specifies the name of the DB Subnet Group.\n
\n " }, "DBSubnetGroupDescription": { "shape_name": "String", "type": "string", "documentation": "\n\n Provides the description of the DB Subnet Group.\n
\n " }, "VpcId": { "shape_name": "String", "type": "string", "documentation": "\n\n Provides the VpcId of the DB Subnet Group.\n
\n " }, "SubnetGroupStatus": { "shape_name": "String", "type": "string", "documentation": "\n\n Provides the status of the DB Subnet Group.\n
\n " }, "Subnets": { "shape_name": "SubnetList", "type": "list", "members": { "shape_name": "Subnet", "type": "structure", "members": { "SubnetIdentifier": { "shape_name": "String", "type": "string", "documentation": "\n\n Specifies the identifier of the subnet.\n
\n " }, "SubnetAvailabilityZone": { "shape_name": "AvailabilityZone", "type": "structure", "members": { "Name": { "shape_name": "String", "type": "string", "documentation": "\n\n The name of the availability zone.\n
\n " }, "ProvisionedIopsCapable": { "shape_name": "Boolean", "type": "boolean", "documentation": "\n\n True indicates the availability zone is capable of provisioned IOPs.\n
\n " } }, "wrapper": true, "documentation": "\n\n Contains Availability Zone information. \n
\n\n This data type is used as an element in the following data type:\n
\n \n \n " }, "SubnetStatus": { "shape_name": "String", "type": "string", "documentation": "\n\n Specifies the status of the subnet.\n
\n " } }, "documentation": "\n\n This data type is used as a response element in the DescribeDBSubnetGroups action.\n
\n ", "xmlname": "Subnet" }, "documentation": "\n\n Contains a list of Subnet elements.\n
\n " } }, "wrapper": true, "documentation": "\n\n Provides the inforamtion of the subnet group associated with the DB instance, including the name, descrption and subnets in the subnet group.\n
\n " }, "PreferredMaintenanceWindow": { "shape_name": "String", "type": "string", "documentation": "\n\n Specifies the weekly time range (in UTC) during which\n system maintenance can occur.\n
\n " }, "PendingModifiedValues": { "shape_name": "PendingModifiedValues", "type": "structure", "members": { "DBInstanceClass": { "shape_name": "String", "type": "string", "documentation": "\n\n Contains the new DBInstanceClass
for the DB Instance\n that will be applied or is in progress.\n
\n Contains the new AllocatedStorage
size for the DB Instance\n that will be applied or is in progress.\n
\n Contains the pending or in-progress change of the master credentials for the DB Instance.\n
\n " }, "Port": { "shape_name": "IntegerOptional", "type": "integer", "documentation": "\n\n Specifies the pending port for the DB Instance.\n
\n " }, "BackupRetentionPeriod": { "shape_name": "IntegerOptional", "type": "integer", "documentation": "\n\n Specifies the pending number of days for which automated backups are retained.\n
\n " }, "MultiAZ": { "shape_name": "BooleanOptional", "type": "boolean", "documentation": "\n\n Indicates that the Single-AZ DB Instance is to change to a Multi-AZ deployment.\n
\n " }, "EngineVersion": { "shape_name": "String", "type": "string", "documentation": "\n\n Indicates the database engine version. \n
\n " }, "Iops": { "shape_name": "IntegerOptional", "type": "integer", "documentation": "\n\n Specifies the new Provisioned IOPS value for the DB Instance\n that will be applied or is being applied.\n
\n " }, "DBInstanceIdentifier": { "shape_name": "String", "type": "string", "documentation": "\n\n Contains the new DBInstanceIdentifier
for the DB Instance\n that will be applied or is in progress.\n
\n Specifies that changes to the DB Instance are pending.\n This element is only included when changes are pending.\n Specific changes are identified by subelements.\n
\n " }, "LatestRestorableTime": { "shape_name": "TStamp", "type": "timestamp", "documentation": "\n\n Specifies the latest time to which a database\n can be restored with point-in-time restore.\n
\n " }, "MultiAZ": { "shape_name": "Boolean", "type": "boolean", "documentation": "\n\n Specifies if the DB Instance is a Multi-AZ deployment.\n
\n " }, "EngineVersion": { "shape_name": "String", "type": "string", "documentation": "\n\n Indicates the database engine version.\n
\n " }, "AutoMinorVersionUpgrade": { "shape_name": "Boolean", "type": "boolean", "documentation": "\n\n Indicates that minor version patches are applied automatically.\n
\n " }, "ReadReplicaSourceDBInstanceIdentifier": { "shape_name": "String", "type": "string", "documentation": "\n\n Contains the identifier of the source DB Instance if this DB Instance is a Read Replica.\n
\n " }, "ReadReplicaDBInstanceIdentifiers": { "shape_name": "ReadReplicaDBInstanceIdentifierList", "type": "list", "members": { "shape_name": "String", "type": "string", "documentation": null, "xmlname": "ReadReplicaDBInstanceIdentifier" }, "documentation": "\n\n Contains one or more identifiers of the Read Replicas associated with this DB Instance.\n
\n " }, "LicenseModel": { "shape_name": "String", "type": "string", "documentation": "\n\n License model information for this DB Instance.\n
\n " }, "Iops": { "shape_name": "IntegerOptional", "type": "integer", "documentation": "\n\n Specifies the Provisioned IOPS (I/O operations per second) value.\n
\n " }, "OptionGroupMembership": { "shape_name": "OptionGroupMembership", "type": "structure", "members": { "OptionGroupName": { "shape_name": "String", "type": "string", "documentation": "\n\n The name of the option group that the instance belongs to.\n
\n " }, "Status": { "shape_name": "String", "type": "string", "documentation": "\n\n The status of the DB Instance's option group membership (e.g. in-sync, pending, pending-maintenance, applying).\n
\n " } }, "documentation": "\n\n Specifies the name and status of the option group that this instance belongs to. \n
\n " }, "CharacterSetName": { "shape_name": "String", "type": "string", "documentation": "\n\n If present, specifies the name of the character set that this instance is associated with. \n
\n " }, "SecondaryAvailabilityZone": { "shape_name": "String", "type": "string", "documentation": "\n\n If present, specifies the name of the secondary Availability Zone \n for a DB instance with multi-AZ support.\n
\n " }, "PubliclyAccessible": { "shape_name": "Boolean", "type": "boolean", "documentation": null } }, "wrapper": true, "documentation": "\n\n Contains the result of a successful invocation of the following actions:\n
\n \nThis data type is used as a response element in the DescribeDBInstances action.
\n " } } }, "errors": [ { "shape_name": "DBInstanceAlreadyExistsFault", "type": "structure", "members": {}, "documentation": "\n\n User already has a DB Instance with the given identifier.\n
\n " }, { "shape_name": "DBInstanceNotFoundFault", "type": "structure", "members": {}, "documentation": "\n\n DBInstanceIdentifier does not refer to an existing DB Instance.\n
\n " }, { "shape_name": "InstanceQuotaExceededFault", "type": "structure", "members": {}, "documentation": "\n\n Request would result in user exceeding the allowed number of DB Instances.\n
\n " }, { "shape_name": "InsufficientDBInstanceCapacityFault", "type": "structure", "members": {}, "documentation": "\n\n Specified DB Instance class is not available in the specified Availability Zone.\n
\n " }, { "shape_name": "InvalidDBInstanceStateFault", "type": "structure", "members": {}, "documentation": "\n\n The specified DB Instance is not in the available state.\n
\n " }, { "shape_name": "PointInTimeRestoreNotEnabledFault", "type": "structure", "members": {}, "documentation": "\n\n SourceDBInstanceIdentifier\n refers to a DB Instance with\n BackupRetentionPeriod equal to 0.\n
\n " }, { "shape_name": "StorageQuotaExceededFault", "type": "structure", "members": {}, "documentation": "\n\n Request would result in user exceeding the\n allowed amount of storage available across all DB Instances.\n
\n " }, { "shape_name": "InvalidVPCNetworkStateFault", "type": "structure", "members": {}, "documentation": "\n\n DB Subnet Group does not cover all availability zones after it is created because users' change.\n
\n " }, { "shape_name": "InvalidRestoreFault", "type": "structure", "members": {}, "documentation": "\n\n Cannot restore from vpc backup to non-vpc DB instance.\n
\n " }, { "shape_name": "DBSubnetGroupNotFoundFault", "type": "structure", "members": {}, "documentation": "\n\n DBSubnetGroupName does not refer to an existing DB Subnet Group.\n
\n " }, { "shape_name": "DBSubnetGroupDoesNotCoverEnoughAZs", "type": "structure", "members": {}, "documentation": "\n\n Subnets in the DB subnet group should cover at least 2 availability zones unless there's'only 1 available zone.\n
\n " }, { "shape_name": "InvalidSubnet", "type": "structure", "members": {}, "documentation": "\n\n Request subnet is valid, or all subnets are not in common Vpc. \n
\n " }, { "shape_name": "ProvisionedIopsNotAvailableInAZFault", "type": "structure", "members": {}, "documentation": "\n\n Provisioned IOPS not available in the specified Availability Zone.\n
\n " }, { "shape_name": "OptionGroupNotFoundFault", "type": "structure", "members": {}, "documentation": " \n\n The specified option group could not be found. \n
\n " } ], "documentation": "\n\n Restores a DB Instance to an arbitrary point-in-time. Users can restore to any point in\n time before the latestRestorableTime for up to backupRetentionPeriod days. The target database is created\n from the source database with the same configuration as the original database except that the DB instance\n is created with the default DB security group.\n
\n\n The name of the DB Security Group to revoke ingress from.\n
\n ", "required": true }, "CIDRIP": { "shape_name": "String", "type": "string", "documentation": "\n\n The IP range to revoke access from. \n Must be a valid CIDR range. If CIDRIP
is specified, \n EC2SecurityGroupName
, EC2SecurityGroupId
and EC2SecurityGroupOwnerId
\n cannot be provided.\n
\n The name of the EC2 Security Group to revoke access from.\n For VPC DB Security Groups, EC2SecurityGroupId
must be provided.\n Otherwise, EC2SecurityGroupOwnerId and either EC2SecurityGroupName
or EC2SecurityGroupId
must be provided.\n
\n The id of the EC2 Security Group to revoke access from.\n For VPC DB Security Groups, EC2SecurityGroupId
must be provided.\n Otherwise, EC2SecurityGroupOwnerId and either EC2SecurityGroupName
or EC2SecurityGroupId
must be provided.\n
\n The AWS Account Number of the owner of the EC2 security group\n specified in the EC2SecurityGroupName
parameter.\n The AWS Access Key ID is not an acceptable value.\n For VPC DB Security Groups, EC2SecurityGroupId
must be provided.\n Otherwise, EC2SecurityGroupOwnerId and either EC2SecurityGroupName
or EC2SecurityGroupId
must be provided.\n
\n\n
\n " }, "output": { "shape_name": "DBSecurityGroupWrapper", "type": "structure", "members": { "DBSecurityGroup": { "shape_name": "DBSecurityGroup", "type": "structure", "members": { "OwnerId": { "shape_name": "String", "type": "string", "documentation": "\n\n Provides the AWS ID of the owner of a specific DB Security Group.\n
\n " }, "DBSecurityGroupName": { "shape_name": "String", "type": "string", "documentation": "\n\n Specifies the name of the DB Security Group.\n
\n " }, "DBSecurityGroupDescription": { "shape_name": "String", "type": "string", "documentation": "\n\n Provides the description of the DB Security Group.\n
\n " }, "VpcId": { "shape_name": "String", "type": "string", "documentation": "\n\n Provides the VpcId of the DB Security Group.\n
\n " }, "EC2SecurityGroups": { "shape_name": "EC2SecurityGroupList", "type": "list", "members": { "shape_name": "EC2SecurityGroup", "type": "structure", "members": { "Status": { "shape_name": "String", "type": "string", "documentation": "\n\n Provides the status of the EC2 security group. Status can be \"authorizing\", \n \"authorized\", \"revoking\", and \"revoked\".\n
\n " }, "EC2SecurityGroupName": { "shape_name": "String", "type": "string", "documentation": "\n\n Specifies the name of the EC2 Security Group.\n
\n " }, "EC2SecurityGroupId": { "shape_name": "String", "type": "string", "documentation": "\n\n Specifies the id of the EC2 Security Group.\n
\n " }, "EC2SecurityGroupOwnerId": { "shape_name": "String", "type": "string", "documentation": "\n\n Specifies the AWS ID of the owner of the EC2 security group\n specified in the EC2SecurityGroupName
field.\n
\n This data type is used as a response element in the following actions:\n
\n \n ", "xmlname": "EC2SecurityGroup" }, "documentation": "\n\n Contains a list of EC2SecurityGroup elements.\n
\n " }, "IPRanges": { "shape_name": "IPRangeList", "type": "list", "members": { "shape_name": "IPRange", "type": "structure", "members": { "Status": { "shape_name": "String", "type": "string", "documentation": "\n\n Specifies the status of the IP range. Status can be \"authorizing\", \n \"authorized\", \"revoking\", and \"revoked\".\n
\n " }, "CIDRIP": { "shape_name": "String", "type": "string", "documentation": "\n\n Specifies the IP range.\n
\n " } }, "documentation": "\n\n This data type is used as a response element in the DescribeDBSecurityGroups action.\n
\n ", "xmlname": "IPRange" }, "documentation": "\n\n Contains a list of IPRange elements.\n
\n " } }, "wrapper": true, "documentation": "\n\n Contains the result of a successful invocation of the following actions:\n
\nThis data type is used as a response element in the DescribeDBSecurityGroups action.
\n \n " } } }, "errors": [ { "shape_name": "DBSecurityGroupNotFoundFault", "type": "structure", "members": {}, "documentation": "\n\n DBSecurityGroupName does not refer to an existing DB Security Group.\n
\n " }, { "shape_name": "AuthorizationNotFoundFault", "type": "structure", "members": {}, "documentation": "\n\n Specified CIDRIP or EC2 security group is not authorized\n for the specified DB Security Group.\n
\n " }, { "shape_name": "InvalidDBSecurityGroupStateFault", "type": "structure", "members": {}, "documentation": "\n\n The state of the DB Security Group does not allow deletion.\n
\n " } ], "documentation": "\n\n Revokes ingress from a DBSecurityGroup for previously authorized IP ranges or EC2 or VPC Security\n Groups. Required parameters for this API are one of CIDRIP, EC2SecurityGroupId for VPC, or (EC2SecurityGroupOwnerId\n and either EC2SecurityGroupName or EC2SecurityGroupId).\n
\n