Skip to content

Commit 6cd3bdc

Browse files
Merge pull request #309001 from MicrosoftDocs/main
Auto Publish – main to live - 2025-12-03 18:00 UTC
2 parents f5e7aa2 + 8fb8f2e commit 6cd3bdc

48 files changed

Lines changed: 329 additions & 383 deletions

File tree

Some content is hidden

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

articles/backup/quick-secondary-region-restore-postgresql-powershell.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@ title: Quickstart - Cross region restore for PostgreSQL database with PowerShell
33
description: In this Quickstart, learn how to restore PostgreSQL database across region with the Azure PowerShell module.
44
ms.devlang: azurecli
55
ms.topic: quickstart
6-
ms.date: 12/03/2024
6+
ms.date: 12/03/2025
77
ms.custom: mvc, devx-track-azurepowershell, mode-api
88
author: AbhishekMallick-MS
99
ms.author: v-mallicka
@@ -91,15 +91,15 @@ To validate the probabilities of success for the restore operation, run the foll
9191
$validate = Test-AzDataProtectionBackupInstanceRestore -ResourceGroupName $ResourceGroupName -Name $instance[0].Name -VaultName $VaultName -RestoreRequest $OssRestoreReq -SubscriptionId $SubscriptionId -RestoreToSecondaryRegion #-Debug
9292
```
9393

94-
## Trigger the restore operation
94+
## Trigger the restore operation for PostgreSQL database
9595

9696
To trigger the restore operation, run the following cmdlet:
9797

9898
```azurepowershell
9999
$restoreJob = Start-AzDataProtectionBackupInstanceRestore -BackupInstanceName $instance.Name -ResourceGroupName $ResourceGroupName -VaultName $vaultName -SubscriptionId $SubscriptionId -Parameter $OssRestoreReq -RestoreToSecondaryRegion # -Debug
100100
```
101101

102-
## Track the restore job
102+
## Track the restore job for PostgreSQL database
103103

104104
To monitor the restore job progress, choose one of the methods:
105105

articles/cost-management-billing/manage/manage-azure-credits.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -18,7 +18,7 @@ ms.custom:
1818
When you accept Microsoft Azure credit under a Customer Agreement, the credit is assigned to a [subscription](../../cost-management-billing/manage/cloud-subscription.md) and resource group. The associated resource holds metadata such as status, credit amount, currency, start date, and end date. This information is accessible in the Azure portal.
1919

2020
>[!NOTE]
21-
>This article applies to Azure Credit Offer, Azure Prepayment, Support credits accepted after ***August 2025***, credits accepted earlier are not listed as resources under a subscription.
21+
>This article applies to Azure Credit Offer, Azure Prepayment, End Customer Investment Funds (ECIF), and Support credits accepted after ***August 2025***, credits accepted earlier are not listed as resources under a subscription.
2222
2323

2424

articles/digital-twins/resources-migrate-from-preview-apis.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -36,7 +36,7 @@ The changes from the 2020-03-01-preview API version to the 2023-01-31 (GA) API v
3636
If you're using an associated SDK of the 2020-03-01-preview API, we recommend that you update to the latest version of the management SDK. Use the following links to know what other changes are required to migrate to the new management SDK.
3737
* .NET: Migrate from the [Microsoft.Azure.Management.DigitalTwins 1.0.0-preview.1](https://www.nuget.org/packages/Microsoft.Azure.Management.DigitalTwins/1.0.0-preview.1) package to the [Azure.ResourceManager.DigitalTwins 1.1.0](https://www.nuget.org/packages/Azure.ResourceManager.DigitalTwins/1.1.0) package, by following the [.NET SDK migration guidance](https://github.com/Azure/azure-sdk-for-net/blob/main/sdk/resourcemanager/Azure.ResourceManager/docs/MigrationGuide.md).
3838
* Java: Migrate from the [azure-mgmt-digitaltwins:1.0.0-beta](https://search.maven.org/artifact/com.microsoft.azure.digitaltwins.v2020_03_01_preview/azure-mgmt-digitaltwins/1.0.0-beta/jar) package to the [azure-resourcemanager-digitaltwins:1.1.0](https://search.maven.org/artifact/com.azure.resourcemanager/azure-resourcemanager-digitaltwins/1.1.0/jar) package, by following the [Java SDK migration guidance](https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/eventhubs/azure-messaging-eventhubs/migration-guide.md).
39-
* Go: Migrate from the [digitaltwins 2020-03-01-preview](https://pkg.go.dev/github.com/Azure/[email protected]+incompatible/services/preview/digitaltwins/mgmt/2020-03-01-preview/digitaltwins) package to the [armsdigitaltwins v1.0.0](https://pkg.go.dev/github.com/Azure/azure-sdk-for-go/sdk/resourcemanager/digitaltwins/armdigitaltwins) package, by following the [Go SDK migration guidance](https://github.com/Azure/azure-sdk-for-go/blob/main/documentation/MIGRATION_GUIDE.md).
39+
* Go: Migrate from the [digitaltwins 2020-03-01-preview](https://pkg.go.dev/github.com/Azure/[email protected]+incompatible/services/preview/digitaltwins/mgmt/2020-03-01-preview/digitaltwins) package to the [armsdigitaltwins v1.0.0](https://pkg.go.dev/github.com/Azure/azure-sdk-for-go/sdk/resourcemanager/digitaltwins/armdigitaltwins) package, by following the [Go SDK migration guidance](https://github.com/Azure/azure-sdk-for-go/blob/main/documentation/development/ARM/MIGRATION_GUIDE.md).
4040

4141

4242
## Migrate from 2021-06-30-preview control plane API

articles/event-hubs/apache-kafka-configurations.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -26,7 +26,7 @@ Producer configs can be found [here](https://kafka.apache.org/documentation/#pro
2626
|---|---:|---:|---|
2727
|`max.request.size` | 1000000 | < 1046528 | The service closes connections if requests larger than 1,046,528 bytes are sent. *This value **must** be changed and causes issues in high-throughput produce scenarios.*|
2828
|`retries` | > 0 | | Might require increasing `delivery.timeout.ms` value, see documentation.|
29-
|`request.timeout.ms` | 30000 .. 60000 | > 20000| Event Hubs internally defaults to a minimum of 20,000 ms. *While requests with lower time out values are accepted, client behavior isn't guaranteed.* <p>Make sure that your **request.timeout.ms** is at least the recommended value of 60000 and your **session.timeout.ms** is at least the recommended value of 30000. Having these settings too low could cause consumer time-outs, which then cause rebalances (which then cause more time-outs, which cause more rebalancing, and so on).</p>|
29+
|`request.timeout.ms` | 30000 .. 60000 | > 20000| Event Hubs internally defaults to a minimum of 20,000 ms. Producer timeouts are safe with values as low as 10,000 ms and won't be a problem for producers. <p>Make sure that your **request.timeout.ms** is at least the recommended value of 60000 and your **session.timeout.ms** is at least the recommended value of 30000. Having these settings too low could cause consumer time-outs, which then cause rebalances (which then cause more time-outs, which cause more rebalancing, and so on).</p>|
3030
|`metadata.max.idle.ms` | 180000 | > 5000 | Controls how long the producer caches metadata for a topic that's idle. If the elapsed time since a topic was last produced exceeds the metadata idle duration, then the topic's metadata is forgotten and the next access to it will force a metadata fetch request.|
3131
|`linger.ms` | > 0 | | For high throughput scenarios, linger value should be equal to the highest tolerable value to take advantage of batching.|
3232
|`delivery.timeout.ms` | | | Set according to the formula (`request.timeout.ms` + `linger.ms`) * `retries`.|

articles/governance/resource-graph/concepts/azure-resource-graph-get-list-api.md

Lines changed: 25 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -133,6 +133,22 @@ For this specific example, use the following requests to retrieve the list of st
133133
HTTP GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/microsoft.storage/storageAccounts?api-version=2024-01-01&useResourceGraph=true
134134
```
135135

136+
## Building Resilient Resource Queries with ARG and Resource Provider Approach
137+
138+
In scenarios where data quality and reliability are critical, a hybrid querying strategy is highly recommended. This approach combines Azure Resource Graph (ARG) calls with a fallback to the Resource Provider (RP) API, which serves as the source of truth for each resource. By introducing intelligent logic that automatically triggers a fallback when data freshness issues, indexing delays, or latency problems arise, you can significantly improve the resilience of your solution. This ensures that users experience minimal disruption and continue to receive accurate, up-to-date resource information.
139+
140+
### A common scenario: polling immediately after resource creation
141+
142+
Many users poll resources immediately after creation—sometimes within 1–2 seconds—as part of a write workflow, as an example - until resource provisioningState reaches a final state, or until certain properties appear in the response. Since ARG indexing may not have completed yet, callers may receive 404 Not Found even though the resource exists. In these cases, a hybrid strategy helps avoid false negatives.
143+
144+
Two Workarounds to handle the brief window before ARG indexing completes, you can:
145+
146+
1. Retry using the useResourceGraph=true flag a few times until the call returns 200 OK.
147+
148+
2. Retry without the useResourceGraph=true flag to fall back directly to the Resource Provider API.
149+
150+
Both strategies help ensure that users always retrieve the most accurate state of the resource—without being impacted by short-lived data freshness gaps.
151+
136152
## Known Limitations
137153

138154
- **VMSS VM health status** isn't currently supported. If you require this data, you can share your scenario and propose the feature addition on our [feedback forums](https://feedback.azure.com/d365community/forum/675ae472-f324-ec11-b6e6-000d3a4f0da0).
@@ -253,4 +269,12 @@ internal class ArgGetListHttpPipelinePolicy : HttpPipelineSynchronousPolicy
253269

254270
- What should I do if I encounter issues while using the useResourceGraph parameter when calling Azure Resource Graph?
255271

256-
If you experience any issues while using the `useResourceGraph` parameter with ARG, create a support ticket under the Azure Resource Graph service in the [Azure portal](https://ms.portal.azure.com/#home) under **Help + Support.**
272+
If you experience any issues while using the `useResourceGraph` parameter with ARG, create a support ticket under the Azure Resource Graph service in the [Azure portal](https://ms.portal.azure.com/#home) under **Help + Support.**
273+
274+
- How do you differentiate between ARM and ARG throttling?
275+
276+
Please refer to [differentiating between throttling request for ARG and ARM](/azure/governance/resource-graph/concepts/guidance-for-throttled-requests).
277+
278+
- What should I do if ARG GET/LIST API is down?
279+
280+
Treat it as a backend Resource Provider down scenario with a 500 Internal Server Error. ARM does not auto-retry, so first retry with `useResourceGraph=true`. If it still fails, retry without the flag and the call will go directly to the Resource Provider.
Lines changed: 26 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,26 @@
1+
---
2+
title: Differences between ARG GET/LIST API and ARG Query service
3+
description: How is Azure Resource Graph (ARG) GET/LIST API is different than Azure Resource Graph Query service
4+
ms.date: 12/2/2025
5+
ms.topic: reference
6+
ms.custom: devx-track-csharp
7+
---
8+
9+
# Differences between Azure Resource Graph (ARG) GET/LIST API and ARG Query service
10+
11+
Azure Resource Graph (ARG) provides a unified, aggregated data store that consolidates resource information from all Resource Providers. This lets you query and retrieve resource details efficiently, with lower latency and substantially higher throttling quotas compared to traditional Azure Resource Manager APIs. ARG is powerful when you need to understand the state of resources at scale—across multiple subscriptions, resource groups, or large environments.
12+
13+
The ARG GET/LIST API extends this value even further. As a new capability within the ARG ecosystem, it delivers even higher throttling quotas specifically for point GET and LIST calls, making it ideal for services that frequently perform targeted resource lookups.
14+
15+
Below is a comparison table outlining how ARG Query and ARG GET/LIST API differ, and how each caters to specific scenarios—helping you decide which solution best fits your workload:
16+
17+
| | ARG Query API | ARG GET/LIST API |
18+
|----|-----|-----|
19+
|**Solution description** | Use Azure Resource Graph query API for querying resources and Azure inventory. ARG query supports many resource types that are part of a table in Resource Graph. See the full list of [resource types tables](/azure/governance/resource-graph/reference/supported-tables-resources). |Use Azure Resource Graph GET/LIST API for querying resources and Azure inventory. The ARG GET/LIST API is currently supported only for resources in the [resources](/azure/governance/resource-graph/reference/supported-tables-resources#resources) and [computeresources](/azure/governance/resource-graph/reference/supported-tables-resources#computeresources) tables. |
20+
| **Supported clients** | Querying experience is available through [ARG Explorer in the Azure portal](/azure/governance/resource-graph/first-query-portal), Azure PowerShell, AzureCLI, SDKs, REST API etc. | The current experience is available through supported Azure REST APIs and certain SDKs. |
21+
| **API** | POST /resources: [Run Azure Resource Graph query using REST API - Azure Resource Graph Microsoft Learn](/azure/governance/resource-graph/first-query-rest-api?tabs=powershell#review-the-rest-api-syntax) | ARG GET/LIST API uses the existing control plane GET APIs appending the flag `useResourceGraph=true` to the APIs that seamlessly routes the call to the ARG GET/LIST backend. |
22+
| **Ideal for scenarios** | ARG Query API is a tenant level API that is meant for bulk lookups where you have a requirement to join across multiple tenants, subscriptions, resource group, MG etc., for complex analytical scenarios. Example: “Show me all resources across subscriptions” | ARG GET/LIST API serves as a Lookup source for the entire Azure GET & LIST API path against a single subscription or resource group meant for high concurrency, high throughput and low complexity kind of scenarios. Example: “List all VMs under a specific subscription” |
23+
| **Throttling quota** | Generally lower than ARG GE/LIST API. A user can send at most 15 queries within every 5-second window 1. However this is a soft limit and is subject to change based on users calling pattern. | Aligns with the Azure Resource Manager limits, currently set upto 4k per minute, user, and subscription. It’s a soft limit and can be raised based on scenario. |
24+
| **Consistency level** | Bounded Staleness consistency level, which means data is indexed in ARG with a certain latency. | Bounded Staleness consistency level, which means data is indexed in ARG with a certain latency.|
25+
|**Product lifecycle stage** | Generally available | Generally available |
26+
| **Pricing**| Free | Free |

articles/governance/resource-graph/concepts/guidance-for-throttled-requests.md

Lines changed: 15 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -228,7 +228,7 @@ while (!string.IsNullOrEmpty(azureOperationResponse.Body.SkipToken))
228228

229229
## Differentiate between throttling requests for ARG and ARM
230230

231-
When using the ARG GET / LIST API, you may encounter throttling errors in response to your requests. It’s important to identify the source of throttling, as it can occur at two levels:
231+
When using ARG, you may encounter throttling errors in response to your requests. It’s important to identify the source of throttling, as it can occur at two levels:
232232

233233
- ARG API throttling: limits applied by Azure Resource Graph.
234234
- ARM throttling: limits enforced by Azure Resource Manager.
@@ -271,15 +271,21 @@ ARG is introducing an alternative approach to the existing Azure control plane G
271271

272272
The ARG GET/LIST API is meant to address scenarios where you need a lookup of a single resource by ID, or you’re listing resources under the same type and within a certain scope (subscription, resource group, or parent resource).
273273

274-
You should consider the ARG GET/LIST API if your service falls into one (or many) of the following categories:
274+
You should consider using the ARG GET/LIST API if your service fits into one or more of the following categories:
275275

276-
- Your service is issuing a large volume of GET calls to retrieve data for a resource targeted to a single subscription or a single RG and do not require batches of records from multiple subscriptions through complex filtering or joins.
277-
- Your service issues a large volume of GET requests, and is at risk of:
278-
- Facing throttling.
279-
- Competing for throttling quota with other customers.
280-
- Your service may be or is prone to issuing a large burst of concurrent GET requests within a short period of time.
281-
- Your service requires high availability and faster performance for GET requests, for single resource management or enumeration of a list of resources within a certain scope.
282-
- You require full instanceView of VMs and VMSS VMs in Uniform as well as Flex orchestration mode.
276+
- **High Volume of GET Calls Within a Single Scope:**
277+
Your service issues a large number of GET requests targeting resources within a single subscription or resource group, without the need for cross-subscription queries, complex filters, or joins.
278+
279+
- **Risk of Throttling or Quota Competition:**
280+
Your service produces a high volume of requests and may encounter issues such as:
281+
- Experience throttling during sudden traffic spikes.
282+
- Quota competition, where other workloads in the same subscription consume shared quota limits, causing your service to be throttled.
283+
- Bursty traffic patterns, where large volume of GET requests are issued within a short time window, increasing the chance of throttling.
284+
285+
- **Need for High Availability and Faster Performance:**
286+
Your service depends on consistent; low-latency GET operations for either single-resource lookups or listing resources within a specific scope.
287+
288+
- You require full `instanceView` of VMs and VMSS VMs in Uniform as well as Flex orchestration mode.
283289

284290
> [!NOTE]
285291
> ARG GET/LIST API doesn't support VM and VMSS VM Health Status and extension running status in the instanceView. To learn more about the ARG GET/LIST API limits, see the [known limitations](./azure-resource-graph-get-list-api.md#known-limitations).

articles/governance/resource-graph/toc.yml

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -81,6 +81,8 @@
8181
href: ./concepts/guidance-for-throttled-requests.md
8282
- name: Guidance for the Azure Resource Graph GET/LIST API
8383
href: ./concepts/azure-resource-graph-get-list-api.md
84+
- name: Differences between the Azure Resource Graph GET/LIST API and Azure Resource Graph Query service
85+
href: ./concepts/get-list-query-service-differences.md
8486
- name: Security
8587
items:
8688
- name: Security baseline for Azure Security Benchmark

articles/internet-peering/walkthrough-communications-services-partner.md

Lines changed: 0 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -217,10 +217,6 @@ Get answers to frequently asked questions.
217217

218218
**A.** Yes. A private ASN can't be in the AS path. For registered prefixes smaller than \/24, the AS path must be less than 4.
219219

220-
**Q.** I need to set the prefix limit. How many routes will Microsoft announce?
221-
222-
**A.** Microsoft announces roughly 280 prefixes on the internet. The number might increase by 10% to 15%. A limit of 400 to 500 is safe to set as the value for **Max prefix count**.
223-
224220
**Q.** Will Microsoft readvertise peer prefixes to the internet?
225221

226222
**A.** No.

articles/load-balancer/skus.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -17,11 +17,11 @@ ms.custom: template-reference, engagement-fy23
1717
>On September 30, 2025, Basic Load Balancer was retired. For more information, see the [official announcement](https://azure.microsoft.com/updates/azure-basic-load-balancer-will-be-retired-on-30-september-2025-upgrade-to-standard-load-balancer/). If you are currently using Basic Load Balancer, make sure to upgrade to Standard Load Balancer as soon as possible. For guidance on upgrading, visit [Upgrading from Basic Load Balancer - Guidance](load-balancer-basic-upgrade-guidance.md).
1818
1919
## <a name="skus"></a> SKU comparison
20-
Azure Load Balancer has three stock-keeping units (SKUs) - Basic, Standard, and Gateway. Each SKU is catered towards a specific scenario and has differences in scale, features, and pricing.
20+
Azure Load Balancer has three stock-keeping units (SKUs) - Basic(Retired), Standard, and Gateway. Each SKU is catered towards a specific scenario and has differences in scale, features, and pricing.
2121

22-
To compare and understand the differences between Basic and Standard SKU, see the following table.
22+
To compare and understand the differences between Basic(Retired) and Standard SKU, see the following table.
2323

24-
| | Standard Load Balancer | Basic Load Balancer |
24+
| | Standard Load Balancer | Basic Load Balancer (retired) |
2525
| --- | --- | --- |
2626
| **Scenario** | Equipped for load-balancing network layer traffic when high performance and ultra-low latency is needed. Routes traffic within and across regions, and to availability zones for high resiliency. | Equipped for small-scale applications that don't need high availability or redundancy. Not compatible with availability zones. |
2727
| **Backend type** | IP based, NIC based | NIC based |

0 commit comments

Comments
 (0)