SuperAPI AI Directory
Partner with us中文AI newsFavorites
Skillsget-migration-assessment

get-migration-assessment

Data & analytics

View repository

Updated 10-16 00:31

About this skill

Get Migration Assessment

These claims were checked on 2026-09-15 against the bundled skill-contract.yml, Azure Resource Graph query contract, response schema, and assessment output contract.

When to Use

Use for existing Azure SQL Server assessment, readiness, blocker, SKU, and cost data. This skill does not trigger a new assessment.

Workflow

Step 1: Resolve Inputs

Use ARM resource identification when inputs are missing. Reuse identifiers already in context. Confirm a defaulted subscription by display name and ID.

Step 2: Query Instance Data

Build and execute the instance query from references/arg-queries.md when retrieving server-level data.

Step 3: Query Database Data

When retrieving database-level data, build and execute the database query from references/arg-queries.md for every returned instance.

Step 4: Interpret Results

Use references/response-schema.md when interpreting results. For every NotReady target, identify the server or database blocker. If blocker details are unavailable, report a data gap.

If assessment data or assessmentUploadTime is missing, state that no migration assessment data is available and identify likely causes: it has not been enabled or run, results have not uploaded, the agent is not configured, or permissions are insufficient.

Step 5: Render Results

Use assessment output when rendering the combined readiness and SKU recommendation.

  • Multiple instances -> show a summary table, then render each instance.

For multiple instances, include aggregate readiness, cost, and common blocker insights when the returned data supports them.

Check it worked

  • Both query phases completed for every instance.
  • Pagination completed.
  • Every NotReady result has a cause or data-gap note.
  • Missing settings or readiness are stated explicitly.
  • Cleanup verification: Clear the in-memory ARM token and confirm no temporary request body or response file remains unless the user asked to retain it.

Notes

  • Use ARG as the assessment read transport.
  • Execute queries through the curl adapter in references/arg-queries.md whenever requesting ARG data.
  • Exclude master, model, msdb, and tempdb.
  • Show subscription display name with its ID.
  • Follow the output template exactly.

Error Handling

  • 401/403 -> verify Azure CLI login and read permission on the target scope.
  • 429 -> honor Retry-After; report persistent throttling.
  • Invalid resource URI -> show the expected Azure SQL Server instance resource-ID format.
  • Empty result -> show the subscription display name/ID and resource group that were searched.

References