リソース: インスタンス
Google Cloud Redis のインスタンス。
JSON 表現 | |
---|---|
{ "name": string, "displayName": string, "labels": { string: string, ... }, "locationId": string, "alternativeLocationId": string, "redisVersion": string, "reservedIpRange": string, "host": string, "port": number, "currentLocationId": string, "createTime": string, "state": enum( |
フィールド | |
---|---|
name |
必須。プロジェクトとロケーションを含むスコープ内で一意のリソース名。 注: Redis インスタンスはリージョン レベルで管理され、アドレス指定されるため、locationId の部分は GCP のリージョンを指します。ただし、インスタンスをプロビジョニングするゾーン(複数のゾーンにまたがるインスタンスの場合はゾーンのコレクション)はユーザーが選択できます。詳細については、[locationId] と [alternativeLocationId] フィールドを参照してください。 |
displayName |
ユーザーが指定する任意で省略可能なインスタンスの名前。 |
labels |
ユーザーが指定したメタデータを表すリソースラベル
|
locationId |
省略可。インスタンスがプロビジョニングされるゾーン。指定しない場合は、サービスによってインスタンスのゾーンが選択されます。STANDARD_HA 階層の場合、ゾーン障害に対する保護を目的として、インスタンスが 2 つのゾーンにまたがって作成されます。[alternativeLocationId] も指定する場合は、[locationId] と異なるものにする必要があります。 |
alternativeLocationId |
省略可。STANDARD_HA 階層だけに該当します。2 つのゾーンにまたがってプロビジョニングすることで、ゾーン障害に対する保護を提供します。指定する場合は、[locationId] で指定されているゾーンとは異なるゾーンにする必要があります。 |
redisVersion |
省略可。Redis ソフトウェアのバージョン。指定しない場合は、サポートされている最新のバージョンが使用されます。バージョンを更新すると、新しいバージョンへのアップグレード / ダウングレードが実行されます。現在サポートされている値は |
reservedIpRange |
省略可。このインスタンス用に予約されている内部アドレスの CIDR 範囲。指定しない場合は、10.0.0.0/29 や 192.168.0.0/29 など、未使用の /29 ブロックがサービスによって選択されます。範囲は一意でなければならず、承認済みネットワーク内の既存のサブネットと重複していてはなりません。 |
host |
出力のみ。クライアントがサービスに接続するために使用する、公開されている Redis エンドポイントのホスト名または IP アドレス。 |
port |
出力のみ。公開されている Redis エンドポイントのポート番号。 |
currentLocationId |
出力のみ。Redis エンドポイントが配置されている現在のゾーン。基本階層のインスタンスの場合は、作成時にユーザーが指定した [locationId] と常に同じになります。標準階層のインスタンスの場合は [locationId] または [alternativeLocationId] のいずれかとなり、フェイルオーバーの発生後に変化する場合があります。 |
createTime |
出力のみ。インスタンスが作成された時刻。 RFC3339 UTC「Zulu」形式のタイムスタンプ。精度はナノ秒。例: |
state |
出力のみ。このインスタンスの現在の状態。 |
statusMessage |
出力のみ。このインスタンスの現在のステータスに関する追加情報(利用可能な場合)。 |
redisConfigs |
省略可。http://redis.io/topics/config に従った Redis 構成パラメータ。現在サポートされているパラメータは次のものだけです。
|
tier |
必須。インスタンスのサービス階層。 |
memorySizeGb |
必須。Redis のメモリサイズ(GiB 単位)。 |
authorizedNetwork |
省略可。インスタンスが接続されている Google Compute Engine ネットワークの完全修飾名。指定しない場合、 |
persistenceIamIdentity |
出力のみ。GCS との間でデータをやり取りするためにインポート / エクスポート オペレーションが使用する IAM 識別子。「serviceAccount: |
状態
Redis インスタンスのさまざまな状態を表します。
列挙型 | |
---|---|
STATE_UNSPECIFIED |
未設定。 |
CREATING |
Redis インスタンスを作成中です。 |
READY |
Redis インスタンスが作成済みで、完全に使用可能です。 |
UPDATING |
Redis インスタンスの構成を更新中です。更新の種類によっては、更新の進行中にインスタンスが使用不能になることがあります。 |
DELETING |
Redis インスタンスを削除中です。 |
REPAIRING |
Redis インスタンスを修復中のため、使用できない可能性があります。詳細については、statusMessage フィールドをご覧ください。 |
MAINTENANCE |
この Redis インスタンスに対するメンテナンスが実行中です。 |
IMPORTING |
Redis インスタンスがデータをインポート中です(可用性に影響する場合があります)。 |
階層
選択可能な提供中のサービス階層
列挙型 | |
---|---|
TIER_UNSPECIFIED |
未設定。 |
BASIC |
BASIC 階層: スタンドアロン インスタンス |
STANDARD_HA |
STANDARD_HA 階層: 高可用性のプライマリ / レプリカ インスタンス |
メソッド |
|
---|---|
|
指定した階層とメモリサイズに基づいて Redis インスタンスを作成します。 |
|
特定の Redis インスタンスを削除します。 |
|
特定の Redis インスタンスの詳細を取得します。 |
|
指定したロケーション(リージョン)またはすべてのロケーションのいずれかのプロジェクトによって所有されているすべての Redis インスタンスをリストします。 |
|
特定の Redis インスタンスのメタデータと構成を更新します。 |