az postgres flexible-server replica

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

コマンド

名前	説明	型	状態
az postgres flexible-server replica create	サーバーの読み取りレプリカを作成します。	コア	GA
az postgres flexible-server replica list	特定のサーバーのすべての読み取りレプリカを一覧表示します。	コア	GA
az postgres flexible-server replica promote	読み取りレプリカのレプリケーションを停止し、独立したサーバーまたはプライマリ サーバーに昇格させます。	コア	GA
az postgres flexible-server replica stop-replication	読み取りレプリカへのレプリケーションを停止し、読み取り/書き込みサーバーにします。	コア	"非推奨"

az postgres flexible-server replica create

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

az postgres flexible-server replica create --replica-name
                                           --resource-group
                                           --source-server
                                           [--address-prefixes]
                                           [--identity]
                                           [--key]
                                           [--location]
                                           [--no-wait]
                                           [--performance-tier]
                                           [--private-dns-zone]
                                           [--sku-name]
                                           [--storage-size]
                                           [--subnet]
                                           [--subnet-prefixes]
                                           [--tier]
                                           [--vnet]
                                           [--yes]
                                           [--zone]

例

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

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

プライベート アクセスを持つ 'testserver' 用の新しいサブネットを使用して、読み取りレプリカ 'testReplicaServer' を作成します。

az postgres flexible-server replica create --replica-name testReplicaServer -g testGroup \
  --source-server testserver --zone 3 --location testLocation \
  --vnet newVnet --subnet newSubnet \
  --address-prefixes 172.0.0.0/16 --subnet-prefixes 172.0.0.0/24 \
  --private-dns-zone testDNS.postgres.database.azure.com

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

az postgres flexible-server replica create --replica-name testReplicaServer -g testGroup --source-server testserver --location testLocation

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

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

必須のパラメーター

--replica-name

復元先のサーバーの名前。

--resource-group -g

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

--source-server

復元元のソース サーバーの名前またはリソース ID。

省略可能のパラメーター

--address-prefixes

CIDR 形式で新しい仮想ネットワークを作成するときに使用する IP アドレス プレフィックス。 既定値は 10.0.0.0/16 です。

--identity

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

--key

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

--location -l

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

--no-wait

実行時間の長い操作の終了を待機しません。

規定値: False

--performance-tier

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

--private-dns-zone

このパラメーターは、プライベート アクセスを持つサーバーにのみ適用されます。 新規または既存のプライベート DNS ゾーンの名前または ID。 同じリソース グループ、異なるリソース グループ、または異なるサブスクリプションのプライベート DNS ゾーンを使用できます。 別のリソース グループまたはサブスクリプションのゾーンを使いたい場合は、リソース ID を指定してください。ユーザーが指定しない場合、CLI により、仮想ネットワークと同じリソース グループ内に新しいプライベート DNS ゾーンが作成されます。

--sku-name

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

--storage-size

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

--subnet

新規または既存のサブネットの名前またはリソース ID。 別のリソース グループまたはサブスクリプションのサブネットを使いたい場合は、名前の代わりにリソース ID を指定してください。 サブネットは flexibleServers に委任されることに注意してください。 委任後、このサブネットを他の種類の Azure リソースに使うことはできません。

--subnet-prefixes

CIDR 形式で新しいサブネットを作成するときに使用するサブネット IP アドレス プレフィックス。 既定値は 10.0.0.0/24 です。

--tier

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

--vnet

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

--yes -y

確認のダイアログを表示しません。

規定値: False

--zone -z

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

グローバル パラメーター

--debug

すべてのデバッグ ログを表示するようにログの詳細レベルを上げます。

--help -h

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

--only-show-errors

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

--output -o

出力形式。

指定可能な値: json, jsonc, none, table, tsv, yaml, yamlc

規定値: json

--query

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

--subscription

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

--verbose

ログの詳細レベルを上げます。 詳細なデバッグ ログを表示するには --debug を使います。

az postgres flexible-server replica list

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

az postgres flexible-server replica list --name
                                         --resource-group

例

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

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

必須のパラメーター

--name -n

ソース サーバーの名前。

--resource-group -g

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

グローバル パラメーター

--debug

すべてのデバッグ ログを表示するようにログの詳細レベルを上げます。

--help -h

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

--only-show-errors

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

--output -o

出力形式。

指定可能な値: json, jsonc, none, table, tsv, yaml, yamlc

規定値: json

--query

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

--subscription

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

--verbose

ログの詳細レベルを上げます。 詳細なデバッグ ログを表示するには --debug を使います。

az postgres flexible-server replica promote

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

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

例

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

az postgres flexible-server replica promote -g testGroup -n testReplicaServer

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

az postgres flexible-server replica promote -g testGroup -n testReplicaServer --promote-mode standalone --promote-option forced

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

az postgres flexible-server replica promote -g testGroup -n testReplicaServer --promote-mode switchover --promote-option planned

省略可能のパラメーター

--ids

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

--name -n

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

--promote-mode

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

指定可能な値: standalone, switchover

規定値: standalone

--promote-option

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

指定可能な値: forced, planned

規定値: planned

--resource-group -g

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

--subscription

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

--yes -y

確認のダイアログを表示しません。

規定値: False

グローバル パラメーター

--debug

すべてのデバッグ ログを表示するようにログの詳細レベルを上げます。

--help -h

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

--only-show-errors

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

--output -o

出力形式。

指定可能な値: json, jsonc, none, table, tsv, yaml, yamlc

規定値: json

--query

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

--subscription

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

--verbose

ログの詳細レベルを上げます。 詳細なデバッグ ログを表示するには --debug を使います。

az postgres flexible-server replica stop-replication

非推奨

このコマンドは非推奨となり、今後のリリースで削除される予定です。 代わりに 'postgres フレキシブル サーバー レプリカの昇格' を使用してください。

読み取りレプリカへのレプリケーションを停止し、読み取り/書き込みサーバーにします。

az postgres flexible-server replica stop-replication [--ids]
                                                     [--name]
                                                     [--resource-group]
                                                     [--subscription]
                                                     [--yes]

例

'testReplicaServer' へのレプリケーションを停止し、読み取り/書き込みサーバーにします。

az postgres flexible-server replica stop-replication -g testGroup -n testReplicaServer

省略可能のパラメーター

--ids

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

--name -n

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

--resource-group -g

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

--subscription

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

--yes -y

確認のダイアログを表示しません。

規定値: False

グローバル パラメーター

--debug

すべてのデバッグ ログを表示するようにログの詳細レベルを上げます。

--help -h

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

--only-show-errors

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

--output -o

出力形式。

指定可能な値: json, jsonc, none, table, tsv, yaml, yamlc

規定値: json

--query

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

--subscription

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

--verbose

ログの詳細レベルを上げます。 詳細なデバッグ ログを表示するには --debug を使います。