Skip to content

Commit 30b41e5

Browse files
authored
Merge pull request #296516 from MicrosoftDocs/main
3/18/2025 AM Publish
2 parents c14cf90 + ba3aa95 commit 30b41e5

File tree

57 files changed

+506
-405
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

57 files changed

+506
-405
lines changed

articles/azure-cache-for-redis/cache-how-to-premium-persistence.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -12,7 +12,7 @@ ms.date: 02/21/2025
1212

1313
> [!IMPORTANT]
1414
>
15-
> The data persistence functionality provides resilience for unexpected Redis node failures. Data persistence isn't a data backup or point in time recovery (PITR) feature. If corrupted data is written to the Redis instance, th corrupted data is also persisted. To make backups of your Redis instance, use the [export feature](cache-how-to-import-export-data.md).
15+
> The data persistence functionality provides resilience for unexpected Redis node failures. Data persistence isn't a data backup or point in time recovery (PITR) feature. If corrupted data is written to the Redis instance, the corrupted data is also persisted. To make backups of your Redis instance, use the [export feature](cache-how-to-import-export-data.md).
1616
>
1717
1818
> [!WARNING]

articles/azure-vmware/configure-storage-policy.md

Lines changed: 7 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -83,7 +83,7 @@ Run the `Set-VMStoragePolicy` cmdlet to modify vSAN-based storage policies on a
8383

8484

8585
> [!NOTE]
86-
> You cannot use the vSphere Client to change the default storage policy or any existing storage policies for a VM.
86+
> You can't use the vSphere Client to change the default storage policy or any existing storage policies for a VM.
8787
8888
1. Select **Run command** > **Packages** > **Set-VMStoragePolicy**.
8989

@@ -104,7 +104,7 @@ Run the `Set-VMStoragePolicy` cmdlet to modify vSAN-based storage policies on a
104104
Run the `Set-LocationStoragePolicy` cmdlet to Modify vSAN based storage policies on all VMs in a location where a location is the name of a cluster, resource pool, or folder. For example, if you have 3 VMs in Cluster-3, supplying "Cluster-3" would change the storage policy on all three VMs.
105105

106106
> [!NOTE]
107-
> You cannot use the vSphere Client to change the default storage policy or any existing storage policies for a VM.
107+
> You can't use the vSphere Client to change the default storage policy or any existing storage policies for a VM.
108108
109109
1. Select **Run command** > **Packages** > **Set-LocationStoragePolicy**.
110110

@@ -140,14 +140,18 @@ Run the `Set-ClusterDefaultStoragePolicy` cmdlet to specify default storage poli
140140
| **Timeout** | The period after which a cmdlet exits if taking too long to finish. |
141141

142142
1. Check **Notifications** to see the progress.
143+
> [!NOTE]
144+
> Changing the default cluster policy will only affect new VMs. Existing VMs will retain the policy they're currently configured/deployed with.
143145
144146
## Create custom AVS storage policy
145147

146148
Run the `New-AVSStoragePolicy` cmdlet to create or overwrite an existing policy.
147149
This function creates a new or overwrites an existing vSphere Storage Policy. Non vSAN-Based, vSAN Only, VMEncryption Only, Tag Only based and/or any combination of these policy types are supported.
148150
> [!NOTE]
149-
> You cannot modify existing AVS default storage policies.
151+
> You can't modify existing AVS default storage policies.
150152
> Certain options enabled in storage policies will produce warnings to associated risks.
153+
> Modifying existing storage policies will make existing associated vsan objects (vms/vmdks/iso/etc) appear as 'out of compliance'.
154+
> This simply means existing objects are running against premodified policy settings. Reapply storage policy to objects to update to match modified policy settings.
151155
152156
1. Select **Run command** > **Packages** > **New-AVSStoragePolicy**.
153157

articles/backup/backup-azure-database-postgresql-overview.md

Lines changed: 3 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
title: About Azure Database for PostgreSQL backup
33
description: An overview on Azure Database for PostgreSQL backup
44
ms.topic: overview
5-
ms.date: 03/06/2025
5+
ms.date: 03/18/2025
66
ms.service: azure-backup
77
author: jyothisuri
88
ms.author: jsuri
@@ -195,4 +195,5 @@ You can add new databases and database users to the server. For database users,
195195

196196
## Next steps
197197

198-
[Azure Database for PostgreSQL backup](backup-azure-database-postgresql.md)
198+
- [Frequently asked questions](/azure/backup/backup-azure-database-postgresql-server-faq).
199+
- [Back up Azure Database for PostgreSQL](backup-azure-database-postgresql.md).

articles/backup/backup-azure-database-postgresql-server-faq.yml

Lines changed: 6 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -4,14 +4,19 @@ metadata:
44
description: In this article, discover answers to common questions about backing up Azure Database for PostgreSQL server with the Azure Backup service.
55
ms.topic: faq
66
ms.service: azure-backup
7-
ms.date: 01/24/2022
7+
ms.date: 03/18/2025
88
author: jyothisuri
99
ms.author: jsuri
1010

1111
title: Frequently asked questions-Back up Azure Database for PostgreSQL server
1212
summary: |
1313
This article answers common questions about backing up Azure Database for PostgreSQL server with the [Azure Backup](./backup-overview.md) service.
1414
15+
>[!Important]
16+
>Azure Database for PostgreSQL single servers is scheduled for retirement on March 28, 2025. On this date, changes will be implemented to Azure Backup for PostgreSQL single servers. Learn more [about the retirement announcement here](/azure/postgresql/migrate/whats-happening-to-postgresql-single-server).
17+
>
18+
>To understand the changes to Vaulted backups for PostgreSQL single server, see [this section](backup-azure-database-postgresql-overview.md#changes-to-vaulted-backups-for-postgresql-single-server).
19+
1520
1621
sections:
1722
- name: Backup

articles/backup/backup-azure-database-postgresql.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -2,15 +2,15 @@
22
title: Back up Azure Database for PostgreSQL
33
description: Learn about Azure Database for PostgreSQL backup with long-term retention
44
ms.topic: how-to
5-
ms.date: 02/17/2025
5+
ms.date: 03/18/2025
66
ms.service: azure-backup
77
author: jyothisuri
88
ms.author: jsuri
99
---
1010

1111
# Azure Database for PostgreSQL backup with long-term retention
1212

13-
This article describes how to back up Azure Database for PostgreSQL server. Before you begin, review the [supported configurations, feature considerations and known limitations](./backup-azure-database-postgresql-support-matrix.md)
13+
This article describes how to back up Azure Database for PostgreSQL server. Before you begin, review the [supported configurations, feature considerations, known limitations](./backup-azure-database-postgresql-support-matrix.md), and [frequently asked questions](/azure/backup/backup-azure-database-postgresql-server-faq).
1414

1515
## Configure backup on Azure PostgreSQL databases
1616

articles/backup/backup-postgresql-cli.md

Lines changed: 14 additions & 21 deletions
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
title: Back up Azure Database for PostgreSQL with long-term-retention using Azure CLI
33
description: Learn how to back up Azure Database for PostgreSQL using Azure CLI.
44
ms.topic: how-to
5-
ms.date: 07/30/2024
5+
ms.date: 03/18/2025
66
ms.custom: devx-track-azurecli
77
ms.service: azure-backup
88
author: jyothisuri
@@ -13,22 +13,15 @@ ms.author: jsuri
1313

1414
This article explains how to back up [Azure PostgreSQL database](/azure/postgresql/overview#azure-database-for-postgresql---single-server) using Azure CLI.
1515

16-
In this article, you'll learn how to:
17-
18-
- Create a Backup vault
19-
- Create a backup policy
20-
- Configure a backup of an Azure PostgreSQL database
21-
- Run an on-demand backup job
22-
23-
For informgreSQL databases supported scenarios and limitations, see the [support matrix](backup-azure-database-postgresql-support-matrix.md).
16+
Learn more about the [supported scenarios](backup-azure-database-postgresql-support-matrix.md) and [frequently asked questions](/azure/backup/backup-azure-database-postgresql-server-faq) to back up Azure Database for PostgreSQL Database.
2417

2518
## Create a Backup vault
2619

2720
Backup vault is a storage entity in Azure. This stores the backup data for new workloads that Azure Backup supports. For example, Azure Database for PostgreSQL servers, blobs in a storage account, and Azure Disks. Backup vaults help to organize your backup data, while minimizing management overhead. Backup vaults are based on the Azure Resource Manager model of Azure, which provides enhanced capabilities to help secure backup data.
2821

2922
Before you create a Backup vault, choose the storage redundancy of the data within the vault. Then proceed to create the Backup vault with that storage redundancy and the location.
3023

31-
In this article, we'll create a Backup vault _TestBkpVault_, in the region _westus_, under the resource group _testBkpVaultRG_. Use the [az dataprotection vault create](/cli/azure/dataprotection/backup-vault#az-dataprotection-backup-vault-create) command to create a Backup vault. Learn more about [creating a Backup vault](./create-manage-backup-vault.md#create-a-backup-vault).
24+
In this article, we'll create a Backup vault _TestBkpVault_, in the region _westus_, under the resource group _testBkpVaultRG_. Use the [`az dataprotection vault create`](/cli/azure/dataprotection/backup-vault#az-dataprotection-backup-vault-create) command to create a Backup vault. Learn more about [creating a Backup vault](./create-manage-backup-vault.md#create-a-backup-vault).
3225

3326
```azurecli-interactive
3427
az dataprotection backup-vault create -g testBkpVaultRG --vault-name TestBkpVault -l westus --type SystemAssigned --storage-settings datastore-type="VaultStore" type="LocallyRedundant"
@@ -101,7 +94,7 @@ The resultant PowerShell object is as follows:
10194

10295
### Retrieve the policy template
10396

104-
To understand the inner components of a Backup policy for Azure PostgreSQL database backup, retrieve the policy template using the [az dataprotection backup-policy get-default-policy-template](/cli/azure/dataprotection/backup-policy#az-dataprotection-backup-policy-get-default-policy-template) command. This command returns a default policy template for a given datasource type. Use this policy template to create a new policy.
97+
To understand the inner components of a Backup policy for Azure PostgreSQL database backup, retrieve the policy template using the [`az dataprotection backup-policy get-default-policy-template`](/cli/azure/dataprotection/backup-policy#az-dataprotection-backup-policy-get-default-policy-template) command. This command returns a default policy template for a given datasource type. Use this policy template to create a new policy.
10598

10699
```azurecli-interactive
107100
az dataprotection backup-policy get-default-policy-template --datasource-type AzureDatabaseForPostgreSQL
@@ -210,7 +203,7 @@ The policy template consists of a trigger (which decides what triggers the backu
210203

211204
#### Modify the schedule
212205

213-
The default policy template offers a backup once per week. You can modify the schedule for the backup to happen multiple days per week. To modify the schedule, use the [az dataprotection backup-policy trigger set](/cli/azure/dataprotection/backup-policy/trigger#az-dataprotection-backup-policy-trigger-set) command.
206+
The default policy template offers a backup once per week. You can modify the schedule for the backup to happen multiple days per week. To modify the schedule, use the [`az dataprotection backup-policy trigger set`](/cli/azure/dataprotection/backup-policy/trigger#az-dataprotection-backup-policy-trigger-set) command.
214207

215208
The following example modifies the weekly backup to back up happening on every Sunday, Wednesday, and Friday of every week. The schedule date array mentions the dates, and the days of the week of those dates are taken as days of the week. You also need to specify that these schedules should repeat every week. So, the schedule interval is *1* and the interval type is *Weekly*.
216209

@@ -229,7 +222,7 @@ az dataprotection backup-policy trigger set --policy .\OSSPolicy.json --schedul
229222

230223
If you want to add the *archive* protection, you need to modify the policy template as below.
231224

232-
The default template will have a lifecycle for the initial datastore under the default retention rule. In this scenario, the rule says to delete the backup data after three months. You should add a new retention rule that defines when the data is *moved* to *archive* datastore, that is, backup data is first copied to archive datastore, and then deleted in vault datastore. Also, the rule should define for how long the data is kept in the *archive* datastore. Use the [az dataprotection backup-policy retention-rule create-lifecycle](/cli/azure/dataprotection/backup-policy/retention-rule#az-dataprotection-backup-policy-retention-rule-create-lifecycle) command to create new lifecycles and use the [az dataprotection backup-policy retention-rule set](/cli/azure/dataprotection/backup-policy/retention-rule#az-dataprotection-backup-policy-retention-rule-set) command to associate them with the new rules or to the existing rules.
225+
The default template will have a lifecycle for the initial datastore under the default retention rule. In this scenario, the rule says to delete the backup data after three months. You should add a new retention rule that defines when the data is *moved* to *archive* datastore, that is, backup data is first copied to archive datastore, and then deleted in vault datastore. Also, the rule should define for how long the data is kept in the *archive* datastore. Use the [`az dataprotection backup-policy retention-rule create-lifecycle`](/cli/azure/dataprotection/backup-policy/retention-rule#az-dataprotection-backup-policy-retention-rule-create-lifecycle) command to create new lifecycles and use the [`az dataprotection backup-policy retention-rule set`](/cli/azure/dataprotection/backup-policy/retention-rule#az-dataprotection-backup-policy-retention-rule-set) command to associate them with the new rules or to the existing rules.
233226

234227
The following example creates a new retention rule named *Monthly*, where the first successful backup of every month should be retained in vault for six months, moved to archive tier, and kept in archive tier for 24 months.
235228

@@ -243,7 +236,7 @@ az dataprotection backup-policy retention-rule set --lifecycles .\VaultToArchive
243236

244237
#### Add a tag and the relevant criteria
245238

246-
Once a retention rule is created, you've to create a corresponding *tag* in the *Trigger* property of the Backup policy. Use the [az dataprotection backup-policy tag create-absolute-criteria](/cli/azure/dataprotection/backup-policy/tag#az-dataprotection-backup-policy-tag-create-absolute-criteria) command to create a new tagging criteria and use the [az dataprotection backup-policy tag set](/cli/azure/dataprotection/backup-policy/tag#az-dataprotection-backup-policy-tag-set) command to update the existing tag or create a new tag.
239+
Once a retention rule is created, you've to create a corresponding *tag* in the *Trigger* property of the Backup policy. Use the [`az dataprotection backup-policy tag create-absolute-criteria`](/cli/azure/dataprotection/backup-policy/tag#az-dataprotection-backup-policy-tag-create-absolute-criteria) command to create a new tagging criteria and use the [`az dataprotection backup-policy tag set`](/cli/azure/dataprotection/backup-policy/tag#az-dataprotection-backup-policy-tag-set) command to update the existing tag or create a new tag.
247240

248241
The following example creates a new *tag* along with the criteria, the first successful backup of the month. The tag has the same name as the corresponding retention rule to be applied.
249242

@@ -254,7 +247,7 @@ az dataprotection backup-policy tag create-absolute-criteria --absolute-criteria
254247
az dataprotection backup-policy tag set --criteria .\tagCriteria.JSON --name Monthly --policy .\AddedRetentionRulePolicy.JSON > AddedRetentionRuleAndTag.JSON
255248
```
256249

257-
Suppose if the schedule is multiple backups per week (every Sunday, Wednesday, Thursday as specified in the above example) and you want to archive the Sunday and Friday backups, then the tagging criteria can be changed as follows, using the [az dataprotection backup-policy tag create-generic-criteria](/cli/azure/dataprotection/backup-policy/tag#az-dataprotection-backup-policy-tag-create-generic-criteria) command.
250+
Suppose if the schedule is multiple backups per week (every Sunday, Wednesday, Thursday as specified in the above example) and you want to archive the Sunday and Friday backups, then the tagging criteria can be changed as follows, using the [`az dataprotection backup-policy tag create-generic-criteria`](/cli/azure/dataprotection/backup-policy/tag#az-dataprotection-backup-policy-tag-create-generic-criteria) command.
258251

259252
```azurecli
260253
az dataprotection backup-policy tag create-generic-criteria --days-of-week Sunday Friday > tagCriteria.JSON
@@ -263,7 +256,7 @@ az dataprotection backup-policy tag set --criteria .\tagCriteria.JSON --name Mon
263256

264257
### Create a new PostgreSQL backup policy
265258

266-
Once the template is modified as per the requirements, use the [az dataprotection backup-policy create](/cli/azure/dataprotection/backup-policy#az-dataprotection-backup-policy-create) command to create a policy using the modified template.
259+
Once the template is modified as per the requirements, use the [`az dataprotection backup-policy create`](/cli/azure/dataprotection/backup-policy#az-dataprotection-backup-policy-create) command to create a policy using the modified template.
267260

268261
```azurecli
269262
az dataprotection backup-policy create --backup-policy-name FinalOSSPolicy --policy AddedRetentionRuleAndTag.JSON --resource-group testBkpVaultRG --vault-name TestBkpVault
@@ -305,8 +298,8 @@ See the [permissions](./backup-azure-database-postgresql-overview.md#set-of-perm
305298

306299
Once all the relevant permissions are set, the configuration of backup is performed in two steps.
307300

308-
1. We prepare the relevant request by using the relevant vault, policy, PostgreSQL database using the [az dataprotection backup-instance initialize](/cli/azure/dataprotection/backup-instance#az-dataprotection-backup-instance-initialize) command.
309-
1. We submit the request to protect the database using the [az dataprotection backup-instance create](/cli/azure/dataprotection/backup-instance#az-dataprotection-backup-instance-create) command.
301+
1. We prepare the relevant request by using the relevant vault, policy, PostgreSQL database using the [`az dataprotection backup-instance initialize`](/cli/azure/dataprotection/backup-instance#az-dataprotection-backup-instance-initialize) command.
302+
1. We submit the request to protect the database using the [`az dataprotection backup-instance create`](/cli/azure/dataprotection/backup-instance#az-dataprotection-backup-instance-create) command.
310303

311304
```azurecli
312305
az dataprotection backup-instance initialize --datasource-id $ossId --datasource-type AzureDatabaseForPostgreSQL -l <vault-location> --policy-id <policy_arm_id> --secret-store-type AzureKeyVault --secret-store-uri $keyURI > OSSBkpInstance.JSON
@@ -429,17 +422,17 @@ az dataprotection backup-policy show -g ossdemorg --vault-name ossdemovault-1 -
429422
}
430423
```
431424

432-
To trigger an on-demand backup, use the [az dataprotection backup-instance adhoc-backup](/cli/azure/dataprotection/backup-instance#az-dataprotection-backup-instance-adhoc-backup) command.
425+
To trigger an on-demand backup, use the [`az dataprotection backup-instance adhoc-backup`](/cli/azure/dataprotection/backup-instance#az-dataprotection-backup-instance-adhoc-backup) command.
433426

434427
```azurecli
435428
az dataprotection backup-instance adhoc-backup --name "ossrg-empdb11" --rule-name "Monthly" --resource-group testBkpVaultRG --vault-name TestBkpVault
436429
```
437430

438431
## Track jobs
439432

440-
Track all jobs using the [az dataprotection job list](/cli/azure/dataprotection/job#az-dataprotection-job-list) command. You can list all jobs and fetch a particular job detail.
433+
Track all jobs using the [`az dataprotection job list`](/cli/azure/dataprotection/job#az-dataprotection-job-list) command. You can list all jobs and fetch a particular job detail.
441434

442-
You can also use _Az.ResourceGraph_ to track all jobs across all Backup vaults. Use the [az dataprotection job list-from-resourcegraph](/cli/azure/dataprotection/job#az-dataprotection-job-list-from-resourcegraph) command to fetch the relevant jobs that are across Backup vaults.
435+
You can also use _Az.ResourceGraph_ to track all jobs across all Backup vaults. Use the [`az dataprotection job list-from-resourcegraph`](/cli/azure/dataprotection/job#az-dataprotection-job-list-from-resourcegraph) command to fetch the relevant jobs that are across Backup vaults.
443436

444437
```azurecli
445438
az dataprotection job list-from-resourcegraph --datasource-type AzureDatabaseForPostgreSQL --status Completed

0 commit comments

Comments
 (0)