[Key Vault Certificates] Remove 2026-03-01-preview service version (#50990)

* Remove certificates preview service version

* Update CHANGELOG for breaking changes in service version

Removed deprecated service version and updated changelog.

---------

Co-authored-by: Rohit Singhal <singhalrohit@microsoft.com>

Author: rohitsinghal4u

sdk/keyvault/azure-security-keyvault-certificates/CHANGELOG.md

@@ -14,7 +14,6 @@
 
 #### `CertificateServiceVersion` was modified
 
-* `V2026_03_01_PREVIEW` was added
 * `V2026_04_01` was added and is the default service version.
 
 ## 4.9.3 (2026-10-06)

sdk/keyvault/azure-security-keyvault-certificates/customizations/src/main/java/CertificatesCustomizations.java

@@ -121,7 +121,7 @@ private static void customizeServiceVersion(LibraryCustomization customization)
             .setJavadocComment("The versions of Azure Key Vault Certificates supported by this client library.");
 
         for (String version : Arrays.asList("7.0", "7.1", "7.2", "7.3", "7.4", "7.5", "7.6",
-            "2025-07-01", "2026-03-01-preview", "2026-04-01")) {
+            "2025-07-01", "2026-04-01")) {
             enumDeclaration.addEnumConstant("V" + version.replace('.', '_').replace('-', '_').toUpperCase())
                 .setJavadocComment("Service version {@code " + version + "}.")
                 .addArgument(new StringLiteralExpr(version));

sdk/keyvault/azure-security-keyvault-certificates/src/main/java/com/azure/security/keyvault/certificates/CertificateServiceVersion.java

@@ -42,10 +42,6 @@ public enum CertificateServiceVersion implements ServiceVersion {
      * Service version {@code 2025-07-01}.
      */
     V2025_07_01("2025-07-01"),
-    /**
-     * Service version {@code 2026-03-01-preview}.
-     */
-    V2026_03_01_PREVIEW("2026-03-01-preview"),
     /**
      * Service version {@code 2026-04-01}.
      */

sdk/keyvault/azure-security-keyvault-certificates/src/test/java/com/azure/security/keyvault/certificates/CertificateClientBuilderTest.java

@@ -15,10 +15,14 @@
 import com.azure.core.util.Header;
 import org.junit.jupiter.api.BeforeEach;
 import org.junit.jupiter.api.Test;
+import org.junit.jupiter.params.ParameterizedTest;
+import org.junit.jupiter.params.provider.EnumSource;
 import reactor.core.publisher.Mono;
 
+import java.util.Arrays;
 import java.util.Collections;
 
+import static org.junit.jupiter.api.Assertions.assertArrayEquals;
 import static org.junit.jupiter.api.Assertions.assertEquals;
 import static org.junit.jupiter.api.Assertions.assertNotNull;
 import static org.junit.jupiter.api.Assertions.assertThrows;
@@ -92,6 +96,46 @@ public void buildAsyncClientUsingDefaultApiVersionTest() {
         assertThrows(HttpResponseException.class, () -> certificateAsyncClient.getCertificate(certificateName).block());
     }
 
+    @Test
+    public void supportedServiceVersions() {
+        assertArrayEquals(new String[] { "7.0", "7.1", "7.2", "7.3", "7.4", "7.5", "7.6", "2025-07-01", "2026-04-01" },
+            Arrays.stream(CertificateServiceVersion.values())
+                .map(CertificateServiceVersion::getVersion)
+                .toArray(String[]::new));
+    }
+
+    @ParameterizedTest
+    @EnumSource(CertificateServiceVersion.class)
+    public void buildClientsUsingExplicitApiVersion(CertificateServiceVersion version) {
+        CertificateClientBuilder builder = new CertificateClientBuilder().vaultUrl(vaultUrl)
+            .serviceVersion(version)
+            .credential(new TestUtils.TestCredential())
+            .httpClient(request -> {
+                assertEquals("api-version=" + version.getVersion(), request.getUrl().getQuery());
+                return Mono.just(new MockHttpResponse(request, 404));
+            });
+
+        assertThrows(HttpResponseException.class, () -> builder.buildClient().getCertificate(certificateName));
+        assertThrows(HttpResponseException.class,
+            () -> builder.buildAsyncClient().getCertificate(certificateName).block());
+    }
+
+    @Test
+    public void nullServiceVersionResetsToDefault() {
+        CertificateClientBuilder builder = new CertificateClientBuilder().vaultUrl(vaultUrl)
+            .serviceVersion(serviceVersion)
+            .serviceVersion(null)
+            .credential(new TestUtils.TestCredential())
+            .httpClient(request -> {
+                assertEquals("api-version=2026-04-01", request.getUrl().getQuery());
+                return Mono.just(new MockHttpResponse(request, 404));
+            });
+
+        assertThrows(HttpResponseException.class, () -> builder.buildClient().getCertificate(certificateName));
+        assertThrows(HttpResponseException.class,
+            () -> builder.buildAsyncClient().getCertificate(certificateName).block());
+    }
+
     @Test
     public void emptyVaultUrlThrowsIllegalArgumentException() {
         assertThrows(IllegalArgumentException.class, () -> new CertificateClientBuilder().vaultUrl(""));

sdk/keyvault/azure-security-keyvault-certificates/src/test/java/com/azure/security/keyvault/certificates/CertificateClientTestBase.java

@@ -699,12 +699,10 @@ static Stream<Arguments> getTestParameters() {
     static Stream<Arguments> getPlatformManagedTestParameters() {
         List<Arguments> argumentsList = new ArrayList<>();
 
-        getHttpClients().forEach(httpClient -> Arrays
-            .stream(new CertificateServiceVersion[] {
-                CertificateServiceVersion.V2026_03_01_PREVIEW,
-                CertificateServiceVersion.V2026_04_01 })
-            .filter(CertificateClientTestBase::shouldServiceVersionBeTested)
-            .forEach(serviceVersion -> argumentsList.add(Arguments.of(httpClient, serviceVersion))));
+        getHttpClients().forEach(
+            httpClient -> Arrays.stream(new CertificateServiceVersion[] { CertificateServiceVersion.V2026_04_01 })
+                .filter(CertificateClientTestBase::shouldServiceVersionBeTested)
+                .forEach(serviceVersion -> argumentsList.add(Arguments.of(httpClient, serviceVersion))));
 
         return argumentsList.stream();
     }