Skip to content

[Python] TypeSpec migration for azure-mgmt-authorization#46179

Draft
ChenxiJiang333 wants to merge 6 commits intoAzure:mainfrom
ChenxiJiang333:sdk-azure-mgmt-authorization
Draft

[Python] TypeSpec migration for azure-mgmt-authorization#46179
ChenxiJiang333 wants to merge 6 commits intoAzure:mainfrom
ChenxiJiang333:sdk-azure-mgmt-authorization

Conversation

@ChenxiJiang333
Copy link
Copy Markdown
Member

[Python] TypeSpec migration for azure-mgmt-authorization

Spec PR: Azure/azure-rest-api-specs#41617

Pre-migration swagger source: specification/authorization/resource-manager@31fb4b3e

Default tag package-2025-12-01-preview contains multiple API versions: 2015-07-01 / 2021-12-01-preview / 2022-04-01 / 2022-05-01-preview / 2022-08-01-preview / 2024-07-01-preview / 2024-09-01-preview / 2025-12-01-preview

Breaking Change Analysis

Summary

  • 1 mitigated (client name)
  • ~199 accepted (flattening removal, model deletions, parameter changes)

Mitigated Breaking Changes

Breaking Change Classification Mitigation
Deleted or renamed client AuthorizationManagementClient MITIGATE (Guide #4) @@clientName(Microsoft.AuthorizationCombinedClient, "AuthorizationManagementClient", "python")

Spec mitigation PR: mcgallan/azure-rest-api-specs#4

Accepted Breaking Changes

Removal of multi-level flattened properties (Guide #11) — ~170 items

Models that had deeply flattened properties from sub-objects exposed at the top level now properly nest them under properties, principal, resource, reviewed_by, applied_by, settings, scope, recurrence, etc. Affected models include:

  • AccessReviewDecision, AccessReviewDecisionInsight, AccessReviewDecisionProperties
  • AccessReviewDefaultSettings, AccessReviewHistoryDefinition, AccessReviewHistoryDefinitionProperties
  • AccessReviewInstance, AccessReviewScheduleDefinition, AccessReviewScheduleDefinitionProperties
  • AccessReviewScheduleSettings, AlertConfiguration, AlertIncident
  • RoleAssignmentCreateParameters

Removal of filter/unreferenced models (Guide #7) — 15 items

  • DenyAssignmentFilter, DenyAssignmentPrincipalType
  • ErrorDetailAutoGenerated, ErrorResponseAutoGenerated
  • PermissionGetResult
  • RoleAssignmentFilter, RoleAssignmentScheduleFilter, RoleAssignmentScheduleInstanceFilter, RoleAssignmentScheduleRequestFilter
  • RoleDefinitionFilter
  • RoleEligibilityScheduleFilter, RoleEligibilityScheduleInstanceFilter, RoleEligibilityScheduleRequestFilter
  • ValidationResponse, ValidationResponseErrorInfo

Enum value restructuring — 1 item

  • UserType.SERVICE_PRINCIPAL removed — TypeSpec correctly separates two distinct UserType definitions from the spec. ServicePrincipal is now in CommonUserType.

Parameters changed to keyword-only (Guide #9) — 10 items

  • Various parameters in ProviderOperationsMetadataOperations and RoleAssignmentsOperations changed from positional to keyword-only.

Parameter default value changes — 2 items

  • ProviderOperationsMetadataOperations.get/list parameter expand default changed from str to none.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant