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.
Note
This feature is currently in public preview. This preview is provided without a service-level agreement and isn't recommended for production workloads. Certain features might not be supported or might have constrained capabilities. For more information, see Supplemental Terms of Use for Microsoft Azure Previews.
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 now move up 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.
In this preview, 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 2024. Services created after April 2024 should already have higher capacity. To see when you created your service, check your service creation date.
- Must be in a region where higher capacity is enabled.
- Must be in one of the following regions:
- East US
- North Central US
- West Central US
- UK South
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 the Create date (UTC) and Upgrade date (UTC).
The date you created your service partially determines its upgrade eligibility. If your service has never been upgraded, the Upgrade date (UTC) 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.
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 is in an unsupported region.
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.
The upgrade is an asynchronous operation, so you can continue using your service. Depending on the size of your service, the upgrade 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: