您现在访问的是微软AZURE全球版技术文档网站,若需要访问由世纪互联运营的MICROSOFT AZURE中国区技术文档网站,请访问 https://docs.azure.cn.

az postgres server

管理 PostgreSQL 服务器。

命令

az postgres server ad-admin

管理 postgres 服务器的 Active Directory 管理员。

az postgres server ad-admin create

为 PostgreSQL 服务器创建 Active Directory 管理员。

az postgres server ad-admin delete

删除 PostgreSQL 服务器的 Active Directory 管理员。

az postgres server ad-admin list

列出 PostgreSQL 服务器的所有 Active Directory 管理员。

az postgres server ad-admin show

获取 PostgreSQL 服务器的 Active Directory 管理员信息。

az postgres server ad-admin wait

将 CLI 放在等待状态,直到满足 PostgreSQL 服务器 Active Directory 管理员的条件。

az postgres server configuration

管理服务器的配置值。

az postgres server configuration list

列出服务器的配置值。

az postgres server configuration set

更新服务器的配置。

az postgres server configuration show

获取服务器的配置。"。

az postgres server create

创建服务器。

az postgres server delete

删除服务器。

az postgres server firewall-rule

管理服务器的防火墙规则。

az postgres server firewall-rule create

为服务器创建新的防火墙规则。

az postgres server firewall-rule delete

删除防火墙规则。

az postgres server firewall-rule list

列出服务器的所有防火墙规则。

az postgres server firewall-rule show

获取防火墙规则的详细信息。

az postgres server firewall-rule update

更新防火墙规则。

az postgres server georestore

从备份异地还原服务器。

az postgres server key

管理 PostgreSQL 服务器密钥。

az postgres server key create

创建服务器密钥。

az postgres server key delete

删除服务器密钥。

az postgres server key list

获取服务器密钥的列表。

az postgres server key show

显示服务器密钥。

az postgres server list

列出可用服务器。

az postgres server list-skus

列出给定区域中的可用 SKU。

az postgres server private-endpoint-connection

管理 PostgreSQL 服务器专用终结点连接。

az postgres server private-endpoint-connection approve

批准与 PostgreSQL 服务器关联的指定专用终结点连接。

az postgres server private-endpoint-connection delete

删除与 PostgreSQL 服务器关联的指定专用终结点连接。

az postgres server private-endpoint-connection reject

拒绝与 PostgreSQL 服务器关联的指定专用终结点连接。

az postgres server private-endpoint-connection show

显示与 PostgreSQL 服务器关联的专用终结点连接的详细信息。

az postgres server private-link-resource

管理 PostgreSQL 服务器专用链接资源。

az postgres server private-link-resource list

列出 PostgreSQL 服务器支持的专用链接资源。

az postgres server replica

管理只读副本。

az postgres server replica create

为服务器创建只读副本。

az postgres server replica list

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

az postgres server replica stop

停止复制到只读副本,使其成为读/写服务器。

az postgres server restart

重新启动服务器。

az postgres server restore

从备份还原服务器。

az postgres server show

获取服务器的详细信息。

az postgres server show-connection-string

显示 PostgreSQL 服务器数据库的连接字符串。

az postgres server update

更新服务器。

az postgres server vnet-rule

管理服务器的虚拟网络规则。

az postgres server vnet-rule create

创建虚拟网络规则以允许访问 PostgreSQL 服务器。

az postgres server vnet-rule delete

删除具有给定名称的虚拟网络规则。

az postgres server vnet-rule list

获取服务器中的虚拟网络规则列表。

az postgres server vnet-rule show

获取虚拟网络规则。

az postgres server vnet-rule update

更新虚拟网络规则。

az postgres server wait

等待服务器满足某些条件。

az postgres server create

创建服务器。

az postgres server create [--admin-password]
                          [--admin-user]
                          [--assign-identity]
                          [--auto-grow {Disabled, Enabled}]
                          [--backup-retention]
                          [--geo-redundant-backup {Disabled, Enabled}]
                          [--infrastructure-encryption {Disabled, Enabled}]
                          [--location]
                          [--minimal-tls-version {TLS1_0, TLS1_1, TLS1_2, TLSEnforcementDisabled}]
                          [--name]
                          [--public]
                          [--resource-group]
                          [--sku-name]
                          [--ssl-enforcement {Disabled, Enabled}]
                          [--storage-size]
                          [--subscription]
                          [--tags]
                          [--version]

示例

使用 s GP_Gen5_2 (常规用途ku 配置、第 5 代北欧、第 5 代硬件、2 个 vCore) 在) 。

az postgres server create -l northeurope -g testgroup -n testsvr -u username -p password \
    --sku-name GP_Gen5_2

创建设置了所有参数的 PostgreSQL 服务器。

az postgres server create -l northeurope -g testgroup -n testsvr -u username -p password \
    --sku-name B_Gen5_1 --ssl-enforcement Enabled --minimal-tls-version TLS1_0 --public-network-access Disabled \
    --backup-retention 10 --geo-redundant-backup Enabled --storage-size 51200 \
    --tags "key=value" --version 11

可选参数

--admin-password -p

管理员的密码。 最少 8 个字符,最多 128 个字符。 密码必须包含以下类别中的三个类别的字符:英文大写字母、英文小写字母、数字和非字母数字字符。

--admin-user -u

服务器的管理员用户名。 设置后,无法更改它。

默认值: unlinedtruffle9
--assign-identity

为此服务器生成Azure Active Directory标识,以用于 Azure KeyVault 等密钥管理服务。

--auto-grow

启用或禁用存储的自动增长。 默认值为 Enabled。

接受的值: Disabled, Enabled
默认值: Enabled
--backup-retention

备份的保留天数。 范围为 7 到 35 天。 默认值为 7 天。

--geo-redundant-backup

启用或禁用异地冗余备份。 默认值为 Disabled。 基本定价层不支持。

接受的值: Disabled, Enabled
--infrastructure-encryption -i

使用新的加密算法为数据添加可选的第二层加密。 默认值为 Disabled。

接受的值: Disabled, Enabled
--location -l

位置。 az account list-locations 中的值。 可以使用 az configure --defaults location=<location> 配置默认位置。

--minimal-tls-version

启用 SSL 时,为服务器连接设置最低 TLS 版本。 默认值为 TLSEnforcementDisabled。

接受的值: TLS1_0, TLS1_1, TLS1_2, TLSEnforcementDisabled
--name -n

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

--public --public-network-access

启用或禁用对服务器的公用网络访问。 禁用后,只有通过专用链接建立的连接才能访问此服务器。 允许的值为:Enabled、Disabled、all、0.0.0.0、、。 默认值为"已启用"。

--resource-group -g

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

--sku-name

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

默认值: GP_Gen5_2
--ssl-enforcement

启用或禁用到服务器的连接的 ssl 强制。 默认值为"已启用"。

接受的值: Disabled, Enabled
--storage-size

服务器的存储容量(以 MB 为单位)。 最小值为 5120,以 1024 为增量递增。 默认值为 51200。

默认值: 51200
--subscription

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

--tags

空格分隔标记:key[=value] [key[=value] ...]。使用""清除现有标记。

--version

服务器主版本。

az postgres server delete

删除服务器。

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

示例

删除服务器。

az postgres server delete -g testgroup -n testsvr

可选参数

--ids

一个或多个资源 (以空格分隔) 。 它应该是包含"资源 ID"参数所有信息的完整资源 ID。 应提供 --ids 或其他"资源 ID"参数。

--name -n

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

--resource-group -g

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

--subscription

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

--yes -y

不提示确认。

az postgres server georestore

从备份异地还原服务器。

az postgres server georestore --location
                              --source-server
                              [--backup-retention]
                              [--geo-redundant-backup]
                              [--ids]
                              [--name]
                              [--no-wait]
                              [--resource-group]
                              [--sku-name]
                              [--subscription]

示例

将"testsvr"异地还原到位于美国西部 2 的新服务器"testsvrnew"中。

az postgres server georestore -g testgroup -n testsvrnew --source-server testsvr -l westus2

使用 sku GP_Gen5_2 将"testsvr"异地还原到位于美国西部 2 的新服务器"testsvrnew"中。

az postgres server georestore -g testgroup -n testsvrnew --source-server testsvr -l westus2 --sku-name GP_Gen5_2

将"testsvr2"异地还原到新服务器"testsvrnew",其中"testsvrnew"与"testsvr2"位于不同的资源组中。

az postgres server georestore -g testgroup -n testsvrnew \
    -s "/subscriptions/${SubID}/resourceGroups/${ResourceGroup}/providers/Microsoft.DBforPostgreSQL/servers/testsvr2" \
    -l westus2

必需参数

--location -l

位置。 az account list-locations 中的值。 可以使用 az configure --defaults location=<location> 配置默认位置。

--source-server -s

要从其还原的源服务器的名称或 ID。

可选参数

--backup-retention

备份的保留天数。 范围为 7 到 35 天。 默认值为 7 天。

--geo-redundant-backup

启用或禁用异地冗余备份。 默认值为 Disabled。 基本定价层不支持。

--ids

一个或多个资源 (以空格分隔) 。 它应该是包含"资源 ID"参数所有信息的完整资源 ID。 应提供 --ids 或其他"资源 ID"参数。

--name -n

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

--no-wait

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

--resource-group -g

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

--sku-name

SKU 的名称。 默认为源服务器的 sku。 请遵循简写约定 {pricing tier} {compute generation} {vCores}。 示例:B_Gen5_1、GP_Gen5_4、MO_Gen5_16。

--subscription

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

az postgres server list

列出可用服务器。

az postgres server list [--query-examples]
                        [--resource-group]
                        [--subscription]

示例

列出订阅中所有 PostgreSQL 服务器。

az postgres server list

列出资源组内的所有 PostgreSQL 服务器。

az postgres server list -g testgroup

可选参数

--query-examples

建议使用 JMESPath 字符串。 可以复制其中一个查询并将其粘贴到 --query 参数的双引号内,以查看结果。 可以添加一个或多个位置关键字,以便我们可以基于这些关键字提供建议。

--resource-group -g

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

--subscription

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

az postgres server list-skus

列出给定区域中的可用 SKU。

az postgres server list-skus --location
                             [--subscription]

示例

列出给定区域中的可用 SKU。

az postgres server list-skus -l eastus

必需参数

--location -l

位置的名称。

可选参数

--subscription

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

az postgres server restart

重新启动服务器。

az postgres server restart [--ids]
                           [--name]
                           [--resource-group]
                           [--subscription]

示例

重新启动服务器。

az postgres server restart -g testgroup -n testsvr

可选参数

--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

az postgres server restore

从备份还原服务器。

az postgres server restore --pitr-time
                           --source-server
                           [--ids]
                           [--name]
                           [--no-wait]
                           [--resource-group]
                           [--subscription]

示例

将 "testsvr" 还原到特定的时间点,作为新服务器 "testsvrnew"。

az postgres server restore -g testgroup -n testsvrnew --source-server testsvr --restore-point-in-time "2017-06-15T13:10:00Z"

将 "testsvr2" 还原到 "testsvrnew",其中 "testsvrnew" 与 "testsvr2" 在不同的资源组中。

az postgres server restore -g testgroup -n testsvrnew \
    -s "/subscriptions/${SubID}/resourceGroups/${ResourceGroup}/providers/Microsoft.DBforPostgreSQL/servers/testsvr2" \
    --restore-point-in-time "2017-06-15T13:10:00Z"

必需参数

--pitr-time --restore-point-in-time

以 UTC 格式从 (ISO8601 格式还原的时间点) 例如 2017-04-26T02:10: 00 + 08:00。

--source-server -s

要从中进行还原的源服务器的名称或资源 ID。

可选参数

--ids

一个或多个资源 Id (以空格分隔) 。 它应该是包含 "资源 Id" 参数的所有信息的完整资源 ID。 应提供--id 或其他 "资源 Id" 参数。

--name -n

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

--no-wait

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

--resource-group -g

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

--subscription

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

az postgres server show

获取服务器的详细信息。

az postgres server show [--ids]
                        [--name]
                        [--query-examples]
                        [--resource-group]
                        [--subscription]

示例

获取服务器的详细信息。 (自动生成)

az postgres server show --name MyServer --resource-group MyResourceGroup

可选参数

--ids

一个或多个资源 Id (以空格分隔) 。 它应该是包含 "资源 Id" 参数的所有信息的完整资源 ID。 应提供--id 或其他 "资源 Id" 参数。

--name -n

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

--query-examples

建议 JMESPath 字符串。 可以复制其中一个查询,然后将其粘贴在双引号内,以查看结果。 您可以添加一个或多个位置关键字,以便我们可以根据这些关键字提供建议。

--resource-group -g

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

--subscription

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

az postgres server show-connection-string

显示 PostgreSQL 服务器数据库的连接字符串。

az postgres server show-connection-string [--admin-password]
                                          [--admin-user]
                                          [--database-name]
                                          [--ids]
                                          [--server-name]
                                          [--subscription]

示例

显示 cmd 和编程语言的连接字符串。

az postgres server show-connection-string -s testServer -u username -p password -d databasename

可选参数

--admin-password -p

管理员的登录密码。

默认值: {password}
--admin-user -u

管理员的登录用户名。

默认值: {username}
--database-name -d

数据库的名称。

默认值: {database}
--ids

一个或多个资源 Id (以空格分隔) 。 它应该是包含 "资源 Id" 参数的所有信息的完整资源 ID。 应提供--id 或其他 "资源 Id" 参数。

--server-name -s

服务器的名称。

默认值: {server}
--subscription

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

az postgres server update

更新服务器。

az postgres server update [--add]
                          [--admin-password]
                          [--assign-identity]
                          [--auto-grow {Disabled, Enabled}]
                          [--backup-retention]
                          [--force-string]
                          [--ids]
                          [--minimal-tls-version {TLS1_0, TLS1_1, TLS1_2, TLSEnforcementDisabled}]
                          [--name]
                          [--public]
                          [--remove]
                          [--resource-group]
                          [--set]
                          [--sku-name]
                          [--ssl-enforcement {Disabled, Enabled}]
                          [--storage-size]
                          [--subscription]
                          [--tags]

示例

更新服务器的 sku。

az postgres server update -g testgroup -n testsvrnew --sku-name GP_Gen5_4

更新服务器的标记。

az postgres server update -g testgroup -n testsvrnew --tags "k1=v1" "k2=v2"

更新服务器。 (自动生成)

az postgres server update --name testsvrnew --resource-group testgroup --ssl-enforcement Enabled --minimal-tls-version TLS1_0

可选参数

--add

通过指定路径和键值对,将对象添加到对象列表中。 示例:--添加 listProperty <键 = 值、字符串或 JSON 字符串>。

--admin-password -p

管理员的密码。 最少8个字符,最多128个字符。 密码必须包含以下类别中的三个类别的字符:英文大写字母、英文小写字母、数字和非字母数字字符。

--assign-identity

为此服务器生成并分配一个 Azure Active Directory 标识,以便与 Azure KeyVault 等密钥管理服务一起使用。

--auto-grow

启用或禁用存储的自动增长。 默认值为 "已启用"。

接受的值: Disabled, Enabled
--backup-retention

保留备份的天数。 7到35天的范围。 默认值为 7 天。

--force-string

使用 "set" 或 "add" 时,保留字符串文本,而不是尝试转换为 JSON。

--ids

一个或多个资源 Id (以空格分隔) 。 它应该是包含 "资源 Id" 参数的所有信息的完整资源 ID。 应提供--id 或其他 "资源 Id" 参数。

--minimal-tls-version

启用 SSL 时,设置与服务器的连接的最小 TLS 版本。 默认值为 TLSEnforcementDisabled。

接受的值: TLS1_0, TLS1_1, TLS1_2, TLSEnforcementDisabled
--name -n

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

--public --public-network-access

启用或禁用对服务器的公共网络访问。 如果禁用,则仅通过专用链接建立的连接可访问此服务器。 允许的值为: Enabled、Disabled、all、0.0.0.0、 。 默认为启用。

--remove

从列表中删除属性或元素。 示例:--remove property. list 或--Remove propertyToRemove。

--resource-group -g

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

--set

通过指定要设置的属性路径和值来更新对象。 示例:--set property1. property2 =.

--sku-name

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

--ssl-enforcement

启用或禁用与服务器的连接的 ssl 强制。 默认为启用。

接受的值: Disabled, Enabled
--storage-size

服务器的存储容量(以 MB 为单位)。 最小值为 5120,以 1024 为增量递增。 默认值为 51200。

--subscription

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

--tags

空格分隔标记:key[=value] [key[=value] ...]。使用""清除现有标记。

az postgres server wait

等待服务器满足某些条件。

az postgres server wait [--custom]
                        [--exists]
                        [--ids]
                        [--interval]
                        [--name]
                        [--resource-group]
                        [--subscription]
                        [--timeout]

可选参数

--custom

等待条件满足自定义 JMESPath 查询。 例如 provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running']。

--exists

等待资源存在。

--ids

一个或多个资源 (以空格分隔) 。 它应该是包含"资源 ID"参数所有信息的完整资源 ID。 应提供 --ids 或其他"资源 ID"参数。

--interval

轮询间隔(以秒为单位)。

默认值: 30
--name -n

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

--resource-group -g

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

--subscription

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

--timeout

最大等待时间(以秒表示)。

默认值: 3600