ディスク間でデータを非同期にレプリケートするレプリケーションペアを作成します。

説明

非同期レプリケーションは、Elastic Block Storage (EBS) のデータレプリケーション機能に基づいて、リージョン間のデータを保護する機能です。 この機能は、ジオディザスタリカバリのために、あるリージョンのディスクから別のリージョンのディスクにデータを非同期に複製できます。 この機能を使用して、重要なビジネスにディザスタリカバリを実装し、データベースのデータを保護し、ビジネスの継続性を向上させることができます。

現在、非同期レプリケーション機能は、拡張SSD (ESSD) 間でのみデータを非同期にレプリケートできます。 レプリケーションペアのディスクの機能は制限されています。 サブスクリプションベースでの非同期レプリケーションの使用に対して課金され、帯域幅料金を支払う必要があります。

この操作を呼び出す前に、次の項目に注意してください。

  • データを複製するソースディスク (プライマリディスク) と、データを複製する宛先ディスク (セカンダリディスク) が作成されます。 CreateDisk操作を呼び出して、ディスクを作成できます。 プライマリディスクとセカンダリディスクを同じリージョンに配置することはできません。 現在、レプリケーションペアは次のリージョンで作成できます。
    • 中国 (上海): ゾーンB、ゾーンE、ゾーンF
    • 中国 (北京): ゾーンF、ゾーンG、ゾーンJ
    • 中国 (Heyuan): ゾーンA、ゾーンB
    • 中国 (成都): ゾーンA、ゾーンB
  • この操作を呼び出してレプリケーションペアを作成した後、StartDiskReplicaPair操作を呼び出してレプリケーションペアをアクティブ化し、プライマリディスクからセカンダリディスクの複数のリージョンにデータを定期的にレプリケートする必要があります。

デバッグ

OpenAPI Explorer は署名値を自動的に計算します。 この操作は、OpenAPI Explorer で呼び出すことを推奨します。 OpenAPI Explorer は、さまざまな SDK に対して操作のサンプルコードを動的に生成します。

リクエストパラメーター

パラメーター データ型 必須／任意 例 説明
操作 String 必須 CreateDiskReplicaPair

実行する操作です。 値をCreateDiskReplicaPairに設定します。

SourceRegionId String 必須 cn-beijing

プライマリディスクのリージョンID。 DescribeRegions操作を呼び出して、非同期レプリケーションがサポートされているリージョンの最新リストを照会できます。

DiskId String 必須 d-iq80sgp4d0xbk24q ****

プライマリディスクのID。

DestinationRegionId String 必須 cn-shanghai

セカンダリディスクのリージョンID。 DescribeRegions操作を呼び出して、非同期レプリケーションがサポートされているリージョンの最新リストを照会できます。

DestinationDiskId String 必須 d-sa1f82p58p1tdw9g ****

セカンダリディスクのID。

SourceZoneId String 任意 cn-北京-f

プライマリディスクのゾーンID。

DestinationZoneId String 任意 cn-shanghai-e

セカンダリディスクのゾーンID。

ペア名 String 任意 TestReplicaPair

レプリケーションペアの名前。 名前の長さは 2 から 128 文字です。 文字で始める必要があり、http:// またはhttps:// で始めることはできません。 英数字、コロン (:)、アンダースコア (_)、ピリオド (.) およびハイフン (-) を使用できます。

説明 String 任意 これは説明です。

レプリケーションペアの説明。 説明の長さは 2 ~ 256 文字である必要があります。文頭に http:// または https:// を使用することはできません。

ChargeType String 任意 PrePaid

レプリケーションペアの課金方法。 サブスクリプション課金方法のみがサポートされています。 値をPrePaidに設定します。

デフォルト値は、Prepaid です。
期間 Long 任意 1

The subscription duration of the replication pair. ChargeTypeをPrePaidに設定した場合、このパラメーターを指定する必要があります。 サブスクリプション期間の単位は、PeriodUnitパラメーターで指定します。

  • PeriodUnitがWeekに設定されている場合の有効な値: 1、2、3、および4。
  • PeriodUnitがMonthに設定されている場合の有効な値: 1、2、3、4、5、6、7、8、9、12、24、36、48、60。
PeriodUnit String 任意 月

レプリケーションペアのサブスクリプション期間の単位。 設定可能な値は以下のとおりです。

  • 週
  • 月

デフォルト値：Month 。
ClientTokend String 任意 123e4567-e89b-12d3-a456-426655440000

リクエストのべき等性を保証するために使用されるクライアントトークンです。 クライアントを使用して値を生成できますが、値が異なるリクエスト間で一意であることを確認する必要があります。 トークンにはASCII文字のみを使用でき、長さは64文字を超えることはできません。 詳細については、「べき等性を確保する方法」をご参照ください。

帯域幅 Long 任意 10240

プライマリディスクとセカンダリディスク間でデータを非同期に複製するために使用される帯域幅。 単位：Kbit/s 設定可能な値は以下のとおりです。

  • 10240: 10 Mbit/sに等しい
  • 20480: 20 Mbit/sに等しい
  • 51200: 50 Mbit/sに等しい
  • 102400: 100 Mbit/sに等しい

デフォルト値: 10240

レスポンスパラメーター

パラメーター データ型 例 説明
RequestId String C123F94F-4E38-19AE-942A-A8D6F44F0450

リクエストの ID です。

ReplicaPairId String ペア-cn-dsa ****

レプリケーションペアのID。

OrderId String 1234567890

注文 ID このパラメーターは、ChargeTypeリクエストパラメーターがPrePaidに設定されている場合にのみ値を持ちます。

例

リクエストの例

https://ebs.cn-beijing.aliyuncs.com/?Action=CreateDiskReplicaPair
&RegionId=cn-beijing
&DiskId=d-iq80sgp4d0xbk24q ****
&DestinationRegionId=cn-shanghai
&DestinationDiskId=d-sa1f82p58p1tdw9g ****
&ZoneId=cn-beijing-f
&DestinationZoneId=cn-shanghai-e
&期間=1
&PeriodUnit=月
&帯域幅=10240
&<共通リクエストパラメーター>

正常に処理された場合のレスポンス例

XML 形式 

HTTP/1.1 200 OK
Content-Type:application/xml

<CreateDiskReplicaPairResponse>
    <RequestId>C123F94F-4E38-19AE-942A-A8D6F44F0450</RequestId>
    <ReplicaPairId>pair-cn-dsa****</ReplicaPairId>
    <OrderId>1234567890</OrderId>
</CreateDiskReplicaPairResponse>

JSON 形式 

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "C123F94F-4E38-19AE-942A-A8D6F44F0450" 、
  "ReplicaPairId" : "pair-cn-dsa ****" 、
  "OrderId" : "1234567890"
}

エラーコード

エラーコードリストについては、「API エラーセンター」をご参照ください。