mgmt Swagger generation, add suffix config to api-specs.yaml if present, when generating for the first-time (#45441)

* add suffix

* Update eng/automation/generate_utils.py

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

---------

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

Author: XiaofeiCao

eng/automation/generate.py

@@ -451,8 +451,9 @@ def main():
         args["readme"] = readme
         args["spec"] = spec
 
-        update_parameters(args.get("suffix") or get_suffix_from_api_specs(api_specs_file, spec))
-        service = get_and_update_service_from_api_specs(api_specs_file, spec, args["service"])
+        suffix = args.get("suffix") or get_suffix_from_api_specs(api_specs_file, spec)
+        update_parameters(suffix)
+        service = get_and_update_service_from_api_specs(api_specs_file, spec, args["service"], suffix)
         args["service"] = service
         module = ARTIFACT_FORMAT.format(service)
         stable_version, current_version = set_or_increase_version(sdk_root, GROUP_ID, module, **args)

eng/automation/generate_utils.py

@@ -284,8 +284,22 @@ def get_and_update_service_from_api_specs(
     api_specs_file: str,
     spec: str,
     service: str = None,
+    suffix: str = None,
     truncate_service: bool = False,
 ):
+    """
+    Updates the API specs file with the provided service name and optional suffix.
+
+    Args:
+        api_specs_file (str): Path to the API specs file.
+        spec (str): The specification key to update in the API specs.
+        service (str, optional): The service name to associate with the spec. If not provided, it will be derived.
+        suffix (str, optional): An optional suffix to add to the spec entry in the API specs file.
+        truncate_service (bool, optional): Whether to truncate the service name to a maximum length of 32 characters.
+
+    Returns:
+        str: The validated and potentially updated service name.
+    """
     special_spec = {"resources"}
     if spec in special_spec:
         if not service:
@@ -315,6 +329,9 @@ def get_and_update_service_from_api_specs(
         api_specs[spec] = dict() if not api_spec else api_spec
         api_specs[spec]["service"] = service
 
+    if suffix:
+        api_specs[spec]["suffix"] = suffix
+
     write_api_specs(api_specs_file, comment, api_specs)
 
     return service