通过

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

az postgres flexible-server long-term-retention

  • 中断性变更

将重新使用 --name/-n 参数来指定备份名称。 将引入 --server-name/-s 参数，以在计划于 2026 年 5 月的下一个中断性变更版本（2.86.0）中指定服务器名称。 --backup-name/-b 参数已弃用，将在计划于 2026 年 5 月的下一个中断性变更版本（2.86.0）中删除。

管理灵活的服务器长期保留备份。

命令

名称 说明 类型 Status
az postgres flexible-server long-term-retention list

列出给定服务器的所有长期保留备份。

 Core GA
az postgres flexible-server long-term-retention pre-check

执行后续长期保留备份操作成功所需的所有检查。

 Core GA
az postgres flexible-server long-term-retention show

显示给定服务器的特定长期保留备份的详细信息。

 Core GA
az postgres flexible-server long-term-retention start

为灵活服务器启动长期保留备份。 SAS URL 参数是指将上传备份的存储帐户中的容器 SAS URL。

 Core GA

az postgres flexible-server long-term-retention list

中断性变更

将重新使用 --name/-n 参数来指定备份名称。 将引入 --server-name/-s 参数，以在计划于 2026 年 5 月的下一个中断性变更版本（2.86.0）中指定服务器名称。 --backup-name/-b 参数已弃用，将在计划于 2026 年 5 月的下一个中断性变更版本（2.86.0）中删除。

列出给定服务器的所有长期保留备份。

az postgres flexible-server long-term-retention list [--ids]
                                                     [--name]
                                                     [--resource-group]
                                                     [--subscription]

示例

列出“testsvr”的所有长期保留备份。

az postgres flexible-server long-term-retention list -g resource-group-name -n server-name

可选参数

以下参数是可选的，但根据上下文，命令可能需要一个或多个参数才能成功执行。

--ids

一个或多个资源 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 long-term-retention pre-check

中断性变更

将重新使用 --name/-n 参数来指定备份名称。 将引入 --server-name/-s 参数，以在计划于 2026 年 5 月的下一个中断性变更版本（2.86.0）中指定服务器名称。 --backup-name/-b 参数已弃用，将在计划于 2026 年 5 月的下一个中断性变更版本（2.86.0）中删除。

执行后续长期保留备份操作成功所需的所有检查。

az postgres flexible-server long-term-retention pre-check --backup-name
                                                          [--ids]
                                                          [--name]
                                                          [--resource-group]
                                                          [--subscription]

示例

预检查是否可以在资源组“resource-group-name”上的服务器“server-name”上执行长期保留命令，其备份名称为“backup-name”。

az postgres flexible-server long-term-retention pre-check -g resource-group-name -b backup-name -n server-name

必需参数

--backup-name -b

长期保留备份名称。

可选参数

以下参数是可选的，但根据上下文，命令可能需要一个或多个参数才能成功执行。

--ids

一个或多个资源 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 long-term-retention show

中断性变更

将重新使用 --name/-n 参数来指定备份名称。 将引入 --server-name/-s 参数，以在计划于 2026 年 5 月的下一个中断性变更版本（2.86.0）中指定服务器名称。 --backup-name/-b 参数已弃用，将在计划于 2026 年 5 月的下一个中断性变更版本（2.86.0）中删除。

显示给定服务器的特定长期保留备份的详细信息。

az postgres flexible-server long-term-retention show --backup-name
                                                     [--ids]
                                                     [--name]
                                                     [--resource-group]
                                                     [--subscription]

示例

显示“testsvr”的长期保留备份“testbackup”的详细信息。

az postgres flexible-server long-term-retention show -g resource-group-name -n server-name -b backup-name

必需参数

--backup-name -b

长期保留备份名称。

可选参数

以下参数是可选的，但根据上下文，命令可能需要一个或多个参数才能成功执行。

--ids

一个或多个资源 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 long-term-retention start

中断性变更

将重新使用 --name/-n 参数来指定备份名称。 将引入 --server-name/-s 参数，以在计划于 2026 年 5 月的下一个中断性变更版本（2.86.0）中指定服务器名称。 --backup-name/-b 参数已弃用，将在计划于 2026 年 5 月的下一个中断性变更版本（2.86.0）中删除。

为灵活服务器启动长期保留备份。 SAS URL 参数是指将上传备份的存储帐户中的容器 SAS URL。

az postgres flexible-server long-term-retention start --backup-name
                                                      --sas-url
                                                      [--ids]
                                                      [--name]
                                                      [--resource-group]
                                                      [--subscription]

示例

在资源组“resource-group-name”中创建名为“backup-name”的服务器“backup-name”的备份，将容器与 SAS URL“<sas-url>”配合使用。

az postgres flexible-server long-term-retention start -g resource-group-name -b backup-name -n server-name -u <sas-url>

必需参数

--backup-name -b

长期保留备份名称。

--sas-url -u

容器 SAS URL。

可选参数

以下参数是可选的，但根据上下文，命令可能需要一个或多个参数才能成功执行。

--ids

一个或多个资源 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