本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# Neptune 实例 API
<a name="api-instances"></a>

**操作：**
+ [CreateDBInstance（操作）](#CreateDBInstance)
+ [DeleteDBInstance（操作）](#DeleteDBInstance)
+ [ModifyDBInstance（操作）](#ModifyDBInstance)
+ [RebootDBInstance（操作）](#RebootDBInstance)
+ [DescribeDBInstances（操作）](#DescribeDBInstances)
+ [DescribeOrderableDBInstanceOptions（操作）](#DescribeOrderableDBInstanceOptions)
+ [DescribeValidDBInstanceModifications（操作）](#DescribeValidDBInstanceModifications)

**结构：**
+ [DBInstance（结构）](#DBInstance)
+ [DBInstanceStatusInfo（结构）](#DBInstanceStatusInfo)
+ [OrderableDBInstanceOption（结构）](#OrderableDBInstanceOption)
+ [PendingModifiedValues（结构）](#PendingModifiedValues)
+ [ValidStorageOptions（结构）](#ValidStorageOptions)
+ [ValidDBInstanceModificationsMessage（结构）](#ValidDBInstanceModificationsMessage)

## CreateDBInstance（操作）
<a name="CreateDBInstance"></a>

         此 API 的 Amazon CLI 名称为：`create-db-instance`。

创建新的数据库实例。

**请求**
+ **AutoMinorVersionUpgrade**（在 CLI 中：`--auto-minor-version-upgrade`）– BooleanOptional，类型为：`boolean` [布尔值（true 或 false）]。

  指示在维护时段期间，将对该数据库实例自动应用次要引擎升级。

  默认值：`true`
+ **AvailabilityZone**（在 CLI 中：`--availability-zone`）– 一个字符串，类型为：`string`（UTF-8 编码的字符串）。

   在其中创建了数据库实例的 EC2 可用区

  默认值：端点的 Amazon 区域中系统选择的随机可用区。

   示例：`us-east-1d`

   约束：如果 MultiAZ 设置为 `true`，则不能指定 AvailabilityZone 参数。指定的可用区必须与当前端点位于相同 Amazon 区域中。
+ **BackupRetentionPeriod**（在 CLI 中：`--backup-retention-period`）– IntegerOptional，类型为：`integer`（带符号的 32 位整数）。

  自动备份的保留天数。

  不适用。自动备份保留期由数据库集群管理。有关更多信息，请参阅 [CreateDBCluster（操作）](api-clusters.md#CreateDBCluster)。

  默认值：1

  约束：
  + 值必须介于 0 到 35 之间
  + 如果数据库实例是只读副本的源，则不能设置为 0。
+ **CopyTagsToSnapshot**（在 CLI 中：`--copy-tags-to-snapshot`）– BooleanOptional，类型为：`boolean` [布尔值（true 或 false）]。

  如果为 true，则将数据库实例的所有标签复制到数据库实例的快照中，否则为 false。默认值为 false。
+ **DBClusterIdentifier**（在 CLI 中：`--db-cluster-identifier`）– *必需：*一个字符串，类型为：`string`（UTF-8 编码的字符串）。

  实例所属的数据库集群的标识符。

  有关创建数据库集群的信息，请参阅[CreateDBCluster（操作）](api-clusters.md#CreateDBCluster)。

  类型：字符串
+ **DBInstanceClass**（在 CLI 中：`--db-instance-class`）– *必需：*一个字符串，类型为：`string`（UTF-8 编码的字符串）。

  数据库实例的计算和内存容量，例如，`db.m4.large`。并非所有数据库实例类在所有 Amazon 区域中都可用。
+ **DBInstanceIdentifier**（在 CLI 中：`--db-instance-identifier`）– *必需：*一个字符串，类型为：`string`（UTF-8 编码的字符串）。

  数据库实例标识符。该参数作为一个小写字符串存储。

  约束：
  + 必须包含 1 到 63 个字母、数字或连字符。
  + 第一个字符必须是字母。
  + 不能以连字符结束或包含两个连续连字符。

  示例：`mydbinstance`
+ **DBName**（在 CLI 中：`--db-name`）– 一个字符串，类型为：`string`（UTF-8 编码的字符串）。

  不支持。
+ **DBParameterGroupName**（在 CLI 中：`--db-parameter-group-name`）– 一个字符串，类型为：`string`（UTF-8 编码的字符串）。

  要与此数据库实例关联的数据库参数组的名称。如果省略此参数，则使用指定引擎的默认 DBParameterGroup。

  约束：
  + 必须为 1 到 255 个字母、数字或连字符。
  + 第一个字符必须是字母
  + 不能以连字符结束或包含两个连续连字符
+ **DBSecurityGroups**（在 CLI 中：`--db-security-groups`）– 一个字符串，类型为：`string`（UTF-8 编码的字符串）。

  要与此数据库实例关联的数据库安全组的列表。

  默认值：数据库引擎的默认数据库安全组。
+ **DBSubnetGroupName**（在 CLI 中：`--db-subnet-group-name`）– 一个字符串，类型为：`string`（UTF-8 编码的字符串）。

  与此数据库实例关联的数据库子网组。

  如果不存在数据库子网组，则该实例为非 VPC 数据库实例。
+ **DeletionProtection**（在 CLI 中：`--deletion-protection`）– BooleanOptional，类型为：`boolean` [布尔值（true 或 false）]。

  指示数据库实例是否已启用删除保护的值。在启用删除保护时，无法删除数据库。默认情况下，将禁用删除保护。请参阅[删除数据库实例](https://docs.amazonaws.cn/neptune/latest/userguide/manage-console-instances-delete.html)。

  可以删除数据库集群中的数据库实例，即使在其父数据库集群中启用了删除保护也是如此。
+ **Domain**（在 CLI 中：`--domain`）– 一个字符串，类型为：`string`（UTF-8 编码的字符串）。

  指定在其中创建实例的 Active Directory 域。
+ **DomainIAMRoleName**（在 CLI 中：`--domain-iam-role-name`）– 一个字符串，类型为：`string`（UTF-8 编码的字符串）。

  指定在对 Directory Service 进行 API 调用时使用的 IAM 角色的名称。
+ **EnableCloudwatchLogsExports**（在 CLI 中：`--enable-cloudwatch-logs-exports`）– 一个字符串，类型为：`string`（UTF-8 编码的字符串）。

  需要启用以导出到 CloudWatch Logs 的日志类型的列表。
+ **EnableIAMDatabaseAuthentication**（在 CLI 中：`--enable-iam-database-authentication`）– BooleanOptional，类型为：`boolean` [布尔值（true 或 false）]。

  不受 Neptune 支持（忽略）。
+ **Engine**（在 CLI 中：`--engine`）– *必需：*一个字符串，类型为：`string`（UTF-8 编码的字符串）。

  要用于此实例的数据库引擎的名称。

  有效值：`neptune`
+ **EngineVersion**（在 CLI 中：`--engine-version`）– 一个字符串，类型为：`string`（UTF-8 编码的字符串）。

  要使用的数据库引擎的版本号。目前，设置此参数不起作用。
+ **Iops**（在 CLI 中：`--iops`）– IntegerOptional，类型为：`integer`（带符号的 32 位整数）。

  最初为数据库实例分配的预配置 IOPS（每秒输入/输出操作数）量。
+ **KmsKeyId**（在 CLI 中：`--kms-key-id`）– 一个字符串，类型为：`string`（UTF-8 编码的字符串）。

  加密数据库实例的 Amazon KMS 密钥标识符。

  KMS 密钥标识符是 KMS 加密密钥的 Amazon 资源名称 (ARN)。如果您创建数据库实例时使用的 Amazon 账户，是拥有加密新数据库实例所用 KMS 加密密钥的同一个账户，则您可以使用 KMS 密钥别名，而不用 KMS 加密密钥的 ARN。

  不适用。KMS 密钥标识符由数据库集群管理。有关更多信息，请参阅 [CreateDBCluster（操作）](api-clusters.md#CreateDBCluster)。

  如果 `StorageEncrypted` 参数为 true，并且您没有为 `KmsKeyId` 参数指定值，则 Amazon Neptune 将使用您的默认加密密钥。Amazon KMS 将为您的 Amazon 账户创建默认加密密钥。您的 Amazon 账户在每个 Amazon 区域都有一个不同的默认加密密钥。
+ **LicenseModel**（在 CLI 中：`--license-model`）– 一个字符串，类型为：`string`（UTF-8 编码的字符串）。

  该数据库实例的许可模式信息。

   有效值：`license-included` \|`bring-your-own-license` \|`general-public-license`
+ **MonitoringInterval**（在 CLI 中：`--monitoring-interval`）– IntegerOptional，类型为：`integer`（带符号的 32 位整数）。

  收集数据库实例的增强监控指标的时间点之间的间隔，以秒为单位。要禁用收集增强监控指标，请指定 0。默认值是 0。

  如果指定 `MonitoringRoleArn`，则您还必须将 `MonitoringInterval` 设置为 0 以外的值。

  有效值：`0, 1, 5, 10, 15, 30, 60`
+ **MonitoringRoleArn**（在 CLI 中：`--monitoring-role-arn`）– 一个字符串，类型为：`string`（UTF-8 编码的字符串）。

  允许 Neptune 将增强监控指标发送到 Amazon CloudWatch Logs 的 IAM 角色的 ARN。例如 `arn:aws:iam:123456789012:role/emaccess`。

  如果 `MonitoringInterval` 设置为 0 以外的值，则您必须提供 `MonitoringRoleArn` 值。
+ **MultiAZ**（在 CLI 中：`--multi-az`）– BooleanOptional，类型为：`boolean` [布尔值（true 或 false）]。

  指定数据库实例是否为多可用区部署。如果 MultiAZ 参数设为 true，则不能设置 AvailabilityZone 参数。
+ **Port**（在 CLI 中：`--port`）– IntegerOptional，类型为：`integer`（带符号的 32 位整数）。

  数据库实例接受连接的端口编号。

  不适用。端口由数据库集群管理。有关更多信息，请参阅 [CreateDBCluster（操作）](api-clusters.md#CreateDBCluster)。

   默认值：`8182`

  类型：整数
+ **PreferredBackupWindow**（在 CLI 中：`--preferred-backup-window`）– 一个字符串，类型为：`string`（UTF-8 编码的字符串）。

   创建自动备份的每日时间范围。

  不适用。每天创建自动备份的时间范围由数据库集群管理。有关更多信息，请参阅 [CreateDBCluster（操作）](api-clusters.md#CreateDBCluster)。
+ **PreferredMaintenanceWindow**（在 CLI 中：`--preferred-maintenance-window`）– 一个字符串，类型为：`string`（UTF-8 编码的字符串）。

  每周可以进行系统维护的时间范围（采用通用协调时间 (UTC)）。

   格式：`ddd:hh24:mi-ddd:hh24:mi`

  默认值为每个 Amazon 区域 8 小时的时段中随机选择的 30 分钟时段（随机选取周中的某天进行）。

  有效值：Mon、Tue、Wed、Thu、Fri、Sat、Sun。

  约束：至少为 30 分钟的时段。
+ **PromotionTier**（在 CLI 中：`--promotion-tier`）– IntegerOptional，类型为：`integer`（带符号的 32 位整数）。

  该值指定在现有主实例发生故障后将只读副本提升为主实例的顺序。

  默认值：1

  有效值：0 - 15
+ **PubliclyAccessible**（在 CLI 中：`--publicly-accessible`）– BooleanOptional，类型为：`boolean` [布尔值（true 或 false）]。

  此标记不应再使用。
+ **StorageEncrypted**（在 CLI 中：`--storage-encrypted`）– BooleanOptional，类型为：`boolean` [布尔值（true 或 false）]。

  指定是否已对数据库实例加密。

  不适用。数据库实例的加密由数据库集群管理。有关更多信息，请参阅 [CreateDBCluster（操作）](api-clusters.md#CreateDBCluster)。

  默认：false
+ **StorageType**（在 CLI 中：`--storage-type`）– 一个字符串，类型为：`string`（UTF-8 编码的字符串）。

  不适用。在 Neptune 中，存储类型在数据库集群级别进行管理。
+ **Tags**：（在 CLI 中：`--tags`）[标签](api-other-apis.md#Tag) 对象的数组。

  分配到新实例的标签。
+ **TdeCredentialArn**（在 CLI 中：`--tde-credential-arn`）– 一个字符串，类型为：`string`（UTF-8 编码的字符串）。

  来自密钥存储的 ARN，实例通过它进行关联用于 TDE 加密。
+ **TdeCredentialPassword**（在 CLI 中：`--tde-credential-password`）– 一个敏感字符串，类型为：`string`（UTF-8 编码的字符串）。

  密钥存储中指定 ARN 的密码，以便访问设备。
+ **Timezone**（在 CLI 中：`--timezone`）– 一个字符串，类型为：`string`（UTF-8 编码的字符串）。

  数据库实例的时区。
+ **VpcSecurityGroupIds**（在 CLI 中：`--vpc-security-group-ids`）– 一个字符串，类型为：`string`（UTF-8 编码的字符串）。

  要与此数据库实例关联的 EC2 VPC 安全组的列表。

  不适用。关联的 EC2 VPC 安全组列表由数据库集群管理。有关更多信息，请参阅 [CreateDBCluster（操作）](api-clusters.md#CreateDBCluster)。

  默认值：数据库子网组的 VPC 的默认 EC2 VPC 安全组。

**响应**

包含 Amazon Neptune 数据库实例的详细信息。

此数据类型用作 [DescribeDBInstances（操作）](#DescribeDBInstances) 操作中的响应元素。
+ **AutoMinorVersionUpgrade** - 一个布尔值，类型为：`boolean` [布尔值（true 或 false）]。

  指示自动应用次要版本补丁。
+ **AvailabilityZone** – 一个字符串，类型为：`string`（UTF-8 编码的字符串）。

  指定数据库实例所在可用区域的名称。
+ **BackupRetentionPeriod** – 一个整数，类型为：`integer`（带符号的 32 位整数）。

  指定自动数据库快照的保留天数。
+ **CACertificateIdentifier** – 一个字符串，类型为：`string`（UTF-8 编码的字符串）。

  此数据库实例的 CA 证书的标识符。
+ **CopyTagsToSnapshot** - 一个布尔值，类型为：`boolean` [布尔值（true 或 false）]。

  指定是否将标签从数据库实例复制到数据库实例的快照。
+ **DBClusterIdentifier** – 一个字符串，类型为：`string`（UTF-8 编码的字符串）。

  如果数据库实例属于某个数据库集群，则包含数据库实例所属的数据库集群的名称。
+ **DBInstanceArn** – 一个字符串，类型为：`string`（UTF-8 编码的字符串）。

  数据库实例的 Amazon 资源名称 (ARN)。
+ **DBInstanceClass** – 一个字符串，类型为：`string`（UTF-8 编码的字符串）。

  包含数据库实例的计算和内存容量级别名称。
+ **DBInstanceIdentifier** – 一个字符串，类型为：`string`（UTF-8 编码的字符串）。

  包含用户提供的数据库标识符。此标识符是标识数据库实例的唯一密钥。
+ **DbInstancePort** – 一个整数，类型为：`integer`（带符号的 32 位整数）。

  指定数据库实例侦听的端口。如果数据库实例属于某个数据库集群，则此端口可能不同于数据库集群的端口。
+ **DBInstanceStatus** – 一个字符串，类型为：`string`（UTF-8 编码的字符串）。

  指定此数据库的当前状态。
+ **DbiResourceId** – 一个字符串，类型为：`string`（UTF-8 编码的字符串）。

  数据库实例的 Amazon 区域唯一且不变的标识符。只要访问数据库实例的 Amazon KMS 密钥，就可以在 Amazon CloudTrail 日志条目中找到此标识符。
+ **DBName** – 一个字符串，类型为：`string`（UTF-8 编码的字符串）。

  数据库名称。
+ **DBParameterGroups** – [DBParameterGroupStatus](api-parameters.md#DBParameterGroupStatus) 对象的数组。

  提供应用到此数据库实例的数据库参数组的列表。
+ **DBSecurityGroups** – [DBSecurityGroupMembership](api-datatypes.md#DBSecurityGroupMembership) 对象的数组。

   提供仅包含 `DBSecurityGroup.Name` 和 `DBSecurityGroup.Status` 子元素的数据库安全组元素的列表。
+ **DBSubnetGroup** – 一个 [DBSubnetGroup](api-subnets.md#DBSubnetGroup) 对象。

  指定与数据库实例关联的子网组的信息，包括名称、描述和子网组中的子网。
+ **DeletionProtection** – BooleanOptional，类型为：`boolean` [布尔值（true 或 false）]。

  指示数据库实例是否已启用删除保护。在启用删除保护时，无法删除实例。请参阅[删除数据库实例](https://docs.amazonaws.cn/neptune/latest/userguide/manage-console-instances-delete.html)。
+ **DomainMemberships** – [DomainMembership](api-datatypes.md#DomainMembership) 对象的数组。

  不支持
+ **EnabledCloudwatchLogsExports** – 一个字符串，类型为：`string`（UTF-8 编码的字符串）。

  此数据库实例配置为导出到 CloudWatch Logs 的日志类型的列表。
+ **Endpoint** – 一个 [终端节点](api-datatypes.md#Endpoint) 对象。

  指定连接端点。
+ **Engine** – 一个字符串，类型为：`string`（UTF-8 编码的字符串）。

  提供要用于此数据库实例的数据库引擎的名称。
+ **EngineVersion** – 一个字符串，类型为：`string`（UTF-8 编码的字符串）。

  指示数据库引擎版本。
+ **EnhancedMonitoringResourceArn** – 一个字符串，类型为：`string`（UTF-8 编码的字符串）。

  接收数据库实例的增强监控指标数据的 Amazon CloudWatch Logs 日志流的 Amazon 资源名称 (ARN)。
+ **IAMDatabaseAuthenticationEnabled** - 一个布尔值，类型为：`boolean` [布尔值（true 或 false）]。

  如果 Amazon Identity and Access Management (IAM) 身份验证已启用，则为 true；否则为 false。
+ **InstanceCreateTime** – TStamp，类型为：`timestamp`（一个时间点，通常定义为与 1970 年 1 月 1 日午夜的偏移量）。

  提供创建数据库实例的日期和时间。
+ **Iops** – IntegerOptional，类型为：`integer`（带符号的 32 位整数）。

  指定预配置的 IOPS（每秒 I/O 操作数）值。
+ **KmsKeyId** – 一个字符串，类型为：`string`（UTF-8 编码的字符串）。

   不支持：数据库实例的加密由数据库集群管理。
+ **LatestRestorableTime** – TStamp，类型为：`timestamp`（一个时间点，通常定义为与 1970 年 1 月 1 日午夜的偏移量）。

  指定数据库可以使用时间点还原的最新还原时间。
+ **LicenseModel** – 一个字符串，类型为：`string`（UTF-8 编码的字符串）。

  该数据库实例的许可模式信息。
+ **MonitoringInterval** – IntegerOptional，类型为：`integer`（带符号的 32 位整数）。

  收集数据库实例的增强监控指标的时间点之间的间隔，以秒为单位。
+ **MonitoringRoleArn** – 一个字符串，类型为：`string`（UTF-8 编码的字符串）。

  允许 Neptune 将增强监控指标发送到 Amazon CloudWatch Logs 的 IAM 角色的 ARN。
+ **MultiAZ** - 一个布尔值，类型为：`boolean` [布尔值（true 或 false）]。

  指定数据库实例是否为多可用区部署。
+ **PendingModifiedValues** – 一个 [PendingModifiedValues](#PendingModifiedValues) 对象。

  指定对数据库实例的更改待处理。仅在更改待处理时包含此元素。特定更改由子元素标识。
+ **PreferredBackupWindow** – 一个字符串，类型为：`string`（UTF-8 编码的字符串）。

   指定在启用自动备份时，自动执行备份的日常时间范围，如 `BackupRetentionPeriod` 所规定。
+ **PreferredMaintenanceWindow** – 一个字符串，类型为：`string`（UTF-8 编码的字符串）。

  指定可进行系统维护的每周时间范围（采用通用协调时间 (UTC)）。
+ **PromotionTier** – IntegerOptional，类型为：`integer`（带符号的 32 位整数）。

  该值指定在现有主实例发生故障后将只读副本提升为主实例的顺序。
+ **PubliclyAccessible** - 一个布尔值，类型为：`boolean` [布尔值（true 或 false）]。

  此标记不应再使用。
+ **ReadReplicaDBClusterIdentifiers** – 一个字符串，类型为：`string`（UTF-8 编码的字符串）。

  包含一个或多个数据集集群（作为此数据库实例只读副本的集群）的标识符。
+ **ReadReplicaDBInstanceIdentifiers** – 一个字符串，类型为：`string`（UTF-8 编码的字符串）。

  包含一个或多个与此数据库实例关联的只读副本的标识符。
+ **ReadReplicaSourceDBInstanceIdentifier** – 一个字符串，类型为：`string`（UTF-8 编码的字符串）。

  包含源数据库实例（在此数据库实例是只读副本时）的标识符。
+ **SecondaryAvailabilityZone** – 一个字符串，类型为：`string`（UTF-8 编码的字符串）。

  如果存在，则指定带多可用区支持的数据库实例辅助可用区的名称。
+ **StatusInfos** – [DBInstanceStatusInfo](#DBInstanceStatusInfo) 对象的数组。

  只读副本的状态。如果实例不是只读副本，则此项空白。
+ **StorageEncrypted** - 一个布尔值，类型为：`boolean` [布尔值（true 或 false）]。

  不支持：数据库实例的加密由数据库集群管理。
+ **StorageType** – 一个字符串，类型为：`string`（UTF-8 编码的字符串）。

  指定与数据库实例关联的存储类型。
+ **TdeCredentialArn** – 一个字符串，类型为：`string`（UTF-8 编码的字符串）。

  来自密钥存储的 ARN，实例通过它进行关联用于 TDE 加密。
+ **Timezone** – 一个字符串，类型为：`string`（UTF-8 编码的字符串）。

  不支持。
+ **VpcSecurityGroups** – [VpcSecurityGroupMembership](api-datatypes.md#VpcSecurityGroupMembership) 对象的数组。

  提供数据库实例所属的 VPC 安全组元素的列表。

**错误**
+ [DBInstanceAlreadyExistsFault](api-faults.md#DBInstanceAlreadyExistsFault)
+ [InsufficientDBInstanceCapacityFault](api-faults.md#InsufficientDBInstanceCapacityFault)
+ [DBParameterGroupNotFoundFault](api-faults.md#DBParameterGroupNotFoundFault)
+ [DBSecurityGroupNotFoundFault](api-faults.md#DBSecurityGroupNotFoundFault)
+ [InstanceQuotaExceededFault](api-faults.md#InstanceQuotaExceededFault)
+ [StorageQuotaExceededFault](api-faults.md#StorageQuotaExceededFault)
+ [DBSubnetGroupNotFoundFault](api-faults.md#DBSubnetGroupNotFoundFault)
+ [DBSubnetGroupDoesNotCoverEnoughAZs](api-faults.md#DBSubnetGroupDoesNotCoverEnoughAZs)
+ [InvalidDBClusterStateFault](api-faults.md#InvalidDBClusterStateFault)
+ [InvalidSubnet](api-faults.md#InvalidSubnet)
+ [InvalidVPCNetworkStateFault](api-faults.md#InvalidVPCNetworkStateFault)
+ [ProvisionedIopsNotAvailableInAZFault](api-faults.md#ProvisionedIopsNotAvailableInAZFault)
+ [OptionGroupNotFoundFault](api-faults.md#OptionGroupNotFoundFault)
+ [DBClusterNotFoundFault](api-faults.md#DBClusterNotFoundFault)
+ [StorageTypeNotSupportedFault](api-faults.md#StorageTypeNotSupportedFault)
+ [AuthorizationNotFoundFault](api-faults.md#AuthorizationNotFoundFault)
+ [KMSKeyNotAccessibleFault](api-faults.md#KMSKeyNotAccessibleFault)
+ [DomainNotFoundFault](api-faults.md#DomainNotFoundFault)

## DeleteDBInstance（操作）
<a name="DeleteDBInstance"></a>

         此 API 的 Amazon CLI 名称为：`delete-db-instance`。

DeleteDBInstance 操作将删除先前预置的数据库实例。删除数据库实例时，会删除该实例的所有自动备份，且无法恢复。使用 `DeleteDBInstance` 删除数据库实例时，不删除其手动数据库快照。

 如果您请求最终数据库快照，则在创建数据库快照之前，Amazon Neptune 数据库实例的状态为 `deleting`。API 操作 `DescribeDBInstance` 可用于监控此操作的状态。操作一旦提交就无法取消或恢复。

请注意，当数据库实例处于 `failed`、`incompatible-restore` 或 `incompatible-network` 的失败状态时，只有在将 `SkipFinalSnapshot` 参数设置为 `true` 时才能删除它。

如果数据库实例是数据库集群中的唯一实例，或者启用了删除保护，则无法删除该实例。

**请求**
+ **DBInstanceIdentifier**（在 CLI 中：`--db-instance-identifier`）– *必需：*一个字符串，类型为：`string`（UTF-8 编码的字符串）。

  要删除的数据库实例的数据库实例标识符。该参数不区分大小写。

  约束：
  + 必须与现有数据库实例的名称匹配。
+ **FinalDBSnapshotIdentifier**（在 CLI 中：`--final-db-snapshot-identifier`）– 一个字符串，类型为：`string`（UTF-8 编码的字符串）。

   SkipFinalSnapshot 设置为 `false` 时，所创建新 DBSnapshot 的 DBSnapshotIdentifier。
**注意**  
指定此参数并且将 SkipFinalShapshot 参数设置为 true 会导致错误。

  约束：
  + 必须为 1 到 255 个字母或数字。
  + 第一个字符必须是字母
  + 不能以连字符结束或包含两个连续连字符
  + 删除只读副本时无法指定。
+ **SkipFinalSnapshot**（在 CLI 中：`--skip-final-snapshot`）– 一个布尔值，类型为：`boolean` [布尔值（true 或 false）]。

   确定删除数据库实例之前是否创建最终数据库快照。如果指定 `true`，则不创建 DBSnapshot。如果指定 `false`，则删除数据库实例之前创建一个数据库快照。

  请注意，当数据库实例处于“failed”、“incompatible-restore”或“incompatible-network”的失败状态时，只能在 SkipFinalSnapshot 参数设置为“true”时删除该实例。

  删除只读副本时指定 `true`。
**注意**  
如果 SkipFinalSnapshot 为 `false`，则必须指定 FinalDBSnapshotIdentifier 参数。

  默认值：`false`

**响应**

包含 Amazon Neptune 数据库实例的详细信息。

此数据类型用作 [DescribeDBInstances（操作）](#DescribeDBInstances) 操作中的响应元素。
+ **AutoMinorVersionUpgrade** - 一个布尔值，类型为：`boolean` [布尔值（true 或 false）]。

  指示自动应用次要版本补丁。
+ **AvailabilityZone** – 一个字符串，类型为：`string`（UTF-8 编码的字符串）。

  指定数据库实例所在可用区域的名称。
+ **BackupRetentionPeriod** – 一个整数，类型为：`integer`（带符号的 32 位整数）。

  指定自动数据库快照的保留天数。
+ **CACertificateIdentifier** – 一个字符串，类型为：`string`（UTF-8 编码的字符串）。

  此数据库实例的 CA 证书的标识符。
+ **CopyTagsToSnapshot** - 一个布尔值，类型为：`boolean` [布尔值（true 或 false）]。

  指定是否将标签从数据库实例复制到数据库实例的快照。
+ **DBClusterIdentifier** – 一个字符串，类型为：`string`（UTF-8 编码的字符串）。

  如果数据库实例属于某个数据库集群，则包含数据库实例所属的数据库集群的名称。
+ **DBInstanceArn** – 一个字符串，类型为：`string`（UTF-8 编码的字符串）。

  数据库实例的 Amazon 资源名称 (ARN)。
+ **DBInstanceClass** – 一个字符串，类型为：`string`（UTF-8 编码的字符串）。

  包含数据库实例的计算和内存容量级别名称。
+ **DBInstanceIdentifier** – 一个字符串，类型为：`string`（UTF-8 编码的字符串）。

  包含用户提供的数据库标识符。此标识符是标识数据库实例的唯一密钥。
+ **DbInstancePort** – 一个整数，类型为：`integer`（带符号的 32 位整数）。

  指定数据库实例侦听的端口。如果数据库实例属于某个数据库集群，则此端口可能不同于数据库集群的端口。
+ **DBInstanceStatus** – 一个字符串，类型为：`string`（UTF-8 编码的字符串）。

  指定此数据库的当前状态。
+ **DbiResourceId** – 一个字符串，类型为：`string`（UTF-8 编码的字符串）。

  数据库实例的 Amazon 区域唯一且不变的标识符。只要访问数据库实例的 Amazon KMS 密钥，就可以在 Amazon CloudTrail 日志条目中找到此标识符。
+ **DBName** – 一个字符串，类型为：`string`（UTF-8 编码的字符串）。

  数据库名称。
+ **DBParameterGroups** – [DBParameterGroupStatus](api-parameters.md#DBParameterGroupStatus) 对象的数组。

  提供应用到此数据库实例的数据库参数组的列表。
+ **DBSecurityGroups** – [DBSecurityGroupMembership](api-datatypes.md#DBSecurityGroupMembership) 对象的数组。

   提供仅包含 `DBSecurityGroup.Name` 和 `DBSecurityGroup.Status` 子元素的数据库安全组元素的列表。
+ **DBSubnetGroup** – 一个 [DBSubnetGroup](api-subnets.md#DBSubnetGroup) 对象。

  指定与数据库实例关联的子网组的信息，包括名称、描述和子网组中的子网。
+ **DeletionProtection** – BooleanOptional，类型为：`boolean` [布尔值（true 或 false）]。

  指示数据库实例是否已启用删除保护。在启用删除保护时，无法删除实例。请参阅[删除数据库实例](https://docs.amazonaws.cn/neptune/latest/userguide/manage-console-instances-delete.html)。
+ **DomainMemberships** – [DomainMembership](api-datatypes.md#DomainMembership) 对象的数组。

  不支持
+ **EnabledCloudwatchLogsExports** – 一个字符串，类型为：`string`（UTF-8 编码的字符串）。

  此数据库实例配置为导出到 CloudWatch Logs 的日志类型的列表。
+ **Endpoint** – 一个 [终端节点](api-datatypes.md#Endpoint) 对象。

  指定连接端点。
+ **Engine** – 一个字符串，类型为：`string`（UTF-8 编码的字符串）。

  提供要用于此数据库实例的数据库引擎的名称。
+ **EngineVersion** – 一个字符串，类型为：`string`（UTF-8 编码的字符串）。

  指示数据库引擎版本。
+ **EnhancedMonitoringResourceArn** – 一个字符串，类型为：`string`（UTF-8 编码的字符串）。

  接收数据库实例的增强监控指标数据的 Amazon CloudWatch Logs 日志流的 Amazon 资源名称 (ARN)。
+ **IAMDatabaseAuthenticationEnabled** - 一个布尔值，类型为：`boolean` [布尔值（true 或 false）]。

  如果 Amazon Identity and Access Management (IAM) 身份验证已启用，则为 true；否则为 false。
+ **InstanceCreateTime** – TStamp，类型为：`timestamp`（一个时间点，通常定义为与 1970 年 1 月 1 日午夜的偏移量）。

  提供创建数据库实例的日期和时间。
+ **Iops** – IntegerOptional，类型为：`integer`（带符号的 32 位整数）。

  指定预配置的 IOPS（每秒 I/O 操作数）值。
+ **KmsKeyId** – 一个字符串，类型为：`string`（UTF-8 编码的字符串）。

   不支持：数据库实例的加密由数据库集群管理。
+ **LatestRestorableTime** – TStamp，类型为：`timestamp`（一个时间点，通常定义为与 1970 年 1 月 1 日午夜的偏移量）。

  指定数据库可以使用时间点还原的最新还原时间。
+ **LicenseModel** – 一个字符串，类型为：`string`（UTF-8 编码的字符串）。

  该数据库实例的许可模式信息。
+ **MonitoringInterval** – IntegerOptional，类型为：`integer`（带符号的 32 位整数）。

  收集数据库实例的增强监控指标的时间点之间的间隔，以秒为单位。
+ **MonitoringRoleArn** – 一个字符串，类型为：`string`（UTF-8 编码的字符串）。

  允许 Neptune 将增强监控指标发送到 Amazon CloudWatch Logs 的 IAM 角色的 ARN。
+ **MultiAZ** - 一个布尔值，类型为：`boolean` [布尔值（true 或 false）]。

  指定数据库实例是否为多可用区部署。
+ **PendingModifiedValues** – 一个 [PendingModifiedValues](#PendingModifiedValues) 对象。

  指定对数据库实例的更改待处理。仅在更改待处理时包含此元素。特定更改由子元素标识。
+ **PreferredBackupWindow** – 一个字符串，类型为：`string`（UTF-8 编码的字符串）。

   指定在启用自动备份时，自动执行备份的日常时间范围，如 `BackupRetentionPeriod` 所规定。
+ **PreferredMaintenanceWindow** – 一个字符串，类型为：`string`（UTF-8 编码的字符串）。

  指定可进行系统维护的每周时间范围（采用通用协调时间 (UTC)）。
+ **PromotionTier** – IntegerOptional，类型为：`integer`（带符号的 32 位整数）。

  该值指定在现有主实例发生故障后将只读副本提升为主实例的顺序。
+ **PubliclyAccessible** - 一个布尔值，类型为：`boolean` [布尔值（true 或 false）]。

  此标记不应再使用。
+ **ReadReplicaDBClusterIdentifiers** – 一个字符串，类型为：`string`（UTF-8 编码的字符串）。

  包含一个或多个数据集集群（作为此数据库实例只读副本的集群）的标识符。
+ **ReadReplicaDBInstanceIdentifiers** – 一个字符串，类型为：`string`（UTF-8 编码的字符串）。

  包含一个或多个与此数据库实例关联的只读副本的标识符。
+ **ReadReplicaSourceDBInstanceIdentifier** – 一个字符串，类型为：`string`（UTF-8 编码的字符串）。

  包含源数据库实例（在此数据库实例是只读副本时）的标识符。
+ **SecondaryAvailabilityZone** – 一个字符串，类型为：`string`（UTF-8 编码的字符串）。

  如果存在，则指定带多可用区支持的数据库实例辅助可用区的名称。
+ **StatusInfos** – [DBInstanceStatusInfo](#DBInstanceStatusInfo) 对象的数组。

  只读副本的状态。如果实例不是只读副本，则此项空白。
+ **StorageEncrypted** - 一个布尔值，类型为：`boolean` [布尔值（true 或 false）]。

  不支持：数据库实例的加密由数据库集群管理。
+ **StorageType** – 一个字符串，类型为：`string`（UTF-8 编码的字符串）。

  指定与数据库实例关联的存储类型。
+ **TdeCredentialArn** – 一个字符串，类型为：`string`（UTF-8 编码的字符串）。

  来自密钥存储的 ARN，实例通过它进行关联用于 TDE 加密。
+ **Timezone** – 一个字符串，类型为：`string`（UTF-8 编码的字符串）。

  不支持。
+ **VpcSecurityGroups** – [VpcSecurityGroupMembership](api-datatypes.md#VpcSecurityGroupMembership) 对象的数组。

  提供数据库实例所属的 VPC 安全组元素的列表。

**错误**
+ [DBInstanceNotFoundFault](api-faults.md#DBInstanceNotFoundFault)
+ [InvalidDBInstanceStateFault](api-faults.md#InvalidDBInstanceStateFault)
+ [DBSnapshotAlreadyExistsFault](api-faults.md#DBSnapshotAlreadyExistsFault)
+ [SnapshotQuotaExceededFault](api-faults.md#SnapshotQuotaExceededFault)
+ [InvalidDBClusterStateFault](api-faults.md#InvalidDBClusterStateFault)

## ModifyDBInstance（操作）
<a name="ModifyDBInstance"></a>

         此 API 的 Amazon CLI 名称为：`modify-db-instance`。

修改数据库实例的设置。您可通过在请求中指定这些参数以及新值，更改一个或多个数据库配置参数。要了解您可对数据库实例进行哪些修改，请在调用[DescribeValidDBInstanceModifications（操作）](#DescribeValidDBInstanceModifications)之前调用[ModifyDBInstance（操作）](#ModifyDBInstance)。

**请求**
+ **AllowMajorVersionUpgrade**（在 CLI 中：`--allow-major-version-upgrade`）– 一个布尔值，类型为：`boolean` [布尔值（true 或 false）]。

  指示允许主要版本升级。更改此参数不会导致中断，所做更改会尽快以异步方式应用。
+ **ApplyImmediately**（在 CLI 中：`--apply-immediately`）– 一个布尔值，类型为：`boolean` [布尔值（true 或 false）]。

  指定是否应尽快异步应用此请求中修改及任何待处理修改，无论数据库实例的 `PreferredMaintenanceWindow` 设置如何。

   如果此参数设置为 `false`，则在下一个维护时段中应用对数据库实例的更改。某些参数更改会导致中断，在下次调用 [RebootDBInstance（操作）](#RebootDBInstance) 时或者下次故障重启时应用。

  默认值：`false`
+ **AutoMinorVersionUpgrade**（在 CLI 中：`--auto-minor-version-upgrade`）– BooleanOptional，类型为：`boolean` [布尔值（true 或 false）]。

   指示在维护时段期间，将对该数据库实例自动应用次要版本升级。更改此参数不会导致中断（除非在下列情况中），所做更改会尽快以异步方式应用。如果在维护时段内将此参数设置为 `true`，有较新的次要版本可用，并且 Neptune 已启用对该引擎版本的自动修补，则将导致服务中断。
+ **BackupRetentionPeriod**（在 CLI 中：`--backup-retention-period`）– IntegerOptional，类型为：`integer`（带符号的 32 位整数）。

  不适用。自动备份保留期由数据库集群管理。有关更多信息，请参阅 [ModifyDBCluster（操作）](api-clusters.md#ModifyDBCluster)。

  默认值：使用现有设置
+ **CACertificateIdentifier**（在 CLI 中：`--ca-certificate-identifier`）– 一个字符串，类型为：`string`（UTF-8 编码的字符串）。

  指示需要与实例相关联的证书。
+ **CloudwatchLogsExportConfiguration**（在 CLI 中：`--cloudwatch-logs-export-configuration`） – [CloudwatchLogsExportConfiguration](api-clusters.md#CloudwatchLogsExportConfiguration) 对象。

  要启用日志类型的配置设置，以便针对特定数据库实例或数据库集群导出到 CloudWatch Logs。
+ **CopyTagsToSnapshot**（在 CLI 中：`--copy-tags-to-snapshot`）– BooleanOptional，类型为：`boolean` [布尔值（true 或 false）]。

  如果为 true，则将数据库实例的所有标签复制到数据库实例的快照中，否则为 false。默认值为 false。
+ **DBInstanceClass**（在 CLI 中：`--db-instance-class`）– 一个字符串，类型为：`string`（UTF-8 编码的字符串）。

  数据库实例的新计算和内存容量，例如，`db.m4.large`。并非所有数据库实例类在所有 Amazon 区域中都可用。

  如果您修改数据库实例类，则在更改期间会发生中断。更改在下一个维护时段内应用，除非此请求的 `ApplyImmediately` 指定为 `true`。

  默认值：使用现有设置
+ **DBInstanceIdentifier**（在 CLI 中：`--db-instance-identifier`）– *必需：*一个字符串，类型为：`string`（UTF-8 编码的字符串）。

  数据库实例标识符。此值以一个小写字符串存储。

  约束：
  + 必须匹配现有 DBInstance 的标识符。
+ **DBParameterGroupName**（在 CLI 中：`--db-parameter-group-name`）– 一个字符串，类型为：`string`（UTF-8 编码的字符串）。

  要应用到数据库实例的数据库参数组的名称。更改此设置不会导致中断。参数组名称本身将立即发生更改，但在您重新启动实例而不进行故障转移之前，不会应用实际参数更改。在下一个维护时段内，将不自动重启数据库实例，并且不应用参数更改。

  默认值：使用现有设置

  约束：数据库参数组必须与此数据库实例位于同一个数据库参数组系列中。
+ **DBPortNumber**（在 CLI 中：`--db-port-number`）– IntegerOptional，类型为：`integer`（带符号的 32 位整数）。

  数据库实例接受连接的端口编号。

  `DBPortNumber` 参数的值不能与为数据库实例选项组中的选项指定的任何端口值相同。

  不论 `DBPortNumber` 参数的值如何，在您更改 `ApplyImmediately` 值时，数据库将重启。

   默认值：`8182`
+ **DBSecurityGroups**（在 CLI 中：`--db-security-groups`）– 一个字符串，类型为：`string`（UTF-8 编码的字符串）。

  在此数据库实例上授权的数据库安全组的列表。更改此设置不会导致中断，所做更改会尽快以异步方式应用。

  约束：
  + 如果提供，则必须匹配现有 DBSecurityGroups。
+ **DBSubnetGroupName**（在 CLI 中：`--db-subnet-group-name`）– 一个字符串，类型为：`string`（UTF-8 编码的字符串）。

  数据库实例的新数据库子网组。您可以使用此参数将数据库实例移动到其他 VPC。

  更改子网组将导致更改期间发生中断。更改在下一个维护时段内应用，除非您为 `true` 参数指定 `ApplyImmediately`。

  约束：如果提供，则必须与现有 DBSubnetGroup 的名称匹配。

  示例：`mySubnetGroup`
+ **DeletionProtection**（在 CLI 中：`--deletion-protection`）– BooleanOptional，类型为：`boolean` [布尔值（true 或 false）]。

  指示数据库实例是否已启用删除保护的值。在启用删除保护时，无法删除数据库。默认情况下，将禁用删除保护。请参阅[删除数据库实例](https://docs.amazonaws.cn/neptune/latest/userguide/manage-console-instances-delete.html)。
+ **Domain**（在 CLI 中：`--domain`）– 一个字符串，类型为：`string`（UTF-8 编码的字符串）。

  不支持。
+ **DomainIAMRoleName**（在 CLI 中：`--domain-iam-role-name`）– 一个字符串，类型为：`string`（UTF-8 编码的字符串）。

  不支持
+ **EnableIAMDatabaseAuthentication**（在 CLI 中：`--enable-iam-database-authentication`）– BooleanOptional，类型为：`boolean` [布尔值（true 或 false）]。

  如果启用 Amazon Identity and Access Management (IAM) 账户与数据库账户之间的映射，则为 true；否则为 false。

  您可以为以下数据库引擎启用 IAM 数据库身份验证

  不适用。将 Amazon IAM 账户映射到数据库账户是由数据库集群管理的。有关更多信息，请参阅 [ModifyDBCluster（操作）](api-clusters.md#ModifyDBCluster)。

  默认值：`false`
+ **EngineVersion**（在 CLI 中：`--engine-version`）– 一个字符串，类型为：`string`（UTF-8 编码的字符串）。

  数据库引擎要升级到的版本号。目前，设置此参数不起作用。要将数据库引擎升级到最新版本，请使用 [ApplyPendingMaintenanceAction（操作）](api-other-apis.md#ApplyPendingMaintenanceAction) API。
+ **Iops**（在 CLI 中：`--iops`）– IntegerOptional，类型为：`integer`（带符号的 32 位整数）。

  实例的新预配置 IOPS（每秒 I/O 操作数）值。

  更改此设置不会导致中断，除非此请求的 `ApplyImmediately` 参数设置为 `true`，否则将在下个维护时段应用更改。

  默认值：使用现有设置
+ **MonitoringInterval**（在 CLI 中：`--monitoring-interval`）– IntegerOptional，类型为：`integer`（带符号的 32 位整数）。

  收集数据库实例的增强监控指标的时间点之间的间隔，以秒为单位。要禁用收集增强监控指标，请指定 0。默认值是 0。

  如果指定 `MonitoringRoleArn`，则您还必须将 `MonitoringInterval` 设置为 0 以外的值。

  有效值：`0, 1, 5, 10, 15, 30, 60`
+ **MonitoringRoleArn**（在 CLI 中：`--monitoring-role-arn`）– 一个字符串，类型为：`string`（UTF-8 编码的字符串）。

  允许 Neptune 将增强监控指标发送到 Amazon CloudWatch Logs 的 IAM 角色的 ARN。例如 `arn:aws:iam:123456789012:role/emaccess`。

  如果 `MonitoringInterval` 设置为 0 以外的值，则您必须提供 `MonitoringRoleArn` 值。
+ **MultiAZ**（在 CLI 中：`--multi-az`）– BooleanOptional，类型为：`boolean` [布尔值（true 或 false）]。

  指定数据库实例是否为多可用区部署。更改此参数不会导致中断，除非此请求的 `ApplyImmediately` 参数设置为 `true`，否则将在下个维护时段应用更改。
+ **NewDBInstanceIdentifier**（在 CLI 中：`--new-db-instance-identifier`）– 一个字符串，类型为：`string`（UTF-8 编码的字符串）。

   重命名数据库实例时数据库实例的新标识符。在更改数据库实例标识符的时候，若将 `Apply Immediately` 设置为 true，则实例立即重启；若将 `Apply Immediately` 设置为 false，则实例将在下一个维护时段重启。此值以一个小写字符串存储。

  约束：
  + 必须包含 1 到 63 个字母、数字或连字符。
  + 第一个字符必须是字母。
  + 不能以连字符结束或包含两个连续连字符。

  示例：`mydbinstance`
+ **PreferredBackupWindow**（在 CLI 中：`--preferred-backup-window`）– 一个字符串，类型为：`string`（UTF-8 编码的字符串）。

   如果启用自动备份，该属性指定创建自动备份的日常时间范围。

  不适用。每天创建自动备份的时间范围由数据库集群管理。有关更多信息，请参阅 [ModifyDBCluster（操作）](api-clusters.md#ModifyDBCluster)。

  约束：
  + 必须采用 hh24:mi-hh24:mi 格式
  + 必须采用协调世界时 (UTC)
  + 不得与首选维护时段冲突
  + 必须至少为 30 分钟
+ **PreferredMaintenanceWindow**（在 CLI 中：`--preferred-maintenance-window`）– 一个字符串，类型为：`string`（UTF-8 编码的字符串）。

  可进行系统维护的每周时间范围（采用 UTC），这可能导致中断。更改此参数不会导致中断（除非在下列情况中），所做更改会尽快以异步方式应用。如果有待处理的操作导致服务重启，并且维护时段经过更改，加入了当前时间，则更改此参数将导致数据库实例重启。如果将此时段移动到当前时间，则当前时间与时段结束之间必须相隔至少 30 分钟以确保应用待处理的更改。

  默认值：使用现有设置

  格式：ddd:hh24:mi-ddd:hh24:mi

  有效值：Mon \| Tue \| Wed \| Thu \| Fri \| Sat \| Sun

  约束：必须至少为 30 分钟
+ **PromotionTier**（在 CLI 中：`--promotion-tier`）– IntegerOptional，类型为：`integer`（带符号的 32 位整数）。

  该值指定在现有主实例发生故障后将只读副本提升为主实例的顺序。

  默认值：1

  有效值：0 - 15
+ **PubliclyAccessible**（在 CLI 中：`--publicly-accessible`）– BooleanOptional，类型为：`boolean` [布尔值（true 或 false）]。

  此标记不应再使用。
+ **StorageType**（在 CLI 中：`--storage-type`）– 一个字符串，类型为：`string`（UTF-8 编码的字符串）。

  不适用。在 Neptune 中，存储类型在数据库集群级别进行管理。
+ **TdeCredentialArn**（在 CLI 中：`--tde-credential-arn`）– 一个字符串，类型为：`string`（UTF-8 编码的字符串）。

  来自密钥存储的 ARN，实例通过它进行关联用于 TDE 加密。
+ **TdeCredentialPassword**（在 CLI 中：`--tde-credential-password`）– 一个敏感字符串，类型为：`string`（UTF-8 编码的字符串）。

  密钥存储中指定 ARN 的密码，以便访问设备。
+ **VpcSecurityGroupIds**（在 CLI 中：`--vpc-security-group-ids`）– 一个字符串，类型为：`string`（UTF-8 编码的字符串）。

  在此数据库实例上授权的 EC2 VPC 安全组的列表。此更改会尽快异步应用。

  不适用。关联的 EC2 VPC 安全组列表由数据库集群管理。有关更多信息，请参阅 [ModifyDBCluster（操作）](api-clusters.md#ModifyDBCluster)。

  约束：
  + 如果提供，则必须匹配现有 VpcSecurityGroupIds。

**响应**

包含 Amazon Neptune 数据库实例的详细信息。

此数据类型用作 [DescribeDBInstances（操作）](#DescribeDBInstances) 操作中的响应元素。
+ **AutoMinorVersionUpgrade** - 一个布尔值，类型为：`boolean` [布尔值（true 或 false）]。

  指示自动应用次要版本补丁。
+ **AvailabilityZone** – 一个字符串，类型为：`string`（UTF-8 编码的字符串）。

  指定数据库实例所在可用区域的名称。
+ **BackupRetentionPeriod** – 一个整数，类型为：`integer`（带符号的 32 位整数）。

  指定自动数据库快照的保留天数。
+ **CACertificateIdentifier** – 一个字符串，类型为：`string`（UTF-8 编码的字符串）。

  此数据库实例的 CA 证书的标识符。
+ **CopyTagsToSnapshot** - 一个布尔值，类型为：`boolean` [布尔值（true 或 false）]。

  指定是否将标签从数据库实例复制到数据库实例的快照。
+ **DBClusterIdentifier** – 一个字符串，类型为：`string`（UTF-8 编码的字符串）。

  如果数据库实例属于某个数据库集群，则包含数据库实例所属的数据库集群的名称。
+ **DBInstanceArn** – 一个字符串，类型为：`string`（UTF-8 编码的字符串）。

  数据库实例的 Amazon 资源名称 (ARN)。
+ **DBInstanceClass** – 一个字符串，类型为：`string`（UTF-8 编码的字符串）。

  包含数据库实例的计算和内存容量级别名称。
+ **DBInstanceIdentifier** – 一个字符串，类型为：`string`（UTF-8 编码的字符串）。

  包含用户提供的数据库标识符。此标识符是标识数据库实例的唯一密钥。
+ **DbInstancePort** – 一个整数，类型为：`integer`（带符号的 32 位整数）。

  指定数据库实例侦听的端口。如果数据库实例属于某个数据库集群，则此端口可能不同于数据库集群的端口。
+ **DBInstanceStatus** – 一个字符串，类型为：`string`（UTF-8 编码的字符串）。

  指定此数据库的当前状态。
+ **DbiResourceId** – 一个字符串，类型为：`string`（UTF-8 编码的字符串）。

  数据库实例的 Amazon 区域唯一且不变的标识符。只要访问数据库实例的 Amazon KMS 密钥，就可以在 Amazon CloudTrail 日志条目中找到此标识符。
+ **DBName** – 一个字符串，类型为：`string`（UTF-8 编码的字符串）。

  数据库名称。
+ **DBParameterGroups** – [DBParameterGroupStatus](api-parameters.md#DBParameterGroupStatus) 对象的数组。

  提供应用到此数据库实例的数据库参数组的列表。
+ **DBSecurityGroups** – [DBSecurityGroupMembership](api-datatypes.md#DBSecurityGroupMembership) 对象的数组。

   提供仅包含 `DBSecurityGroup.Name` 和 `DBSecurityGroup.Status` 子元素的数据库安全组元素的列表。
+ **DBSubnetGroup** – 一个 [DBSubnetGroup](api-subnets.md#DBSubnetGroup) 对象。

  指定与数据库实例关联的子网组的信息，包括名称、描述和子网组中的子网。
+ **DeletionProtection** – BooleanOptional，类型为：`boolean` [布尔值（true 或 false）]。

  指示数据库实例是否已启用删除保护。在启用删除保护时，无法删除实例。请参阅[删除数据库实例](https://docs.amazonaws.cn/neptune/latest/userguide/manage-console-instances-delete.html)。
+ **DomainMemberships** – [DomainMembership](api-datatypes.md#DomainMembership) 对象的数组。

  不支持
+ **EnabledCloudwatchLogsExports** – 一个字符串，类型为：`string`（UTF-8 编码的字符串）。

  此数据库实例配置为导出到 CloudWatch Logs 的日志类型的列表。
+ **Endpoint** – 一个 [终端节点](api-datatypes.md#Endpoint) 对象。

  指定连接端点。
+ **Engine** – 一个字符串，类型为：`string`（UTF-8 编码的字符串）。

  提供要用于此数据库实例的数据库引擎的名称。
+ **EngineVersion** – 一个字符串，类型为：`string`（UTF-8 编码的字符串）。

  指示数据库引擎版本。
+ **EnhancedMonitoringResourceArn** – 一个字符串，类型为：`string`（UTF-8 编码的字符串）。

  接收数据库实例的增强监控指标数据的 Amazon CloudWatch Logs 日志流的 Amazon 资源名称 (ARN)。
+ **IAMDatabaseAuthenticationEnabled** - 一个布尔值，类型为：`boolean` [布尔值（true 或 false）]。

  如果 Amazon Identity and Access Management (IAM) 身份验证已启用，则为 true；否则为 false。
+ **InstanceCreateTime** – TStamp，类型为：`timestamp`（一个时间点，通常定义为与 1970 年 1 月 1 日午夜的偏移量）。

  提供创建数据库实例的日期和时间。
+ **Iops** – IntegerOptional，类型为：`integer`（带符号的 32 位整数）。

  指定预配置的 IOPS（每秒 I/O 操作数）值。
+ **KmsKeyId** – 一个字符串，类型为：`string`（UTF-8 编码的字符串）。

   不支持：数据库实例的加密由数据库集群管理。
+ **LatestRestorableTime** – TStamp，类型为：`timestamp`（一个时间点，通常定义为与 1970 年 1 月 1 日午夜的偏移量）。

  指定数据库可以使用时间点还原的最新还原时间。
+ **LicenseModel** – 一个字符串，类型为：`string`（UTF-8 编码的字符串）。

  该数据库实例的许可模式信息。
+ **MonitoringInterval** – IntegerOptional，类型为：`integer`（带符号的 32 位整数）。

  收集数据库实例的增强监控指标的时间点之间的间隔，以秒为单位。
+ **MonitoringRoleArn** – 一个字符串，类型为：`string`（UTF-8 编码的字符串）。

  允许 Neptune 将增强监控指标发送到 Amazon CloudWatch Logs 的 IAM 角色的 ARN。
+ **MultiAZ** - 一个布尔值，类型为：`boolean` [布尔值（true 或 false）]。

  指定数据库实例是否为多可用区部署。
+ **PendingModifiedValues** – 一个 [PendingModifiedValues](#PendingModifiedValues) 对象。

  指定对数据库实例的更改待处理。仅在更改待处理时包含此元素。特定更改由子元素标识。
+ **PreferredBackupWindow** – 一个字符串，类型为：`string`（UTF-8 编码的字符串）。

   指定在启用自动备份时，自动执行备份的日常时间范围，如 `BackupRetentionPeriod` 所规定。
+ **PreferredMaintenanceWindow** – 一个字符串，类型为：`string`（UTF-8 编码的字符串）。

  指定可进行系统维护的每周时间范围（采用通用协调时间 (UTC)）。
+ **PromotionTier** – IntegerOptional，类型为：`integer`（带符号的 32 位整数）。

  该值指定在现有主实例发生故障后将只读副本提升为主实例的顺序。
+ **PubliclyAccessible** - 一个布尔值，类型为：`boolean` [布尔值（true 或 false）]。

  此标记不应再使用。
+ **ReadReplicaDBClusterIdentifiers** – 一个字符串，类型为：`string`（UTF-8 编码的字符串）。

  包含一个或多个数据集集群（作为此数据库实例只读副本的集群）的标识符。
+ **ReadReplicaDBInstanceIdentifiers** – 一个字符串，类型为：`string`（UTF-8 编码的字符串）。

  包含一个或多个与此数据库实例关联的只读副本的标识符。
+ **ReadReplicaSourceDBInstanceIdentifier** – 一个字符串，类型为：`string`（UTF-8 编码的字符串）。

  包含源数据库实例（在此数据库实例是只读副本时）的标识符。
+ **SecondaryAvailabilityZone** – 一个字符串，类型为：`string`（UTF-8 编码的字符串）。

  如果存在，则指定带多可用区支持的数据库实例辅助可用区的名称。
+ **StatusInfos** – [DBInstanceStatusInfo](#DBInstanceStatusInfo) 对象的数组。

  只读副本的状态。如果实例不是只读副本，则此项空白。
+ **StorageEncrypted** - 一个布尔值，类型为：`boolean` [布尔值（true 或 false）]。

  不支持：数据库实例的加密由数据库集群管理。
+ **StorageType** – 一个字符串，类型为：`string`（UTF-8 编码的字符串）。

  指定与数据库实例关联的存储类型。
+ **TdeCredentialArn** – 一个字符串，类型为：`string`（UTF-8 编码的字符串）。

  来自密钥存储的 ARN，实例通过它进行关联用于 TDE 加密。
+ **Timezone** – 一个字符串，类型为：`string`（UTF-8 编码的字符串）。

  不支持。
+ **VpcSecurityGroups** – [VpcSecurityGroupMembership](api-datatypes.md#VpcSecurityGroupMembership) 对象的数组。

  提供数据库实例所属的 VPC 安全组元素的列表。

**错误**
+ [InvalidDBInstanceStateFault](api-faults.md#InvalidDBInstanceStateFault)
+ [InvalidDBSecurityGroupStateFault](api-faults.md#InvalidDBSecurityGroupStateFault)
+ [DBInstanceAlreadyExistsFault](api-faults.md#DBInstanceAlreadyExistsFault)
+ [DBInstanceNotFoundFault](api-faults.md#DBInstanceNotFoundFault)
+ [DBSecurityGroupNotFoundFault](api-faults.md#DBSecurityGroupNotFoundFault)
+ [DBParameterGroupNotFoundFault](api-faults.md#DBParameterGroupNotFoundFault)
+ [InsufficientDBInstanceCapacityFault](api-faults.md#InsufficientDBInstanceCapacityFault)
+ [StorageQuotaExceededFault](api-faults.md#StorageQuotaExceededFault)
+ [InvalidVPCNetworkStateFault](api-faults.md#InvalidVPCNetworkStateFault)
+ [ProvisionedIopsNotAvailableInAZFault](api-faults.md#ProvisionedIopsNotAvailableInAZFault)
+ [OptionGroupNotFoundFault](api-faults.md#OptionGroupNotFoundFault)
+ [DBUpgradeDependencyFailureFault](api-faults.md#DBUpgradeDependencyFailureFault)
+ [StorageTypeNotSupportedFault](api-faults.md#StorageTypeNotSupportedFault)
+ [AuthorizationNotFoundFault](api-faults.md#AuthorizationNotFoundFault)
+ [CertificateNotFoundFault](api-faults.md#CertificateNotFoundFault)
+ [DomainNotFoundFault](api-faults.md#DomainNotFoundFault)

## RebootDBInstance（操作）
<a name="RebootDBInstance"></a>

         此 API 的 Amazon CLI 名称为：`reboot-db-instance`。

您可能需要重启数据库实例，通常是出于维护目的。例如，如果进行某些修改或更改与数据库实例关联的数据库参数组，您必须重启该实例以使更改生效。

重启数据库实例会重新启动数据库引擎服务。重启数据库实例将导致短暂中断，在此期间，数据库实例状态将设置为正在重启。

**请求**
+ **DBInstanceIdentifier**（在 CLI 中：`--db-instance-identifier`）– *必需：*一个字符串，类型为：`string`（UTF-8 编码的字符串）。

  数据库实例标识符。该参数作为一个小写字符串存储。

  约束：
  + 必须匹配现有 DBInstance 的标识符。
+ **ForceFailover**（在 CLI 中：`--force-failover`）– BooleanOptional，类型为：`boolean` [布尔值（true 或 false）]。

   如果为 `true`，则通过多可用区故障转移进行重启。

  约束：如果没有为多可用区配置实例，则无法指定 `true`。

**响应**

包含 Amazon Neptune 数据库实例的详细信息。

此数据类型用作 [DescribeDBInstances（操作）](#DescribeDBInstances) 操作中的响应元素。
+ **AutoMinorVersionUpgrade** - 一个布尔值，类型为：`boolean` [布尔值（true 或 false）]。

  指示自动应用次要版本补丁。
+ **AvailabilityZone** – 一个字符串，类型为：`string`（UTF-8 编码的字符串）。

  指定数据库实例所在可用区域的名称。
+ **BackupRetentionPeriod** – 一个整数，类型为：`integer`（带符号的 32 位整数）。

  指定自动数据库快照的保留天数。
+ **CACertificateIdentifier** – 一个字符串，类型为：`string`（UTF-8 编码的字符串）。

  此数据库实例的 CA 证书的标识符。
+ **CopyTagsToSnapshot** - 一个布尔值，类型为：`boolean` [布尔值（true 或 false）]。

  指定是否将标签从数据库实例复制到数据库实例的快照。
+ **DBClusterIdentifier** – 一个字符串，类型为：`string`（UTF-8 编码的字符串）。

  如果数据库实例属于某个数据库集群，则包含数据库实例所属的数据库集群的名称。
+ **DBInstanceArn** – 一个字符串，类型为：`string`（UTF-8 编码的字符串）。

  数据库实例的 Amazon 资源名称 (ARN)。
+ **DBInstanceClass** – 一个字符串，类型为：`string`（UTF-8 编码的字符串）。

  包含数据库实例的计算和内存容量级别名称。
+ **DBInstanceIdentifier** – 一个字符串，类型为：`string`（UTF-8 编码的字符串）。

  包含用户提供的数据库标识符。此标识符是标识数据库实例的唯一密钥。
+ **DbInstancePort** – 一个整数，类型为：`integer`（带符号的 32 位整数）。

  指定数据库实例侦听的端口。如果数据库实例属于某个数据库集群，则此端口可能不同于数据库集群的端口。
+ **DBInstanceStatus** – 一个字符串，类型为：`string`（UTF-8 编码的字符串）。

  指定此数据库的当前状态。
+ **DbiResourceId** – 一个字符串，类型为：`string`（UTF-8 编码的字符串）。

  数据库实例的 Amazon 区域唯一且不变的标识符。只要访问数据库实例的 Amazon KMS 密钥，就可以在 Amazon CloudTrail 日志条目中找到此标识符。
+ **DBName** – 一个字符串，类型为：`string`（UTF-8 编码的字符串）。

  数据库名称。
+ **DBParameterGroups** – [DBParameterGroupStatus](api-parameters.md#DBParameterGroupStatus) 对象的数组。

  提供应用到此数据库实例的数据库参数组的列表。
+ **DBSecurityGroups** – [DBSecurityGroupMembership](api-datatypes.md#DBSecurityGroupMembership) 对象的数组。

   提供仅包含 `DBSecurityGroup.Name` 和 `DBSecurityGroup.Status` 子元素的数据库安全组元素的列表。
+ **DBSubnetGroup** – 一个 [DBSubnetGroup](api-subnets.md#DBSubnetGroup) 对象。

  指定与数据库实例关联的子网组的信息，包括名称、描述和子网组中的子网。
+ **DeletionProtection** – BooleanOptional，类型为：`boolean` [布尔值（true 或 false）]。

  指示数据库实例是否已启用删除保护。在启用删除保护时，无法删除实例。请参阅[删除数据库实例](https://docs.amazonaws.cn/neptune/latest/userguide/manage-console-instances-delete.html)。
+ **DomainMemberships** – [DomainMembership](api-datatypes.md#DomainMembership) 对象的数组。

  不支持
+ **EnabledCloudwatchLogsExports** – 一个字符串，类型为：`string`（UTF-8 编码的字符串）。

  此数据库实例配置为导出到 CloudWatch Logs 的日志类型的列表。
+ **Endpoint** – 一个 [终端节点](api-datatypes.md#Endpoint) 对象。

  指定连接端点。
+ **Engine** – 一个字符串，类型为：`string`（UTF-8 编码的字符串）。

  提供要用于此数据库实例的数据库引擎的名称。
+ **EngineVersion** – 一个字符串，类型为：`string`（UTF-8 编码的字符串）。

  指示数据库引擎版本。
+ **EnhancedMonitoringResourceArn** – 一个字符串，类型为：`string`（UTF-8 编码的字符串）。

  接收数据库实例的增强监控指标数据的 Amazon CloudWatch Logs 日志流的 Amazon 资源名称 (ARN)。
+ **IAMDatabaseAuthenticationEnabled** - 一个布尔值，类型为：`boolean` [布尔值（true 或 false）]。

  如果 Amazon Identity and Access Management (IAM) 身份验证已启用，则为 true；否则为 false。
+ **InstanceCreateTime** – TStamp，类型为：`timestamp`（一个时间点，通常定义为与 1970 年 1 月 1 日午夜的偏移量）。

  提供创建数据库实例的日期和时间。
+ **Iops** – IntegerOptional，类型为：`integer`（带符号的 32 位整数）。

  指定预配置的 IOPS（每秒 I/O 操作数）值。
+ **KmsKeyId** – 一个字符串，类型为：`string`（UTF-8 编码的字符串）。

   不支持：数据库实例的加密由数据库集群管理。
+ **LatestRestorableTime** – TStamp，类型为：`timestamp`（一个时间点，通常定义为与 1970 年 1 月 1 日午夜的偏移量）。

  指定数据库可以使用时间点还原的最新还原时间。
+ **LicenseModel** – 一个字符串，类型为：`string`（UTF-8 编码的字符串）。

  该数据库实例的许可模式信息。
+ **MonitoringInterval** – IntegerOptional，类型为：`integer`（带符号的 32 位整数）。

  收集数据库实例的增强监控指标的时间点之间的间隔，以秒为单位。
+ **MonitoringRoleArn** – 一个字符串，类型为：`string`（UTF-8 编码的字符串）。

  允许 Neptune 将增强监控指标发送到 Amazon CloudWatch Logs 的 IAM 角色的 ARN。
+ **MultiAZ** - 一个布尔值，类型为：`boolean` [布尔值（true 或 false）]。

  指定数据库实例是否为多可用区部署。
+ **PendingModifiedValues** – 一个 [PendingModifiedValues](#PendingModifiedValues) 对象。

  指定对数据库实例的更改待处理。仅在更改待处理时包含此元素。特定更改由子元素标识。
+ **PreferredBackupWindow** – 一个字符串，类型为：`string`（UTF-8 编码的字符串）。

   指定在启用自动备份时，自动执行备份的日常时间范围，如 `BackupRetentionPeriod` 所规定。
+ **PreferredMaintenanceWindow** – 一个字符串，类型为：`string`（UTF-8 编码的字符串）。

  指定可进行系统维护的每周时间范围（采用通用协调时间 (UTC)）。
+ **PromotionTier** – IntegerOptional，类型为：`integer`（带符号的 32 位整数）。

  该值指定在现有主实例发生故障后将只读副本提升为主实例的顺序。
+ **PubliclyAccessible** - 一个布尔值，类型为：`boolean` [布尔值（true 或 false）]。

  此标记不应再使用。
+ **ReadReplicaDBClusterIdentifiers** – 一个字符串，类型为：`string`（UTF-8 编码的字符串）。

  包含一个或多个数据集集群（作为此数据库实例只读副本的集群）的标识符。
+ **ReadReplicaDBInstanceIdentifiers** – 一个字符串，类型为：`string`（UTF-8 编码的字符串）。

  包含一个或多个与此数据库实例关联的只读副本的标识符。
+ **ReadReplicaSourceDBInstanceIdentifier** – 一个字符串，类型为：`string`（UTF-8 编码的字符串）。

  包含源数据库实例（在此数据库实例是只读副本时）的标识符。
+ **SecondaryAvailabilityZone** – 一个字符串，类型为：`string`（UTF-8 编码的字符串）。

  如果存在，则指定带多可用区支持的数据库实例辅助可用区的名称。
+ **StatusInfos** – [DBInstanceStatusInfo](#DBInstanceStatusInfo) 对象的数组。

  只读副本的状态。如果实例不是只读副本，则此项空白。
+ **StorageEncrypted** - 一个布尔值，类型为：`boolean` [布尔值（true 或 false）]。

  不支持：数据库实例的加密由数据库集群管理。
+ **StorageType** – 一个字符串，类型为：`string`（UTF-8 编码的字符串）。

  指定与数据库实例关联的存储类型。
+ **TdeCredentialArn** – 一个字符串，类型为：`string`（UTF-8 编码的字符串）。

  来自密钥存储的 ARN，实例通过它进行关联用于 TDE 加密。
+ **Timezone** – 一个字符串，类型为：`string`（UTF-8 编码的字符串）。

  不支持。
+ **VpcSecurityGroups** – [VpcSecurityGroupMembership](api-datatypes.md#VpcSecurityGroupMembership) 对象的数组。

  提供数据库实例所属的 VPC 安全组元素的列表。

**错误**
+ [InvalidDBInstanceStateFault](api-faults.md#InvalidDBInstanceStateFault)
+ [DBInstanceNotFoundFault](api-faults.md#DBInstanceNotFoundFault)

## DescribeDBInstances（操作）
<a name="DescribeDBInstances"></a>

         此 API 的 Amazon CLI 名称为：`describe-db-instances`。

返回有关预配置的实例的信息，并支持分页。

**注意**  
此操作还可以返回 Amazon RDS 实例和 Amazon DocDB 实例的信息。

**请求**
+ **DBInstanceIdentifier**（在 CLI 中：`--db-instance-identifier`）– 一个字符串，类型为：`string`（UTF-8 编码的字符串）。

  用户提供的实例标识符。如果指定了此参数，则只返回特定数据库实例的信息。该参数不区分大小写。

  约束：
  + 如果提供，必须匹配现有 DBInstance 的标识符。
+ **Filters**：（在 CLI 中：`--filters`）[筛选条件](api-datatypes.md#Filter) 对象的数组。

  筛选条件指定要描述的一个或多个数据库实例。

  支持的筛选条件：
  +  `db-cluster-id` - 接受数据库集群标识符和数据库集群 Amazon 资源名称 (ARN)。该结果列表仅包括与这些 ARN 所标识数据库集群关联的数据库实例的相关信息。
  + `engine` - 接受引擎名称（例如 `neptune`），并将结果列表限制为由该引擎创建的数据库实例。

  例如，要从 Amazon CLI 调用此 API 并进行筛选，以便仅返回 Neptune 数据库实例，您可以使用以下命令：  
**Example**  

  ```
  aws neptune describe-db-instances \
              --filters  Name=engine,Values=neptune
  ```
+ **Marker**（在 CLI 中：`--marker`）– 一个字符串，类型为：`string`（UTF-8 编码的字符串）。

   由之前的 `DescribeDBInstances` 请求提供的可选分页标记。如果指定此参数，则响应仅包含标记之外的记录，最大数量为 `MaxRecords` 指定的值。
+ **MaxRecords**（在 CLI 中：`--max-records`）– IntegerOptional，类型为：`integer`（带符号的 32 位整数）。

   包括在响应中的最大记录数。如果存在的记录数超过了指定的`MaxRecords` 值，则在响应中包含称为标记的分页记号，以便检索剩余的结果。

  默认值：100

  约束：最低为 20，最高为 100。

**响应**
+ **DBInstances** – [DBInstance](#DBInstance) 对象的数组。

   [DBInstance（结构）](#DBInstance) 实例的列表。
+ **Marker** – 一个字符串，类型为：`string`（UTF-8 编码的字符串）。

   由之前的请求提供的可选分页标记。如果指定此参数，则响应仅包含标记之外的记录，最大数量为 `MaxRecords` 指定的值。

**错误**
+ [DBInstanceNotFoundFault](api-faults.md#DBInstanceNotFoundFault)

## DescribeOrderableDBInstanceOptions（操作）
<a name="DescribeOrderableDBInstanceOptions"></a>

         此 API 的 Amazon CLI 名称为：`describe-orderable-db-instance-options`。

返回指定引擎的可订购数据库实例选项的列表。

**请求**
+ **DBInstanceClass**（在 CLI 中：`--db-instance-class`）– 一个字符串，类型为：`string`（UTF-8 编码的字符串）。

  数据库实例类筛选值。指定此参数以只显示与指定数据库实例类匹配的可用产品。
+ **Engine**（在 CLI 中：`--engine`）– *必需：*一个字符串，类型为：`string`（UTF-8 编码的字符串）。

  为其检索数据库实例选项的引擎的名称。
+ **EngineVersion**（在 CLI 中：`--engine-version`）– 一个字符串，类型为：`string`（UTF-8 编码的字符串）。

  引擎版本筛选值。指定此参数以只显示与指定引擎版本匹配的可用产品。
+ **Filters**：（在 CLI 中：`--filters`）[筛选条件](api-datatypes.md#Filter) 对象的数组。

  当前不支持此参数。
+ **LicenseModel**（在 CLI 中：`--license-model`）– 一个字符串，类型为：`string`（UTF-8 编码的字符串）。

  许可模式筛选值。指定此参数以只显示与指定许可模式匹配的可用产品。
+ **Marker**（在 CLI 中：`--marker`）– 一个字符串，类型为：`string`（UTF-8 编码的字符串）。

   由之前的 DescribeOrderableDBInstanceOptions 请求提供的可选分页标记。如果指定此参数，则响应仅包含标记之外的记录，最大数量为 `MaxRecords` 指定的值。
+ **MaxRecords**（在 CLI 中：`--max-records`）– IntegerOptional，类型为：`integer`（带符号的 32 位整数）。

   包括在响应中的最大记录数。如果存在的记录数超过了指定的`MaxRecords` 值，则在响应中包含称为标记的分页记号，以便检索剩余的结果。

  默认值：100

  约束：最低为 20，最高为 100。
+ **Vpc**（在 CLI 中：`--vpc`）– BooleanOptional，类型为：`boolean` [布尔值（true 或 false）]。

  VPC 筛选值。指定此参数以只显示可用的 VPC 或非 VPC 产品。

**响应**
+ **Marker** – 一个字符串，类型为：`string`（UTF-8 编码的字符串）。

   由之前的 OrderableDBInstanceOptions 请求提供的可选分页标记。如果指定此参数，则响应仅包含标记之外的记录，最大数量为 `MaxRecords` 指定的值。
+ **OrderableDBInstanceOptions** – [OrderableDBInstanceOption](#OrderableDBInstanceOption) 对象的数组。

  一个 [OrderableDBInstanceOption（结构）](#OrderableDBInstanceOption) 结构，其中包含有关数据库实例可订购选项的信息。

## DescribeValidDBInstanceModifications（操作）
<a name="DescribeValidDBInstanceModifications"></a>

         此 API 的 Amazon CLI 名称为：`describe-valid-db-instance-modifications`。

您可以调用 [DescribeValidDBInstanceModifications（操作）](#DescribeValidDBInstanceModifications) 来了解可以对数据库实例进行哪些修改。您可在调用 [ModifyDBInstance（操作）](#ModifyDBInstance) 时使用此信息。

**请求**
+ **DBInstanceIdentifier**（在 CLI 中：`--db-instance-identifier`）– *必需：*一个字符串，类型为：`string`（UTF-8 编码的字符串）。

  客户标识符或数据库实例的 ARN。

**响应**

有关您可对数据库实例进行的有效更改的信息。包含对 [DescribeValidDBInstanceModifications（操作）](#DescribeValidDBInstanceModifications) 操作的成功调用的结果。您可在调用 [ModifyDBInstance（操作）](#ModifyDBInstance) 时使用此信息。
+ **Storage** – [ValidStorageOptions](#ValidStorageOptions) 对象的数组。

  数据库实例的有效存储选项。

**错误**
+ [DBInstanceNotFoundFault](api-faults.md#DBInstanceNotFoundFault)
+ [InvalidDBInstanceStateFault](api-faults.md#InvalidDBInstanceStateFault)

## *结构：*
<a name="api-instances-structures-spacer"></a>

## DBInstance（结构）
<a name="DBInstance"></a>

包含 Amazon Neptune 数据库实例的详细信息。

此数据类型用作 [DescribeDBInstances（操作）](#DescribeDBInstances) 操作中的响应元素。

**Fields**
+ **AutoMinorVersionUpgrade** - 这是一个布尔值，类型为：`boolean` [布尔值（true 或 false）]。

  指示自动应用次要版本补丁。
+ **AvailabilityZone** – 这是一个字符串，类型为：`string`（UTF-8 编码的字符串）。

  指定数据库实例所在可用区域的名称。
+ **BackupRetentionPeriod** – 这是一个整数，类型为：`integer`（带符号的 32 位整数）。

  指定自动数据库快照的保留天数。
+ **CACertificateIdentifier** – 这是一个字符串，类型为：`string`（UTF-8 编码的字符串）。

  此数据库实例的 CA 证书的标识符。
+ **CopyTagsToSnapshot** - 这是一个布尔值，类型为：`boolean` [布尔值（true 或 false）]。

  指定是否将标签从数据库实例复制到数据库实例的快照。
+ **DBClusterIdentifier** – 这是一个字符串，类型为：`string`（UTF-8 编码的字符串）。

  如果数据库实例属于某个数据库集群，则包含数据库实例所属的数据库集群的名称。
+ **DBInstanceArn** – 这是一个字符串，类型为：`string`（UTF-8 编码的字符串）。

  数据库实例的 Amazon 资源名称 (ARN)。
+ **DBInstanceClass** – 这是一个字符串，类型为：`string`（UTF-8 编码的字符串）。

  包含数据库实例的计算和内存容量级别名称。
+ **DBInstanceIdentifier** – 这是一个字符串，类型为：`string`（UTF-8 编码的字符串）。

  包含用户提供的数据库标识符。此标识符是标识数据库实例的唯一密钥。
+ **DbInstancePort** – 这是一个整数，类型为：`integer`（带符号的 32 位整数）。

  指定数据库实例侦听的端口。如果数据库实例属于某个数据库集群，则此端口可能不同于数据库集群的端口。
+ **DBInstanceStatus** – 这是一个字符串，类型为：`string`（UTF-8 编码的字符串）。

  指定此数据库的当前状态。
+ **DbiResourceId** – 这是一个字符串，类型为：`string`（UTF-8 编码的字符串）。

  数据库实例的 Amazon 区域唯一且不变的标识符。只要访问数据库实例的 Amazon KMS 密钥，就可以在 Amazon CloudTrail 日志条目中找到此标识符。
+ **DBName** – 这是一个字符串，类型为：`string`（UTF-8 编码的字符串）。

  数据库名称。
+ **DBParameterGroups** – 这是 [DBParameterGroupStatus](api-parameters.md#DBParameterGroupStatus) 对象数组。

  提供应用到此数据库实例的数据库参数组的列表。
+ **DBSecurityGroups** – 这是 [DBSecurityGroupMembership](api-datatypes.md#DBSecurityGroupMembership) 对象数组。

   提供仅包含 `DBSecurityGroup.Name` 和 `DBSecurityGroup.Status` 子元素的数据库安全组元素的列表。
+ **DBSubnetGroup** –这是一个 [DBSubnetGroup](api-subnets.md#DBSubnetGroup) 对象。

  指定与数据库实例关联的子网组的信息，包括名称、描述和子网组中的子网。
+ **DeletionProtection** – 这是 BooleanOptional，类型为：`boolean` [布尔值（true 或 false）]。

  指示数据库实例是否已启用删除保护。在启用删除保护时，无法删除实例。请参阅[删除数据库实例](https://docs.amazonaws.cn/neptune/latest/userguide/manage-console-instances-delete.html)。
+ **DomainMemberships** – 这是 [DomainMembership](api-datatypes.md#DomainMembership) 对象数组。

  不支持
+ **EnabledCloudwatchLogsExports** – 这是一个字符串，类型为：`string`（UTF-8 编码的字符串）。

  此数据库实例配置为导出到 CloudWatch Logs 的日志类型的列表。
+ **Endpoint** –这是一个 [终端节点](api-datatypes.md#Endpoint) 对象。

  指定连接端点。
+ **Engine** – 这是一个字符串，类型为：`string`（UTF-8 编码的字符串）。

  提供要用于此数据库实例的数据库引擎的名称。
+ **EngineVersion** – 这是一个字符串，类型为：`string`（UTF-8 编码的字符串）。

  指示数据库引擎版本。
+ **EnhancedMonitoringResourceArn** – 这是一个字符串，类型为：`string`（UTF-8 编码的字符串）。

  接收数据库实例的增强监控指标数据的 Amazon CloudWatch Logs 日志流的 Amazon 资源名称 (ARN)。
+ **IAMDatabaseAuthenticationEnabled** - 这是一个布尔值，类型为：`boolean` [布尔值（true 或 false）]。

  如果 Amazon Identity and Access Management (IAM) 身份验证已启用，则为 true；否则为 false。
+ **InstanceCreateTime** – 这是 TStamp，类型为：`timestamp`（一个时间点，通常定义为与 1970 年 1 月 1 日午夜的偏移量）。

  提供创建数据库实例的日期和时间。
+ **Iops** – 这是 IntegerOptional，类型为：`integer`（带符号的 32 位整数）。

  指定预配置的 IOPS（每秒 I/O 操作数）值。
+ **KmsKeyId** – 这是一个字符串，类型为：`string`（UTF-8 编码的字符串）。

   不支持：数据库实例的加密由数据库集群管理。
+ **LatestRestorableTime** – 这是 TStamp，类型为：`timestamp`（一个时间点，通常定义为与 1970 年 1 月 1 日午夜的偏移量）。

  指定数据库可以使用时间点还原的最新还原时间。
+ **LicenseModel** – 这是一个字符串，类型为：`string`（UTF-8 编码的字符串）。

  该数据库实例的许可模式信息。
+ **MonitoringInterval** – 这是 IntegerOptional，类型为：`integer`（带符号的 32 位整数）。

  收集数据库实例的增强监控指标的时间点之间的间隔，以秒为单位。
+ **MonitoringRoleArn** – 这是一个字符串，类型为：`string`（UTF-8 编码的字符串）。

  允许 Neptune 将增强监控指标发送到 Amazon CloudWatch Logs 的 IAM 角色的 ARN。
+ **MultiAZ** - 这是一个布尔值，类型为：`boolean` [布尔值（true 或 false）]。

  指定数据库实例是否为多可用区部署。
+ **PendingModifiedValues** –这是一个 [PendingModifiedValues](#PendingModifiedValues) 对象。

  指定对数据库实例的更改待处理。仅在更改待处理时包含此元素。特定更改由子元素标识。
+ **PreferredBackupWindow** – 这是一个字符串，类型为：`string`（UTF-8 编码的字符串）。

   指定在启用自动备份时，自动执行备份的日常时间范围，如 `BackupRetentionPeriod` 所规定。
+ **PreferredMaintenanceWindow** – 这是一个字符串，类型为：`string`（UTF-8 编码的字符串）。

  指定可进行系统维护的每周时间范围（采用通用协调时间 (UTC)）。
+ **PromotionTier** – 这是 IntegerOptional，类型为：`integer`（带符号的 32 位整数）。

  该值指定在现有主实例发生故障后将只读副本提升为主实例的顺序。
+ **PubliclyAccessible** - 这是一个布尔值，类型为：`boolean` [布尔值（true 或 false）]。

  此标记不应再使用。
+ **ReadReplicaDBClusterIdentifiers** – 这是一个字符串，类型为：`string`（UTF-8 编码的字符串）。

  包含一个或多个数据集集群（作为此数据库实例只读副本的集群）的标识符。
+ **ReadReplicaDBInstanceIdentifiers** – 这是一个字符串，类型为：`string`（UTF-8 编码的字符串）。

  包含一个或多个与此数据库实例关联的只读副本的标识符。
+ **ReadReplicaSourceDBInstanceIdentifier** – 这是一个字符串，类型为：`string`（UTF-8 编码的字符串）。

  包含源数据库实例（在此数据库实例是只读副本时）的标识符。
+ **SecondaryAvailabilityZone** – 这是一个字符串，类型为：`string`（UTF-8 编码的字符串）。

  如果存在，则指定带多可用区支持的数据库实例辅助可用区的名称。
+ **StatusInfos** – 这是 [DBInstanceStatusInfo](#DBInstanceStatusInfo) 对象数组。

  只读副本的状态。如果实例不是只读副本，则此项空白。
+ **StorageEncrypted** - 这是一个布尔值，类型为：`boolean` [布尔值（true 或 false）]。

  不支持：数据库实例的加密由数据库集群管理。
+ **StorageType** – 这是一个字符串，类型为：`string`（UTF-8 编码的字符串）。

  指定与数据库实例关联的存储类型。
+ **TdeCredentialArn** – 这是一个字符串，类型为：`string`（UTF-8 编码的字符串）。

  来自密钥存储的 ARN，实例通过它进行关联用于 TDE 加密。
+ **Timezone** – 这是一个字符串，类型为：`string`（UTF-8 编码的字符串）。

  不支持。
+ **VpcSecurityGroups** – 这是 [VpcSecurityGroupMembership](api-datatypes.md#VpcSecurityGroupMembership) 对象数组。

  提供数据库实例所属的 VPC 安全组元素的列表。

`DBInstance` 用作下列对象的响应元素：
+ [CreateDBInstance](#CreateDBInstance)
+ [DeleteDBInstance](#DeleteDBInstance)
+ [ModifyDBInstance](#ModifyDBInstance)
+ [RebootDBInstance](#RebootDBInstance)

## DBInstanceStatusInfo（结构）
<a name="DBInstanceStatusInfo"></a>

提供数据库实例状态信息的列表。

**Fields**
+ **Message** – 这是一个字符串，类型为：`string`（UTF-8 编码的字符串）。

  实例出现错误时，错误的详细信息。如果实例未处于出错状态，则此值为空白。
+ **Normal** - 这是一个布尔值，类型为：`boolean` [布尔值（true 或 false）]。

  布尔值，如果实例正常运行则为 true，如果实例处于错误状态则为 false。
+ **Status** – 这是一个字符串，类型为：`string`（UTF-8 编码的字符串）。

  数据库实例的状态。对于只读副本的 StatusType，该值可以为 replicating、error、stopped 或 terminated。
+ **StatusType** – 这是一个字符串，类型为：`string`（UTF-8 编码的字符串）。

  此值当前是“只读复制”。

## OrderableDBInstanceOption（结构）
<a name="OrderableDBInstanceOption"></a>

包含数据库实例的可用选项列表。

 此数据类型用作 [DescribeOrderableDBInstanceOptions（操作）](#DescribeOrderableDBInstanceOptions) 操作中的响应元素。

**Fields**
+ **AvailabilityZones** – 这是 [AvailabilityZone](api-datatypes.md#AvailabilityZone) 对象数组。

  数据库实例的可用区域列表。
+ **DBInstanceClass** – 这是一个字符串，类型为：`string`（UTF-8 编码的字符串）。

  数据库实例的数据库实例类。
+ **Engine** – 这是一个字符串，类型为：`string`（UTF-8 编码的字符串）。

  数据库实例的引擎类型。
+ **EngineVersion** – 这是一个字符串，类型为：`string`（UTF-8 编码的字符串）。

  数据库实例的引擎版本。
+ **LicenseModel** – 这是一个字符串，类型为：`string`（UTF-8 编码的字符串）。

  数据库实例的许可模式
+ **MaxIopsPerDbInstance** – 这是 IntegerOptional，类型为：`integer`（带符号的 32 位整数）。

  数据库实例的最大总预配置 IOPS。
+ **MaxIopsPerGib** – 这是 DoubleOptional，类型为：`double`（双精度 IEEE 754 浮点数）。

  数据库实例每 Gib 的最大预配置 IOPS。
+ **MaxStorageSize** – 这是 IntegerOptional，类型为：`integer`（带符号的 32 位整数）。

  数据库实例的最大存储大小。
+ **MinIopsPerDbInstance** – 这是 IntegerOptional，类型为：`integer`（带符号的 32 位整数）。

  数据库实例的最小总预配置 IOPS。
+ **MinIopsPerGib** – 这是 DoubleOptional，类型为：`double`（双精度 IEEE 754 浮点数）。

  数据库实例每 Gib 的最小预配置 IOPS。
+ **MinStorageSize** – 这是 IntegerOptional，类型为：`integer`（带符号的 32 位整数）。

  数据库实例的最小存储大小。
+ **MultiAZCapable** - 这是一个布尔值，类型为：`boolean` [布尔值（true 或 false）]。

  指示数据库实例是否有多可用区。
+ **ReadReplicaCapable** - 这是一个布尔值，类型为：`boolean` [布尔值（true 或 false）]。

  指示数据库实例是否可以有只读副本。
+ **StorageType** – 这是一个字符串，类型为：`string`（UTF-8 编码的字符串）。

  不适用。在 Neptune 中，存储类型在数据库集群级别进行管理。
+ **SupportsEnhancedMonitoring** - 这是一个布尔值，类型为：`boolean` [布尔值（true 或 false）]。

  指示数据库实例是否支持增强监控（间隔从 1 到 60 秒）。
+ **SupportsGlobalDatabases** - 这是一个布尔值，类型为：`boolean` [布尔值（true 或 false）]。

  一个值，表示是否可以将 Neptune 全球数据库与其它数据库引擎属性的特定组合一起使用。
+ **SupportsIAMDatabaseAuthentication** - 这是一个布尔值，类型为：`boolean` [布尔值（true 或 false）]。

  指示数据库实例是否支持 IAM 数据库身份验证。
+ **SupportsIops** - 这是一个布尔值，类型为：`boolean` [布尔值（true 或 false）]。

  指示数据库实例是否支持预配置的 IOPS。
+ **SupportsStorageEncryption** - 这是一个布尔值，类型为：`boolean` [布尔值（true 或 false）]。

  指示数据库实例是否支持加密存储。
+ **Vpc** - 这是一个布尔值，类型为：`boolean` [布尔值（true 或 false）]。

  指示数据库实例是否在 VPC 中。

## PendingModifiedValues（结构）
<a name="PendingModifiedValues"></a>

此数据类型用作 [ModifyDBInstance（操作）](#ModifyDBInstance) 操作中的响应元素。

**Fields**
+ **AllocatedStorage** – 这是 IntegerOptional，类型为：`integer`（带符号的 32 位整数）。

   包含将要应用或当前正在应用的数据库实例的新 `AllocatedStorage` 大小。
+ **BackupRetentionPeriod** – 这是 IntegerOptional，类型为：`integer`（带符号的 32 位整数）。

  指定保留自动备份的挂起天数。
+ **CACertificateIdentifier** – 这是一个字符串，类型为：`string`（UTF-8 编码的字符串）。

  指定数据库实例的 CA 证书的标识符。
+ **DBInstanceClass** – 这是一个字符串，类型为：`string`（UTF-8 编码的字符串）。

   包含将要应用或当前正在应用的数据库实例的新 `DBInstanceClass`。
+ **DBInstanceIdentifier** – 这是一个字符串，类型为：`string`（UTF-8 编码的字符串）。

   包含将要应用或当前正在应用的数据库实例的新 `DBInstanceIdentifier`。
+ **DBSubnetGroupName** – 这是一个字符串，类型为：`string`（UTF-8 编码的字符串）。

  数据库实例的新数据库子网组。
+ **EngineVersion** – 这是一个字符串，类型为：`string`（UTF-8 编码的字符串）。

  指示数据库引擎版本。
+ **Iops** – 这是 IntegerOptional，类型为：`integer`（带符号的 32 位整数）。

  指定将应用或当前正在应用的数据库实例的新预配置 IOPS 值。
+ **MultiAZ** – 这是 BooleanOptional，类型为：`boolean` [布尔值（true 或 false）]。

  指示单可用区数据库实例将更改为多可用区部署。
+ **PendingCloudwatchLogsExports** –这是一个 [PendingCloudwatchLogsExports](api-clusters.md#PendingCloudwatchLogsExports) 对象。

  此 `PendingCloudwatchLogsExports` 结构指定了已启用和已禁用 CloudWatch Logs 的待处理更改。
+ **Port** – 这是 IntegerOptional，类型为：`integer`（带符号的 32 位整数）。

  指定数据库实例的挂起端口。
+ **StorageType** – 这是一个字符串，类型为：`string`（UTF-8 编码的字符串）。

  不适用。在 Neptune 中，存储类型在数据库集群级别进行管理。

## ValidStorageOptions（结构）
<a name="ValidStorageOptions"></a>

不适用。在 Neptune 中，存储类型在数据库集群级别进行管理。

**Fields**
+ **IopsToStorageRatio** – 这是 [DoubleRange](api-datatypes.md#DoubleRange) 对象数组。

  不适用。在 Neptune 中，存储类型在数据库集群级别进行管理。
+ **ProvisionedIops** – 这是 [Range](api-datatypes.md#Range) 对象数组。

  不适用。在 Neptune 中，存储类型在数据库集群级别进行管理。
+ **StorageSize** – 这是 [Range](api-datatypes.md#Range) 对象数组。

  不适用。在 Neptune 中，存储类型在数据库集群级别进行管理。
+ **StorageType** – 这是一个字符串，类型为：`string`（UTF-8 编码的字符串）。

  不适用。在 Neptune 中，存储类型在数据库集群级别进行管理。

## ValidDBInstanceModificationsMessage（结构）
<a name="ValidDBInstanceModificationsMessage"></a>

有关您可对数据库实例进行的有效更改的信息。包含对 [DescribeValidDBInstanceModifications（操作）](#DescribeValidDBInstanceModifications) 操作的成功调用的结果。您可在调用 [ModifyDBInstance（操作）](#ModifyDBInstance) 时使用此信息。

**Fields**
+ **Storage** – 这是 [ValidStorageOptions](#ValidStorageOptions) 对象数组。

  数据库实例的有效存储选项。

`ValidDBInstanceModificationsMessage` 用作下列对象的响应元素：
+ [DescribeValidDBInstanceModifications](#DescribeValidDBInstanceModifications)