List recommendations for an Azure analysis

curl --request GET \
  --url https://{host}/analysis/cloud/azure/{analysisId}/results

[
  {
    "entityId": "12345",
    "resourceId": "/subscriptions/cc377154.../resourceGroups/rg/providers/Microsoft.Compute/virtualMachines/vm01",
    "accountIdRef": "cc377154-9605-4cb0-8b41-1b39e1c4ac0f",
    "region": "eastus",
    "currentType": "Standard_D2s_v3",
    "recommendationType": "Downsize",
    "recommendedType": "Standard_B2s",
    "implementationMethod": "Manual",
    "predictedUptime": "98.5",
    "totalHoursRunning": "712",
    "totalHours": "720",
    "name": "vm01",
    "rptHref": "https://{host}/reports/impact?entityId=12345",
    "approvalType": "na",
    "densifyPolicy": "Default Azure Policy",
    "savingsEstimate": "24.50",
    "serviceType": "Virtual Machine",
    "currentHourlyRate": "0.096",
    "recommendedHourlyRate": "0.062",
    "recommFirstSeen": 1715731200000,
    "recommLastSeen": 1718323200000,
    "recommSeenCount": 4,
    "auditInfo": {
      "dataCollection": {
        "dateFirstAudited": 1713312000000,
        "dateLastAudited": 1718323200000,
        "auditCount": 31
      },
      "workloadDataLast30": {
        "firstDate": 1715731200000,
        "lastDate": 1718323200000,
        "totalDays": 30,
        "seenDays": 29
      }
    },
    "dataQuality": [
      {
        "workloadName": "CPU Utilization (CINT2006 Rate)",
        "firstSeen": 1715731200000,
        "lastSeen": 1718323200000,
        "completeDays": 28,
        "partialDays": 1
      }
    ],
    "attributes": [
      {
        "id": "attr-1",
        "name": "Environment",
        "value": "prod"
      }
    ]
  }
]

Azure: Recommendations

List recommendations for an Azure analysis

Returns Azure recommendations for a completed analysis.

Content negotiation

Accept: application/json → JSON recommendation objects
Accept: application/terraform-map → Terraform-map objects

Filtering

Element-based filters are supplied as ordinary query pairs named after fields (e.g., recommendationType=Upsize). Not all fields are filterable.

Attributes/data quality

includeAttributes=true returns the attributes array.
dataQuality accepts a quoted, comma-separated list of workload names.

GET

analysis

cloud

azure

{analysisId}

results

List recommendations for an Azure analysis

curl --request GET \
  --url https://{host}/analysis/cloud/azure/{analysisId}/results

[
  {
    "entityId": "12345",
    "resourceId": "/subscriptions/cc377154.../resourceGroups/rg/providers/Microsoft.Compute/virtualMachines/vm01",
    "accountIdRef": "cc377154-9605-4cb0-8b41-1b39e1c4ac0f",
    "region": "eastus",
    "currentType": "Standard_D2s_v3",
    "recommendationType": "Downsize",
    "recommendedType": "Standard_B2s",
    "implementationMethod": "Manual",
    "predictedUptime": "98.5",
    "totalHoursRunning": "712",
    "totalHours": "720",
    "name": "vm01",
    "rptHref": "https://{host}/reports/impact?entityId=12345",
    "approvalType": "na",
    "densifyPolicy": "Default Azure Policy",
    "savingsEstimate": "24.50",
    "serviceType": "Virtual Machine",
    "currentHourlyRate": "0.096",
    "recommendedHourlyRate": "0.062",
    "recommFirstSeen": 1715731200000,
    "recommLastSeen": 1718323200000,
    "recommSeenCount": 4,
    "auditInfo": {
      "dataCollection": {
        "dateFirstAudited": 1713312000000,
        "dateLastAudited": 1718323200000,
        "auditCount": 31
      },
      "workloadDataLast30": {
        "firstDate": 1715731200000,
        "lastDate": 1718323200000,
        "totalDays": 30,
        "seenDays": 29
      }
    },
    "dataQuality": [
      {
        "workloadName": "CPU Utilization (CINT2006 Rate)",
        "firstSeen": 1715731200000,
        "lastSeen": 1718323200000,
        "completeDays": 28,
        "partialDays": 1
      }
    ],
    "attributes": [
      {
        "id": "attr-1",
        "name": "Environment",
        "value": "prod"
      }
    ]
  }
]

Path Parameters

analysisId

string

required

Unique ID of the Azure analysis.

Query Parameters

includeAttributes

boolean

default:false

Return system attributes when true.

dataQuality

string

Quoted, comma-separated workload type names to include in the dataQuality block (e.g., "CPU Utilization (CINT2006 Rate),Memory Utilization in Percent").

recommendationType

string

Filter by recommendation action (e.g., Upsize, Downsize, Modernize, Just Right, Terminate, etc.).

region

string

Filter by Azure region.

currentType

string

Filter by current instance type.

serviceType

string

Filter by service type (Virtual Machine or VM Scale Set).

name

string

Filter by system name.

entityId

string

Filter by Kubex entity ID.

accountIdRef

string

Filter by Azure subscription ID.

Response

Collection of recommendations

accountIdRef

string

Azure subscription identifier.

approvalType

string

Approval setting for the recommendation.

attributes

object[]

Only returned when includeAttributes=true.

Show child attributes

auditInfo

object

Show child attributes

currentCost

string

currentHourlyRate

string

currentType

string

dataQuality

object[]

Show child attributes

densifyPolicy

string

effortEstimate

enum<string>

Available options:

Moderate,

Low,

Very Low,

None,

Impossible

entityId

string

implementationMethod

string

Self-Optimization status. Not returned for VMSS with more than one VM instance.

name

string

powerState

string

Not available for VMSS.

predictedUptime

string

region

string

resourceId

string

recommendationType

string

Recommended action (e.g., Just Right, Upsize, Downsize, Modernize, Terminate, Not Analyzed; for VMSS also Upscale/Downscale).

recommendedCost

string

recommendedHostEntityId

string

recommendedType

string

recommFirstSeen

integer<int64>

recommLastSeen

integer<int64>

recommSeenCount

integer

rptHref

string<uri>

Link to Impact Analysis and Recommendation Report PDF. Use Accept: application/octet-stream to download.

savingsEstimate

string

serviceType

enum<string>

Available options:

Virtual Machine,

VM Scale Set

totalHours

string

totalHoursRunning

string

autoScaling

object

avgInstanceCountCurrent

number

avgInstanceCountRecommended

number

minGroupCurrent

integer

minGroupRecommended

integer

maxGroupCurrent

integer

maxGroupRecommended

integer

orchestrationMode

string

profiles

object[]

scalingPolicies

object[]

Analysis: Azure Recommendations Analysis: GCP Analyze

⌘I