你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

az postgres server replica

管理读取副本 (replica)。

命令

名称	说明	类型	Status
az postgres server replica create	创建服务器的只读副本。	核心	GA
az postgres server replica list	列出某个给定服务器的所有只读副本。	核心	GA
az postgres server replica stop	停止复制到只读副本，并使该副本成为读/写服务器。	核心	GA

az postgres server replica create

创建服务器的只读副本。

az postgres server replica create --name
                                  --resource-group
                                  --source-server
                                  [--location]
                                  [--no-wait]
                                  [--sku-name]

示例

为“testsvr”创建读取副本 (replica)“testreplsvr”。

az postgres server replica create -n testreplsvr -g testgroup -s testsvr

为“testsvr2”创建读取副本 (replica)“testreplsvr”，其中“testreplsvr”位于不同的资源组中。

az postgres server replica create -n testreplsvr -g testgroup \
    -s "/subscriptions/${SubID}/resourceGroups/${ResourceGroup}/providers/Microsoft.DBforPostgreSQL/servers/testsvr2"

必需参数

--name -n

服务器的名称。 名称只能包含小写字母、数字和连字符 (-)。 最少 3 个字符，最多 63 个字符。

--resource-group -g

资源组的名称。 可以使用 az configure --defaults group=<name> 配置默认组。

--source-server -s

要为其创建副本 (replica)的主服务器的名称或资源 ID。

可选参数

--location -l

Location。 az account list-locations 中的值。 如果未提供，则创建副本 (replica)将与主服务器位于同一位置。

--no-wait

不等待长时间运行的操作完成。

默认值: False

--sku-name

SKU 的名称。 请遵循简写约定 {pricing tier} {compute generation} {vCores}。 示例：B_Gen5_1、GP_Gen5_4、MO_Gen5_16。

全局参数

--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 server replica list

列出某个给定服务器的所有只读副本。

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

示例

列出主服务器“testsvr”的所有读取副本 (replica)。

az postgres server replica list -g testgroup -s testsvr

可选参数

--ids

一个或多个资源 ID（空格分隔）。 它应该是包含“资源 ID”参数的所有信息的完整资源 ID。 应提供 --id 或其他“资源 ID”参数。

--resource-group -g

资源组的名称。 可以使用 az configure --defaults group=<name> 配置默认组。

--server-name -s

主服务器的名称。

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

全局参数

--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 server replica stop

停止复制到只读副本，并使该副本成为读/写服务器。

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

示例

停止对“testreplsvr”的副本 (replica)，使其成为读/写服务器。

az postgres server replica stop -g testgroup -n testreplsvr

可选参数

--ids

一个或多个资源 ID（空格分隔）。 它应该是包含“资源 ID”参数的所有信息的完整资源 ID。 应提供 --id 或其他“资源 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 获取完整的调试日志。