Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
An upgrade brings older search services to the capabilities of new services created in the same region. Specifically, it upgrades the computing power of the underlying service. This one-time operation doesn't introduce breaking changes to your application, and you shouldn't need to change any code.
For eligible services, an upgrade increases the partition storage and vector index size on the same tier at no extra cost.
Tip
Looking to change your pricing tier? You can switch between Basic and Standard (S1, S2, and S3) tiers.
This article describes how to upgrade your service in the Azure portal. Alternatively, you can use the Search Management REST APIs to upgrade your service programmatically. For more information, see Manage your search service using REST.
About service upgrades
In April 2024, Azure AI Search increased the storage capacity of newly created search services. Services created before April 2024 saw no capacity changes, so if you wanted larger and faster partitions, you had to create a new service. However, some older services can now be upgraded to benefit from the higher-capacity partitions.
Currently, an upgrade only increases the storage limit and vector index size of eligible services.
Upgrade eligibility
To qualify for an upgrade, your service must:
- Have been created before April 3, 2024. Services created after this date should already have higher capacity.
- Be in a region where higher capacity is enabled. Most regions provide higher-capacity partitions, as noted in the table's footnotes.
- Be in a region that doesn't have capacity constraints on your pricing tier. Constrained regions and tiers are noted in the footnotes of each table.
Important
Some search services created before January 1, 2019 don't support upgrades. In this situation, you must create a new service in a high-capacity region to get increased storage and vector limits.
Higher storage limits
For eligible services, the following table compares the storage limit (per partition) before and after an upgrade.
| Basic 1 | S1 | S2 | S3/HD | L1 | L2 | |
|---|---|---|---|---|---|---|
| Limit before upgrade | 2 GB | 25 GB | 100 GB | 200 GB | 1 TB | 2 TB |
| Limit after upgrade | 15 GB | 160 GB | 512 GB | 1 TB | 2 TB | 4 TB |
1 Basic services created before April 3, 2024 were originally limited to one partition, which increases to three partitions after an upgrade. Partition counts for all other pricing tiers stay the same.
Higher vector limits
For eligible services, the following table compares the vector index size (per partition) before and after an upgrade.
| Basic | S1 | S2 | S3/HD | L1 | L2 | |
|---|---|---|---|---|---|---|
| Limit before upgrade | 0.5 GB 1 or 1 GB 2 | 1 GB 1 or 3 GB 2 | 6 GB 1 or 12 GB 2 | 12 GB 1 or 36 GB 2 | 12 GB | 36 GB |
| Limit after upgrade | 5 GB | 35 GB | 150 GB | 300 GB | 150 GB | 300 GB |
1 Applies to services created before July 1, 2023.
2 Applies to services created between July 1, 2023 and April 3, 2024 in all regions except Germany West Central, Qatar Central, and West India, to which the 1 limits apply.
Check your service creation or upgrade date
On the Overview page, you can view various metadata about your search service, including Date created and Date upgraded.
The date you created your service partially determines its upgrade eligibility. If your service has never been upgraded, Date upgraded doesn't appear.
Upgrade your service
You can't undo a service upgrade. Before you proceed, make sure that you want to permanently increase the storage limit and vector index size of your search service. We recommend that you test this operation in a nonproduction environment.
The availability of your search service during an upgrade depends on how many replicas you've provisioned. With two or more replicas, your service remains available while one replica is updated. For more information, see Reliability in Azure AI Search.
To upgrade your service:
Sign in to the Azure portal and select your search service.
On the Overview page, select Upgrade from the command bar.
If this button appears dimmed, an upgrade isn’t available for your service. Your service either has the latest upgrade or doesn't qualify for an upgrade.
Review the upgrade details for your service, and then select Upgrade.
A confirmation appears reminding you that the upgrade can't be undone.
To permanently upgrade your service, select Upgrade.
Check your notifications to confirm that the operation started.
Depending on the size of your service, this operation can take several hours to complete. If the upgrade fails, your service returns to its original state.
Next step
After you upgrade your search service, you might want to reconsider your scale configuration: