你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn。
az postgres server-arc
注意
此参考是 Azure CLI(版本 2.3.1 或更高版本)的 arcdata 扩展的一部分。 该扩展将在首次运行 az postgres server-arc 命令时自动安装。 详细了解扩展。
此命令组处于预览状态,正在开发中。 参考和支持级别: https://aka.ms/CLI_refstatus
管理已启用 Azure Arc 的 PostgreSQL 服务器。
命令
名称 | 说明 | 类型 | Status |
---|---|---|---|
az postgres server-arc create |
创建已启用 Azure Arc 的 PostgreSQL 服务器。 |
分机 | 预览 |
az postgres server-arc delete |
删除已启用 Azure Arc 的 PostgreSQL 服务器。 |
分机 | 预览版 |
az postgres server-arc endpoint |
管理已启用 Azure Arc 的 PostgreSQL 服务器终结点。 |
分机 | 预览版 |
az postgres server-arc endpoint list |
列出已启用 Azure Arc 的 PostgreSQL 服务器终结点。 |
分机 | 预览 |
az postgres server-arc list |
列出已启用 Azure Arc 的 PostgreSQL 服务器。 |
分机 | 预览 |
az postgres server-arc restore |
从另一台服务器的备份还原已启用 Azure Arc 的 PostgreSQL 服务器。 |
扩展 | 预览版 |
az postgres server-arc show |
显示已启用 Azure Arc 的 PostgreSQL 服务器的详细信息。 |
分机 | 预览版 |
az postgres server-arc update |
更新已启用 Azure Arc 的 PostgreSQL 服务器的配置。 |
分机 | 预览版 |
az postgres server-arc create
命令组“postgres server-arc”处于预览状态,正在开发中。 参考和支持级别: https://aka.ms/CLI_refstatus
创建已启用 Azure Arc 的 PostgreSQL 服务器。
若要设置服务器的密码,请AZDATA_PASSWORD设置环境变量。
az postgres server-arc create --name
[--ad-account-name]
[--ad-connector-name]
[--admin-login-secret]
[--cert-private-key-file]
[--cert-public-key-file]
[--cores-limit]
[--cores-request]
[--dev]
[--dns-name]
[--extensions]
[--k8s-namespace]
[--keytab-secret]
[--log-level]
[--memory-limit]
[--memory-request]
[--no-external-endpoint]
[--no-wait]
[--path]
[--port]
[--retention-days]
[--service-annotations]
[--service-cert-secret]
[--service-labels]
[--service-type]
[--storage-class-backups]
[--storage-class-data]
[--storage-class-logs]
[--use-k8s]
[--volume-size-backups]
[--volume-size-data]
[--volume-size-logs]
示例
创建已启用 Azure Arc 的 PostgreSQL 服务器。
az postgres server-arc create -n pg1 --k8s-namespace namespace --use-k8s
必需参数
已启用 Azure Arc 的 PostgreSQL 服务器的名称。
可选参数
此已启用 Azure Arc 的 PostgreSQL 服务器的 Active Directory 帐户名称。 此帐户需要在部署此实例之前创建。
Active Directory 连接or 的名称。 此参数指示使用 AD 支持进行部署的意向。
要生成的用于托管或将托管用户管理员登录帐户凭据的 Kubernetes 机密的名称。
包含要用于客户端 SSL 连接的 PEM 格式证书私钥的文件的路径。
包含要用于客户端 SSL 连接的 PEM 格式证书公钥的文件的路径。
可用于已启用 Azure Arc 的 PostgreSQL 服务器的最大 CPU 核心数。
每个节点计划服务时可使用的最小 CPU 核心数。
如果指定了此项,则会将其视为开发实例,而不会对其进行计费。
向最终用户公开的服务 DNS 名称,以连接到已启用 Azure Arc 的 PostgreSQL 服务器(例如 pginstancename.contoso.com)。
要启用的扩展的逗号分隔列表。 启用后,可以通过“CREATE EXTENSION”命令安装扩展。
部署已启用 Azure Arc 的 PostgreSQL 服务器的 Kubernetes 命名空间。 若未指定命名空间,则将使用 kubeconfig 中定义的命名空间。
包含此已启用 Azure Arc 的 PostgreSQL 服务器的 keytab 文件的 Kubernetes 机密的名称。
设置 PostgreSQL 引擎的log_min_messages设置。 有效值为:DEBUG5、DEBUG4、DEBUG3、DEBUG2、DEBUG1、INFO、NOTICE、WARNING、ERROR、LOG、FATAL、PANIC。
已启用 Azure Arc 的 PostgreSQL 服务器的内存限制,后跟 Ki(千字节)、Mi(兆字节)或 Gi(GB)。
已启用 Azure Arc 的 PostgreSQL 服务器的内存请求,后跟 Ki(千字节)、Mi(兆字节)或 Gi(GB)。
如果已指定,则不会创建外部服务。 否则,将使用提供 --service-type 参数的类型或与数据控制器相同的服务类型创建外部服务。
不要等待部署在返回之前准备就绪。
已启用 Azure Arc 的 PostgreSQL 服务器的源 json 文件的路径。 此为可选项。
主服务向最终用户公开的端口号。
备份保留期,以天为单位指定。 允许的值为 0 到 35。 默认值为 7。 将保留期设置为 0 将关闭已启用 Azure Arc 的 PostgreSql 的自动备份。
要应用于所有外部服务的注释的逗号分隔列表。
用于生成托管 SSL 证书的 Kubernetes 机密的名称。
要应用于所有外部服务的标签的逗号分隔列表。
主服务的类型。
要用于备份永久性卷的存储类。
要用于数据永久性卷的存储类。
要用于日志永久性卷的存储类。
使用本地 Kubernetes API 来执行此操作。
要用于备份的存储卷的大小(正数),后跟 Ki(千字节)、Mi(兆字节)或 Gi(吉字节)。
要用于数据的存储卷的大小(正数),后跟 Ki(千字节)、Mi(兆字节)或 Gi(吉字节)。
要用于日志的存储卷的大小(正数),后跟 Ki(千字节)、Mi(兆字节)或 Gi(吉字节)。
全局参数
提高日志记录详细程度以显示所有调试日志。
显示此帮助消息并退出。
只显示错误,取消显示警告。
输出格式。
JMESPath 查询字符串。 有关更多信息和示例,请参阅 http://jmespath.org/。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID
配置默认订阅。
提高日志记录详细程度。 使用 --debug 获取完整的调试日志。
az postgres server-arc delete
命令组“postgres server-arc”处于预览状态,正在开发中。 参考和支持级别: https://aka.ms/CLI_refstatus
删除已启用 Azure Arc 的 PostgreSQL 服务器。
az postgres server-arc delete --name
[--force]
[--k8s-namespace]
[--use-k8s]
示例
删除已启用 Azure Arc 的 PostgreSQL 服务器。
az postgres server-arc delete -n pg1 --k8s-namespace namespace --use-k8s
必需参数
已启用 Azure Arc 的 PostgreSQL 服务器的名称。
可选参数
在不确认的情况下删除已启用 Azure Arc 的 PostgreSQL 服务器。
部署已启用 Azure Arc 的 PostgreSQL 服务器的 Kubernetes 命名空间。 若未指定命名空间,则将使用 kubeconfig 中定义的命名空间。
使用本地 Kubernetes API 来执行此操作。
全局参数
提高日志记录详细程度以显示所有调试日志。
显示此帮助消息并退出。
只显示错误,取消显示警告。
输出格式。
JMESPath 查询字符串。 有关更多信息和示例,请参阅 http://jmespath.org/。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID
配置默认订阅。
提高日志记录详细程度。 使用 --debug 获取完整的调试日志。
az postgres server-arc list
命令组“postgres server-arc”处于预览状态,正在开发中。 参考和支持级别: https://aka.ms/CLI_refstatus
列出已启用 Azure Arc 的 PostgreSQL 服务器。
az postgres server-arc list [--k8s-namespace]
[--use-k8s]
示例
列出已启用 Azure Arc 的 PostgreSQL 服务器。
az postgres server-arc list --k8s-namespace namespace --use-k8s
可选参数
部署已启用 Azure Arc 的 PostgreSQL 服务器的 Kubernetes 命名空间。 若未指定命名空间,则将使用 kubeconfig 中定义的命名空间。
使用本地 Kubernetes API 来执行此操作。
全局参数
提高日志记录详细程度以显示所有调试日志。
显示此帮助消息并退出。
只显示错误,取消显示警告。
输出格式。
JMESPath 查询字符串。 有关更多信息和示例,请参阅 http://jmespath.org/。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID
配置默认订阅。
提高日志记录详细程度。 使用 --debug 获取完整的调试日志。
az postgres server-arc restore
命令组“postgres server-arc”处于预览状态,正在开发中。 参考和支持级别: https://aka.ms/CLI_refstatus
从另一台服务器的备份还原已启用 Azure Arc 的 PostgreSQL 服务器。
若要设置服务器的密码,请AZDATA_PASSWORD设置环境变量。
az postgres server-arc restore --k8s-namespace
--name
--source-server
[--dry-run]
[--no-wait]
[--storage-class-backups]
[--storage-class-data]
[--storage-class-logs]
[--time]
[--use-k8s]
[--volume-size-backups]
[--volume-size-data]
[--volume-size-logs]
示例
还原已启用 Azure Arc 的 PostgreSQL 服务器。
az postgres server-arc restore -n <to-pg> --source-server <from-pg> --k8s-namespace namespace --use-k8s
必需参数
包含已启用 Azure Arc 的 PostgreSql 的 Kubernetes 命名空间。 若未指定命名空间,则将使用 kubeconfig 中定义的命名空间。
要创建的已启用 Azure Arc 的 PostgreSQL 服务器的名称。
要从中还原的已启用 Azure Arc 的 PostgreSQL 服务器的名称。
可选参数
如果设置,则验证源资源和目标资源和时间,而不执行还原。 在还原任务的状态中返回最早和最新的可能还原时间。
不要等待部署在返回之前准备就绪。
要用于备份永久性卷的存储类。
要用于数据永久性卷的存储类。
要用于日志永久性卷的存储类。
将还原以创建新的已启用 Azure Arc 的 PostgreSQL 服务器的源服务器的时间点。 必须大于或等于源数据库的最早还原日期/时间值。 时间应采用以下格式:“YYYY-MM-DDTHH:MM:SSZ”。 如果未提供任何时间,将还原最新的备份。
使用本地 Kubernetes API 来执行此操作。
要用于备份的存储卷的大小(正数),后跟 Ki(千字节)、Mi(兆字节)或 Gi(吉字节)。
要用于数据的存储卷的大小(正数),后跟 Ki(千字节)、Mi(兆字节)或 Gi(吉字节)。
要用于日志的存储卷的大小(正数),后跟 Ki(千字节)、Mi(兆字节)或 Gi(吉字节)。
全局参数
提高日志记录详细程度以显示所有调试日志。
显示此帮助消息并退出。
只显示错误,取消显示警告。
输出格式。
JMESPath 查询字符串。 有关更多信息和示例,请参阅 http://jmespath.org/。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID
配置默认订阅。
提高日志记录详细程度。 使用 --debug 获取完整的调试日志。
az postgres server-arc show
命令组“postgres server-arc”处于预览状态,正在开发中。 参考和支持级别: https://aka.ms/CLI_refstatus
显示已启用 Azure Arc 的 PostgreSQL 服务器的详细信息。
az postgres server-arc show --name
[--k8s-namespace]
[--path]
[--use-k8s]
示例
显示已启用 Azure Arc 的 PostgreSQL 服务器的详细信息。
az postgres server-arc show -n pg1 --k8s-namespace namespace --use-k8s
必需参数
已启用 Azure Arc 的 PostgreSQL 服务器的名称。
可选参数
部署已启用 Azure Arc 的 PostgreSQL 服务器的 Kubernetes 命名空间。 若未指定命名空间,则将使用 kubeconfig 中定义的命名空间。
应写入已启用 Azure Arc 的 PostgreSQL 服务器的完整规范的路径。 如果省略,则会将规范写入标准输出。
使用本地 Kubernetes API 来执行此操作。
全局参数
提高日志记录详细程度以显示所有调试日志。
显示此帮助消息并退出。
只显示错误,取消显示警告。
输出格式。
JMESPath 查询字符串。 有关更多信息和示例,请参阅 http://jmespath.org/。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID
配置默认订阅。
提高日志记录详细程度。 使用 --debug 获取完整的调试日志。
az postgres server-arc update
命令组“postgres server-arc”处于预览状态,正在开发中。 参考和支持级别: https://aka.ms/CLI_refstatus
更新已启用 Azure Arc 的 PostgreSQL 服务器的配置。
az postgres server-arc update --name
[--cert-private-key-file]
[--cert-public-key-file]
[--cores-limit]
[--cores-request]
[--dev]
[--extensions]
[--k8s-namespace]
[--keytab-secret]
[--log-level]
[--memory-limit]
[--memory-request]
[--no-external-endpoint]
[--no-wait]
[--path]
[--port]
[--retention-days]
[--service-annotations]
[--service-cert-secret]
[--service-labels]
[--service-type]
[--use-k8s]
示例
更新已启用 Azure Arc 的 PostgreSQL 服务器的配置。
az postgres server-arc update --path ./spec.json -n pg1 --k8s-namespace namespace --use-k8s
为已启用 Azure Arc 的现有 PostgreSQL 服务器启用扩展。
az postgres server-arc update -n pg1 --extensions 'pgaudit,pg_partman' --k8s-namespace namespace --use-k8s
从已启用 Azure Arc 的 PostgreSQL 服务器中删除扩展。
az postgres server-arc update -n pg1 --extensions "''" --k8s-namespace namespace --use-k8s
必需参数
正在更新的已启用 Azure Arc 的 PostgreSQL 服务器的名称。 不能更改部署实例时为其指定的名称。
可选参数
包含要用于客户端 SSL 连接的 PEM 格式证书私钥的文件的路径。
包含要用于客户端 SSL 连接的 PEM 格式证书公钥的文件的路径。
已启用 Azure Arc 的 PostgreSQL 服务器的最大 CPU 核心数,可用于每个节点。 若要删除 cores_limit,请将其值指定为空字符串。
每个节点计划服务时可使用的最小 CPU 核心数。 若要删除 cores_request,请将其值指定为空字符串。
如果指定了此项,则会将其视为开发实例,而不会对其进行计费。
要启用的扩展的逗号分隔列表。 添加或删除新扩展,请更新现有扩展列表。 启用后,可以通过“CREATE EXTENSION”命令安装扩展。
部署已启用 Azure Arc 的 PostgreSQL 服务器的 Kubernetes 命名空间。 若未指定命名空间,则将使用 kubeconfig 中定义的命名空间。
包含此已启用 Azure Arc 的 PostgreSQL 服务器的 keytab 文件的 Kubernetes 机密的名称。
设置 PostgreSQL 引擎的log_min_messages设置。 有效值为:DEBUG5、DEBUG4、DEBUG3、DEBUG2、DEBUG1、INFO、NOTICE、WARNING、ERROR、LOG、FATAL、PANIC。
已启用 Azure Arc 的 PostgreSQL 服务器的内存限制,后跟 Ki(千字节)、Mi(兆字节)或 Gi(GB)。 若要删除 memory_limit,请将其值指定为空字符串。
已启用 Azure Arc 的 PostgreSQL 服务器的内存请求,后跟 Ki(千字节)、Mi(兆字节)或 Gi(GB)。 若要删除 memory_request,请将其值指定为空字符串。
如果已指定,则不会创建外部服务。 否则,将使用提供 --service-type 参数的类型或与数据控制器相同的服务类型创建外部服务。
不要等待部署在返回之前准备就绪。
已启用 Azure Arc 的 PostgreSQL 服务器的源 json 文件的路径。 此为可选项。
主服务向最终用户公开的端口号。
备份保留期,以天为单位指定。 允许的值为 0 到 35。 默认值为 7。 将保留期设置为 0 将关闭已启用 Azure Arc 的 PostgreSql 的自动备份。
要应用于所有外部服务的注释的逗号分隔列表。
用于生成托管 SSL 证书的 Kubernetes 机密的名称。
要应用于所有外部服务的标签的逗号分隔列表。
主服务的类型。
使用本地 Kubernetes API 来执行此操作。
全局参数
提高日志记录详细程度以显示所有调试日志。
显示此帮助消息并退出。
只显示错误,取消显示警告。
输出格式。
JMESPath 查询字符串。 有关更多信息和示例,请参阅 http://jmespath.org/。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID
配置默认订阅。
提高日志记录详细程度。 使用 --debug 获取完整的调试日志。