TypeSpec Assessment

Apply an API-version-wide change

TypeSpec source diff: 2991970c5377110244bcf9614be03e5aaf32362f → b209254310b3e569b16210d3c59fc8b8ac3b84b4

ⓘ
Semantic intents
1 intent
109 operations
0 Added, 1 Modified, 0 Removed
✓
Azure Guidelines
0 findings
0/0 intents assessed
✓
REST breaking changes
0 findings
✓
Downstream breaking changes
0 findings
✓
Documentation Completeness
0 findings
0 declarations checked
Preview NoticeThe TypeSpec Assessment Assistant is in preview; official validation and review remain the source of truth.

The TypeSpec Assessment Assistant is currently in preview. Its goal is to help service developers build confidence earlier in the TypeSpec authoring workflow by providing contextual analysis, risk identification, and guidance on potential downstream impacts.

This report is intended as a review reference and learning aid only. It does not replace official ARM API, Azure API Stewardship, Azure Breaking Change reviews, and should not be treated as authoritative review feedback or approval for specification changes. Official validation tools, generated artifacts, and reviewer feedback remain the source of truth for merge and release decisions.

Semantic intents

Impact links are visible at a glance; expand for changed TypeSpec source, followed by affected operations.

1 intents · 0 added · 1 modified · 0 removed
Apply an API-version-wide changeCovers 109 affected operations. This API-version-wide intent is reported deterministically and is not used for inference, guideline findings, or breaking-change relationships.
modify
Changed TypeSpec source (1)
specification/deviceregistry/DeviceRegistry.Management/main.tsp
   v2026_04_01: "2026-04-01",
 
   @doc("Microsoft.DeviceRegistry Resource Provider management API version 2026-11-01-preview.")
-  @armCommonTypesVersion(Azure.ResourceManager.CommonTypes.Versions.v6)
+  @armCommonTypesVersion(Azure.ResourceManager.CommonTypes.Versions.v5)
   v2026_11_01_preview: "2026-11-01-preview",
 
   @doc("Microsoft.DeviceRegistry Resource Provider management API version 2026-11-02-preview.")
   @Azure.Core.previewVersion
-  @armCommonTypesVersion(Azure.ResourceManager.CommonTypes.Versions.v6)
+  @armCommonTypesVersion(Azure.ResourceManager.CommonTypes.Versions.v5)
   v2026_11_02_preview: "2026-11-02-preview",
 }

specification/deviceregistry/DeviceRegistry.Management/main.tsp:42

Affected operations (109)

Showing 10 operation cards; the remaining 99 are listed below.

AssetEndpointProfiles_CreateOrReplacePUT/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DeviceRegistry/assetEndpointProfiles/{assetEndpointProfileName}2026-11-02-preview

HTTP signature and represented payload contract unchanged.

AssetEndpointProfiles_DeleteDELETE/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DeviceRegistry/assetEndpointProfiles/{assetEndpointProfileName}2026-11-02-preview

HTTP signature and represented payload contract unchanged.

AssetEndpointProfiles_GetGET/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DeviceRegistry/assetEndpointProfiles/{assetEndpointProfileName}2026-11-02-preview

HTTP signature and represented payload contract unchanged.

AssetEndpointProfiles_ListByResourceGroupGET/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DeviceRegistry/assetEndpointProfiles2026-11-02-preview

HTTP signature and represented payload contract unchanged.

AssetEndpointProfiles_ListBySubscriptionGET/subscriptions/{subscriptionId}/providers/Microsoft.DeviceRegistry/assetEndpointProfiles2026-11-02-preview

HTTP signature and represented payload contract unchanged.

AssetEndpointProfiles_UpdatePATCH/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DeviceRegistry/assetEndpointProfiles/{assetEndpointProfileName}2026-11-02-preview

HTTP signature and represented payload contract unchanged.

Assets_CreateOrReplacePUT/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DeviceRegistry/assets/{assetName}2026-11-02-preview

HTTP signature and represented payload contract unchanged.

Assets_DeleteDELETE/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DeviceRegistry/assets/{assetName}2026-11-02-preview

HTTP signature and represented payload contract unchanged.

Assets_GetGET/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DeviceRegistry/assets/{assetName}2026-11-02-preview

HTTP signature and represented payload contract unchanged.

Assets_ListByResourceGroupGET/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DeviceRegistry/assets2026-11-02-preview

HTTP signature and represented payload contract unchanged.

Other affected operations (99)

Assets_ListBySubscription (GET, 2026-11-02-preview); Assets_Update (PATCH, 2026-11-02-preview); AsyncOperationStatus_Get (GET, 2026-11-02-preview); BillingContainers_Get (GET, 2026-11-02-preview); BillingContainers_ListBySubscription (GET, 2026-11-02-preview); CertificateAuthorities_Activate (POST, 2026-11-02-preview); CertificateAuthorities_CreateOrReplace (PUT, 2026-11-02-preview); CertificateAuthorities_Delete (DELETE, 2026-11-02-preview); CertificateAuthorities_Get (GET, 2026-11-02-preview); CertificateAuthorities_ListByNamespace (GET, 2026-11-02-preview); CertificateAuthorities_RevokeAndRotate (POST, 2026-11-02-preview); CertificateAuthorities_Update (PATCH, 2026-11-02-preview); CertificatePolicies_CreateOrUpdate (PUT, 2026-11-02-preview); CertificatePolicies_Delete (DELETE, 2026-11-02-preview); CertificatePolicies_Get (GET, 2026-11-02-preview); CertificatePolicies_ListByCertificateAuthority (GET, 2026-11-02-preview); CertificatePolicies_Update (PATCH, 2026-11-02-preview); Groups_CountMembers (POST, 2026-11-02-preview); Groups_CreateOrReplace (PUT, 2026-11-02-preview); Groups_Delete (DELETE, 2026-11-02-preview); Groups_Get (GET, 2026-11-02-preview); Groups_ListByNamespace (GET, 2026-11-02-preview); Groups_ListMembers (POST, 2026-11-02-preview); Groups_RefreshMembers (POST, 2026-11-02-preview); Groups_Update (PATCH, 2026-11-02-preview); JobRuns_Cancel (POST, 2026-11-02-preview); JobRuns_CreateOrReplace (PUT, 2026-11-02-preview); JobRuns_Delete (DELETE, 2026-11-02-preview); JobRuns_Get (GET, 2026-11-02-preview); JobRuns_GetSummary (POST, 2026-11-02-preview); JobRuns_ListByJob (GET, 2026-11-02-preview); JobRuns_ListByNamespace (GET, 2026-11-02-preview); JobRuns_ListResults (POST, 2026-11-02-preview); Jobs_CreateOrReplace (PUT, 2026-11-02-preview); Jobs_Delete (DELETE, 2026-11-02-preview); Jobs_Get (GET, 2026-11-02-preview); Jobs_ListByNamespace (GET, 2026-11-02-preview); Jobs_Update (PATCH, 2026-11-02-preview); NamespaceAssets_CreateOrReplace (PUT, 2026-11-02-preview); NamespaceAssets_Delete (DELETE, 2026-11-02-preview); NamespaceAssets_ExecuteAction (POST, 2026-11-02-preview); NamespaceAssets_Get (GET, 2026-11-02-preview); NamespaceAssets_ListByResourceGroup (GET, 2026-11-02-preview); NamespaceAssets_Update (PATCH, 2026-11-02-preview); NamespaceDevices_CreateOrReplace (PUT, 2026-11-02-preview); NamespaceDevices_Delete (DELETE, 2026-11-02-preview); NamespaceDevices_Get (GET, 2026-11-02-preview); NamespaceDevices_ListByResourceGroup (GET, 2026-11-02-preview); NamespaceDevices_Update (PATCH, 2026-11-02-preview); NamespaceDiscoveredAssets_CreateOrReplace (PUT, 2026-11-02-preview); NamespaceDiscoveredAssets_Delete (DELETE, 2026-11-02-preview); NamespaceDiscoveredAssets_Get (GET, 2026-11-02-preview); NamespaceDiscoveredAssets_ListByResourceGroup (GET, 2026-11-02-preview); NamespaceDiscoveredAssets_Update (PATCH, 2026-11-02-preview); NamespaceDiscoveredDevices_CreateOrReplace (PUT, 2026-11-02-preview); NamespaceDiscoveredDevices_Delete (DELETE, 2026-11-02-preview); NamespaceDiscoveredDevices_Get (GET, 2026-11-02-preview); NamespaceDiscoveredDevices_ListByResourceGroup (GET, 2026-11-02-preview); NamespaceDiscoveredDevices_Update (PATCH, 2026-11-02-preview); Namespaces_CreateOrReplace (PUT, 2026-11-02-preview); Namespaces_Delete (DELETE, 2026-11-02-preview); Namespaces_GenerateReport (POST, 2026-11-02-preview); Namespaces_Get (GET, 2026-11-02-preview); Namespaces_GetLatestReport (POST, 2026-11-02-preview); Namespaces_ListByResourceGroup (GET, 2026-11-02-preview); Namespaces_ListBySubscription (GET, 2026-11-02-preview); Namespaces_Migrate (POST, 2026-11-02-preview); Namespaces_Update (PATCH, 2026-11-02-preview); Operations_List (GET, 2026-11-02-preview); OperationStatus_Get (GET, 2026-11-02-preview); RegistryDeviceAttributes_CreateOrReplace (PUT, 2026-11-02-preview); RegistryDeviceAttributes_Delete (DELETE, 2026-11-02-preview); RegistryDeviceAttributes_Get (GET, 2026-11-02-preview); RegistryDeviceAttributes_ListByDevice (GET, 2026-11-02-preview); RegistryDeviceAuthenticationProfiles_Get (GET, 2026-11-02-preview); RegistryDeviceAuthenticationProfiles_GetKeys (POST, 2026-11-02-preview); RegistryDeviceAuthenticationProfiles_ListByDevice (GET, 2026-11-02-preview); RegistryDeviceAuthenticationProfiles_RevokeCertificates (POST, 2026-11-02-preview); RegistryDeviceCapabilities_Get (GET, 2026-11-02-preview); RegistryDeviceCapabilities_ListByDevice (GET, 2026-11-02-preview); RegistryDevices_CreateOrReplace (PUT, 2026-11-02-preview); RegistryDevices_Delete (DELETE, 2026-11-02-preview); RegistryDevices_Get (GET, 2026-11-02-preview); RegistryDevices_ListByNamespace (GET, 2026-11-02-preview); RegistryDevices_Update (PATCH, 2026-11-02-preview); SchemaRegistries_CreateOrReplace (PUT, 2026-11-02-preview); SchemaRegistries_Delete (DELETE, 2026-11-02-preview); SchemaRegistries_Get (GET, 2026-11-02-preview); SchemaRegistries_ListByResourceGroup (GET, 2026-11-02-preview); SchemaRegistries_ListBySubscription (GET, 2026-11-02-preview); SchemaRegistries_Update (PATCH, 2026-11-02-preview); Schemas_CreateOrReplace (PUT, 2026-11-02-preview); Schemas_Delete (DELETE, 2026-11-02-preview); Schemas_Get (GET, 2026-11-02-preview); Schemas_ListBySchemaRegistry (GET, 2026-11-02-preview); SchemaVersions_CreateOrReplace (PUT, 2026-11-02-preview); SchemaVersions_Delete (DELETE, 2026-11-02-preview); SchemaVersions_Get (GET, 2026-11-02-preview); SchemaVersions_ListBySchema (GET, 2026-11-02-preview).

Azure Guidelines

Findings and affected intents at a glance; expand for expected guidance and actual changes.

passed0 findings

0 of 0 semantic intents assessed · 0 documents selected

No Azure Guidelines findings.

REST breaking changes

Operation impact and affected intents at a glance; expand for before/after evidence.

passed0 operations · 0 findings
No confirmed REST breaking changes.

Downstream breaking changes

Method impact and affected intents at a glance; expand for before/after evidence.

passed0 mapped methods · 0 changed types
No downstream breaking changes detected.

Documentation Completeness

Checks only whether newly added operation, model, enum, and interface declarations have a nonempty effective TypeSpec description.

passed

0 findings · 0 declarations checked

Appendix

Potential limits

None

Projects and compiler status

ProjectModeBaseline commit@versionTarget commit@versionBaseline AutoRest / TCGCTarget AutoRest / TCGC
specification/deviceregistry/DeviceRegistry.Managementexisting-api-version2991970c5377110244bcf9614be03e5aaf32362f@2026-11-02-preview
base · affected-existing-version		b209254310b3e569b16210d3c59fc8b8ac3b84b4@2026-11-02-preview
current · affected-existing-version		succeeded / succeededsucceeded / succeeded

Pull request: Not available for this local pre-PR assessment.

Guidance fetched

No guidance fetched.
Guidance coverage and retrieval evidence
{
  "status": "passed",
  "coverage": {
    "semanticIntentCount": 0,
    "assessedIntentCount": 0,
    "selectedDocumentCount": 0,
    "unassessedIntentIds": []
  },
  "intentAssessments": [],
  "retrievalFailures": [],
  "blockers": []
}

Changed files

  • specification/deviceregistry/DeviceRegistry.Management/main.tsp (committed)

Timing and model input

{
  "timings": {
    "metadataMs": 987,
    "fetchMs": 134,
    "scopeDiscoveryMs": 65,
    "setupExcludingFetchMs": 6673,
    "comparisonMs": 115,
    "changeDiscoveryMs": 77,
    "workspacePreparationMs": 5194,
    "projectDiscoveryMs": 46,
    "totalMs": 85628,
    "semanticAnalysisMs": 241,
    "restAnalysisMs": 141,
    "downstreamAnalysisMs": 4302,
    "documentQualityAnalysisMs": 0
  },
  "inputAccounting": {
    "budgetTier": "small",
    "budgetBytes": 131072,
    "bytes": 2432,
    "estimatedTokens": 608,
    "retained": {
      "evidenceSets": 0,
      "facts": 0,
      "semanticReviewUnits": 0,
      "restCandidates": 0,
      "downstreamCandidates": 0,
      "downstreamRootCauses": 0,
      "complianceSearchRequests": 0,
      "inferenceRequests": 0
    },
    "omittedRedundant": {
      "rawEmitterArtifacts": true,
      "compilerLogs": true,
      "unchangedInventories": true,
      "unreferencedFacts": true,
      "unreferencedDeterministicFacts": true,
      "sourceChanges": true,
      "repeatedDeclarationIds": true,
      "repeatedReviewUnitEvidence": true
    }
  }
}

Provenance: model-input.json, dimensions/document-quality-input.json, assessment-judgment.json, preparation-manifest.json