Client library customization of input param name when creating a Dataset or Index (instead of generic variable name "body") (#35235)

Author: dargilco

specification/ai/Azure.AI.Projects/datasets/routes.tsp

@@ -19,37 +19,41 @@ alias ListDatasetVersionsParameters = {};
 interface Datasets
   extends VersionedOperations<
       DatasetVersion,
+      InputParameters<DatasetVersion, "datasetVersion">,
       ListDatasetVersionsParameters,
       ListDatasetVersionsParameters
     > {
   @doc("Start a new or get an existing pending upload of a dataset for a specific version.")
   @Rest.action("startPendingUpload")
-  startPendingUploadVersion is VersionedResourceActionWithBody<
+  startPendingUploadVersion is Azure.Core.Foundations.ResourceOperation<
     DatasetVersion,
-    PendingUploadRequest,
-    PendingUploadResponse
-  >;
+    {
+      @doc("The pending upload request parameters")
+      @Http.bodyRoot
+      pendingUploadRequest: PendingUploadRequest;
 
-  /* Reenable this once the service supports "unversioned" dataset operations
-  @doc("Start a new pending upload for a dataset. The version id will be generated by the service.")
-  @Rest.actionSeparator("/")
-  @Rest.action("startPendingUpload")
-  @Http.post
-  startPendingUpload is UnversionedResourceAction<
-    DatasetVersion,
-    PendingUploadRequest,
+      @doc("The specific version id of the DatasetVersion to operate on.")
+      @Rest.segment("versions")
+      @Http.path
+      version: string;
+    },
     PendingUploadResponse
   >;
-  */
 
   #suppress "@azure-tools/typespec-azure-core/operation-missing-api-version"
   #suppress "@azure-tools/typespec-azure-core/use-standard-operations"
   @doc("Get the SAS credential to access the storage account associated with a Dataset version.")
   @post
   @Rest.action("credentials")
   @Rest.actionSeparator("/")
-  getCredentials is VersionedResourceActionNoBody<
+  getCredentials is Azure.Core.Foundations.ResourceOperation<
     DatasetVersion,
+    {
+      @doc("The specific version id of the DatasetVersion to operate on.")
+      @Rest.segment("versions")
+      @Http.path
+      version: string;
+    },
     AssetCredentialResponse
   >;
 }

specification/ai/Azure.AI.Projects/examples/2025-05-01/Datasets_CreateOrUpdateVersion_MaximumSet_Gen.json

@@ -5,7 +5,7 @@
     "api-version": "2025-05-01",
     "name": "grpenjfobadxmsceuqwunwqn",
     "version": "dfo",
-    "body": {
+    "datasetVersion": {
       "dataUri": "Replace this value with a string matching RegExp [a-zA-Z0-9_]",
       "type": "DatasetVersion",
       "description": "zukluwbmoq",

specification/ai/Azure.AI.Projects/examples/2025-05-01/Datasets_CreateOrUpdateVersion_MinimumSet_Gen.json

@@ -5,7 +5,7 @@
     "api-version": "2025-05-01",
     "name": "rpnyigsqddnpdmrboazyi",
     "version": "iplgbfirylwervrnglnnbwwzodsm",
-    "body": {
+    "datasetVersion": {
       "type": "DatasetVersion",
       "dataUri": "Replace this value with a string matching RegExp [a-zA-Z0-9_]"
     }

specification/ai/Azure.AI.Projects/examples/2025-05-01/Datasets_StartPendingUploadVersion_MaximumSet_Gen.json

@@ -5,7 +5,7 @@
     "api-version": "2025-05-01",
     "name": "hvusmygqjnkihfwprkw",
     "version": "zcrxyums",
-    "body": {
+    "pendingUploadRequest": {
       "pendingUploadId": "cnvf",
       "connectionName": "qepjjlfgjlcalfuhchnojqlzhzrtcj",
       "pendingUploadType": "BlobReference"

specification/ai/Azure.AI.Projects/examples/2025-05-01/Datasets_StartPendingUploadVersion_MinimumSet_Gen.json

@@ -5,7 +5,7 @@
     "api-version": "2025-05-01",
     "name": "esicohztsytnvxxqcpzsxnesug",
     "version": "rrwerwxmkfuewptwsxeylxrcjkcp",
-    "body": {
+    "pendingUploadRequest": {
       "pendingUploadType": "BlobReference"
     }
   },

specification/ai/Azure.AI.Projects/examples/2025-05-01/Indexes_CreateOrUpdateVersion_MaximumSet_Gen.json

@@ -5,7 +5,7 @@
     "api-version": "2025-05-01",
     "name": "qlslwpztrobxh",
     "version": "lvwrjftywgtfixhxoxbmcs",
-    "body": {
+    "index": {
       "type": "Index",
       "description": "fvbkomalkxkj",
       "tags": {

specification/ai/Azure.AI.Projects/examples/2025-05-01/Indexes_CreateOrUpdateVersion_MinimumSet_Gen.json

@@ -5,7 +5,7 @@
     "api-version": "2025-05-01",
     "name": "ypkrjjvche",
     "version": "gmorfjnfnwawvkwsjsodunylq",
-    "body": {
+    "index": {
       "type": "Index"
     }
   },

specification/ai/Azure.AI.Projects/examples/2025-05-15-preview/Datasets_CreateOrUpdateVersion_MaximumSet_Gen.json

@@ -5,7 +5,7 @@
     "api-version": "2025-05-15-preview",
     "name": "vfupg",
     "version": "ecacrnqtmggfqsocagocpf",
-    "body": {
+    "datasetVersion": {
       "dataUri": "Replace this value with a string matching RegExp [a-zA-Z0-9_]",
       "type": "DatasetVersion",
       "description": "u",

specification/ai/Azure.AI.Projects/examples/2025-05-15-preview/Datasets_CreateOrUpdateVersion_MinimumSet_Gen.json

@@ -5,7 +5,7 @@
     "api-version": "2025-05-15-preview",
     "name": "ryqozexodzklgkffokixpftfkcy",
     "version": "vldbiveryfmysxuzw",
-    "body": {
+    "datasetVersion": {
       "dataUri": "Replace this value with a string matching RegExp [a-zA-Z0-9_]",
       "type": "DatasetVersion"
     }

specification/ai/Azure.AI.Projects/examples/2025-05-15-preview/Datasets_StartPendingUploadVersion_MaximumSet_Gen.json

@@ -5,7 +5,7 @@
     "api-version": "2025-05-15-preview",
     "name": "sgrzyrpltz",
     "version": "ozdqisviavgqgfbtnzk",
-    "body": {
+    "pendingUploadRequest": {
       "pendingUploadId": "mxjahcghabuplfwtlopiqgxtcyw",
       "connectionName": "bknvpmlisrqxaphkf",
       "pendingUploadType": "BlobReference"