weidongxu-microsoft

Migration Guide

Assumption

• Project is Maven.
• Java code is on JDK 8 or above.

Migrate pom.xml

It is recommended to use azure-sdk-bom (version higher than 1.3.0).

weidongxu-microsoft

The intention is to investigate whether including the TypeSpec authoring chatbot MCP in the Azure/azure-rest-api-specs repository can help GitHub Copilot better handle user issues and PR reviews.

One champion scenario I'd imagine would be:

Issue by user with description like below:

1. Add preview api-version 2025-09-01 to RP <resource-provider>
2. Add resource <resource> with path <route>, including standard CRUD operations on this resource

weidongxu-microsoft

Follow up on https://gist.github.com/weidongxu-microsoft/fa420c35cf0611a62a8d155771dd3425

With @armRenameListByOperation solved, we can put multiple List operation into same Interface.

Group operations in "route.tsp"

TypeSpec dev advises against this approach.

Group operations in "client.tsp"

weidongxu-microsoft

TCGC

TCGC, by default, groups operations via TypeSpec Interfaces.

If @operationGroup is specified in client.tsp, it would group operations from Interfaces with @operationGroup in client.tsp instead.

Management - brownfield

Swagger in Management usually groups many different resources in a single resource group, via "operationId".

weidongxu-microsoft

Context

Related issue:

• Azure/cadl-ranch#487
• microsoft/typespec#2477

PR

• Azure/azure-rest-api-specs#26359 (only a draft)

DevBox resource model is

weidongxu-microsoft

Generate client method signature which follow the serivce operation signature.

Different language may have different interpretation of the signature, based on best practise of that language.

Interprecate model as class

Model ClientOptions

@resource("resource-collection")

weidongxu-microsoft

Information and runtime behavior of the new design can be found at cadl-ranch PR

Runtime

Major difference in PUT.

1. Response of the PUT is the Resource object, not the OperationStatus object.
2. The last GET on Resource URL preferred to be omitted. The Resource object from the PUT is already the final result.

Major difference in POST.

weidongxu-microsoft

/**
 * Copyright (c) Microsoft Corporation. All rights reserved.
 * Licensed under the MIT License. See License.txt in the project root for
 * license information.
 */

package com.microsoft.azure.azuresdktest;

import com.google.common.io.BaseEncoding;
import com.microsoft.aad.adal4j.AsymmetricKeyCredential;