az postgres flexible-server replica

読み取りレプリカを管理します。

コマンド

名前 説明 状態
az postgres flexible-server replica create

サーバーの読み取りレプリカを作成します。

Core GA
az postgres flexible-server replica list

特定のサーバーのすべての読み取りレプリカを一覧表示します。

Core GA
az postgres flexible-server replica promote

読み取りレプリカのレプリケーションを停止し、独立したサーバーまたはプライマリ サーバーに昇格させます。

Core GA

az postgres flexible-server replica create

サーバーの読み取りレプリカを作成します。

az postgres flexible-server replica create --name
                                           --resource-group
                                           --source-server
                                           [--acquire-policy-token]
                                           [--backup-federated-client-id]
                                           [--change-reference]
                                           [--federated-client-id]
                                           [--identity]
                                           [--key]
                                           [--location]
                                           [--no-wait]
                                           [--performance-tier]
                                           [--private-dns-zone]
                                           [--sku-name]
                                           [--storage-size]
                                           [--storage-type {PremiumV2_LRS}]
                                           [--subnet]
                                           [--tags]
                                           [--tier]
                                           [--vnet]
                                           [--yes]
                                           [--zone]

指定したゾーンと場所 (使用可能な場合) にパブリックまたはプライベート アクセスを使用して、'testserver' の読み取りレプリカ 'testreplica' を作成します。

az postgres flexible-server replica create --name testreplica -g testGroup --source-server testserver --zone 3 --location testLocation

既存のネットワーク リソースを使用してプライベート アクセスを使用して、'testserver' の読み取りレプリカ 'testreplica' を作成します。

az postgres flexible-server replica create --name testreplica -g testGroup \
  --source-server testserver --zone 3 --location testLocation \
  --vnet newVnet --subnet newSubnet \
  --private-dns-zone testdns.postgres.database.azure.com \
  --tags "key=value"

使用可能な場合は、指定した場所にパブリックまたはプライベート アクセスを使用して、'testserver' の読み取りレプリカ 'testreplica' を作成します。 ゾーンは渡されないため、ソース サーバーとは異なるレプリカの場所にあるゾーンが自動的に取得され、使用可能な場合はレプリカの場所のソース サーバーと同じゾーンが選択されます。それ以外の場合は、ゾーンが [なし] に設定されます。つまり、優先設定なし

az postgres flexible-server replica create --name testreplica -g testgroup --source-server testserver --location testLocation

カスタム --storage-size と --sku を使用して、'testserver' の読み取りレプリカ 'testreplica' を作成します。

az postgres flexible-server replica create --name testreplica -g testgroup --source-server testserver --sku-name Standard_D4ds_v5 --storage-size 256

'testserver' の読み取りレプリカ 'testreplica' を作成します。ここで、'testreplica' は別のリソース グループ 'newTestGroup' にあります。 ここでは、--resource-group は読み取りレプリカのリソース グループ用であり、--source-server はリソース識別子として渡す必要があります。

az postgres flexible-server replica create --name testreplicaserver -g newTestGroup         --source-server /subscriptions/{sourceSubscriptionId}/resourceGroups/{sourceResourceGroup}/providers/Microsoft.DBforPostgreSQL/flexibleServers/{sourceServer} --location testLocation

必須のパラメーター

--name -n

読み取りレプリカの名前。

--resource-group -g

リソース グループの名前。 az configure --defaults group=<name>を使用して既定のグループを構成できます。

--source-server

復元元のソース サーバーの名前またはリソース識別子。

オプションのパラメーター

次のパラメーターは省略可能ですが、コマンドを正常に実行するには、状況に応じて 1 つ以上が必要になる場合があります。

--acquire-policy-token

このリソース操作のAzure Policy トークンを自動的に取得します。

プロパティ
パラメーター グループ: Global Policy Arguments
--backup-federated-client-id -f

geo バックアップフェデレーション ID のクライアント ID。

--change-reference

このリソース操作の関連する変更参照 ID。

プロパティ
パラメーター グループ: Global Policy Arguments
--federated-client-id

フェデレーション ID のクライアント ID。

--identity

データ暗号化のユーザー割り当て ID の名前またはリソース識別子。

--key

データ暗号化用の主キーコンテナー キーのリソース識別子。

--location -l

Location. 値のソース: az account list-locations az configure --defaults location=<location>を使用して、既定の場所を構成できます。

--no-wait

実行時間の長い操作が完了するまで待つ必要はありません。

プロパティ
規定値: False
--performance-tier

サーバーのパフォーマンスレベル。

--private-dns-zone

このパラメーターは、プライベート アクセスを持つサーバーにのみ適用され、--vnet または --subnet を使用する場合に必要です。 既存のプライベート DNS ゾーンの名前またはリソース識別子。 同じリソース グループ、別のリソース グループ、または別のサブスクリプションのプライベート DNS ゾーンを使用できます。 別のリソース グループまたはサブスクリプションのゾーンを使用する場合は、そのリソース識別子を指定してください。

--sku-name

コンピューティング SKU の名前。 {VM 名} Standard_規則に従います。 例: Standard_B1ms。

--storage-size

サーバーのストレージ容量。 最小値は 32 GiB、最大値は 16 TiB です。

--storage-type

読み取りレプリカのストレージの種類。 使用できる値はPremiumV2_LRS。 既定では、読み取りレプリカがプライマリ サーバーのストレージの種類と一致します。

プロパティ
指定可能な値: PremiumV2_LRS
--subnet

既存のサブネットの名前または識別子。 別のリソース グループまたはサブスクリプションのサブネットを使用する場合は、名前の代わりにそのリソース識別子を指定してください。

--tags

スペース区切りのタグ: key[=value] [key[=value] ...]既存のタグをクリアするには、"" を使用します。

--tier

サーバーのコンピューティング レベル。 指定できる値: Burstable、GeneralPurpose、MemoryOptimized。

--vnet

既存の仮想ネットワークの名前または識別子。 別のリソース グループまたはサブスクリプションの vnet を使用する場合は、リソース識別子を指定してください。 名前は 2 文字から 64 文字にする必要があります。 名前は先頭が文字または数字、末尾が文字、数字、アンダースコアでなければならず、中に含めることができるのは文字、数字、アンダースコア、ピリオド、ハイフンのみです。

--yes -y

確認を求めないでください。

プロパティ
規定値: False
--zone -z

リソースをプロビジョニングする可用性ゾーン。

グローバル パラメーター
--debug

ログの詳細度を上げて、すべてのデバッグ ログを表示します。

プロパティ
規定値: False
--help -h

このヘルプ メッセージを表示して終了します。

--only-show-errors

エラーのみを表示し、警告を抑制します。

プロパティ
規定値: False
--output -o

出力フォーマット。

プロパティ
規定値: json
指定可能な値: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ を参照してください。

--subscription

サブスクリプションの名前または ID。 az account set -s NAME_OR_IDを使用して既定のサブスクリプションを構成できます。

--verbose

ログの詳細度を高める。 完全なデバッグ ログには --debug を使用します。

プロパティ
規定値: False

az postgres flexible-server replica list

特定のサーバーのすべての読み取りレプリカを一覧表示します。

az postgres flexible-server replica list [--ids]
                                         [--name]
                                         [--resource-group]
                                         [--subscription]

マスター サーバー 'testserver' のすべての読み取りレプリカを一覧表示します。

az postgres flexible-server replica list -g testgroup -n testserver

オプションのパラメーター

次のパラメーターは省略可能ですが、コマンドを正常に実行するには、状況に応じて 1 つ以上が必要になる場合があります。

--ids

1 つ以上のリソース ID (スペース区切り)。 これは、'Resource Id' 引数のすべての情報を含む完全なリソース ID である必要があります。 --ids または他の 'Resource Id' 引数を指定する必要があります。

プロパティ
パラメーター グループ: Resource Id Arguments
--name -n

サーバーの名前。 名前に含めることができるのは、英小文字、数字、ハイフン (-) のみです。 3 文字以上、最大 63 文字。

プロパティ
パラメーター グループ: Resource Id Arguments
--resource-group -g

リソース グループの名前。 az configure --defaults group=<name>を使用して既定のグループを構成できます。

プロパティ
パラメーター グループ: Resource Id Arguments
--subscription

サブスクリプションの名前または ID。 az account set -s NAME_OR_IDを使用して既定のサブスクリプションを構成できます。

プロパティ
パラメーター グループ: Resource Id Arguments
グローバル パラメーター
--debug

ログの詳細度を上げて、すべてのデバッグ ログを表示します。

プロパティ
規定値: False
--help -h

このヘルプ メッセージを表示して終了します。

--only-show-errors

エラーのみを表示し、警告を抑制します。

プロパティ
規定値: False
--output -o

出力フォーマット。

プロパティ
規定値: json
指定可能な値: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ を参照してください。

--verbose

ログの詳細度を高める。 完全なデバッグ ログには --debug を使用します。

プロパティ
規定値: False

az postgres flexible-server replica promote

読み取りレプリカのレプリケーションを停止し、独立したサーバーまたはプライマリ サーバーに昇格させます。

az postgres flexible-server replica promote [--acquire-policy-token]
                                            [--change-reference]
                                            [--ids]
                                            [--name]
                                            [--promote-mode {standalone, switchover}]
                                            [--promote-option {forced, planned}]
                                            [--resource-group]
                                            [--subscription]
                                            [--yes]

'testreplica' へのレプリケーションを停止し、スタンドアロンの読み取り/書き込みサーバーに昇格させます。

az postgres flexible-server replica promote -g testgroup -n testreplica

'testreplica' へのレプリケーションを停止し、強制データ同期を使用してスタンドアロンの読み取り/書き込みサーバーに昇格させます。

az postgres flexible-server replica promote -g testgroup -n testreplica --promote-mode standalone --promote-option forced

'testreplica' へのレプリケーションを停止し、計画されたデータ同期を使用してプライマリ サーバーに昇格させます。昇格するレプリカには、リーダー仮想エンドポイントが割り当てられている必要があります。または、昇格時にエラーが発生します。

az postgres flexible-server replica promote -g testgroup -n testreplica --promote-mode switchover --promote-option planned

オプションのパラメーター

次のパラメーターは省略可能ですが、コマンドを正常に実行するには、状況に応じて 1 つ以上が必要になる場合があります。

--acquire-policy-token

このリソース操作のAzure Policy トークンを自動的に取得します。

プロパティ
パラメーター グループ: Global Policy Arguments
--change-reference

このリソース操作の関連する変更参照 ID。

プロパティ
パラメーター グループ: Global Policy Arguments
--ids

1 つ以上のリソース ID (スペース区切り)。 これは、'Resource Id' 引数のすべての情報を含む完全なリソース ID である必要があります。 --ids または他の 'Resource Id' 引数を指定する必要があります。

プロパティ
パラメーター グループ: Resource Id Arguments
--name -n

読み取りレプリカの名前。

プロパティ
パラメーター グループ: Resource Id Arguments
--promote-mode

読み取りレプリカを独立したサーバーに昇格するか、プライマリ サーバーとして昇格させるか。

プロパティ
規定値: standalone
指定可能な値: standalone, switchover
--promote-option

読み取りレプリカを昇格する前にデータを同期するか、できるだけ早く昇格するかを指定します。

プロパティ
規定値: planned
指定可能な値: forced, planned
--resource-group -g

リソース グループの名前。 az configure --defaults group=<name>を使用して既定のグループを構成できます。

プロパティ
パラメーター グループ: Resource Id Arguments
--subscription

サブスクリプションの名前または ID。 az account set -s NAME_OR_IDを使用して既定のサブスクリプションを構成できます。

プロパティ
パラメーター グループ: Resource Id Arguments
--yes -y

確認を求めないでください。

プロパティ
規定値: False
グローバル パラメーター
--debug

ログの詳細度を上げて、すべてのデバッグ ログを表示します。

プロパティ
規定値: False
--help -h

このヘルプ メッセージを表示して終了します。

--only-show-errors

エラーのみを表示し、警告を抑制します。

プロパティ
規定値: False
--output -o

出力フォーマット。

プロパティ
規定値: json
指定可能な値: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ を参照してください。

--verbose

ログの詳細度を高める。 完全なデバッグ ログには --debug を使用します。

プロパティ
規定値: False