[Compute] az compute-recommender spot-placement-score: Add new command to replace original command az compute-recommender spot-placement-recommender

src/azure-cli/azure/cli/command_modules/compute_recommender/_breaking_change.py

@@ -0,0 +1,11 @@
+# --------------------------------------------------------------------------------------------
+# Copyright (c) Microsoft Corporation. All rights reserved.
+# Licensed under the MIT License. See License.txt in the project root for license information.
+# --------------------------------------------------------------------------------------------
+
+from azure.cli.core.breaking_change import register_command_deprecate
+
+register_command_deprecate(
+    'compute-recommender spot-placement-recommender',
+    redirect='az compute-recommender spot-placement-score',
+    hide=True)

src/azure-cli/azure/cli/command_modules/compute_recommender/aaz/latest/compute_recommender/__cmd_group.py

@@ -13,7 +13,6 @@
 
 @register_command_group(
     "compute-recommender",
-    is_preview=True,
 )
 class __CMDGroup(AAZCommandGroup):
     """Manage sku/zone/region recommender info for compute resources

src/azure-cli/azure/cli/command_modules/compute_recommender/aaz/latest/compute_recommender/__init__.py

@@ -10,3 +10,4 @@
 
 from .__cmd_group import *
 from ._spot_placement_recommender import *
+from ._spot_placement_score import *

src/azure-cli/azure/cli/command_modules/compute_recommender/aaz/latest/compute_recommender/_spot_placement_score.py

@@ -0,0 +1,260 @@
+# --------------------------------------------------------------------------------------------
+# Copyright (c) Microsoft Corporation. All rights reserved.
+# Licensed under the MIT License. See License.txt in the project root for license information.
+#
+# Code generated by aaz-dev-tools
+# --------------------------------------------------------------------------------------------
+
+# pylint: skip-file
+# flake8: noqa
+
+from azure.cli.core.aaz import *
+
+
+@register_command(
+    "compute-recommender spot-placement-score"
+)
+class SpotPlacementScore(AAZCommand):
+    """Generate placement scores for Spot VM skus.
+
+    :example: generate spot vm placement score example
+        az compute-recommender spot-placement-score -l eastus --subscription ffffffff-ffff-ffff-ffff-ffffffffffff --availability-zones true --desired-locations '["eastus", "eastus2"]' --desired-count 1 --desired-sizes '[{"sku": "Standard_D2_v2"}]'
+    """
+
+    _aaz_info = {
+        "version": "2025-06-05",
+        "resources": [
+            ["mgmt-plane", "/subscriptions/{}/providers/microsoft.compute/locations/{}/placementscores/spot/generate", "2025-06-05"],
+        ]
+    }
+
+    def _handler(self, command_args):
+        super()._handler(command_args)
+        self._execute_operations()
+        return self._output()
+
+    _args_schema = None
+
+    @classmethod
+    def _build_arguments_schema(cls, *args, **kwargs):
+        if cls._args_schema is not None:
+            return cls._args_schema
+        cls._args_schema = super()._build_arguments_schema(*args, **kwargs)
+
+        # define Arg Group ""
+
+        _args_schema = cls._args_schema
+        _args_schema.location = AAZResourceLocationArg(
+            required=True,
+            id_part="name",
+        )
+
+        # define Arg Group "SpotPlacementScoresInput"
+
+        _args_schema = cls._args_schema
+        _args_schema.availability_zones = AAZBoolArg(
+            options=["--availability-zones"],
+            arg_group="SpotPlacementScoresInput",
+            help="Defines if the scope is zonal or regional.",
+        )
+        _args_schema.desired_count = AAZIntArg(
+            options=["--desired-count"],
+            arg_group="SpotPlacementScoresInput",
+            help="Desired instance count per region/zone based on the scope.",
+        )
+        _args_schema.desired_locations = AAZListArg(
+            options=["--desired-locations"],
+            arg_group="SpotPlacementScoresInput",
+            help="The desired regions",
+            required=True,
+        )
+        _args_schema.desired_sizes = AAZListArg(
+            options=["--desired-sizes"],
+            arg_group="SpotPlacementScoresInput",
+            help="The desired resource SKUs.",
+            required=True,
+        )
+
+        desired_locations = cls._args_schema.desired_locations
+        desired_locations.Element = AAZStrArg()
+
+        desired_sizes = cls._args_schema.desired_sizes
+        desired_sizes.Element = AAZObjectArg()
+
+        _element = cls._args_schema.desired_sizes.Element
+        _element.sku = AAZStrArg(
+            options=["sku"],
+            help="The resource's CRP virtual machine SKU size.",
+        )
+        return cls._args_schema
+
+    def _execute_operations(self):
+        self.pre_operations()
+        self.SpotPlacementScoresPost(ctx=self.ctx)()
+        self.post_operations()
+
+    @register_callback
+    def pre_operations(self):
+        pass
+
+    @register_callback
+    def post_operations(self):
+        pass
+
+    def _output(self, *args, **kwargs):
+        result = self.deserialize_output(self.ctx.vars.instance, client_flatten=True)
+        return result
+
+    class SpotPlacementScoresPost(AAZHttpOperation):
+        CLIENT_TYPE = "MgmtClient"
+
+        def __call__(self, *args, **kwargs):
+            request = self.make_request()
+            session = self.client.send_request(request=request, stream=False, **kwargs)
+            if session.http_response.status_code in [200]:
+                return self.on_200(session)
+
+            return self.on_error(session.http_response)
+
+        @property
+        def url(self):
+            return self.client.format_url(
+                "/subscriptions/{subscriptionId}/providers/Microsoft.Compute/locations/{location}/placementScores/spot/generate",
+                **self.url_parameters
+            )
+
+        @property
+        def method(self):
+            return "POST"
+
+        @property
+        def error_format(self):
+            return "MgmtErrorFormat"
+
+        @property
+        def url_parameters(self):
+            parameters = {
+                **self.serialize_url_param(
+                    "location", self.ctx.args.location,
+                    required=True,
+                ),
+                **self.serialize_url_param(
+                    "subscriptionId", self.ctx.subscription_id,
+                    required=True,
+                ),
+            }
+            return parameters
+
+        @property
+        def query_parameters(self):
+            parameters = {
+                **self.serialize_query_param(
+                    "api-version", "2025-06-05",
+                    required=True,
+                ),
+            }
+            return parameters
+
+        @property
+        def header_parameters(self):
+            parameters = {
+                **self.serialize_header_param(
+                    "Content-Type", "application/json",
+                ),
+                **self.serialize_header_param(
+                    "Accept", "application/json",
+                ),
+            }
+            return parameters
+
+        @property
+        def content(self):
+            _content_value, _builder = self.new_content_builder(
+                self.ctx.args,
+                typ=AAZObjectType,
+                typ_kwargs={"flags": {"required": True, "client_flatten": True}}
+            )
+            _builder.set_prop("availabilityZones", AAZBoolType, ".availability_zones")
+            _builder.set_prop("desiredCount", AAZIntType, ".desired_count")
+            _builder.set_prop("desiredLocations", AAZListType, ".desired_locations", typ_kwargs={"flags": {"required": True}})
+            _builder.set_prop("desiredSizes", AAZListType, ".desired_sizes", typ_kwargs={"flags": {"required": True}})
+
+            desired_locations = _builder.get(".desiredLocations")
+            if desired_locations is not None:
+                desired_locations.set_elements(AAZStrType, ".")
+
+            desired_sizes = _builder.get(".desiredSizes")
+            if desired_sizes is not None:
+                desired_sizes.set_elements(AAZObjectType, ".")
+
+            _elements = _builder.get(".desiredSizes[]")
+            if _elements is not None:
+                _elements.set_prop("sku", AAZStrType, ".sku")
+
+            return self.serialize_content(_content_value)
+
+        def on_200(self, session):
+            data = self.deserialize_http_content(session)
+            self.ctx.set_var(
+                "instance",
+                data,
+                schema_builder=self._build_schema_on_200
+            )
+
+        _schema_on_200 = None
+
+        @classmethod
+        def _build_schema_on_200(cls):
+            if cls._schema_on_200 is not None:
+                return cls._schema_on_200
+
+            cls._schema_on_200 = AAZObjectType()
+
+            _schema_on_200 = cls._schema_on_200
+            _schema_on_200.availability_zones = AAZBoolType(
+                serialized_name="availabilityZones",
+            )
+            _schema_on_200.desired_count = AAZIntType(
+                serialized_name="desiredCount",
+            )
+            _schema_on_200.desired_locations = AAZListType(
+                serialized_name="desiredLocations",
+            )
+            _schema_on_200.desired_sizes = AAZListType(
+                serialized_name="desiredSizes",
+            )
+            _schema_on_200.placement_scores = AAZListType(
+                serialized_name="placementScores",
+            )
+
+            desired_locations = cls._schema_on_200.desired_locations
+            desired_locations.Element = AAZStrType()
+
+            desired_sizes = cls._schema_on_200.desired_sizes
+            desired_sizes.Element = AAZObjectType()
+
+            _element = cls._schema_on_200.desired_sizes.Element
+            _element.sku = AAZStrType()
+
+            placement_scores = cls._schema_on_200.placement_scores
+            placement_scores.Element = AAZObjectType()
+
+            _element = cls._schema_on_200.placement_scores.Element
+            _element.availability_zone = AAZStrType(
+                serialized_name="availabilityZone",
+            )
+            _element.is_quota_available = AAZBoolType(
+                serialized_name="isQuotaAvailable",
+            )
+            _element.region = AAZStrType()
+            _element.score = AAZStrType()
+            _element.sku = AAZStrType()
+
+            return cls._schema_on_200
+
+
+class _SpotPlacementScoreHelper:
+    """Helper class for SpotPlacementScore"""
+
+
+__all__ = ["SpotPlacementScore"]

src/azure-cli/azure/cli/command_modules/compute_recommender/tests/latest/recordings/test_spot_placement_score_generate.yaml

@@ -0,0 +1,61 @@
+interactions:
+- request:
+    body: '{"availabilityZones": true, "desiredCount": 1, "desiredLocations": ["eastus",
+      "eastus2"], "desiredSizes": [{"sku": "Standard_D2_v2"}]}'
+    headers:
+      Accept:
+      - application/json
+      Accept-Encoding:
+      - gzip, deflate
+      CommandName:
+      - compute-recommender spot-placement-score
+      Connection:
+      - keep-alive
+      Content-Length:
+      - '134'
+      Content-Type:
+      - application/json
+      ParameterSetName:
+      - -l --subscription --availability-zones --desired-locations --desired-count
+        --desired-sizes
+      User-Agent:
+      - AZURECLI/2.75.0 azsdk-python-core/1.35.0 Python/3.12.10 (Windows-11-10.0.22621-SP0)
+    method: POST
+    uri: https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.Compute/locations/eastus/placementScores/spot/generate?api-version=2025-06-05
+  response:
+    body:
+      string: '{"desiredLocations":["eastus","eastus2"],"desiredSizes":[{"sku":"Standard_D2_v2"}],"desiredCount":1,"availabilityZones":true,"placementScores":[{"sku":"Standard_D2_v2","region":"eastus","availabilityZone":"1","score":"RestrictedSkuNotAvailable","isQuotaAvailable":true},{"sku":"Standard_D2_v2","region":"eastus","availabilityZone":"2","score":"RestrictedSkuNotAvailable","isQuotaAvailable":true},{"sku":"Standard_D2_v2","region":"eastus","availabilityZone":"3","score":"RestrictedSkuNotAvailable","isQuotaAvailable":true},{"sku":"Standard_D2_v2","region":"eastus2","availabilityZone":"1","score":"Low","isQuotaAvailable":true},{"sku":"Standard_D2_v2","region":"eastus2","availabilityZone":"2","score":"Low","isQuotaAvailable":true},{"sku":"Standard_D2_v2","region":"eastus2","availabilityZone":"3","score":"Low","isQuotaAvailable":true}]}'
+    headers:
+      api-supported-versions:
+      - 2024-03-01-preview, 2024-06-01-preview, 2025-02-01-preview, 2025-06-05-preview,
+        2025-06-05
+      cache-control:
+      - no-cache
+      content-length:
+      - '838'
+      content-type:
+      - application/json; charset=utf-8
+      date:
+      - Thu, 24 Jul 2025 00:54:07 GMT
+      expires:
+      - '-1'
+      pragma:
+      - no-cache
+      strict-transport-security:
+      - max-age=31536000; includeSubDomains
+      x-cache:
+      - CONFIG_NOCACHE
+      x-content-type-options:
+      - nosniff
+      x-ms-operation-identifier:
+      - tenantId=72f988bf-86f1-41af-91ab-2d7cd011db47,objectId=08e22377-6d70-4f82-b548-12ea80f00e8a/westus2/6d5eba66-9484-4bea-be37-6f3f019a6390
+      x-ms-ratelimit-remaining-subscription-global-writes:
+      - '11999'
+      x-ms-ratelimit-remaining-subscription-writes:
+      - '799'
+      x-msedge-ref:
+      - 'Ref A: 5970299CFCE942E98330E15C3118BC33 Ref B: MWH011020809025 Ref C: 2025-07-24T00:54:02Z'
+    status:
+      code: 200
+      message: OK
+version: 1

src/azure-cli/azure/cli/command_modules/compute_recommender/tests/latest/test_compute_recommender.py

@@ -21,4 +21,18 @@ def test_spot_placement_recommender_generate(self):
 
         spot_scores_output = self.cmd('az compute-recommender spot-placement-recommender -l {location} --subscription {subscription_id} --availability-zones {availability_zones} --desired-locations \'{desired_locations}\' --desired-count {desired_count} --desired-sizes \'{desired_sizes}\'').get_output_in_json()
 
+        self.assertTrue(len(spot_scores_output["placementScores"]) > 0, "Spot scores should have at least one item")
+
+    def test_spot_placement_score_generate(self):        
+        self.kwargs.update({
+            'location': 'eastus',
+            'subscription_id': self.get_subscription_id(),
+            'availability_zones': 'true',
+            'desired_locations': '["eastus", "eastus2"]',
+            'desired_count': 1,
+            'desired_sizes': '[{"sku": "Standard_D2_v2"}]'
+        })
+
+        spot_scores_output = self.cmd('az compute-recommender spot-placement-score -l {location} --subscription {subscription_id} --availability-zones {availability_zones} --desired-locations \'{desired_locations}\' --desired-count {desired_count} --desired-sizes \'{desired_sizes}\'').get_output_in_json()
+
         self.assertTrue(len(spot_scores_output["placementScores"]) > 0, "Spot scores should have at least one item")