Neptune 資料庫叢集 API - Amazon Neptune

本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。

Neptune 資料庫叢集 API

動作:

結構:

CreateDBCluster (動作)

        此 API 的 AWS CLI 名稱是:create-db-cluster

建立新的 Amazon Neptune 資料庫叢集。

您可以使用 ReplicationSourceIdentifier 參數來建立資料庫叢集,做為另一個資料庫叢集或 Amazon Neptune 資料庫執行個體的僅供讀取複本。

請注意,當您直接使用 CreateDBCluster 建立新叢集時,預設會停用刪除保護 (當您在主控台中建立新的生產叢集時,預設會啟用刪除保護)。如果資料庫叢集的 DeletionProtection 欄位設定為 false,您只能刪除資料庫叢集。

請求

  • AvailabilityZones (在 CLI 中:--availability-zones) – 字串,類型為:string (UTF-8 編碼的字串)。

    EC2 可用區域的清單,在這些可用區域中可以建立資料庫叢集中的執行個體。

  • BackupRetentionPeriod (在 CLI 中:--backup-retention-period) – IntegerOptional,類型為:integer (帶正負號的 32 位元整數)。

    自動備份保留的天數。您必須指定一個值 (最小值為 1)。

    預設:1

    約束:

    • 該值必須介於 1 到 35 之間

  • CopyTagsToSnapshot (在 CLI 中:--copy-tags-to-snapshot) – BooleanOptional,類型為:boolean (布林值 (true 或 false))。

    如果設定為 true,則會將標籤複製到所建立之資料庫叢集的任何快照。

  • DatabaseName (在 CLI 中:--database-name) – 字串,類型為:string (UTF-8 編碼的字串)。

    您資料庫的名稱最長可達 64 個英數字元。若您沒有提供名稱,Amazon Neptune 將不會在您建立的資料庫叢集中建立資料庫。

  • DBClusterIdentifier (在 CLI 中:--db-cluster-identifier) – 必要:字串,類型為:string (UTF-8 編碼的字串)。

    資料庫叢集識別碼 此參數是以小寫字母字串的形式儲存。

    約束:

    • 必須包含 1 到 63 個字母、數字或連字號。

    • 第一個字元必須是字母。

    • 不能以連字號結尾或連續包含兩個連字號。

    範例:my-cluster1

  • DBClusterParameterGroupName (在 CLI 中:--db-cluster-parameter-group-name) – 字串,類型為:string (UTF-8 編碼的字串)。

    要與此資料庫叢集建立關聯的資料庫叢集參數群組名稱。若省略此引數,則會使用預設。

    約束:

    • 若有提供,則必須符合現有 DBClusterParameterGroup 的名稱。

  • DBSubnetGroupName (在 CLI 中:--db-subnet-group-name) – 字串,類型為:string (UTF-8 編碼的字串)。

    要與此資料庫叢集建立關聯的資料庫子網路群組。

    限制條件:必須符合現有 DBSubnetGroup 的名稱。絕不能為預設值。

    範例:mySubnetgroup

  • DeletionProtection (在 CLI 中:--deletion-protection) – BooleanOptional,類型為:boolean (布林值 (true 或 false))。

    指示資料庫叢集是否已啟用刪除保護的值。啟用刪除保護時無法刪除資料庫。根據預設,刪除保護是啟用的。

  • EnableCloudwatchLogsExports (在 CLI 中:--enable-cloudwatch-logs-exports) – 字串,類型為:string (UTF-8 編碼的字串)。

    此資料庫叢集應該匯出至 CloudWatch Logs 的日誌類型清單。有效的日誌類型為:audit (用來發佈稽核日誌) 和 slowquery (用來發佈慢查詢日誌)。請參閱將 Neptune 日誌發佈至 Amazon CloudWatch Logs

  • EnableIAMDatabaseAuthentication (在 CLI 中:--enable-iam-database-authentication) – BooleanOptional,類型為:boolean (布林值 (true 或 false))。

    如果設定為 true,則會針對整個資料庫叢集啟用 Amazon Identity and Access Management (IAM) 身分驗證 (這無法在執行個體層級設定)。

    預設:false

  • Engine (在 CLI 中:--engine) – 必要:字串,類型為:string (UTF-8 編碼的字串)。

    要用於此資料庫叢集的資料庫引擎名稱。

    有效值:neptune

  • EngineVersion (在 CLI 中:--engine-version) – 字串,類型為:string (UTF-8 編碼的字串)。

    要用於新資料庫叢集的資料庫引擎版本號碼。

    範例:1.2.1.0

  • GlobalClusterIdentifier (在 CLI 中:--global-cluster-identifier) – GlobalClusterIdentifier,類型為:string (UTF-8 編碼的字串),不小於 1 或大於 255 ?st?s,符合此規則運算式:[A-Za-z][0-9A-Za-z-:._]*

    應將此新資料庫叢集新增至其中之 Neptune 全球資料庫的 ID。

  • KmsKeyId (在 CLI 中:--kms-key-id) – 字串,類型為:string (UTF-8 編碼的字串)。

    已加密資料庫叢集的 Amazon KMS 金鑰識別符。

    KMS 金鑰識別符是 KMS 加密金鑰的 Amazon Resource Name (ARN)。如果您使用擁有用來加密新資料庫叢集 KMS 加密金鑰的相同 Amazon 帳戶建立資料庫叢集,您可以改為使用 KMS 金鑰別名,而非 KMS 加密金鑰的 ARN。

    若加密金鑰並未在 KmsKeyId 中指定:

    • ReplicationSourceIdentifier 可識別加密來源,則 Amazon Neptune 會使用用於加密來源的加密金鑰。否則,Amazon Neptune 將使用您的預設加密金鑰。

    • StorageEncrypted 參數為 true 且並未指定 ReplicationSourceIdentifier,則 Amazon Neptune 會使用您的預設加密金鑰。

    Amazon KMS 會為您的 Amazon 帳戶建立預設加密金鑰。您的 Amazon 帳戶在每個 Amazon 區域各有不同的預設加密金鑰。

    如果您在另一個 Amazon 區域內建立加密資料庫叢集的僅供讀取複本,您必須將 KmsKeyId 設為在目標 Amazon 區域中有效的 KMS 金鑰 ID。此金鑰會用於加密該 Amazon 區域內的僅供讀取複本。

  • Port (在 CLI 中:--port) – IntegerOptional,類型為:integer (帶正負號的 32 位元整數)。

    資料庫叢集中執行個體接受連線的連接埠號碼。

    預設:8182

  • PreferredBackupWindow (在 CLI 中:--preferred-backup-window) – 字串,類型為:string (UTF-8 編碼的字串)。

    每日的時間範圍,若使用 BackupRetentionPeriod 參數啟用自動化備份,則會在此期間建立自動化備份。

    預設是從每個 Amazon 區域 8 小時的時段內隨機選取的 30 分鐘時段。若要查看可用的時段,請參閱《Amazon Neptune 使用者指南》中的 Neptune 維護時段

    約束:

    • 格式必須為 hh24:mi-hh24:mi

    • 必須以國際標準時間 (UTC) 表示。

    • 不得和慣用的維護時段衝突。

    • 必須至少 30 分鐘。

  • PreferredMaintenanceWindow (在 CLI 中:--preferred-maintenance-window) – 字串,類型為:string (UTF-8 編碼的字串)。

    每週可能進行系統維護的時段,以國際標準時間 (UTC) 表示。

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

    預設是從各 Amazon 區域 8 小時時段中隨機選取的 30 分鐘時段,並隨機發生在一週內的某一天。若要查看可用的時段,請參閱《Amazon Neptune 使用者指南》中的 Neptune 維護時段

    有效日:星期一、星期二、星期三、星期四、星期五、星期六、星期日。

    限制條件:必須至少是 30 分鐘的時段。

  • PreSignedUrl (在 CLI 中:--pre-signed-url) – 字串,類型為:string (UTF-8 編碼的字串)。

    目前不支援此參數。

  • ReplicationSourceIdentifier (在 CLI 中:--replication-source-identifier) – 字串,類型為:string (UTF-8 編碼的字串)。

    如果此資料庫叢集已做為僅供讀取複本建立,則為來源資料庫執行個體或資料庫叢集的 Amazon Resource Name (ARN)。

  • ServerlessV2ScalingConfiguration (在 CLI 中:--serverless-v2-scaling-configuration) – ServerlessV2ScalingConfiguration 物件。

    包含 Neptune Serverless 資料庫叢集的擴展組態。

    如需詳細資訊,請參閱《Amazon Neptune 使用者指南》中的使用 Amazon Neptune Serverless

  • StorageEncrypted (在 CLI 中:--storage-encrypted) – BooleanOptional,類型為:boolean (布林值 (true 或 false))。

    指定是否要加密資料庫叢集。

  • StorageType (在 CLI 中:--storage-type) – 字串,類型為:string (UTF-8 編碼的字串)。

    新 DB 叢集的儲存類型。

    有效值:

    • standard   –   (預設值) 針對具有中等至少量 I/O 使用率的應用程式設定具成本效益的資料庫儲存體。設定為 standard時,回應中不會傳回儲存類型。

    • iopt1   –   啟用 I/O 優化儲存,旨在符合 I/O 密集型圖形工作負載的需求,而這些工作負載則需要可預測的定價、低 I/O 延遲和一致的 I/O 輸送量。

      僅引擎版本 1.3.0.0 開始提供 Neptune I/O 優化儲存。

  • Tags (在 CLI 中:--tags) – Tag 物件的陣列。

    要指派給新資料庫叢集的標籤。

  • VpcSecurityGroupIds (在 CLI 中:--vpc-security-group-ids) – 字串,類型為:string (UTF-8 編碼的字串)。

    與此資料庫叢集關聯的 EC2 VPC 安全群組清單。

回應

包含 Amazon Neptune 資料庫叢集的詳細資訊。

此資料類型會在 DescribeDBClusters (動作) 動作中用作回應元素。

  • AllocatedStorage – IntegerOptional,類型為:integer (帶正負號的 32 位元整數)。

    AllocatedStorage 一律會傳回 1,因為 Neptune 資料庫叢集儲存體大小並非固定,而是會視需要自動調整。

  • AssociatedRoles – 一個 DBClusterRole 物件陣列。

    提供與資料庫叢集相關聯的 Amazon Identity and Access Management (IAM) 角色清單。與資料庫叢集相關聯的 IAM 角色,會授予資料庫叢集代您存取其他 Amazon 服務的許可。

  • AutomaticRestartTime – TStamp,類型為:timestamp (一個時間點,通常定義為 1970-01-01 午夜的偏移量)。

    資料庫叢集將自動重新啟動的時間。

  • AvailabilityZones – 字串,類型為:string (UTF-8 編碼的字串)。

    提供可在其中建立資料庫叢集內執行個體的 EC2 可用區域清單。

  • BacktrackConsumedChangeRecords - LongOptional,類型為:long (帶正負號的 64 位元整數)。

    Neptune 不提供支援。

  • BacktrackWindow - LongOptional,類型為:long (帶正負號的 64 位元整數)。

    Neptune 不提供支援。

  • BackupRetentionPeriod – IntegerOptional,類型為:integer (帶正負號的 32 位元整數)。

    指定保留自動資料庫快照的天數。

  • Capacity – IntegerOptional,類型為:integer (帶正負號的 32 位元整數)。

    Neptune 不提供支援。

  • CloneGroupId – 字串,類型為:string (UTF-8 編碼的字串)。

    識別與資料庫叢集建立關聯的複製群組。

  • ClusterCreateTime – TStamp,類型為:timestamp (一個時間點,通常定義為 1970-01-01 午夜的偏移量)。

    指定建立資料庫叢集的時間,以國際標準時間 (UTC) 表示。

  • CopyTagsToSnapshot – BooleanOptional,類型為:boolean (布林值 (true 或 false))。

    如果設定為 true,則會將標籤複製到所建立之資料庫叢集的任何快照。

  • CrossAccountClone – BooleanOptional,類型為:boolean (布林值 (true 或 false))。

    如果設定為 true,則可跨帳戶複製資料庫叢集。

  • DatabaseName – 字串,類型為:string (UTF-8 編碼的字串)。

    包含此資料庫叢集初始資料庫的名稱,該資料庫是在建立時提供的 (若建立資料庫叢集時有指定的話)。在資料庫叢集使用期間,會傳回此名稱。

  • DBClusterArn – 字串,類型為:string (UTF-8 編碼的字串)。

    資料庫叢集的 Amazon Resource Name (ARN)。

  • DBClusterIdentifier – 字串,類型為:string (UTF-8 編碼的字串)。

    包含使用者提供的資料庫叢集識別碼。此識別碼為可識別資料庫叢集的唯一金鑰。

  • DBClusterMembers – 一個 DBClusterMember 物件陣列。

    提供組成資料庫叢集的執行個體清單。

  • DBClusterParameterGroup – 字串,類型為:string (UTF-8 編碼的字串)。

    指定資料庫叢集的資料庫叢集參數群組名稱。

  • DbClusterResourceId – 字串,類型為:string (UTF-8 編碼的字串)。

    資料庫叢集的 Amazon 區域唯一、固定識別符。此識別符可在每次存取資料庫叢集的 Amazon KMS 金鑰時,於 Amazon CloudTrail 日誌項目中找到。

  • DBSubnetGroup – 字串,類型為:string (UTF-8 編碼的字串)。

    指定與資料庫叢集建立關聯子網路群組的資訊,包括名稱、描述,以及子網路群組中的子網路。

  • DeletionProtection – BooleanOptional,類型為:boolean (布林值 (true 或 false))。

    指示資料庫叢集是否已啟用刪除保護。啟用刪除保護時無法刪除資料庫。

  • EarliestBacktrackTime – TStamp,類型為:timestamp (一個時間點,通常定義為 1970-01-01 午夜的偏移量)。

    Neptune 不提供支援。

  • EarliestRestorableTime – TStamp,類型為:timestamp (一個時間點,通常定義為 1970-01-01 午夜的偏移量)。

    指定可透過 point-in-time 還原還原資料庫的最早時間。

  • EnabledCloudwatchLogsExports – 字串,類型為:string (UTF-8 編碼的字串)。

    此資料庫叢集已設為匯出至 CloudWatch Logs 的日誌類型清單。有效的日誌類型為:audit (用來將稽核日誌發佈至 CloudWatch) 和 slowquery (用來將慢查詢日誌發佈至 CloudWatch)。請參閱將 Neptune 日誌發佈至 Amazon CloudWatch Logs

  • Endpoint – 字串,類型為:string (UTF-8 編碼的字串)。

    指定資料庫叢集主要執行個體的連線端點。

  • Engine – 字串,類型為:string (UTF-8 編碼的字串)。

    提供要用於此資料庫叢集的資料庫引擎名稱。

  • EngineVersion – 字串,類型為:string (UTF-8 編碼的字串)。

    指示資料庫引擎版本。

  • GlobalClusterIdentifier – GlobalClusterIdentifier,類型為:string (UTF-8 編碼的字串),不小於 1 或大於 255 ?st?s,符合此規則運算式:[A-Za-z][0-9A-Za-z-:._]*

    包含使用者提供的全球資料庫叢集識別符。此識別符為可識別全球資料庫的唯一金鑰。

  • HostedZoneId – 字串,類型為:string (UTF-8 編碼的字串)。

    指定當您建立託管區域時,Amazon Route 53 指派的 ID。

  • IAMDatabaseAuthenticationEnabled – 布林值,類型為:boolean (布林值 (true 或 false))。

    若有啟用 Amazon Identity and Access Management (IAM) 帳戶對資料庫帳戶的映射,則為 true,否則為 false。

  • IOOptimizedNextAllowedModificationTime – TStamp,類型為:timestamp (一個時間點,通常定義為 1970-01-01 午夜的偏移量)。

    下次您可以修改資料庫叢集以使用 iopt1 儲存類型。

  • KmsKeyId – 字串,類型為:string (UTF-8 編碼的字串)。

    StorageEncrypted 為 true,則為加密資料庫叢集的 Amazon KMS 金鑰識別碼。

  • LatestRestorableTime – TStamp,類型為:timestamp (一個時間點,通常定義為 1970-01-01 午夜的偏移量)。

    指定可透過 point-in-time 還原還原資料庫的最新時間。

  • MultiAZ – 布林值,類型為:boolean (布林值 (true 或 false))。

    指定資料庫叢集是否在多個可用區域中擁有執行個體。

  • PendingModifiedValuesClusterPendingModifiedValues 物件。

    此資料類型會在 ModifyDBCluster 操作中用作回應元素,並包含將在下一個維護時段期間套用的變更。

  • PercentProgress – 字串,類型為:string (UTF-8 編碼的字串)。

    指定操作的進度 (百分比)。

  • Port – IntegerOptional,類型為:integer (帶正負號的 32 位元整數)。

    指定資料庫引擎接聽的連接埠。

  • PreferredBackupWindow – 字串,類型為:string (UTF-8 編碼的字串)。

    指定每日的時間範圍,若有啟用自動化備份 (由 BackupRetentionPeriod 決定),則自動化備份會在此期間建立。

  • PreferredMaintenanceWindow – 字串,類型為:string (UTF-8 編碼的字串)。

    指定每週可能進行系統維護的時段,以世界協調時間 (UTC) 表示。

  • ReaderEndpoint – 字串,類型為:string (UTF-8 編碼的字串)。

    資料庫叢集的讀取器端點。資料庫叢集的讀取器端點,用來針對資料庫叢集中可用僅供讀取複本的連線進行負載平衡。當用戶端向讀取器端點請求新連線時,Neptune 會在資料庫叢集中的僅供讀取複本間分散連線請求。此功能有助於在您資料庫叢集中的多個僅供讀取複本間平衡您的讀取工作負載。

    若發生容錯移轉,且您連線的僅供讀取複本提升為主要執行個體,則會中斷您的連線。若要繼續將您的讀取工作負載傳送到叢集內的其他僅供讀取複本,您可以接著重新連線到讀取器端點。

  • ReadReplicaIdentifiers – 字串,類型為:string (UTF-8 編碼的字串)。

    包含與此資料庫叢集相關聯的一或多個僅供讀取複本識別符。

  • ReplicationSourceIdentifier – 字串,類型為:string (UTF-8 編碼的字串)。

    Neptune 不提供支援。

  • ReplicationType – 字串,類型為:string (UTF-8 編碼的字串)。

    Neptune 不提供支援。

  • ServerlessV2ScalingConfigurationServerlessV2ScalingConfigurationInfo 物件。

    顯示 Neptune Serverless 資料庫叢集的擴展組態。

    如需詳細資訊,請參閱《Amazon Neptune 使用者指南》中的使用 Amazon Neptune Serverless

  • Status – 字串,類型為:string (UTF-8 編碼的字串)。

    指定此資料庫叢集的目前狀態。

  • StorageEncrypted – 布林值,類型為:boolean (布林值 (true 或 false))。

    指定是否要加密資料庫叢集。

  • StorageType – 字串,類型為:string (UTF-8 編碼的字串)。

    資料庫叢集使用的儲存類型。

    有效值:

    • standard   –   (預設值) 針對具有中至低 I/O 使用量的應用程式提供具成本效益的資料庫儲存體。

    • iopt1   –   啟用 I/O 優化儲存,旨在符合 I/O 密集型圖形工作負載的需求,而這些工作負載則需要可預測的定價、低 I/O 延遲和一致的 I/O 輸送量。

      僅引擎版本 1.3.0.0 開始提供 Neptune I/O 優化儲存。

  • VpcSecurityGroups – 一個 VpcSecurityGroupMembership 物件陣列。

    提供資料庫叢集歸屬的 VPC 安全群組清單。

DeleteDBCluster (動作)

        此 API 的 AWS CLI 名稱是:delete-db-cluster

DeleteDBCluster 動作會刪除先前佈建的資料庫叢集。當您刪除資料庫叢集時,所有該資料庫叢集的自動化備份都會遭到刪除,並且無法復原。指定資料庫叢集的手動資料庫叢集快照則不會刪除。

請注意,如果刪除保護已經啟用,資料庫叢集將無法刪除。如果要刪除,您必須先將其 DeletionProtection 欄位設定為 False

請求

  • DBClusterIdentifier (在 CLI 中:--db-cluster-identifier) – 必要:字串,類型為:string (UTF-8 編碼的字串)。

    欲刪除資料庫叢集的資料庫叢集識別符。此參數沒有大小寫之分。

    約束:

    • 必須符合現有的 DBClusterIdentifier。

  • FinalDBSnapshotIdentifier (在 CLI 中:--final-db-snapshot-identifier) – 字串,類型為:string (UTF-8 編碼的字串)。

    SkipFinalSnapshot 設為 false 時,所建立新資料庫叢集快照的資料庫叢集快照識別符。

    注意

    指定此參數,同時又將 SkipFinalShapshot 參數設為 true 時,便會導致錯誤。

    約束:

    • 必須為 1 到 255 個字母、數字或連字號。

    • 第一個字元必須是字母

    • 不能以連字號結尾或連續包含兩個連字號

  • SkipFinalSnapshot (在 CLI 中:--skip-final-snapshot) – 布林值,類型為:boolean (布林值 (true 或 false))。

    判斷最終資料庫叢集快照是否建立於資料庫叢集刪除之前。若指定 true,則不會建立資料庫叢集快照。若指定 false,則資料庫叢集快照會在刪除資料庫叢集前建立。

    注意

    SkipFinalSnapshotfalse,則您必須指定 FinalDBSnapshotIdentifier 參數。

    預設:false

回應

包含 Amazon Neptune 資料庫叢集的詳細資訊。

此資料類型會在 DescribeDBClusters (動作) 動作中用作回應元素。

  • AllocatedStorage – IntegerOptional,類型為:integer (帶正負號的 32 位元整數)。

    AllocatedStorage 一律會傳回 1,因為 Neptune 資料庫叢集儲存體大小並非固定,而是會視需要自動調整。

  • AssociatedRoles – 一個 DBClusterRole 物件陣列。

    提供與資料庫叢集相關聯的 Amazon Identity and Access Management (IAM) 角色清單。與資料庫叢集相關聯的 IAM 角色,會授予資料庫叢集代您存取其他 Amazon 服務的許可。

  • AutomaticRestartTime – TStamp,類型為:timestamp (一個時間點,通常定義為 1970-01-01 午夜的偏移量)。

    資料庫叢集將自動重新啟動的時間。

  • AvailabilityZones – 字串,類型為:string (UTF-8 編碼的字串)。

    提供可在其中建立資料庫叢集內執行個體的 EC2 可用區域清單。

  • BacktrackConsumedChangeRecords - LongOptional,類型為:long (帶正負號的 64 位元整數)。

    Neptune 不提供支援。

  • BacktrackWindow - LongOptional,類型為:long (帶正負號的 64 位元整數)。

    Neptune 不提供支援。

  • BackupRetentionPeriod – IntegerOptional,類型為:integer (帶正負號的 32 位元整數)。

    指定保留自動資料庫快照的天數。

  • Capacity – IntegerOptional,類型為:integer (帶正負號的 32 位元整數)。

    Neptune 不提供支援。

  • CloneGroupId – 字串,類型為:string (UTF-8 編碼的字串)。

    識別與資料庫叢集建立關聯的複製群組。

  • ClusterCreateTime – TStamp,類型為:timestamp (一個時間點,通常定義為 1970-01-01 午夜的偏移量)。

    指定建立資料庫叢集的時間,以國際標準時間 (UTC) 表示。

  • CopyTagsToSnapshot – BooleanOptional,類型為:boolean (布林值 (true 或 false))。

    如果設定為 true,則會將標籤複製到所建立之資料庫叢集的任何快照。

  • CrossAccountClone – BooleanOptional,類型為:boolean (布林值 (true 或 false))。

    如果設定為 true,則可跨帳戶複製資料庫叢集。

  • DatabaseName – 字串,類型為:string (UTF-8 編碼的字串)。

    包含此資料庫叢集初始資料庫的名稱,該資料庫是在建立時提供的 (若建立資料庫叢集時有指定的話)。在資料庫叢集使用期間,會傳回此名稱。

  • DBClusterArn – 字串,類型為:string (UTF-8 編碼的字串)。

    資料庫叢集的 Amazon Resource Name (ARN)。

  • DBClusterIdentifier – 字串,類型為:string (UTF-8 編碼的字串)。

    包含使用者提供的資料庫叢集識別碼。此識別碼為可識別資料庫叢集的唯一金鑰。

  • DBClusterMembers – 一個 DBClusterMember 物件陣列。

    提供組成資料庫叢集的執行個體清單。

  • DBClusterParameterGroup – 字串,類型為:string (UTF-8 編碼的字串)。

    指定資料庫叢集的資料庫叢集參數群組名稱。

  • DbClusterResourceId – 字串,類型為:string (UTF-8 編碼的字串)。

    資料庫叢集的 Amazon 區域唯一、固定識別符。此識別符可在每次存取資料庫叢集的 Amazon KMS 金鑰時,於 Amazon CloudTrail 日誌項目中找到。

  • DBSubnetGroup – 字串,類型為:string (UTF-8 編碼的字串)。

    指定與資料庫叢集建立關聯子網路群組的資訊,包括名稱、描述,以及子網路群組中的子網路。

  • DeletionProtection – BooleanOptional,類型為:boolean (布林值 (true 或 false))。

    指示資料庫叢集是否已啟用刪除保護。啟用刪除保護時無法刪除資料庫。

  • EarliestBacktrackTime – TStamp,類型為:timestamp (一個時間點,通常定義為 1970-01-01 午夜的偏移量)。

    Neptune 不提供支援。

  • EarliestRestorableTime – TStamp,類型為:timestamp (一個時間點,通常定義為 1970-01-01 午夜的偏移量)。

    指定可透過 point-in-time 還原還原資料庫的最早時間。

  • EnabledCloudwatchLogsExports – 字串,類型為:string (UTF-8 編碼的字串)。

    此資料庫叢集已設為匯出至 CloudWatch Logs 的日誌類型清單。有效的日誌類型為:audit (用來將稽核日誌發佈至 CloudWatch) 和 slowquery (用來將慢查詢日誌發佈至 CloudWatch)。請參閱將 Neptune 日誌發佈至 Amazon CloudWatch Logs

  • Endpoint – 字串,類型為:string (UTF-8 編碼的字串)。

    指定資料庫叢集主要執行個體的連線端點。

  • Engine – 字串,類型為:string (UTF-8 編碼的字串)。

    提供要用於此資料庫叢集的資料庫引擎名稱。

  • EngineVersion – 字串,類型為:string (UTF-8 編碼的字串)。

    指示資料庫引擎版本。

  • GlobalClusterIdentifier – GlobalClusterIdentifier,類型為:string (UTF-8 編碼的字串),不小於 1 或大於 255 ?st?s,符合此規則運算式:[A-Za-z][0-9A-Za-z-:._]*

    包含使用者提供的全球資料庫叢集識別符。此識別符為可識別全球資料庫的唯一金鑰。

  • HostedZoneId – 字串,類型為:string (UTF-8 編碼的字串)。

    指定當您建立託管區域時,Amazon Route 53 指派的 ID。

  • IAMDatabaseAuthenticationEnabled – 布林值,類型為:boolean (布林值 (true 或 false))。

    若有啟用 Amazon Identity and Access Management (IAM) 帳戶對資料庫帳戶的映射,則為 true,否則為 false。

  • IOOptimizedNextAllowedModificationTime – TStamp,類型為:timestamp (一個時間點,通常定義為 1970-01-01 午夜的偏移量)。

    下次您可以修改資料庫叢集以使用 iopt1 儲存類型。

  • KmsKeyId – 字串,類型為:string (UTF-8 編碼的字串)。

    StorageEncrypted 為 true,則為加密資料庫叢集的 Amazon KMS 金鑰識別碼。

  • LatestRestorableTime – TStamp,類型為:timestamp (一個時間點,通常定義為 1970-01-01 午夜的偏移量)。

    指定可透過 point-in-time 還原還原資料庫的最新時間。

  • MultiAZ – 布林值,類型為:boolean (布林值 (true 或 false))。

    指定資料庫叢集是否在多個可用區域中擁有執行個體。

  • PendingModifiedValuesClusterPendingModifiedValues 物件。

    此資料類型會在 ModifyDBCluster 操作中用作回應元素,並包含將在下一個維護時段期間套用的變更。

  • PercentProgress – 字串,類型為:string (UTF-8 編碼的字串)。

    指定操作的進度 (百分比)。

  • Port – IntegerOptional,類型為:integer (帶正負號的 32 位元整數)。

    指定資料庫引擎接聽的連接埠。

  • PreferredBackupWindow – 字串,類型為:string (UTF-8 編碼的字串)。

    指定每日的時間範圍,若有啟用自動化備份 (由 BackupRetentionPeriod 決定),則自動化備份會在此期間建立。

  • PreferredMaintenanceWindow – 字串,類型為:string (UTF-8 編碼的字串)。

    指定每週可能進行系統維護的時段,以世界協調時間 (UTC) 表示。

  • ReaderEndpoint – 字串,類型為:string (UTF-8 編碼的字串)。

    資料庫叢集的讀取器端點。資料庫叢集的讀取器端點,用來針對資料庫叢集中可用僅供讀取複本的連線進行負載平衡。當用戶端向讀取器端點請求新連線時,Neptune 會在資料庫叢集中的僅供讀取複本間分散連線請求。此功能有助於在您資料庫叢集中的多個僅供讀取複本間平衡您的讀取工作負載。

    若發生容錯移轉,且您連線的僅供讀取複本提升為主要執行個體,則會中斷您的連線。若要繼續將您的讀取工作負載傳送到叢集內的其他僅供讀取複本,您可以接著重新連線到讀取器端點。

  • ReadReplicaIdentifiers – 字串,類型為:string (UTF-8 編碼的字串)。

    包含與此資料庫叢集相關聯的一或多個僅供讀取複本識別符。

  • ReplicationSourceIdentifier – 字串,類型為:string (UTF-8 編碼的字串)。

    Neptune 不提供支援。

  • ReplicationType – 字串,類型為:string (UTF-8 編碼的字串)。

    Neptune 不提供支援。

  • ServerlessV2ScalingConfigurationServerlessV2ScalingConfigurationInfo 物件。

    顯示 Neptune Serverless 資料庫叢集的擴展組態。

    如需詳細資訊,請參閱《Amazon Neptune 使用者指南》中的使用 Amazon Neptune Serverless

  • Status – 字串,類型為:string (UTF-8 編碼的字串)。

    指定此資料庫叢集的目前狀態。

  • StorageEncrypted – 布林值,類型為:boolean (布林值 (true 或 false))。

    指定是否要加密資料庫叢集。

  • StorageType – 字串,類型為:string (UTF-8 編碼的字串)。

    資料庫叢集使用的儲存類型。

    有效值:

    • standard   –   (預設值) 針對具有中至低 I/O 使用量的應用程式提供具成本效益的資料庫儲存體。

    • iopt1   –   啟用 I/O 優化儲存,旨在符合 I/O 密集型圖形工作負載的需求,而這些工作負載則需要可預測的定價、低 I/O 延遲和一致的 I/O 輸送量。

      僅引擎版本 1.3.0.0 開始提供 Neptune I/O 優化儲存。

  • VpcSecurityGroups – 一個 VpcSecurityGroupMembership 物件陣列。

    提供資料庫叢集歸屬的 VPC 安全群組清單。

ModifyDBCluster (動作)

        此 API 的 AWS CLI 名稱是:modify-db-cluster

修改資料庫叢集的設定。您可以透過在請求中指定這些參數及新的值,來變更一或多個資料庫組態參數。

請求

  • AllowMajorVersionUpgrade (在 CLI 中:--allow-major-version-upgrade) – 布林值,類型為:boolean (布林值 (true 或 false))。

    一值,指示是否允許不同主要版本之間升級。

    限制條件:在提供 EngineVersion 參數,使用與資料庫叢集目前版本不同的主要版本時,您必須設定 allow-major-version-upgrade 旗標。

  • ApplyImmediately (在 CLI 中:--apply-immediately) – 布林值,類型為:boolean (布林值 (true 或 false))。

    指定此請求中的修改及任何擱置中的請求是否要以非同步方式盡快套用的值,無論資料庫叢集的 PreferredMaintenanceWindow 設定為何。若將此參數設為 false,對資料庫叢集的變更會在下次維護時段期間才會套用。

    ApplyImmediately 參數只會影響 NewDBClusterIdentifier 值。如果您將 ApplyImmediately 參數值設定為 false,則對 NewDBClusterIdentifier 值的變更會在下一個維護時段期間套用。所有其他的變更都會立即套用,無論 ApplyImmediately 參數的值為何。

    預設:false

  • BackupRetentionPeriod (在 CLI 中:--backup-retention-period) – IntegerOptional,類型為:integer (帶正負號的 32 位元整數)。

    自動備份保留的天數。您必須指定一個值 (最小值為 1)。

    預設:1

    約束:

    • 該值必須介於 1 到 35 之間

  • CloudwatchLogsExportConfiguration (在 CLI 中:--cloudwatch-logs-export-configuration) – CloudwatchLogsExportConfiguration 物件。

    要啟用的日誌類型的組態設定,適用於匯出到特定資料庫叢集的 CloudWatch Logs。請參閱使用 CLI 將 Neptune 稽核日誌發佈至 CloudWatch Logs

  • CopyTagsToSnapshot (在 CLI 中:--copy-tags-to-snapshot) – BooleanOptional,類型為:boolean (布林值 (true 或 false))。

    如果設定為 true,則會將標籤複製到所建立之資料庫叢集的任何快照。

  • DBClusterIdentifier (在 CLI 中:--db-cluster-identifier) – 必要:字串,類型為:string (UTF-8 編碼的字串)。

    欲修改叢集的資料庫叢集識別符。此參數不區分大小寫。

    約束:

    • 必須符合現有 DBCluster 的識別碼。

  • DBClusterParameterGroupName (在 CLI 中:--db-cluster-parameter-group-name) – 字串,類型為:string (UTF-8 編碼的字串)。

    資料庫叢集欲使用的資料庫叢集參數群組名稱。

  • DBInstanceParameterGroupName (在 CLI 中:--db-instance-parameter-group-name) – 字串,類型為:string (UTF-8 編碼的字串)。

    要套用至所有資料庫叢集執行個體的資料庫參數群組名稱。

    注意

    當您使用 DBInstanceParameterGroupName 套用參數群組時,參數變更不會在下一個維護時段期間套用,而是會立即套用。

    預設:現有名稱設定

    約束:

    • 資料庫參數群組必須位於與目標資料庫叢集版本相同的資料庫參數群組系列中。

    • DBInstanceParameterGroupName 參數只在與 AllowMajorVersionUpgrade 參數結合時才有效。

  • DeletionProtection (在 CLI 中:--deletion-protection) – BooleanOptional,類型為:boolean (布林值 (true 或 false))。

    指示資料庫叢集是否已啟用刪除保護的值。啟用刪除保護時無法刪除資料庫。根據預設,刪除保護是停用的。

  • EnableIAMDatabaseAuthentication (在 CLI 中:--enable-iam-database-authentication) – BooleanOptional,類型為:boolean (布林值 (true 或 false))。

    設為 True 以啟用 Amazon Identity and Access Management (IAM) 帳戶對資料庫帳戶的對應,否則為 false。

    預設:false

  • EngineVersion (在 CLI 中:--engine-version) – 字串,類型為:string (UTF-8 編碼的字串)。

    您要升級的資料庫引擎版本號碼。變更此參數會造成中斷。變更會在下一次維護時段期間套用,除非 ApplyImmediately 參數已設為 true。

    如需有效引擎版本的清單,請參閱 Amazon Neptune 的引擎版本,或呼叫 DescribeDBEngineVersions (動作)

  • NewDBClusterIdentifier (在 CLI 中:--new-db-cluster-identifier) – 字串,類型為:string (UTF-8 編碼的字串)。

    重新命名資料庫叢集時的新資料庫叢集識別符。此值會以小寫字母字串的形式儲存。

    約束:

    • 必須包含 1 到 63 個字母、數字或連字號

    • 第一個字元必須是字母

    • 不能以連字號結尾或連續包含兩個連字號

    範例:my-cluster2

  • Port (在 CLI 中:--port) – IntegerOptional,類型為:integer (帶正負號的 32 位元整數)。

    資料庫叢集接受連線連接埠號碼。

    限制條件:值必須為 1150-65535

    預設值:與原始資料庫叢集相同的連接埠。

  • PreferredBackupWindow (在 CLI 中:--preferred-backup-window) – 字串,類型為:string (UTF-8 編碼的字串)。

    每日的時間範圍,若使用 BackupRetentionPeriod 參數啟用自動化備份,則會在此期間建立自動化備份。

    預設是從每個 Amazon 區域 8 小時的時段內隨機選取的 30 分鐘時段。

    約束:

    • 格式必須為 hh24:mi-hh24:mi

    • 必須以國際標準時間 (UTC) 表示。

    • 不得和慣用的維護時段衝突。

    • 必須至少 30 分鐘。

  • PreferredMaintenanceWindow (在 CLI 中:--preferred-maintenance-window) – 字串,類型為:string (UTF-8 編碼的字串)。

    每週可能進行系統維護的時段,以國際標準時間 (UTC) 表示。

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

    預設是從各 Amazon 區域 8 小時時段中隨機選取的 30 分鐘時段,並隨機發生在一週內的某一天。

    有效日:星期一、星期二、星期三、星期四、星期五、星期六、星期日。

    限制條件:必須至少是 30 分鐘的時段。

  • ServerlessV2ScalingConfiguration (在 CLI 中:--serverless-v2-scaling-configuration) – ServerlessV2ScalingConfiguration 物件。

    包含 Neptune Serverless 資料庫叢集的擴展組態。

    如需詳細資訊,請參閱《Amazon Neptune 使用者指南》中的使用 Amazon Neptune Serverless

  • StorageType (在 CLI 中:--storage-type) – 字串,類型為:string (UTF-8 編碼的字串)。

    和資料庫叢集相關聯的儲存類型。

    有效值:

    • standard   –   (預設值) 針對具有中至低 I/O 使用量的應用程式設定具成本效益的資料庫儲存體。

    • iopt1   –   啟用 I/O 優化儲存,旨在符合 I/O 密集型圖形工作負載的需求,而這些工作負載則需要可預測的定價、低 I/O 延遲和一致的 I/O 輸送量。

      僅引擎版本 1.3.0.0 開始提供 Neptune I/O 優化儲存。

  • VpcSecurityGroupIds (在 CLI 中:--vpc-security-group-ids) – 字串,類型為:string (UTF-8 編碼的字串)。

    資料庫叢集將歸屬的 VPC 安全群組清單。

回應

包含 Amazon Neptune 資料庫叢集的詳細資訊。

此資料類型會在 DescribeDBClusters (動作) 動作中用作回應元素。

  • AllocatedStorage – IntegerOptional,類型為:integer (帶正負號的 32 位元整數)。

    AllocatedStorage 一律會傳回 1,因為 Neptune 資料庫叢集儲存體大小並非固定,而是會視需要自動調整。

  • AssociatedRoles – 一個 DBClusterRole 物件陣列。

    提供與資料庫叢集相關聯的 Amazon Identity and Access Management (IAM) 角色清單。與資料庫叢集相關聯的 IAM 角色,會授予資料庫叢集代您存取其他 Amazon 服務的許可。

  • AutomaticRestartTime – TStamp,類型為:timestamp (一個時間點,通常定義為 1970-01-01 午夜的偏移量)。

    資料庫叢集將自動重新啟動的時間。

  • AvailabilityZones – 字串,類型為:string (UTF-8 編碼的字串)。

    提供可在其中建立資料庫叢集內執行個體的 EC2 可用區域清單。

  • BacktrackConsumedChangeRecords - LongOptional,類型為:long (帶正負號的 64 位元整數)。

    Neptune 不提供支援。

  • BacktrackWindow - LongOptional,類型為:long (帶正負號的 64 位元整數)。

    Neptune 不提供支援。

  • BackupRetentionPeriod – IntegerOptional,類型為:integer (帶正負號的 32 位元整數)。

    指定保留自動資料庫快照的天數。

  • Capacity – IntegerOptional,類型為:integer (帶正負號的 32 位元整數)。

    Neptune 不提供支援。

  • CloneGroupId – 字串,類型為:string (UTF-8 編碼的字串)。

    識別與資料庫叢集建立關聯的複製群組。

  • ClusterCreateTime – TStamp,類型為:timestamp (一個時間點,通常定義為 1970-01-01 午夜的偏移量)。

    指定建立資料庫叢集的時間,以國際標準時間 (UTC) 表示。

  • CopyTagsToSnapshot – BooleanOptional,類型為:boolean (布林值 (true 或 false))。

    如果設定為 true,則會將標籤複製到所建立之資料庫叢集的任何快照。

  • CrossAccountClone – BooleanOptional,類型為:boolean (布林值 (true 或 false))。

    如果設定為 true,則可跨帳戶複製資料庫叢集。

  • DatabaseName – 字串,類型為:string (UTF-8 編碼的字串)。

    包含此資料庫叢集初始資料庫的名稱,該資料庫是在建立時提供的 (若建立資料庫叢集時有指定的話)。在資料庫叢集使用期間,會傳回此名稱。

  • DBClusterArn – 字串,類型為:string (UTF-8 編碼的字串)。

    資料庫叢集的 Amazon Resource Name (ARN)。

  • DBClusterIdentifier – 字串,類型為:string (UTF-8 編碼的字串)。

    包含使用者提供的資料庫叢集識別碼。此識別碼為可識別資料庫叢集的唯一金鑰。

  • DBClusterMembers – 一個 DBClusterMember 物件陣列。

    提供組成資料庫叢集的執行個體清單。

  • DBClusterParameterGroup – 字串,類型為:string (UTF-8 編碼的字串)。

    指定資料庫叢集的資料庫叢集參數群組名稱。

  • DbClusterResourceId – 字串,類型為:string (UTF-8 編碼的字串)。

    資料庫叢集的 Amazon 區域唯一、固定識別符。此識別符可在每次存取資料庫叢集的 Amazon KMS 金鑰時,於 Amazon CloudTrail 日誌項目中找到。

  • DBSubnetGroup – 字串,類型為:string (UTF-8 編碼的字串)。

    指定與資料庫叢集建立關聯子網路群組的資訊,包括名稱、描述,以及子網路群組中的子網路。

  • DeletionProtection – BooleanOptional,類型為:boolean (布林值 (true 或 false))。

    指示資料庫叢集是否已啟用刪除保護。啟用刪除保護時無法刪除資料庫。

  • EarliestBacktrackTime – TStamp,類型為:timestamp (一個時間點,通常定義為 1970-01-01 午夜的偏移量)。

    Neptune 不提供支援。

  • EarliestRestorableTime – TStamp,類型為:timestamp (一個時間點,通常定義為 1970-01-01 午夜的偏移量)。

    指定可透過 point-in-time 還原還原資料庫的最早時間。

  • EnabledCloudwatchLogsExports – 字串,類型為:string (UTF-8 編碼的字串)。

    此資料庫叢集已設為匯出至 CloudWatch Logs 的日誌類型清單。有效的日誌類型為:audit (用來將稽核日誌發佈至 CloudWatch) 和 slowquery (用來將慢查詢日誌發佈至 CloudWatch)。請參閱將 Neptune 日誌發佈至 Amazon CloudWatch Logs

  • Endpoint – 字串,類型為:string (UTF-8 編碼的字串)。

    指定資料庫叢集主要執行個體的連線端點。

  • Engine – 字串,類型為:string (UTF-8 編碼的字串)。

    提供要用於此資料庫叢集的資料庫引擎名稱。

  • EngineVersion – 字串,類型為:string (UTF-8 編碼的字串)。

    指示資料庫引擎版本。

  • GlobalClusterIdentifier – GlobalClusterIdentifier,類型為:string (UTF-8 編碼的字串),不小於 1 或大於 255 ?st?s,符合此規則運算式:[A-Za-z][0-9A-Za-z-:._]*

    包含使用者提供的全球資料庫叢集識別符。此識別符為可識別全球資料庫的唯一金鑰。

  • HostedZoneId – 字串,類型為:string (UTF-8 編碼的字串)。

    指定當您建立託管區域時,Amazon Route 53 指派的 ID。

  • IAMDatabaseAuthenticationEnabled – 布林值,類型為:boolean (布林值 (true 或 false))。

    若有啟用 Amazon Identity and Access Management (IAM) 帳戶對資料庫帳戶的映射,則為 true,否則為 false。

  • IOOptimizedNextAllowedModificationTime – TStamp,類型為:timestamp (一個時間點,通常定義為 1970-01-01 午夜的偏移量)。

    下次您可以修改資料庫叢集以使用 iopt1 儲存類型。

  • KmsKeyId – 字串,類型為:string (UTF-8 編碼的字串)。

    StorageEncrypted 為 true,則為加密資料庫叢集的 Amazon KMS 金鑰識別碼。

  • LatestRestorableTime – TStamp,類型為:timestamp (一個時間點,通常定義為 1970-01-01 午夜的偏移量)。

    指定可透過 point-in-time 還原還原資料庫的最新時間。

  • MultiAZ – 布林值,類型為:boolean (布林值 (true 或 false))。

    指定資料庫叢集是否在多個可用區域中擁有執行個體。

  • PendingModifiedValuesClusterPendingModifiedValues 物件。

    此資料類型會在 ModifyDBCluster 操作中用作回應元素,並包含將在下一個維護時段期間套用的變更。

  • PercentProgress – 字串,類型為:string (UTF-8 編碼的字串)。

    指定操作的進度 (百分比)。

  • Port – IntegerOptional,類型為:integer (帶正負號的 32 位元整數)。

    指定資料庫引擎接聽的連接埠。

  • PreferredBackupWindow – 字串,類型為:string (UTF-8 編碼的字串)。

    指定每日的時間範圍,若有啟用自動化備份 (由 BackupRetentionPeriod 決定),則自動化備份會在此期間建立。

  • PreferredMaintenanceWindow – 字串,類型為:string (UTF-8 編碼的字串)。

    指定每週可能進行系統維護的時段,以世界協調時間 (UTC) 表示。

  • ReaderEndpoint – 字串,類型為:string (UTF-8 編碼的字串)。

    資料庫叢集的讀取器端點。資料庫叢集的讀取器端點,用來針對資料庫叢集中可用僅供讀取複本的連線進行負載平衡。當用戶端向讀取器端點請求新連線時,Neptune 會在資料庫叢集中的僅供讀取複本間分散連線請求。此功能有助於在您資料庫叢集中的多個僅供讀取複本間平衡您的讀取工作負載。

    若發生容錯移轉,且您連線的僅供讀取複本提升為主要執行個體,則會中斷您的連線。若要繼續將您的讀取工作負載傳送到叢集內的其他僅供讀取複本,您可以接著重新連線到讀取器端點。

  • ReadReplicaIdentifiers – 字串,類型為:string (UTF-8 編碼的字串)。

    包含與此資料庫叢集相關聯的一或多個僅供讀取複本識別符。

  • ReplicationSourceIdentifier – 字串,類型為:string (UTF-8 編碼的字串)。

    Neptune 不提供支援。

  • ReplicationType – 字串,類型為:string (UTF-8 編碼的字串)。

    Neptune 不提供支援。

  • ServerlessV2ScalingConfigurationServerlessV2ScalingConfigurationInfo 物件。

    顯示 Neptune Serverless 資料庫叢集的擴展組態。

    如需詳細資訊,請參閱《Amazon Neptune 使用者指南》中的使用 Amazon Neptune Serverless

  • Status – 字串,類型為:string (UTF-8 編碼的字串)。

    指定此資料庫叢集的目前狀態。

  • StorageEncrypted – 布林值,類型為:boolean (布林值 (true 或 false))。

    指定是否要加密資料庫叢集。

  • StorageType – 字串,類型為:string (UTF-8 編碼的字串)。

    資料庫叢集使用的儲存類型。

    有效值:

    • standard   –   (預設值) 針對具有中至低 I/O 使用量的應用程式提供具成本效益的資料庫儲存體。

    • iopt1   –   啟用 I/O 優化儲存,旨在符合 I/O 密集型圖形工作負載的需求,而這些工作負載則需要可預測的定價、低 I/O 延遲和一致的 I/O 輸送量。

      僅引擎版本 1.3.0.0 開始提供 Neptune I/O 優化儲存。

  • VpcSecurityGroups – 一個 VpcSecurityGroupMembership 物件陣列。

    提供資料庫叢集歸屬的 VPC 安全群組清單。

StartDBCluster (動作)

        此 API 的 AWS CLI 名稱是:start-db-cluster

透過使用 Amazon 主控台、Amazon CLI stop-db-cluster 命令或 StopDBCluster API,來啟動停止的 Amazon Neptune 資料庫叢集。

請求

  • DBClusterIdentifier (在 CLI 中:--db-cluster-identifier) – 必要:字串,類型為:string (UTF-8 編碼的字串)。

    要啟動的 Neptune 資料庫叢集的資料庫叢集識別符。此參數是以小寫字母字串的形式儲存。

回應

包含 Amazon Neptune 資料庫叢集的詳細資訊。

此資料類型會在 DescribeDBClusters (動作) 動作中用作回應元素。

  • AllocatedStorage – IntegerOptional,類型為:integer (帶正負號的 32 位元整數)。

    AllocatedStorage 一律會傳回 1,因為 Neptune 資料庫叢集儲存體大小並非固定,而是會視需要自動調整。

  • AssociatedRoles – 一個 DBClusterRole 物件陣列。

    提供與資料庫叢集相關聯的 Amazon Identity and Access Management (IAM) 角色清單。與資料庫叢集相關聯的 IAM 角色,會授予資料庫叢集代您存取其他 Amazon 服務的許可。

  • AutomaticRestartTime – TStamp,類型為:timestamp (一個時間點,通常定義為 1970-01-01 午夜的偏移量)。

    資料庫叢集將自動重新啟動的時間。

  • AvailabilityZones – 字串,類型為:string (UTF-8 編碼的字串)。

    提供可在其中建立資料庫叢集內執行個體的 EC2 可用區域清單。

  • BacktrackConsumedChangeRecords - LongOptional,類型為:long (帶正負號的 64 位元整數)。

    Neptune 不提供支援。

  • BacktrackWindow - LongOptional,類型為:long (帶正負號的 64 位元整數)。

    Neptune 不提供支援。

  • BackupRetentionPeriod – IntegerOptional,類型為:integer (帶正負號的 32 位元整數)。

    指定保留自動資料庫快照的天數。

  • Capacity – IntegerOptional,類型為:integer (帶正負號的 32 位元整數)。

    Neptune 不提供支援。

  • CloneGroupId – 字串,類型為:string (UTF-8 編碼的字串)。

    識別與資料庫叢集建立關聯的複製群組。

  • ClusterCreateTime – TStamp,類型為:timestamp (一個時間點,通常定義為 1970-01-01 午夜的偏移量)。

    指定建立資料庫叢集的時間,以國際標準時間 (UTC) 表示。

  • CopyTagsToSnapshot – BooleanOptional,類型為:boolean (布林值 (true 或 false))。

    如果設定為 true,則會將標籤複製到所建立之資料庫叢集的任何快照。

  • CrossAccountClone – BooleanOptional,類型為:boolean (布林值 (true 或 false))。

    如果設定為 true,則可跨帳戶複製資料庫叢集。

  • DatabaseName – 字串,類型為:string (UTF-8 編碼的字串)。

    包含此資料庫叢集初始資料庫的名稱,該資料庫是在建立時提供的 (若建立資料庫叢集時有指定的話)。在資料庫叢集使用期間,會傳回此名稱。

  • DBClusterArn – 字串,類型為:string (UTF-8 編碼的字串)。

    資料庫叢集的 Amazon Resource Name (ARN)。

  • DBClusterIdentifier – 字串,類型為:string (UTF-8 編碼的字串)。

    包含使用者提供的資料庫叢集識別碼。此識別碼為可識別資料庫叢集的唯一金鑰。

  • DBClusterMembers – 一個 DBClusterMember 物件陣列。

    提供組成資料庫叢集的執行個體清單。

  • DBClusterParameterGroup – 字串,類型為:string (UTF-8 編碼的字串)。

    指定資料庫叢集的資料庫叢集參數群組名稱。

  • DbClusterResourceId – 字串,類型為:string (UTF-8 編碼的字串)。

    資料庫叢集的 Amazon 區域唯一、固定識別符。此識別符可在每次存取資料庫叢集的 Amazon KMS 金鑰時,於 Amazon CloudTrail 日誌項目中找到。

  • DBSubnetGroup – 字串,類型為:string (UTF-8 編碼的字串)。

    指定與資料庫叢集建立關聯子網路群組的資訊,包括名稱、描述,以及子網路群組中的子網路。

  • DeletionProtection – BooleanOptional,類型為:boolean (布林值 (true 或 false))。

    指示資料庫叢集是否已啟用刪除保護。啟用刪除保護時無法刪除資料庫。

  • EarliestBacktrackTime – TStamp,類型為:timestamp (一個時間點,通常定義為 1970-01-01 午夜的偏移量)。

    Neptune 不提供支援。

  • EarliestRestorableTime – TStamp,類型為:timestamp (一個時間點,通常定義為 1970-01-01 午夜的偏移量)。

    指定可透過 point-in-time 還原還原資料庫的最早時間。

  • EnabledCloudwatchLogsExports – 字串,類型為:string (UTF-8 編碼的字串)。

    此資料庫叢集已設為匯出至 CloudWatch Logs 的日誌類型清單。有效的日誌類型為:audit (用來將稽核日誌發佈至 CloudWatch) 和 slowquery (用來將慢查詢日誌發佈至 CloudWatch)。請參閱將 Neptune 日誌發佈至 Amazon CloudWatch Logs

  • Endpoint – 字串,類型為:string (UTF-8 編碼的字串)。

    指定資料庫叢集主要執行個體的連線端點。

  • Engine – 字串,類型為:string (UTF-8 編碼的字串)。

    提供要用於此資料庫叢集的資料庫引擎名稱。

  • EngineVersion – 字串,類型為:string (UTF-8 編碼的字串)。

    指示資料庫引擎版本。

  • GlobalClusterIdentifier – GlobalClusterIdentifier,類型為:string (UTF-8 編碼的字串),不小於 1 或大於 255 ?st?s,符合此規則運算式:[A-Za-z][0-9A-Za-z-:._]*

    包含使用者提供的全球資料庫叢集識別符。此識別符為可識別全球資料庫的唯一金鑰。

  • HostedZoneId – 字串,類型為:string (UTF-8 編碼的字串)。

    指定當您建立託管區域時,Amazon Route 53 指派的 ID。

  • IAMDatabaseAuthenticationEnabled – 布林值,類型為:boolean (布林值 (true 或 false))。

    若有啟用 Amazon Identity and Access Management (IAM) 帳戶對資料庫帳戶的映射,則為 true,否則為 false。

  • IOOptimizedNextAllowedModificationTime – TStamp,類型為:timestamp (一個時間點,通常定義為 1970-01-01 午夜的偏移量)。

    下次您可以修改資料庫叢集以使用 iopt1 儲存類型。

  • KmsKeyId – 字串,類型為:string (UTF-8 編碼的字串)。

    StorageEncrypted 為 true,則為加密資料庫叢集的 Amazon KMS 金鑰識別碼。

  • LatestRestorableTime – TStamp,類型為:timestamp (一個時間點,通常定義為 1970-01-01 午夜的偏移量)。

    指定可透過 point-in-time 還原還原資料庫的最新時間。

  • MultiAZ – 布林值,類型為:boolean (布林值 (true 或 false))。

    指定資料庫叢集是否在多個可用區域中擁有執行個體。

  • PendingModifiedValuesClusterPendingModifiedValues 物件。

    此資料類型會在 ModifyDBCluster 操作中用作回應元素,並包含將在下一個維護時段期間套用的變更。

  • PercentProgress – 字串,類型為:string (UTF-8 編碼的字串)。

    指定操作的進度 (百分比)。

  • Port – IntegerOptional,類型為:integer (帶正負號的 32 位元整數)。

    指定資料庫引擎接聽的連接埠。

  • PreferredBackupWindow – 字串,類型為:string (UTF-8 編碼的字串)。

    指定每日的時間範圍,若有啟用自動化備份 (由 BackupRetentionPeriod 決定),則自動化備份會在此期間建立。

  • PreferredMaintenanceWindow – 字串,類型為:string (UTF-8 編碼的字串)。

    指定每週可能進行系統維護的時段,以世界協調時間 (UTC) 表示。

  • ReaderEndpoint – 字串,類型為:string (UTF-8 編碼的字串)。

    資料庫叢集的讀取器端點。資料庫叢集的讀取器端點,用來針對資料庫叢集中可用僅供讀取複本的連線進行負載平衡。當用戶端向讀取器端點請求新連線時,Neptune 會在資料庫叢集中的僅供讀取複本間分散連線請求。此功能有助於在您資料庫叢集中的多個僅供讀取複本間平衡您的讀取工作負載。

    若發生容錯移轉,且您連線的僅供讀取複本提升為主要執行個體,則會中斷您的連線。若要繼續將您的讀取工作負載傳送到叢集內的其他僅供讀取複本,您可以接著重新連線到讀取器端點。

  • ReadReplicaIdentifiers – 字串,類型為:string (UTF-8 編碼的字串)。

    包含與此資料庫叢集相關聯的一或多個僅供讀取複本識別符。

  • ReplicationSourceIdentifier – 字串,類型為:string (UTF-8 編碼的字串)。

    Neptune 不提供支援。

  • ReplicationType – 字串,類型為:string (UTF-8 編碼的字串)。

    Neptune 不提供支援。

  • ServerlessV2ScalingConfigurationServerlessV2ScalingConfigurationInfo 物件。

    顯示 Neptune Serverless 資料庫叢集的擴展組態。

    如需詳細資訊,請參閱《Amazon Neptune 使用者指南》中的使用 Amazon Neptune Serverless

  • Status – 字串,類型為:string (UTF-8 編碼的字串)。

    指定此資料庫叢集的目前狀態。

  • StorageEncrypted – 布林值,類型為:boolean (布林值 (true 或 false))。

    指定是否要加密資料庫叢集。

  • StorageType – 字串,類型為:string (UTF-8 編碼的字串)。

    資料庫叢集使用的儲存類型。

    有效值:

    • standard   –   (預設值) 針對具有中至低 I/O 使用量的應用程式提供具成本效益的資料庫儲存體。

    • iopt1   –   啟用 I/O 優化儲存,旨在符合 I/O 密集型圖形工作負載的需求,而這些工作負載則需要可預測的定價、低 I/O 延遲和一致的 I/O 輸送量。

      僅引擎版本 1.3.0.0 開始提供 Neptune I/O 優化儲存。

  • VpcSecurityGroups – 一個 VpcSecurityGroupMembership 物件陣列。

    提供資料庫叢集歸屬的 VPC 安全群組清單。

StopDBCluster (動作)

        此 API 的 AWS CLI 名稱是:stop-db-cluster

停止 Amazon Neptune 資料庫叢集。當您停止資料庫叢集時,Neptune 會留資料庫叢集的中繼資料,包括端點和資料庫參數群組。

Neptune 也會保留交易日誌,以便您視需要進行時間點還原。

請求

  • DBClusterIdentifier (在 CLI 中:--db-cluster-identifier) – 必要:字串,類型為:string (UTF-8 編碼的字串)。

    要停止的 Neptune 資料庫叢集的資料庫叢集識別符。此參數是以小寫字母字串的形式儲存。

回應

包含 Amazon Neptune 資料庫叢集的詳細資訊。

此資料類型會在 DescribeDBClusters (動作) 動作中用作回應元素。

  • AllocatedStorage – IntegerOptional,類型為:integer (帶正負號的 32 位元整數)。

    AllocatedStorage 一律會傳回 1,因為 Neptune 資料庫叢集儲存體大小並非固定,而是會視需要自動調整。

  • AssociatedRoles – 一個 DBClusterRole 物件陣列。

    提供與資料庫叢集相關聯的 Amazon Identity and Access Management (IAM) 角色清單。與資料庫叢集相關聯的 IAM 角色,會授予資料庫叢集代您存取其他 Amazon 服務的許可。

  • AutomaticRestartTime – TStamp,類型為:timestamp (一個時間點,通常定義為 1970-01-01 午夜的偏移量)。

    資料庫叢集將自動重新啟動的時間。

  • AvailabilityZones – 字串,類型為:string (UTF-8 編碼的字串)。

    提供可在其中建立資料庫叢集內執行個體的 EC2 可用區域清單。

  • BacktrackConsumedChangeRecords - LongOptional,類型為:long (帶正負號的 64 位元整數)。

    Neptune 不提供支援。

  • BacktrackWindow - LongOptional,類型為:long (帶正負號的 64 位元整數)。

    Neptune 不提供支援。

  • BackupRetentionPeriod – IntegerOptional,類型為:integer (帶正負號的 32 位元整數)。

    指定保留自動資料庫快照的天數。

  • Capacity – IntegerOptional,類型為:integer (帶正負號的 32 位元整數)。

    Neptune 不提供支援。

  • CloneGroupId – 字串,類型為:string (UTF-8 編碼的字串)。

    識別與資料庫叢集建立關聯的複製群組。

  • ClusterCreateTime – TStamp,類型為:timestamp (一個時間點,通常定義為 1970-01-01 午夜的偏移量)。

    指定建立資料庫叢集的時間,以國際標準時間 (UTC) 表示。

  • CopyTagsToSnapshot – BooleanOptional,類型為:boolean (布林值 (true 或 false))。

    如果設定為 true,則會將標籤複製到所建立之資料庫叢集的任何快照。

  • CrossAccountClone – BooleanOptional,類型為:boolean (布林值 (true 或 false))。

    如果設定為 true,則可跨帳戶複製資料庫叢集。

  • DatabaseName – 字串,類型為:string (UTF-8 編碼的字串)。

    包含此資料庫叢集初始資料庫的名稱,該資料庫是在建立時提供的 (若建立資料庫叢集時有指定的話)。在資料庫叢集使用期間,會傳回此名稱。

  • DBClusterArn – 字串,類型為:string (UTF-8 編碼的字串)。

    資料庫叢集的 Amazon Resource Name (ARN)。

  • DBClusterIdentifier – 字串,類型為:string (UTF-8 編碼的字串)。

    包含使用者提供的資料庫叢集識別碼。此識別碼為可識別資料庫叢集的唯一金鑰。

  • DBClusterMembers – 一個 DBClusterMember 物件陣列。

    提供組成資料庫叢集的執行個體清單。

  • DBClusterParameterGroup – 字串,類型為:string (UTF-8 編碼的字串)。

    指定資料庫叢集的資料庫叢集參數群組名稱。

  • DbClusterResourceId – 字串,類型為:string (UTF-8 編碼的字串)。

    資料庫叢集的 Amazon 區域唯一、固定識別符。此識別符可在每次存取資料庫叢集的 Amazon KMS 金鑰時,於 Amazon CloudTrail 日誌項目中找到。

  • DBSubnetGroup – 字串,類型為:string (UTF-8 編碼的字串)。

    指定與資料庫叢集建立關聯子網路群組的資訊,包括名稱、描述,以及子網路群組中的子網路。

  • DeletionProtection – BooleanOptional,類型為:boolean (布林值 (true 或 false))。

    指示資料庫叢集是否已啟用刪除保護。啟用刪除保護時無法刪除資料庫。

  • EarliestBacktrackTime – TStamp,類型為:timestamp (一個時間點,通常定義為 1970-01-01 午夜的偏移量)。

    Neptune 不提供支援。

  • EarliestRestorableTime – TStamp,類型為:timestamp (一個時間點,通常定義為 1970-01-01 午夜的偏移量)。

    指定可透過 point-in-time 還原還原資料庫的最早時間。

  • EnabledCloudwatchLogsExports – 字串,類型為:string (UTF-8 編碼的字串)。

    此資料庫叢集已設為匯出至 CloudWatch Logs 的日誌類型清單。有效的日誌類型為:audit (用來將稽核日誌發佈至 CloudWatch) 和 slowquery (用來將慢查詢日誌發佈至 CloudWatch)。請參閱將 Neptune 日誌發佈至 Amazon CloudWatch Logs

  • Endpoint – 字串,類型為:string (UTF-8 編碼的字串)。

    指定資料庫叢集主要執行個體的連線端點。

  • Engine – 字串,類型為:string (UTF-8 編碼的字串)。

    提供要用於此資料庫叢集的資料庫引擎名稱。

  • EngineVersion – 字串,類型為:string (UTF-8 編碼的字串)。

    指示資料庫引擎版本。

  • GlobalClusterIdentifier – GlobalClusterIdentifier,類型為:string (UTF-8 編碼的字串),不小於 1 或大於 255 ?st?s,符合此規則運算式:[A-Za-z][0-9A-Za-z-:._]*

    包含使用者提供的全球資料庫叢集識別符。此識別符為可識別全球資料庫的唯一金鑰。

  • HostedZoneId – 字串,類型為:string (UTF-8 編碼的字串)。

    指定當您建立託管區域時,Amazon Route 53 指派的 ID。

  • IAMDatabaseAuthenticationEnabled – 布林值,類型為:boolean (布林值 (true 或 false))。

    若有啟用 Amazon Identity and Access Management (IAM) 帳戶對資料庫帳戶的映射,則為 true,否則為 false。

  • IOOptimizedNextAllowedModificationTime – TStamp,類型為:timestamp (一個時間點,通常定義為 1970-01-01 午夜的偏移量)。

    下次您可以修改資料庫叢集以使用 iopt1 儲存類型。

  • KmsKeyId – 字串,類型為:string (UTF-8 編碼的字串)。

    StorageEncrypted 為 true,則為加密資料庫叢集的 Amazon KMS 金鑰識別碼。

  • LatestRestorableTime – TStamp,類型為:timestamp (一個時間點,通常定義為 1970-01-01 午夜的偏移量)。

    指定可透過 point-in-time 還原還原資料庫的最新時間。

  • MultiAZ – 布林值,類型為:boolean (布林值 (true 或 false))。

    指定資料庫叢集是否在多個可用區域中擁有執行個體。

  • PendingModifiedValuesClusterPendingModifiedValues 物件。

    此資料類型會在 ModifyDBCluster 操作中用作回應元素,並包含將在下一個維護時段期間套用的變更。

  • PercentProgress – 字串,類型為:string (UTF-8 編碼的字串)。

    指定操作的進度 (百分比)。

  • Port – IntegerOptional,類型為:integer (帶正負號的 32 位元整數)。

    指定資料庫引擎接聽的連接埠。

  • PreferredBackupWindow – 字串,類型為:string (UTF-8 編碼的字串)。

    指定每日的時間範圍,若有啟用自動化備份 (由 BackupRetentionPeriod 決定),則自動化備份會在此期間建立。

  • PreferredMaintenanceWindow – 字串,類型為:string (UTF-8 編碼的字串)。

    指定每週可能進行系統維護的時段,以世界協調時間 (UTC) 表示。

  • ReaderEndpoint – 字串,類型為:string (UTF-8 編碼的字串)。

    資料庫叢集的讀取器端點。資料庫叢集的讀取器端點,用來針對資料庫叢集中可用僅供讀取複本的連線進行負載平衡。當用戶端向讀取器端點請求新連線時,Neptune 會在資料庫叢集中的僅供讀取複本間分散連線請求。此功能有助於在您資料庫叢集中的多個僅供讀取複本間平衡您的讀取工作負載。

    若發生容錯移轉,且您連線的僅供讀取複本提升為主要執行個體,則會中斷您的連線。若要繼續將您的讀取工作負載傳送到叢集內的其他僅供讀取複本,您可以接著重新連線到讀取器端點。

  • ReadReplicaIdentifiers – 字串,類型為:string (UTF-8 編碼的字串)。

    包含與此資料庫叢集相關聯的一或多個僅供讀取複本識別符。

  • ReplicationSourceIdentifier – 字串,類型為:string (UTF-8 編碼的字串)。

    Neptune 不提供支援。

  • ReplicationType – 字串,類型為:string (UTF-8 編碼的字串)。

    Neptune 不提供支援。

  • ServerlessV2ScalingConfigurationServerlessV2ScalingConfigurationInfo 物件。

    顯示 Neptune Serverless 資料庫叢集的擴展組態。

    如需詳細資訊,請參閱《Amazon Neptune 使用者指南》中的使用 Amazon Neptune Serverless

  • Status – 字串,類型為:string (UTF-8 編碼的字串)。

    指定此資料庫叢集的目前狀態。

  • StorageEncrypted – 布林值,類型為:boolean (布林值 (true 或 false))。

    指定是否要加密資料庫叢集。

  • StorageType – 字串,類型為:string (UTF-8 編碼的字串)。

    資料庫叢集使用的儲存類型。

    有效值:

    • standard   –   (預設值) 針對具有中至低 I/O 使用量的應用程式提供具成本效益的資料庫儲存體。

    • iopt1   –   啟用 I/O 優化儲存,旨在符合 I/O 密集型圖形工作負載的需求,而這些工作負載則需要可預測的定價、低 I/O 延遲和一致的 I/O 輸送量。

      僅引擎版本 1.3.0.0 開始提供 Neptune I/O 優化儲存。

  • VpcSecurityGroups – 一個 VpcSecurityGroupMembership 物件陣列。

    提供資料庫叢集歸屬的 VPC 安全群組清單。

AddRoleToDBCluster (動作)

        此 API 的 AWS CLI 名稱是:add-role-to-db-cluster

將 Identity and Access Management (IAM) 角色與 Neptune 資料庫叢集建立關聯。

請求

  • DBClusterIdentifier (在 CLI 中:--db-cluster-identifier) – 必要:字串,類型為:string (UTF-8 編碼的字串)。

    要與 IAM 角色建立關聯的資料庫叢集名稱。

  • FeatureName (在 CLI 中:--feature-name) – 字串,類型為:string (UTF-8 編碼的字串)。

    IAM 角色與其相關聯之 Neptune 資料庫叢集的功能名稱。如需支援的功能名稱清單,請參閱 DBEngineVersion (結構)

  • RoleArn (在 CLI 中:--role-arn) – 必要:字串,類型為:string (UTF-8 編碼的字串)。

    要與 Neptune 資料庫叢集建立關聯的 IAM 角色 Amazon Resource Name (ARN),例如 arn:aws:iam::123456789012:role/NeptuneAccessRole

回應
  • 無回應參數。

RemoveRoleFromDBCluster (動作)

        此 API 的 AWS CLI 名稱是:remove-role-from-db-cluster

從資料庫叢集解除關聯一個 Identity and Access Management (IAM) 角色。

請求

  • DBClusterIdentifier (在 CLI 中:--db-cluster-identifier) – 必要:字串,類型為:string (UTF-8 編碼的字串)。

    要從 IAM 角色解除關聯的資料庫叢集名稱。

  • FeatureName (在 CLI 中:--feature-name) – 字串,類型為:string (UTF-8 編碼的字串)。

    IAM 角色要與其取消關聯之資料庫叢集的功能名稱。如需支援的功能名稱清單,請參閱 DescribeDBEngineVersions (動作)

  • RoleArn (在 CLI 中:--role-arn) – 必要:字串,類型為:string (UTF-8 編碼的字串)。

    要從資料庫叢集解除關聯的 IAM 角色 Amazon Resource Name (ARN),例如 arn:aws:iam::123456789012:role/NeptuneAccessRole

回應
  • 無回應參數。

FailoverDBCluster (動作)

        此 API 的 AWS CLI 名稱是:failover-db-cluster

強制資料庫叢集進行容錯移轉。

資料庫叢集的容錯移轉會將資料庫叢集中的其中一個僅供讀取複本 (唯讀執行個體) 提升為主要執行個體 (叢集寫入器)。

Amazon Neptune 會在主要執行個體失敗時,自動容錯移轉至僅供讀取複本 (若有的話)。當您想要模擬主要執行個體故障以進行測試時,可以強制容錯移轉。由於資料庫叢集中的每個執行個體都有自己的端點地址,當容錯移轉完成時,您將需要清除和重新建立任何使用這些端點地址的現有連線。

請求

  • DBClusterIdentifier (在 CLI 中:--db-cluster-identifier) – 字串,類型為:string (UTF-8 編碼的字串)。

    要強制其進行容錯移轉的資料庫叢集識別符。此參數不區分大小寫。

    約束:

    • 必須符合現有 DBCluster 的識別碼。

  • TargetDBInstanceIdentifier (在 CLI 中:--target-db-instance-identifier) – 字串,類型為:string (UTF-8 編碼的字串)。

    要提升為主要執行個體的執行個體名稱。

    您必須為資料庫叢集中的僅供讀取複本指定執行個體識別符。例如:mydbcluster-replica1

回應

包含 Amazon Neptune 資料庫叢集的詳細資訊。

此資料類型會在 DescribeDBClusters (動作) 動作中用作回應元素。

  • AllocatedStorage – IntegerOptional,類型為:integer (帶正負號的 32 位元整數)。

    AllocatedStorage 一律會傳回 1,因為 Neptune 資料庫叢集儲存體大小並非固定,而是會視需要自動調整。

  • AssociatedRoles – 一個 DBClusterRole 物件陣列。

    提供與資料庫叢集相關聯的 Amazon Identity and Access Management (IAM) 角色清單。與資料庫叢集相關聯的 IAM 角色,會授予資料庫叢集代您存取其他 Amazon 服務的許可。

  • AutomaticRestartTime – TStamp,類型為:timestamp (一個時間點,通常定義為 1970-01-01 午夜的偏移量)。

    資料庫叢集將自動重新啟動的時間。

  • AvailabilityZones – 字串,類型為:string (UTF-8 編碼的字串)。

    提供可在其中建立資料庫叢集內執行個體的 EC2 可用區域清單。

  • BacktrackConsumedChangeRecords - LongOptional,類型為:long (帶正負號的 64 位元整數)。

    Neptune 不提供支援。

  • BacktrackWindow - LongOptional,類型為:long (帶正負號的 64 位元整數)。

    Neptune 不提供支援。

  • BackupRetentionPeriod – IntegerOptional,類型為:integer (帶正負號的 32 位元整數)。

    指定保留自動資料庫快照的天數。

  • Capacity – IntegerOptional,類型為:integer (帶正負號的 32 位元整數)。

    Neptune 不提供支援。

  • CloneGroupId – 字串,類型為:string (UTF-8 編碼的字串)。

    識別與資料庫叢集建立關聯的複製群組。

  • ClusterCreateTime – TStamp,類型為:timestamp (一個時間點,通常定義為 1970-01-01 午夜的偏移量)。

    指定建立資料庫叢集的時間,以國際標準時間 (UTC) 表示。

  • CopyTagsToSnapshot – BooleanOptional,類型為:boolean (布林值 (true 或 false))。

    如果設定為 true,則會將標籤複製到所建立之資料庫叢集的任何快照。

  • CrossAccountClone – BooleanOptional,類型為:boolean (布林值 (true 或 false))。

    如果設定為 true,則可跨帳戶複製資料庫叢集。

  • DatabaseName – 字串,類型為:string (UTF-8 編碼的字串)。

    包含此資料庫叢集初始資料庫的名稱,該資料庫是在建立時提供的 (若建立資料庫叢集時有指定的話)。在資料庫叢集使用期間,會傳回此名稱。

  • DBClusterArn – 字串,類型為:string (UTF-8 編碼的字串)。

    資料庫叢集的 Amazon Resource Name (ARN)。

  • DBClusterIdentifier – 字串,類型為:string (UTF-8 編碼的字串)。

    包含使用者提供的資料庫叢集識別碼。此識別碼為可識別資料庫叢集的唯一金鑰。

  • DBClusterMembers – 一個 DBClusterMember 物件陣列。

    提供組成資料庫叢集的執行個體清單。

  • DBClusterParameterGroup – 字串,類型為:string (UTF-8 編碼的字串)。

    指定資料庫叢集的資料庫叢集參數群組名稱。

  • DbClusterResourceId – 字串,類型為:string (UTF-8 編碼的字串)。

    資料庫叢集的 Amazon 區域唯一、固定識別符。此識別符可在每次存取資料庫叢集的 Amazon KMS 金鑰時,於 Amazon CloudTrail 日誌項目中找到。

  • DBSubnetGroup – 字串,類型為:string (UTF-8 編碼的字串)。

    指定與資料庫叢集建立關聯子網路群組的資訊,包括名稱、描述,以及子網路群組中的子網路。

  • DeletionProtection – BooleanOptional,類型為:boolean (布林值 (true 或 false))。

    指示資料庫叢集是否已啟用刪除保護。啟用刪除保護時無法刪除資料庫。

  • EarliestBacktrackTime – TStamp,類型為:timestamp (一個時間點,通常定義為 1970-01-01 午夜的偏移量)。

    Neptune 不提供支援。

  • EarliestRestorableTime – TStamp,類型為:timestamp (一個時間點,通常定義為 1970-01-01 午夜的偏移量)。

    指定可透過 point-in-time 還原還原資料庫的最早時間。

  • EnabledCloudwatchLogsExports – 字串,類型為:string (UTF-8 編碼的字串)。

    此資料庫叢集已設為匯出至 CloudWatch Logs 的日誌類型清單。有效的日誌類型為:audit (用來將稽核日誌發佈至 CloudWatch) 和 slowquery (用來將慢查詢日誌發佈至 CloudWatch)。請參閱將 Neptune 日誌發佈至 Amazon CloudWatch Logs

  • Endpoint – 字串,類型為:string (UTF-8 編碼的字串)。

    指定資料庫叢集主要執行個體的連線端點。

  • Engine – 字串,類型為:string (UTF-8 編碼的字串)。

    提供要用於此資料庫叢集的資料庫引擎名稱。

  • EngineVersion – 字串,類型為:string (UTF-8 編碼的字串)。

    指示資料庫引擎版本。

  • GlobalClusterIdentifier – GlobalClusterIdentifier,類型為:string (UTF-8 編碼的字串),不小於 1 或大於 255 ?st?s,符合此規則運算式:[A-Za-z][0-9A-Za-z-:._]*

    包含使用者提供的全球資料庫叢集識別符。此識別符為可識別全球資料庫的唯一金鑰。

  • HostedZoneId – 字串,類型為:string (UTF-8 編碼的字串)。

    指定當您建立託管區域時,Amazon Route 53 指派的 ID。

  • IAMDatabaseAuthenticationEnabled – 布林值,類型為:boolean (布林值 (true 或 false))。

    若有啟用 Amazon Identity and Access Management (IAM) 帳戶對資料庫帳戶的映射,則為 true,否則為 false。

  • IOOptimizedNextAllowedModificationTime – TStamp,類型為:timestamp (一個時間點,通常定義為 1970-01-01 午夜的偏移量)。

    下次您可以修改資料庫叢集以使用 iopt1 儲存類型。

  • KmsKeyId – 字串,類型為:string (UTF-8 編碼的字串)。

    StorageEncrypted 為 true,則為加密資料庫叢集的 Amazon KMS 金鑰識別碼。

  • LatestRestorableTime – TStamp,類型為:timestamp (一個時間點,通常定義為 1970-01-01 午夜的偏移量)。

    指定可透過 point-in-time 還原還原資料庫的最新時間。

  • MultiAZ – 布林值,類型為:boolean (布林值 (true 或 false))。

    指定資料庫叢集是否在多個可用區域中擁有執行個體。

  • PendingModifiedValuesClusterPendingModifiedValues 物件。

    此資料類型會在 ModifyDBCluster 操作中用作回應元素,並包含將在下一個維護時段期間套用的變更。

  • PercentProgress – 字串,類型為:string (UTF-8 編碼的字串)。

    指定操作的進度 (百分比)。

  • Port – IntegerOptional,類型為:integer (帶正負號的 32 位元整數)。

    指定資料庫引擎接聽的連接埠。

  • PreferredBackupWindow – 字串,類型為:string (UTF-8 編碼的字串)。

    指定每日的時間範圍,若有啟用自動化備份 (由 BackupRetentionPeriod 決定),則自動化備份會在此期間建立。

  • PreferredMaintenanceWindow – 字串,類型為:string (UTF-8 編碼的字串)。

    指定每週可能進行系統維護的時段,以世界協調時間 (UTC) 表示。

  • ReaderEndpoint – 字串,類型為:string (UTF-8 編碼的字串)。

    資料庫叢集的讀取器端點。資料庫叢集的讀取器端點,用來針對資料庫叢集中可用僅供讀取複本的連線進行負載平衡。當用戶端向讀取器端點請求新連線時,Neptune 會在資料庫叢集中的僅供讀取複本間分散連線請求。此功能有助於在您資料庫叢集中的多個僅供讀取複本間平衡您的讀取工作負載。

    若發生容錯移轉,且您連線的僅供讀取複本提升為主要執行個體,則會中斷您的連線。若要繼續將您的讀取工作負載傳送到叢集內的其他僅供讀取複本,您可以接著重新連線到讀取器端點。

  • ReadReplicaIdentifiers – 字串,類型為:string (UTF-8 編碼的字串)。

    包含與此資料庫叢集相關聯的一或多個僅供讀取複本識別符。

  • ReplicationSourceIdentifier – 字串,類型為:string (UTF-8 編碼的字串)。

    Neptune 不提供支援。

  • ReplicationType – 字串,類型為:string (UTF-8 編碼的字串)。

    Neptune 不提供支援。

  • ServerlessV2ScalingConfigurationServerlessV2ScalingConfigurationInfo 物件。

    顯示 Neptune Serverless 資料庫叢集的擴展組態。

    如需詳細資訊,請參閱《Amazon Neptune 使用者指南》中的使用 Amazon Neptune Serverless

  • Status – 字串,類型為:string (UTF-8 編碼的字串)。

    指定此資料庫叢集的目前狀態。

  • StorageEncrypted – 布林值,類型為:boolean (布林值 (true 或 false))。

    指定是否要加密資料庫叢集。

  • StorageType – 字串,類型為:string (UTF-8 編碼的字串)。

    資料庫叢集使用的儲存類型。

    有效值:

    • standard   –   (預設值) 針對具有中至低 I/O 使用量的應用程式提供具成本效益的資料庫儲存體。

    • iopt1   –   啟用 I/O 優化儲存,旨在符合 I/O 密集型圖形工作負載的需求,而這些工作負載則需要可預測的定價、低 I/O 延遲和一致的 I/O 輸送量。

      僅引擎版本 1.3.0.0 開始提供 Neptune I/O 優化儲存。

  • VpcSecurityGroups – 一個 VpcSecurityGroupMembership 物件陣列。

    提供資料庫叢集歸屬的 VPC 安全群組清單。

PromoteReadReplicaDBCluster (動作)

        此 API 的 AWS CLI 名稱是:promote-read-replica-db-cluster

不支援。

請求

  • DBClusterIdentifier (在 CLI 中:--db-cluster-identifier) – 必要:字串,類型為:string (UTF-8 編碼的字串)。

    不支援。

回應

包含 Amazon Neptune 資料庫叢集的詳細資訊。

此資料類型會在 DescribeDBClusters (動作) 動作中用作回應元素。

  • AllocatedStorage – IntegerOptional,類型為:integer (帶正負號的 32 位元整數)。

    AllocatedStorage 一律會傳回 1,因為 Neptune 資料庫叢集儲存體大小並非固定,而是會視需要自動調整。

  • AssociatedRoles – 一個 DBClusterRole 物件陣列。

    提供與資料庫叢集相關聯的 Amazon Identity and Access Management (IAM) 角色清單。與資料庫叢集相關聯的 IAM 角色,會授予資料庫叢集代您存取其他 Amazon 服務的許可。

  • AutomaticRestartTime – TStamp,類型為:timestamp (一個時間點,通常定義為 1970-01-01 午夜的偏移量)。

    資料庫叢集將自動重新啟動的時間。

  • AvailabilityZones – 字串,類型為:string (UTF-8 編碼的字串)。

    提供可在其中建立資料庫叢集內執行個體的 EC2 可用區域清單。

  • BacktrackConsumedChangeRecords - LongOptional,類型為:long (帶正負號的 64 位元整數)。

    Neptune 不提供支援。

  • BacktrackWindow - LongOptional,類型為:long (帶正負號的 64 位元整數)。

    Neptune 不提供支援。

  • BackupRetentionPeriod – IntegerOptional,類型為:integer (帶正負號的 32 位元整數)。

    指定保留自動資料庫快照的天數。

  • Capacity – IntegerOptional,類型為:integer (帶正負號的 32 位元整數)。

    Neptune 不提供支援。

  • CloneGroupId – 字串,類型為:string (UTF-8 編碼的字串)。

    識別與資料庫叢集建立關聯的複製群組。

  • ClusterCreateTime – TStamp,類型為:timestamp (一個時間點,通常定義為 1970-01-01 午夜的偏移量)。

    指定建立資料庫叢集的時間,以國際標準時間 (UTC) 表示。

  • CopyTagsToSnapshot – BooleanOptional,類型為:boolean (布林值 (true 或 false))。

    如果設定為 true,則會將標籤複製到所建立之資料庫叢集的任何快照。

  • CrossAccountClone – BooleanOptional,類型為:boolean (布林值 (true 或 false))。

    如果設定為 true,則可跨帳戶複製資料庫叢集。

  • DatabaseName – 字串,類型為:string (UTF-8 編碼的字串)。

    包含此資料庫叢集初始資料庫的名稱,該資料庫是在建立時提供的 (若建立資料庫叢集時有指定的話)。在資料庫叢集使用期間,會傳回此名稱。

  • DBClusterArn – 字串,類型為:string (UTF-8 編碼的字串)。

    資料庫叢集的 Amazon Resource Name (ARN)。

  • DBClusterIdentifier – 字串,類型為:string (UTF-8 編碼的字串)。

    包含使用者提供的資料庫叢集識別碼。此識別碼為可識別資料庫叢集的唯一金鑰。

  • DBClusterMembers – 一個 DBClusterMember 物件陣列。

    提供組成資料庫叢集的執行個體清單。

  • DBClusterParameterGroup – 字串,類型為:string (UTF-8 編碼的字串)。

    指定資料庫叢集的資料庫叢集參數群組名稱。

  • DbClusterResourceId – 字串,類型為:string (UTF-8 編碼的字串)。

    資料庫叢集的 Amazon 區域唯一、固定識別符。此識別符可在每次存取資料庫叢集的 Amazon KMS 金鑰時,於 Amazon CloudTrail 日誌項目中找到。

  • DBSubnetGroup – 字串,類型為:string (UTF-8 編碼的字串)。

    指定與資料庫叢集建立關聯子網路群組的資訊,包括名稱、描述,以及子網路群組中的子網路。

  • DeletionProtection – BooleanOptional,類型為:boolean (布林值 (true 或 false))。

    指示資料庫叢集是否已啟用刪除保護。啟用刪除保護時無法刪除資料庫。

  • EarliestBacktrackTime – TStamp,類型為:timestamp (一個時間點,通常定義為 1970-01-01 午夜的偏移量)。

    Neptune 不提供支援。

  • EarliestRestorableTime – TStamp,類型為:timestamp (一個時間點,通常定義為 1970-01-01 午夜的偏移量)。

    指定可透過 point-in-time 還原還原資料庫的最早時間。

  • EnabledCloudwatchLogsExports – 字串,類型為:string (UTF-8 編碼的字串)。

    此資料庫叢集已設為匯出至 CloudWatch Logs 的日誌類型清單。有效的日誌類型為:audit (用來將稽核日誌發佈至 CloudWatch) 和 slowquery (用來將慢查詢日誌發佈至 CloudWatch)。請參閱將 Neptune 日誌發佈至 Amazon CloudWatch Logs

  • Endpoint – 字串,類型為:string (UTF-8 編碼的字串)。

    指定資料庫叢集主要執行個體的連線端點。

  • Engine – 字串,類型為:string (UTF-8 編碼的字串)。

    提供要用於此資料庫叢集的資料庫引擎名稱。

  • EngineVersion – 字串,類型為:string (UTF-8 編碼的字串)。

    指示資料庫引擎版本。

  • GlobalClusterIdentifier – GlobalClusterIdentifier,類型為:string (UTF-8 編碼的字串),不小於 1 或大於 255 ?st?s,符合此規則運算式:[A-Za-z][0-9A-Za-z-:._]*

    包含使用者提供的全球資料庫叢集識別符。此識別符為可識別全球資料庫的唯一金鑰。

  • HostedZoneId – 字串,類型為:string (UTF-8 編碼的字串)。

    指定當您建立託管區域時,Amazon Route 53 指派的 ID。

  • IAMDatabaseAuthenticationEnabled – 布林值,類型為:boolean (布林值 (true 或 false))。

    若有啟用 Amazon Identity and Access Management (IAM) 帳戶對資料庫帳戶的映射,則為 true,否則為 false。

  • IOOptimizedNextAllowedModificationTime – TStamp,類型為:timestamp (一個時間點,通常定義為 1970-01-01 午夜的偏移量)。

    下次您可以修改資料庫叢集以使用 iopt1 儲存類型。

  • KmsKeyId – 字串,類型為:string (UTF-8 編碼的字串)。

    StorageEncrypted 為 true,則為加密資料庫叢集的 Amazon KMS 金鑰識別碼。

  • LatestRestorableTime – TStamp,類型為:timestamp (一個時間點,通常定義為 1970-01-01 午夜的偏移量)。

    指定可透過 point-in-time 還原還原資料庫的最新時間。

  • MultiAZ – 布林值,類型為:boolean (布林值 (true 或 false))。

    指定資料庫叢集是否在多個可用區域中擁有執行個體。

  • PendingModifiedValuesClusterPendingModifiedValues 物件。

    此資料類型會在 ModifyDBCluster 操作中用作回應元素,並包含將在下一個維護時段期間套用的變更。

  • PercentProgress – 字串,類型為:string (UTF-8 編碼的字串)。

    指定操作的進度 (百分比)。

  • Port – IntegerOptional,類型為:integer (帶正負號的 32 位元整數)。

    指定資料庫引擎接聽的連接埠。

  • PreferredBackupWindow – 字串,類型為:string (UTF-8 編碼的字串)。

    指定每日的時間範圍,若有啟用自動化備份 (由 BackupRetentionPeriod 決定),則自動化備份會在此期間建立。

  • PreferredMaintenanceWindow – 字串,類型為:string (UTF-8 編碼的字串)。

    指定每週可能進行系統維護的時段,以世界協調時間 (UTC) 表示。

  • ReaderEndpoint – 字串,類型為:string (UTF-8 編碼的字串)。

    資料庫叢集的讀取器端點。資料庫叢集的讀取器端點,用來針對資料庫叢集中可用僅供讀取複本的連線進行負載平衡。當用戶端向讀取器端點請求新連線時,Neptune 會在資料庫叢集中的僅供讀取複本間分散連線請求。此功能有助於在您資料庫叢集中的多個僅供讀取複本間平衡您的讀取工作負載。

    若發生容錯移轉,且您連線的僅供讀取複本提升為主要執行個體,則會中斷您的連線。若要繼續將您的讀取工作負載傳送到叢集內的其他僅供讀取複本,您可以接著重新連線到讀取器端點。

  • ReadReplicaIdentifiers – 字串,類型為:string (UTF-8 編碼的字串)。

    包含與此資料庫叢集相關聯的一或多個僅供讀取複本識別符。

  • ReplicationSourceIdentifier – 字串,類型為:string (UTF-8 編碼的字串)。

    Neptune 不提供支援。

  • ReplicationType – 字串,類型為:string (UTF-8 編碼的字串)。

    Neptune 不提供支援。

  • ServerlessV2ScalingConfigurationServerlessV2ScalingConfigurationInfo 物件。

    顯示 Neptune Serverless 資料庫叢集的擴展組態。

    如需詳細資訊,請參閱《Amazon Neptune 使用者指南》中的使用 Amazon Neptune Serverless

  • Status – 字串,類型為:string (UTF-8 編碼的字串)。

    指定此資料庫叢集的目前狀態。

  • StorageEncrypted – 布林值,類型為:boolean (布林值 (true 或 false))。

    指定是否要加密資料庫叢集。

  • StorageType – 字串,類型為:string (UTF-8 編碼的字串)。

    資料庫叢集使用的儲存類型。

    有效值:

    • standard   –   (預設值) 針對具有中至低 I/O 使用量的應用程式提供具成本效益的資料庫儲存體。

    • iopt1   –   啟用 I/O 優化儲存,旨在符合 I/O 密集型圖形工作負載的需求,而這些工作負載則需要可預測的定價、低 I/O 延遲和一致的 I/O 輸送量。

      僅引擎版本 1.3.0.0 開始提供 Neptune I/O 優化儲存。

  • VpcSecurityGroups – 一個 VpcSecurityGroupMembership 物件陣列。

    提供資料庫叢集歸屬的 VPC 安全群組清單。

DescribeDBClusters (動作)

        此 API 的 AWS CLI 名稱是:describe-db-clusters

傳回所佈建之資料庫叢集的相關資訊,並支援分頁。

注意

此操作也可以傳回 Amazon RDS 叢集和 Amazon DocDB 叢集的資訊。

請求

  • DBClusterIdentifier (在 CLI 中:--db-cluster-identifier) – 字串,類型為:string (UTF-8 編碼的字串)。

    使用者提供的資料庫叢集識別符。若指定此參數,則只會傳回特定資料庫叢集的資訊。此參數沒有大小寫之分。

    約束:

    • 若有提供此項目,則必須符合現有的 DBClusterIdentifier。

  • Filters (在 CLI 中:--filters) – 篩選條件 物件的陣列。

    篩選條件,指定要描述的一或多個資料庫叢集。

    支援的篩選條件:

    • db-cluster-id - 接受資料庫叢集識別符及資料庫叢集 Amazon Resource Name (ARN)。結果清單只會包含由這些 ARN 識別的資料庫叢集相關資訊。

    • engine -接受引擎名稱 (例如 neptune),並將結果清單限制為由該引擎建立的資料庫叢集。

    例如,若要從 Amazon CLI 調用此 API 並進行篩選,以便只傳回 Neptune 資料庫叢集,您可以使用下列命令:

    aws neptune describe-db-clusters \ --filters Name=engine,Values=neptune
  • Marker (在 CLI 中:--marker) – 字串,類型為:string (UTF-8 編碼的字串)。

    前一個 DescribeDBClusters (動作) 請求提供的選用分頁字符。若指定此參數,則回應只會包含超過標記的記錄,直到 MaxRecords 指定的值為止。

  • MaxRecords (在 CLI 中:--max-records) – IntegerOptional,類型為:integer (帶正負號的 32 位元整數)。

    要在回應中包含的記錄數量上限。若存在的記錄比 MaxRecords 值指定的更多,則稱為「標記」的分頁字符會包含在回應中,讓您可以擷取剩餘的結果。

    預設:100

    限制條件:最小 20,最大 100。

回應

  • DBClusters – 一個 DBCluster 物件陣列。

    包含使用者的資料庫叢集清單。

  • Marker – 字串,類型為:string (UTF-8 編碼的字串)。

    可用於後續 DescribeDBClusters 請求的分頁字符。

結構:

DBCluster (結構)

包含 Amazon Neptune 資料庫叢集的詳細資訊。

此資料類型會在 DescribeDBClusters (動作) 動作中用作回應元素。

欄位
  • AllocatedStorage – 這是 IntegerOptional,類型為:integer (帶正負號的 32 位元整數)。

    AllocatedStorage 一律會傳回 1,因為 Neptune 資料庫叢集儲存體大小並非固定,而是會視需要自動調整。

  • AssociatedRoles - 這是 DBClusterRole 物件的陣列。

    提供與資料庫叢集相關聯的 Amazon Identity and Access Management (IAM) 角色清單。與資料庫叢集相關聯的 IAM 角色,會授予資料庫叢集代您存取其他 Amazon 服務的許可。

  • AutomaticRestartTime – 這是 TStamp,類型為:timestamp (一個時間點,通常定義為 1970-01-01 午夜的偏移量)。

    資料庫叢集將自動重新啟動的時間。

  • AvailabilityZones - 這是字串,類型為:string (UTF-8 編碼的字串)。

    提供可在其中建立資料庫叢集內執行個體的 EC2 可用區域清單。

  • BacktrackConsumedChangeRecords - 這是 LongOptional 整數,類型為:long (帶正負號的 64 位元整數)。

    Neptune 不提供支援。

  • BacktrackWindow - 這是 LongOptional 整數,類型為:long (帶正負號的 64 位元整數)。

    Neptune 不提供支援。

  • BackupRetentionPeriod – 這是 IntegerOptional,類型為:integer (帶正負號的 32 位元整數)。

    指定保留自動資料庫快照的天數。

  • Capacity – 這是 IntegerOptional,類型為:integer (帶正負號的 32 位元整數)。

    Neptune 不提供支援。

  • CloneGroupId - 這是字串,類型為:string (UTF-8 編碼的字串)。

    識別與資料庫叢集建立關聯的複製群組。

  • ClusterCreateTime – 這是 TStamp,類型為:timestamp (一個時間點,通常定義為 1970-01-01 午夜的偏移量)。

    指定建立資料庫叢集的時間,以國際標準時間 (UTC) 表示。

  • CopyTagsToSnapshot – 這是 BooleanOptional,類型為:boolean (布林值 (true 或 false))。

    如果設定為 true,則會將標籤複製到所建立之資料庫叢集的任何快照。

  • CrossAccountClone – 這是 BooleanOptional,類型為:boolean (布林值 (true 或 false))。

    如果設定為 true,則可跨帳戶複製資料庫叢集。

  • DatabaseName - 這是字串,類型為:string (UTF-8 編碼的字串)。

    包含此資料庫叢集初始資料庫的名稱,該資料庫是在建立時提供的 (若建立資料庫叢集時有指定的話)。在資料庫叢集使用期間,會傳回此名稱。

  • DBClusterArn - 這是字串,類型為:string (UTF-8 編碼的字串)。

    資料庫叢集的 Amazon Resource Name (ARN)。

  • DBClusterIdentifier - 這是字串,類型為:string (UTF-8 編碼的字串)。

    包含使用者提供的資料庫叢集識別碼。此識別碼為可識別資料庫叢集的唯一金鑰。

  • DBClusterMembers - 這是 DBClusterMember 物件的陣列。

    提供組成資料庫叢集的執行個體清單。

  • DBClusterParameterGroup - 這是字串,類型為:string (UTF-8 編碼的字串)。

    指定資料庫叢集的資料庫叢集參數群組名稱。

  • DbClusterResourceId - 這是字串,類型為:string (UTF-8 編碼的字串)。

    資料庫叢集的 Amazon 區域唯一、固定識別符。此識別符可在每次存取資料庫叢集的 Amazon KMS 金鑰時,於 Amazon CloudTrail 日誌項目中找到。

  • DBSubnetGroup - 這是字串,類型為:string (UTF-8 編碼的字串)。

    指定與資料庫叢集建立關聯子網路群組的資訊,包括名稱、描述,以及子網路群組中的子網路。

  • DeletionProtection – 這是 BooleanOptional,類型為:boolean (布林值 (true 或 false))。

    指示資料庫叢集是否已啟用刪除保護。啟用刪除保護時無法刪除資料庫。

  • EarliestBacktrackTime – 這是 TStamp,類型為:timestamp (一個時間點,通常定義為 1970-01-01 午夜的偏移量)。

    Neptune 不提供支援。

  • EarliestRestorableTime – 這是 TStamp,類型為:timestamp (一個時間點,通常定義為 1970-01-01 午夜的偏移量)。

    指定可透過 point-in-time 還原還原資料庫的最早時間。

  • EnabledCloudwatchLogsExports - 這是字串,類型為:string (UTF-8 編碼的字串)。

    此資料庫叢集已設為匯出至 CloudWatch Logs 的日誌類型清單。有效的日誌類型為:audit (用來將稽核日誌發佈至 CloudWatch) 和 slowquery (用來將慢查詢日誌發佈至 CloudWatch)。請參閱將 Neptune 日誌發佈至 Amazon CloudWatch Logs

  • Endpoint - 這是字串,類型為:string (UTF-8 編碼的字串)。

    指定資料庫叢集主要執行個體的連線端點。

  • Engine - 這是字串,類型為:string (UTF-8 編碼的字串)。

    提供要用於此資料庫叢集的資料庫引擎名稱。

  • EngineVersion - 這是字串,類型為:string (UTF-8 編碼的字串)。

    指示資料庫引擎版本。

  • GlobalClusterIdentifier - 這是 GlobalClusterIdentifier,類型為:string (UTF-8 編碼的字串),不小於 1 或大於 255 ?st?s,符合此規則運算式:[A-Za-z][0-9A-Za-z-:._]*

    包含使用者提供的全球資料庫叢集識別符。此識別符為可識別全球資料庫的唯一金鑰。

  • HostedZoneId - 這是字串,類型為:string (UTF-8 編碼的字串)。

    指定當您建立託管區域時,Amazon Route 53 指派的 ID。

  • IAMDatabaseAuthenticationEnabled - 這是布林值,類型為:boolean (布林值 (true 或 false))。

    若有啟用 Amazon Identity and Access Management (IAM) 帳戶對資料庫帳戶的映射,則為 true,否則為 false。

  • IOOptimizedNextAllowedModificationTime – 這是 TStamp,類型為:timestamp (一個時間點,通常定義為 1970-01-01 午夜的偏移量)。

    下次您可以修改資料庫叢集以使用 iopt1 儲存類型。

  • KmsKeyId - 這是字串,類型為:string (UTF-8 編碼的字串)。

    StorageEncrypted 為 true,則為加密資料庫叢集的 Amazon KMS 金鑰識別碼。

  • LatestRestorableTime – 這是 TStamp,類型為:timestamp (一個時間點,通常定義為 1970-01-01 午夜的偏移量)。

    指定可透過 point-in-time 還原還原資料庫的最新時間。

  • MultiAZ - 這是布林值,類型為:boolean (布林值 (true 或 false))。

    指定資料庫叢集是否在多個可用區域中擁有執行個體。

  • PendingModifiedValues - 這是一個 ClusterPendingModifiedValues 物件。

    此資料類型會在 ModifyDBCluster 操作中用作回應元素,並包含將在下一個維護時段期間套用的變更。

  • PercentProgress - 這是字串,類型為:string (UTF-8 編碼的字串)。

    指定操作的進度 (百分比)。

  • Port – 這是 IntegerOptional,類型為:integer (帶正負號的 32 位元整數)。

    指定資料庫引擎接聽的連接埠。

  • PreferredBackupWindow - 這是字串,類型為:string (UTF-8 編碼的字串)。

    指定每日的時間範圍,若有啟用自動化備份 (由 BackupRetentionPeriod 決定),則自動化備份會在此期間建立。

  • PreferredMaintenanceWindow - 這是字串,類型為:string (UTF-8 編碼的字串)。

    指定每週可能進行系統維護的時段,以世界協調時間 (UTC) 表示。

  • ReaderEndpoint - 這是字串,類型為:string (UTF-8 編碼的字串)。

    資料庫叢集的讀取器端點。資料庫叢集的讀取器端點,用來針對資料庫叢集中可用僅供讀取複本的連線進行負載平衡。當用戶端向讀取器端點請求新連線時,Neptune 會在資料庫叢集中的僅供讀取複本間分散連線請求。此功能有助於在您資料庫叢集中的多個僅供讀取複本間平衡您的讀取工作負載。

    若發生容錯移轉,且您連線的僅供讀取複本提升為主要執行個體,則會中斷您的連線。若要繼續將您的讀取工作負載傳送到叢集內的其他僅供讀取複本,您可以接著重新連線到讀取器端點。

  • ReadReplicaIdentifiers - 這是字串,類型為:string (UTF-8 編碼的字串)。

    包含與此資料庫叢集相關聯的一或多個僅供讀取複本識別符。

  • ReplicationSourceIdentifier - 這是字串,類型為:string (UTF-8 編碼的字串)。

    Neptune 不提供支援。

  • ReplicationType - 這是字串,類型為:string (UTF-8 編碼的字串)。

    Neptune 不提供支援。

  • ServerlessV2ScalingConfiguration - 這是一個 ServerlessV2ScalingConfigurationInfo 物件。

    顯示 Neptune Serverless 資料庫叢集的擴展組態。

    如需詳細資訊,請參閱《Amazon Neptune 使用者指南》中的使用 Amazon Neptune Serverless

  • Status - 這是字串,類型為:string (UTF-8 編碼的字串)。

    指定此資料庫叢集的目前狀態。

  • StorageEncrypted - 這是布林值,類型為:boolean (布林值 (true 或 false))。

    指定是否要加密資料庫叢集。

  • StorageType - 這是字串,類型為:string (UTF-8 編碼的字串)。

    資料庫叢集使用的儲存類型。

    有效值:

    • standard   –   (預設值) 針對具有中至低 I/O 使用量的應用程式提供具成本效益的資料庫儲存體。

    • iopt1   –   啟用 I/O 優化儲存,旨在符合 I/O 密集型圖形工作負載的需求,而這些工作負載則需要可預測的定價、低 I/O 延遲和一致的 I/O 輸送量。

      僅引擎版本 1.3.0.0 開始提供 Neptune I/O 優化儲存。

  • VpcSecurityGroups - 這是 VpcSecurityGroupMembership 物件的陣列。

    提供資料庫叢集歸屬的 VPC 安全群組清單。

DBCluster 會用來做為以下項目的回應元素:

DBClusterMember (結構)

包含做為資料庫叢集一部分的執行個體相關資訊。

欄位
  • DBClusterParameterGroupStatus - 這是字串,類型為:string (UTF-8 編碼的字串)。

    指定此資料庫叢集成員的資料庫叢集參數群組狀態。

  • DBInstanceIdentifier - 這是字串,類型為:string (UTF-8 編碼的字串)。

    指定此資料庫叢集成員的執行個體識別符。

  • IsClusterWriter - 這是布林值,類型為:boolean (布林值 (true 或 false))。

    若叢集成員是資料庫叢集的主要執行個體,則該值為 true,否則為 false

  • PromotionTier – 這是 IntegerOptional,類型為:integer (帶正負號的 32 位元整數)。

    此值指定在現有主要執行個體故障後,僅供讀取複本提升為主要執行個體的順序。

DBClusterRole (結構)

描述與資料庫叢集相關聯的 Amazon Identity and Access Management (IAM) 角色。

欄位
  • FeatureName - 這是字串,類型為:string (UTF-8 編碼的字串)。

    與 Amazon Identity and Access Management (IAM) 角色關聯的功能名稱。如需支援的功能名稱清單,請參閱 DescribeDBEngineVersions (動作)

  • RoleArn - 這是字串,類型為:string (UTF-8 編碼的字串)。

    與資料庫叢集相關聯的 IAM 角色 Amazon Resource Name (ARN)。

  • Status - 這是字串,類型為:string (UTF-8 編碼的字串)。

    描述 IAM 角色和資料庫叢集之間關聯的狀態。Status 屬性會傳回下列其中一個值:

    • ACTIVE - 與資料庫叢集相關聯的 IAM 角色 ARN,可用於代您存取其他 Amazon 服務。

    • PENDING - IAM 角色 ARN 正在和資料庫叢集建立關聯。

    • INVALID - 與資料庫叢集相關聯的 IAM 角色 ARN,但資料庫叢集無法取得 IAM 角色來代您存取其他 Amazon 服務。

CloudwatchLogsExportConfiguration (結構)

要啟用的日誌類型的組態設定,適用於匯出到特定資料庫執行個體或資料庫叢集的 CloudWatch Logs。

EnableLogTypesDisableLogTypes 陣列決定要將哪些日誌匯出 (或不匯出) 到 CloudWatch Logs。

有效的日誌類型為:audit (用來發佈稽核日誌) 和 slowquery (用來發佈慢查詢日誌)。請參閱將 Neptune 日誌發佈至 Amazon CloudWatch Logs

欄位
  • DisableLogTypes - 這是字串,類型為:string (UTF-8 編碼的字串)。

    要停用的日誌類型清單。

  • EnableLogTypes - 這是字串,類型為:string (UTF-8 編碼的字串)。

    要啟用的日誌類型清單。

PendingCloudwatchLogsExports (結構)

組態仍待處理的日誌類型清單。換言之,這些日誌類型正在進行啟用或停用中。

有效的日誌類型為:audit (用來發佈稽核日誌) 和 slowquery (用來發佈慢查詢日誌)。請參閱將 Neptune 日誌發佈至 Amazon CloudWatch Logs

欄位
  • LogTypesToDisable - 這是字串,類型為:string (UTF-8 編碼的字串)。

    正在進行啟用的日誌類型。日誌之後,這些日誌類型會匯出到 CloudWatch Logs。

  • LogTypesToEnable - 這是字串,類型為:string (UTF-8 編碼的字串)。

    正在進行停用的日誌類型。停用日誌之後,這些日誌類型不會匯出到 CloudWatch Logs。

ClusterPendingModifiedValues (結構)

此資料類型會在 ModifyDBCluster 操作中用作回應元素,並包含將在下一個維護時段期間套用的變更。

欄位
  • AllocatedStorage – 這是 IntegerOptional,類型為:integer (帶正負號的 32 位元整數)。

    為資料庫引擎所配置的儲存體大小,以 GiB 為單位。對於 Neptune,AllocatedStorage 一律會傳回 1,因為 Neptune 資料庫叢集儲存體大小並非固定,而是會視需要自動調整。

  • BackupRetentionPeriod – 這是 IntegerOptional,類型為:integer (帶正負號的 32 位元整數)。

    自動資料庫快照保留的天數。

  • DBClusterIdentifier - 這是字串,類型為:string (UTF-8 編碼的字串)。

    資料庫叢集的 DBClusterIdentifier 值。

  • EngineVersion - 這是字串,類型為:string (UTF-8 編碼的字串)。

    資料庫引擎版本。

  • IAMDatabaseAuthenticationEnabled – 這是 BooleanOptional,類型為:boolean (布林值 (true 或 false))。

    一值,指示是否啟用將 AWS Identity and Access Management (IAM) 帳戶對應到資料庫帳戶。

  • Iops – 這是 IntegerOptional,類型為:integer (帶正負號的 32 位元整數)。

    佈建 IOPS (每秒 I/O 操作) 值。此設定僅適用於多可用區域資料庫叢集。

  • PendingCloudwatchLogsExports - 這是一個 PendingCloudwatchLogsExports 物件。

    PendingCloudwatchLogsExports 結構會指定 CloudWatch Logs 啟用和停用的待定變更。

  • StorageType - 這是字串,類型為:string (UTF-8 編碼的字串)。

    資料庫叢集的儲存類型的待處理變更。  有效值:

    • standard   –   (預設值) 針對具有中至低 I/O 使用量的應用程式設定具成本效益的資料庫儲存體。

    • iopt1   –   啟用 I/O 優化儲存,旨在符合 I/O 密集型圖形工作負載的需求,而這些工作負載則需要可預測的定價、低 I/O 延遲和一致的 I/O 輸送量。

      僅引擎版本 1.3.0.0 開始提供 Neptune I/O 優化儲存。