Tair (Redis® OSS-Compatible):CreateTairInstance

リージョン ID です。DescribeRegions 操作を呼び出して、最新のリージョン一覧を照会できます。

インスタンス名です。インスタンス名は以下の要件を満たす必要があります。

• 2 文字以上 80 文字以下である必要があります。

• 先頭は英字で、スペースや特殊文字を含んではいけません。特殊文字には @ / : = " < > { [ ] } が含まれます。

インスタンスへの接続に使用するパスワードです。パスワードは以下の要件を満たす必要があります。

• 8 文字以上 32 文字以下である必要があります。

• 大文字、小文字、数字、特殊文字のうち、少なくとも 3 種類を含む必要があります。特殊文字には ! @ # $ % ^ & * ( ) _ + - = が含まれます。

インスタンスシリーズです。詳細については、以下のトピックをご参照ください。

• DRAM ベースのインスタンス

• 永続メモリインスタンス

• ESSD/SSD ベースのインスタンス

プライマリゾーンの ID です。DescribeRegions 操作を呼び出して、最新のゾーン一覧を照会できます。

セカンダリゾーンの ID です。DescribeRegions 操作を呼び出して、セカンダリゾーンの ID を照会できます。

インスタンスの課金方法です。有効値は次のとおりです。

• PrePaid (デフォルト)：サブスクリプション

• PostPaid：従量課金

VPC の ID です。DescribeVpcs 操作を呼び出して、VPC ID を照会できます。

VPC に属する vSwitch の ID です。DescribeVpcs 操作を呼び出して、vSwitch ID を照会できます。

サブスクリプション期間です。有効値：1、2、3、4、5、6、7、8、9、12、24、36、および 60。単位：月。

プロモーションイベントまたはビジネス情報の ID です。

クーポンコードです。

既存のインスタンスのバックアップセットに基づいてインスタンスを作成する場合は、このパラメーターにソースインスタンスの ID を設定します。

BackupId パラメーターにソースインスタンスのバックアップセット ID を設定できます。システムはバックアップセットに保存されているデータを使用してインスタンスを作成します。DescribeBackups 操作を呼び出して、バックアップセット ID を照会できます。ソースインスタンスがクラスターインスタンスの場合、BackupId パラメーターにソースインスタンスのすべてのシャードのバックアップセット ID をカンマ (,) で区切って設定します。例："10**,11**,15**"。

このパラメーターは、特定の新しいクラスターインスタンスでサポートされています。DescribeClusterBackupList 操作を呼び出して、バックアップセット ID を照会できます。

• このパラメーターがサポートされている場合、バックアップセット ID を指定できます。この場合、BackupId パラメーターを指定する必要はありません。

• このパラメーターがサポートされていない場合、BackupId パラメーターにソースインスタンスのすべてのシャードのバックアップセット ID をカンマ (,) で区切って設定します。例："2158****20,2158****22"。

指定されたバックアップセットからインスタンスを作成する際に、元のバックアップセットからアカウント、カーネルパラメータ、ホワイトリスト情報を復元するかどうかを指定します。たとえば、アカウント情報を復元する場合は、パラメーターを {"account":true} に設定します。

このパラメーターはデフォルトで空であり、これはアカウント、カーネルパラメータ、ホワイトリスト情報が元のバックアップセットから復元されないことを示します。

インスタンスの内部 IP アドレスです。

クーポンを使用するかどうかを指定します。有効値は次のとおりです。

• true：クーポンを使用します。

• false (デフォルト)：クーポンを使用しません。

インスタンスの自動更新を有効にするかどうかを指定します。有効値は次のとおりです。

• true：自動更新を有効にします。

• false (デフォルト)：自動更新を無効にします。

自動更新でサポートされるサブスクリプション期間です。単位：月。有効値：1、2、3、6、および 12。

管理対象のリソースグループの ID です。

• コンソールまたは ListResourceGroups 操作を呼び出して、リソースグループ ID を照会できます。詳細については、「リソースグループの基本情報の表示」をご参照ください。

• インスタンスが属するリソースグループを変更する前に、ListResources 操作を呼び出して、インスタンスの現在のリソースグループを表示できます。

自動支払いを有効にするかどうかを指定します。値を true に設定します。

リクエストのべき等性を保証するために使用されるクライアントトークンです。クライアント側でトークンを生成できますが、異なるリクエスト間でトークンが一意であり、大文字と小文字が区別されることを保証する必要があります。トークンには ASCII 文字のみを含めることができ、長さは 64 文字を超えてはいけません。

ストレージタイプです。有効値：essd_pl1、essd_pl2、および essd_pl3。

列挙値：

• essd_pl0

• essd_pl1

• essd_pl2

• essd_pl3

ESSD/SSD ベースのインスタンスのストレージ容量です。有効値はインスタンスタイプによって異なります。詳細については、「ESSD/SSD ベースのインスタンス」をご参照ください。

インスタンスのシャードタイプです。有効値は次のとおりです。

• MASTER_SLAVE (デフォルト)：高可用性を提供するマスター・レプリカアーキテクチャで動作します。

• STAND_ALONE：スタンドアロンアーキテクチャで動作します。唯一のノードが障害になると、システムは新しいインスタンスを作成し、ワークロードを新しいインスタンスに切り替えます。これによりデータ損失が発生する可能性があります。この値を ShardType パラメーターに設定できるのは、インスタンスがシングルゾーンデプロイモードを使用している場合のみです。この値を設定すると、クラスターインスタンスまたは読み書き分離インスタンスを作成することはできません。

インスタンス内のデータノード数です。有効値は次のとおりです。

• 1 (デフォルト)：スタンダードインスタンス (データノードが 1 つだけ) を作成できます。

• 2 ～ 32：クラスターインスタンス (指定された数のデータノードを含む) を作成できます。

プライマリゾーン内のレプリカノード数です。このパラメーターはクラウドネイティブマルチレプリカクラスターインスタンスにのみ適用されます。有効値：1～4。

• このパラメーターと SlaveReplicaCount パラメーターの値の合計は 4 を超えてはいけません。

• ReplicaCount パラメーターと ReadOnlyCount パラメーターのいずれか一方のみを指定できます。

• マスター・レプリカインスタンスは複数レプリカをサポートしていません。

マルチゾーンデプロイのクラウドネイティブマルチレプリカクラスターインスタンスを作成する際のセカンダリゾーン内のレプリカノード数です。このパラメーターと ReplicaCount パラメーターの値の合計は 4 を超えてはいけません。

プライマリゾーン内の読み取り専用レプリカ数です。このパラメーターはクラウドネイティブ読み書き分離インスタンスにのみ適用されます。有効値：1～9。

マルチゾーン読み書き分離インスタンスを作成する際のセカンダリゾーン内の読み取り専用レプリカ数です。このパラメーターと ReadOnlyCount パラメーターの値の合計は 9 を超えてはいけません。

データベースエンジンバージョンです。デフォルト値：1.0。パラメーター値は Tair インスタンスシリーズによって異なります。

• Redis 5.0、6.0、または 7.0 と互換性のある Tair DRAM ベースのインスタンス (Tair_rdb) を作成する場合は、このパラメーターを 5.0、6.0、または 7.0 に設定します。

• Redis 6.0 と互換性のある Tair 永続メモリインスタンス (tair_scm) を作成する場合は、このパラメーターを 1.0 に設定します。

• Redis 6.0 と互換性のある Tair ESSD ベースのインスタンス (tair_essd) を作成する場合は、このパラメーターを 1.0 に設定します。Redis 6.0 と互換性のある Tair SSD ベースのインスタンスを作成する場合は、このパラメーターを 2.0 に設定します。

インスタンスシリーズです。有効値は次のとおりです。

• tair_rdb：Tair DRAM ベースのインスタンス

• tair_scm：Tair 永続メモリインスタンス

• tair_essd：Tair ESSD/SSD ベースのインスタンス

作成されたインスタンスを分散インスタンスのサブインスタンスとして使用するかどうかを指定します。

• 作成されたインスタンスを最初のサブインスタンスとして使用する場合は、true を入力します。

• 作成されたインスタンスを 2 番目または 3 番目のサブインスタンスとして使用する場合は、分散インスタンスの ID (例：gr-bp14rkqrhac****) を入力します。

• 作成されたインスタンスを分散インスタンスとして使用しない場合は、パラメーターを空のままにします。

実際のリクエストを実行せずにドライランのみを実行するかどうかを指定します。有効値は次のとおりです。

• true：ドライランを実行し、インスタンスは作成されません。システムはリクエストパラメーター、リクエストフォーマット、サービス制限、および利用可能なリソースを事前チェックします。リクエストがドライランに失敗した場合は、エラーコードが返されます。リクエストが事前チェックに合格した場合は、DryRunOperation エラーコードが返されます。

• false (false)：ドライランを実行し、実際のリクエストを実行します。リクエストがドライランに合格した場合は、インスタンスが直接作成されます。

インスタンスのサービスポート番号です。有効値：1024～65535。デフォルト値：6379。

インスタンスのグローバル IP ホワイトリストテンプレートです。複数の IP ホワイトリストテンプレートをカンマ (,) で区切ります。各 IP ホワイトリストテンプレートは一意である必要があります。

パラメータテンプレートの ID です。インスタンスはパラメータテンプレート内のパラメーターに基づいて作成されます。ID は一意である必要があります。

ソースインスタンスでデータフラッシュバックが有効になっている場合、このパラメーターを使用して、ソースインスタンスのバックアップ保持期間内の時点を指定できます。システムはその時点でのソースインスタンスのバックアップデータを使用してインスタンスを作成します。時刻は ISO 8601 標準の yyyy-MM-ddTHH:mm:ssZ 形式で指定し、UTC である必要があります。

エンドポイントのプレフィックスです。プレフィックスは 8～40 文字で、小文字と数字を含めることができます。先頭は小文字で始まる必要があります。

読み書き分離機能を備えたクラウドネイティブデュアルゾーンデプロイインスタンスを作成する際に使用する接続アドレスタイプです。このパラメーターを明示的に指定しない場合、デフォルト値は AzIndependentEndpoint になります。

• AzIndependentEndpoint：デフォルト値。ゾーン非依存型接続アドレス。プライマリゾーンとセカンダリゾーンそれぞれに独立した接続アドレスが提供され、各ゾーンのアドレスを通じて最寄りアクセスが可能になります。

• UnifiedEndpoint：統合接続アドレス。単一の統合接続アドレスが提供され、プライマリゾーンとセカンダリゾーンの両方のノードに同時にアクセスできますが、ゾーン間アクセスが発生する可能性があります。