99 curated breaking changes across major versions of azure.core. Use this as a migration checklist before bumping dependencies.
Some breaking change
Some breaking change
Some breaking change
Some breaking change
Some breaking change
Some breaking change
Some breaking change
Deleted or renamed enum value `PrivateEndpointProvisioningState.APPROVING`
Deleted or renamed enum value `PrivateEndpointProvisioningState.DROPPING`
Deleted or renamed enum value `PrivateEndpointProvisioningState.READY`
Deleted or renamed enum value `PrivateEndpointProvisioningState.REJECTING`
Deleted or renamed method `ServiceGroupsOperations.list_ancestors`
Deleted or renamed model `ServiceGroupCollectionResponse`
Model `MigrationConfigProperties` moved instance variable `provisioning_state`, `pending_replication_operations_count`, `target_namespace`, `post_migration_name` and `migration_state` under property `properties` whose type is `MigrationConfigPropertiesProperties`
Model `NetworkRuleSet` moved instance variable `trusted_service_access_enabled`, `default_action`, `virtual_network_rules`, `ip_rules` and `public_network_access` under property `properties` whose type is `NetworkRuleSetProperties`
Model `PrivateEndpointConnection` moved instance variable `private_endpoint`, `private_link_service_connection_state` and `provisioning_state` under property `properties` whose type is `PrivateEndpointConnectionProperties`
Model `ArmDisasterRecovery` moved instance variable `provisioning_state`, `pending_replication_operations_count`, `partner_namespace`, `alternate_name` and `role` under property `properties` whose type is `ArmDisasterRecoveryProperties`
This version introduces new hybrid models which have dual dictionary and model nature. Please follow https://aka.ms/azsdk/python/migrate/hybrid-models for migration.
Renamed operation group `MicrosoftSerialConsoleClientOperationsMixin` to `_MicrosoftSerialConsoleClientOperationsMixin`
Model `EnableSerialConsoleResult` moved instance variable `disabled` under property `properties` whose type is `EnableSerialConsoleResultProperties`
Model `DisableSerialConsoleResult` moved instance variable `disabled` under property `properties` whose type is `DisableSerialConsoleResultProperties`
This version introduces new hybrid models which have dual dictionary and model nature. Please follow https://aka.ms/azsdk/python/migrate/hybrid-models for migration.
Model `SerialConsoleStatus` moved instance variable `disabled` under property `properties` whose type is `SerialConsoleStatusProperties`
Model `PlatformWorkloadIdentityRoleSet` moved instance variable `open_shift_version` and `platform_workload_identity_roles` under property `properties` whose type is `PlatformWorkloadIdentityRoleSetProperties`
Model `OpenShiftClusterUpdate` moved instance variable `apiserver_profile`, `cluster_profile`, `console_profile`, `ingress_profiles`, `master_profile`, `network_profile`, `platform_workload_identity_profile`, `provisioning_state`, `service_principal_profile`, `worker_profiles` and `worker_profiles_status` under property `properties` whose type is `OpenShiftClusterProperties`
Model `OpenShiftCluster` moved instance variable `apiserver_profile`, `cluster_profile`, `console_profile`, `ingress_profiles`, `master_profile`, `network_profile`, `platform_workload_identity_profile`, `provisioning_state`, `service_principal_profile`, `worker_profiles` and `worker_profiles_status` under property `properties` whose type is `OpenShiftClusterProperties`
This version introduces new hybrid models which have dual dictionary and model nature. Please follow https://aka.ms/azsdk/python/migrate/hybrid-models for migration.
Model `OpenShiftVersion` moved instance variable `version` under property `properties` whose type is `OpenShiftVersionProperties`
Model `AzureWorkloadSAPAsePointInTimeRecoveryPoint` deleted or renamed its instance variable `recovery_point_properties`
Model `AzureWorkloadSAPAsePointInTimeRecoveryPoint` deleted or renamed its instance variable `recovery_point_tier_details`
Model `AzureWorkloadSAPAsePointInTimeRecoveryPoint` deleted or renamed its instance variable `recovery_point_move_readiness_info`
For the method breakings, please refer to https://aka.ms/azsdk/python/migrate/operations for migration.
This version introduces new hybrid models which have dual dictionary and model nature. Please follow https://aka.ms/azsdk/python/migrate/hybrid-models for migration.
Model `BareMetalMachine` moved instance variable `action_states`, `associated_resource_ids`, `bmc_connection_string`, `bmc_credentials`, `bmc_mac_address`, `boot_mac_address`, `ca_certificate`, `cluster_id`, `cordon_status`, `detailed_status`, `detailed_status_message`, `hardware_inventory`, `hardware_validation_status`, `hybrid_aks_clusters_associated_ids`, `kubernetes_node_name`, `kubernetes_version`, `machine_cluster_version`, `machine_details`, `machine_name`, `machine_roles`, `machine_sku_i
This version introduces new hybrid models which have dual dictionary and model nature. Please follow https://aka.ms/azsdk/python/migrate/hybrid-models for migration.
For the method breakings, please refer to https://aka.ms/azsdk/python/migrate/operations for migration.
Model `AgentPool` moved instance variable `administrator_configuration`, `agent_options`, `attached_network_configuration`, `availability_zones`, `count`, `detailed_status`, `detailed_status_message`, `kubernetes_version`, `labels`, `mode`, `provisioning_state`, `taints`, `upgrade_settings` and `vm_sku_name` under property `properties` whose type is `AgentPoolProperties`
Model `AgentPoolPatchParameters` moved instance variable `administrator_configuration`, `count` and `upgrade_settings` under property `properties` whose type is `AgentPoolPatchProperties`
Renamed method `ServiceGatewaysOperations.begin_update_services` to `update_services`
Renamed method `ServiceGatewaysOperations.begin_update_address_locations` to `update_address_locations`
Deleted or renamed enum value `IotHubSkuTier.GENERATION2`
Deleted or renamed enum value `IotHubSku.GEN2`
Model `ConnectedCluster` moved instance variable `agent_public_key_certificate`, `agent_version`, `connectivity_status`, `distribution`, `infrastructure`, `kubernetes_version`, `last_connectivity_time`, `managed_identity_certificate_expiration_time`, `offering`, `provisioning_state`, `total_core_count` and `total_node_count` under property `properties` whose type is `ConnectedClusterProperties`
This version introduces new hybrid models which have dual dictionary and model nature. Please follow https://aka.ms/azsdk/python/migrate/hybrid-models for migration.
Operation group `ConnectedClusterOperations` renamed method `update` to `begin_update_async`
Model `SystemData` renamed type of property `last_modified_by_type` from `LastModifiedByType` to `CreatedByType`
Operation group `ConnectedClusterOperations` renamed method `begin_create` to `begin_create_or_replace`
Deleted or renamed model `Identity`
Deleted or renamed model `ResourceIdentityType`
Model `AccessRule` moved instance variable `address_prefixes` and `direction` under property `properties` whose type is `AccessRuleProperties`
For the method breakings, please refer to https://aka.ms/azsdk/python/migrate/operations for migration.
This version introduces new hybrid models which have dual dictionary and model nature. Please follow https://aka.ms/azsdk/python/migrate/hybrid-models for migration.
Model `License` moved instance variable `license_details`, `license_type`, `provisioning_state` and `tenant_id` under property `properties` whose type is `LicenseProperties`
Model `ExtensionValue` moved instance variable `extension_type`, `publisher` and `version` under property `properties` whose type is `ExtensionValueProperties`
Deleted or renamed method `CloudHsmClusterBackupStatusOperations.begin_get`
Deleted or renamed method `CloudHsmClusterRestoreStatusOperations.begin_get`
For the method breakings, please refer to https://aka.ms/azsdk/python/migrate/operations for migration.
Method `CreationSupportedOperations.get` changed its parameter `datadog_organization_id` from `positional_or_keyword` to `keyword_only`
Method `CreationSupportedOperations.list` changed its parameter `datadog_organization_id` from `positional_or_keyword` to `keyword_only`
This version introduces new hybrid models which have dual dictionary and model nature. Please follow https://aka.ms/azsdk/python/migrate/hybrid-models for migration.
Model `AutoUpgradeProfile` moved instance variable `auto_upgrade_profile_status`, `channel`, `disabled`, `node_image_selection`, `provisioning_state` and `update_strategy_id` under property `properties` whose type is `AutoUpgradeProfileProperties`
Model `Fleet` moved instance variable `hub_profile`, `provisioning_state` and `status` under property `properties` whose type is `FleetProperties`
Model `FleetMember` moved instance variable `cluster_resource_id`, `group`, `provisioning_state` and `status` under property `properties` whose type is `FleetMemberProperties`
For the method breakings, please refer to https://aka.ms/azsdk/python/migrate/operations for migration.
This version introduces new hybrid models which have dual dictionary and model nature. Please follow https://aka.ms/azsdk/python/migrate/hybrid-models for migration.
Model `BudgetComparisonExpression` renamed its instance variable `values` to `values_property`
Model `Budget` moved instance variable `amount`, `category`, `current_spend`, `filter`, `forecast_spend`, `notifications`, `time_grain` and `time_period` under property `properties` whose type is `BudgetProperties`
Model `Balance` moved instance variable `adjustment_details`, `adjustments`, `azure_marketplace_service_charges`, `beginning_balance`, `billing_frequency`, `charges_billed_separately`, `currency`, `ending_balance`, `new_purchases`, `new_purchases_details`, `price_hidden`, `service_overage`, `total_overage`, `total_usage` and `utilized` under property `properties` whose type is `BalanceProperties`
For the method breakings, please refer to https://aka.ms/azsdk/python/migrate/operations for migration.
Deleted or renamed enum value `ActionType.HIBERNATE`
Deleted or renamed enum value `ActionType.START`
Model `ResourceProvisionPayload` renamed its instance variable `base_profile` to `virtual_machine_base_profile`
Model `ResourceProvisionPayload` renamed its instance variable `resource_overrides` to `virtual_machine_overrides`
Deleted or renamed enum value `ActionType.DEALLOCATE`
Renamed enum `RecurringScheduledActionsDeadlineType` to `ScheduledActionsDeadlineType`
Renamed model `RecurringScheduledActionsExecutionParameters` to `ScheduledActionsExecutionParameters`
Renamed enum `RecurringScheduledActionsProvisioningState` to `ScheduledActionsProvisioningState`
Renamed enum `RecurringScheduledActionsResourceOperationType` to `ScheduledActionsResourceOperationType`
Renamed model `RecurringScheduledActionsRetryPolicy` to `ScheduledActionsRetryPolicy`
Model `ScenarioConfigurationProperties` deleted or renamed its instance variable `exclusions`
Model `ScenarioConfigurationProperties` deleted or renamed its instance variable `filters`
Model `WorkspaceEvaluationProperties` deleted or renamed its instance variable `num_scenarios_evaluated_cancelled`
Model `WorkspaceEvaluationProperties` deleted or renamed its instance variable `num_scenarios_evaluated_failed`
Model `WorkspaceEvaluationProperties` deleted or renamed its instance variable `num_scenarios_evaluated_succeeded`
**Default API Version Update**: Changed the SDK default API version from `2026-06-01-preview` to the GA version `2026-07-15`. Pass `api_version="2026-06-01-preview"` explicitly to keep the previous default behavior.
Renamed class `TaskGenerationDataGenerationJobOptions` to `SimulationSeedDataGenerationJobOptions`. The corresponding `DataGenerationJobType.TASK_GENERATION` enum member was renamed to `DataGenerationJobType.SIMULATION_SEED`, and its wire value changed from `task_generation` to `simulation_seed`.
Renamed enum `OptimizationDatasetInputType` to `AgentOptimizationDatasetInputType`.
Renamed class `OptimizationAgentIdentifier` to `OptimizedAgentIdentifier`.
Renamed class `OptimizationCandidate` to `AgentOptimizationCandidate`.
Methods `.beta.routines.list` and `.beta.routines.list_runs` replaced the `before` argument with `after` and now use the service-provided `next_link` for continuation.
Method `.beta.datasets.create_generation_job` renamed to `.beta.datasets.begin_create_generation_job` and is now a long-running operation returning `LROPoller[DataGenerationJobResult]`.
Method `.beta.agents.create_optimization_job` renamed to `.beta.agents.begin_create_optimization_job` and is now a long-running operation returning `LROPoller[OptimizationJobResult]`.
Method `.beta.evaluators.create_generation_job` renamed to `.beta.evaluators.begin_create_generation_job` and is now a long-running operation returning `LROPoller[EvaluatorVersion]` (previously returned `EvaluatorGenerationJob`).
Removed `ResponseContext.conversation_chain_metadata` and the `ConversationChainMetadataNamespace` protocol. Resilient response applications now persist cross-turn state explicitly with `FoundryStateStore`.
Removed the duplicate `azure.ai.agentserver.responses.get_input_expanded` export. Import it from `azure.ai.agentserver.responses.models` instead.
Removed `TaskMetadata`, `TaskContext.metadata`, and `TaskRun.metadata`. Durable application state now belongs in an explicit `FoundryStateStore` and no longer shares task lifecycle PATCHes or lease renewal. Typed task inputs may carry a top-level `call_id`, which the framework restores in `FoundryAgentRequestContext` for every handler attempt.
Removed the unused public `AgentServerHost.sse_keepalive_stream` helper.
Removed the `POST /api/messages` route alias. Inbound activities are served only at `POST /activity/messages`, which is the endpoint the Foundry platform routes to. Callers that posted to `/api/messages` must use `/activity/messages`.
Removed public SSE keepalive helper.
Get this data programmatically \u2014 free, no authentication.
curl https://depscope.dev/api/breaking/pypi/azure.core