Microsoft Azure SDK for Python

This is the Microsoft Azure Containerservicefleet Management Client Library. This package has been tested with Python 3.10+. For a more complete view of Azure libraries, see the azure sdk python release.

Disclaimer

Azure SDK Python packages support for Python 2.7 has ended 01 January 2022. For more information and questions, please refer to https://github.com/Azure/azure-sdk-for-python/issues/20691

Getting started

Prerequisites

• Python 3.10+ is required to use this package.
• Azure subscription

Install the package

pip install azure-mgmt-containerservicefleet
pip install azure-identity

Authentication

By default, Microsoft Entra token authentication depends on correct configuration of the following environment variables.

• AZURE_CLIENT_ID for Azure client ID.
• AZURE_TENANT_ID for Azure tenant ID.
• AZURE_CLIENT_SECRET for Azure client secret.

In addition, Azure subscription ID can be configured via environment variable AZURE_SUBSCRIPTION_ID.

With above configuration, client can be authenticated by following code:

from azure.identity import DefaultAzureCredential
from azure.mgmt.containerservicefleet import ContainerServiceFleetMgmtClient
import os

sub_id = os.getenv("AZURE_SUBSCRIPTION_ID")
client = ContainerServiceFleetMgmtClient(credential=DefaultAzureCredential(), subscription_id=sub_id)

Examples

Code samples for this package can be found at:

• Search Containerservicefleet Management on docs.microsoft.com
• Azure Python Mgmt SDK Samples Repo

Troubleshooting

Next steps

Provide Feedback

If you encounter any bugs or have suggestions, please file an issue in the Issues section of the project.

Release History

4.1.0b1 (2026-09-03)

Features Added

• Client ContainerServiceFleetMgmtClient added operation group cluster_mesh_profiles
• Model AutoUpgradeProfileStatus added property last_trigger_message
• Model ClusterResourcePlacementSpec added property rollout_strategy
• Model FleetManagedNamespacePatch added property properties
• Model FleetMemberProperties added property mesh_properties
• Model GateConfiguration added property scheduled_start_configuration
• Model GateProperties added property scheduled_start_properties
• Enum GateType added member SCHEDULED_START
• Model UpdateGroup added property max_allowed_failures
• Model UpdateGroup added property member_selector
• Model UpdateGroupStatus added property failure_count
• Model UpdateGroupStatus added property max_allowed_failures
• Model UpdateRunStatus added property failure_count
• Model UpdateStage added property max_allowed_failures
• Model UpdateStage added property member_selector
• Model UpdateStageStatus added property failure_count
• Model UpdateStageStatus added property max_allowed_failures
• Enum UpgradeChannel added member SECURITY_PATCH
• Added model AffinityPatch
• Added model CiliumProperties
• Added model ClusterAffinityPatch
• Added model ClusterMeshProfile
• Added model ClusterMeshProfileProperties
• Added enum ClusterMeshProfileProvisioningState
• Added model ClusterMeshProfileStatus
• Added enum ClusterMeshState
• Added model ClusterResourcePlacementSpecPatch
• Added model ClusterSelectorPatch
• Added model ClusterSelectorTermPatch
• Added model ClusterUpdateStrategyReference
• Added enum DayOfWeek
• Added model FleetManagedNamespacePropertiesPatch
• Added model LabelSelectorPatch
• Added model LabelSelectorRequirementPatch
• Added model MemberSelector
• Added enum MeshMemberState
• Added model MeshMemberStatus
• Added model MeshProperties
• Added model PlacementPolicyPatch
• Added model PlacementProfilePatch
• Added model PropagationPolicyPatch
• Added model PropertySelectorPatch
• Added model PropertySelectorRequirementPatch
• Added model RolloutStrategy
• Added enum RolloutStrategyType
• Added model ScheduledStartConfiguration
• Added model ScheduledStartProperties
• Added operation group ClusterMeshProfilesOperations

4.0.0 (2026-08-03)

Features Added

• Client ContainerServiceFleetMgmtClient added parameter cloud_setting in method __init__
• Client ContainerServiceFleetMgmtClient added method send_request
• Client ContainerServiceFleetMgmtClient added operation group fleet_managed_namespaces
• Client ContainerServiceFleetMgmtClient added operation group gates
• Model UpdateGroup added property after_gates
• Model UpdateGroup added property before_gates
• Model UpdateGroup added property max_concurrency
• Model UpdateGroupStatus added property after_gates
• Model UpdateGroupStatus added property before_gates
• Model UpdateGroupStatus added property max_concurrency
• Model UpdateStage added property after_gates
• Model UpdateStage added property before_gates
• Model UpdateStage added property max_concurrency
• Model UpdateStageStatus added property after_gates
• Model UpdateStageStatus added property before_gates
• Model UpdateStageStatus added property max_concurrency
• Enum UpdateState added member PENDING
• Enum UpgradeChannel added member TARGET_KUBERNETES_VERSION
• Added enum AdoptionPolicy
• Added model Affinity
• Added model ClusterAffinity
• Added model ClusterResourcePlacementSpec
• Added model ClusterSelector
• Added model ClusterSelectorTerm
• Added enum DeletePolicy
• Added model FleetManagedNamespace
• Added model FleetManagedNamespacePatch
• Added model FleetManagedNamespaceProperties
• Added enum FleetManagedNamespaceProvisioningState
• Added model FleetManagedNamespaceStatus
• Added model Gate
• Added model GateConfiguration
• Added model GatePatch
• Added model GatePatchProperties
• Added model GateProperties
• Added enum GateProvisioningState
• Added enum GateState
• Added model GateTarget
• Added enum GateType
• Added model LabelSelector
• Added enum LabelSelectorOperator
• Added model LabelSelectorRequirement
• Added model ManagedNamespaceProperties
• Added model NetworkPolicy
• Added model PlacementPolicy
• Added model PlacementProfile
• Added enum PlacementType
• Added enum PolicyRule
• Added model PropagationPolicy
• Added enum PropagationType
• Added model PropertySelector
• Added enum PropertySelectorOperator
• Added model PropertySelectorRequirement
• Added model ResourceQuota
• Added enum TaintEffect
• Added enum Timing
• Added model Toleration
• Added enum TolerationOperator
• Added model UpdateRunGateStatus
• Added model UpdateRunGateTargetProperties
• Operation group AutoUpgradeProfilesOperations added parameter skip_token in method list_by_fleet
• Operation group AutoUpgradeProfilesOperations added parameter top in method list_by_fleet
• Operation group FleetMembersOperations added parameter filter in method list_by_fleet
• Operation group FleetMembersOperations added parameter skip_token in method list_by_fleet
• Operation group FleetMembersOperations added parameter top in method list_by_fleet
• Operation group FleetUpdateStrategiesOperations added parameter skip_token in method list_by_fleet
• Operation group FleetUpdateStrategiesOperations added parameter top in method list_by_fleet
• Operation group FleetsOperations added parameter skip_token in method list_by_subscription
• Operation group FleetsOperations added parameter top in method list_by_subscription
• Operation group UpdateRunsOperations added parameter skip_token in method list_by_fleet
• Operation group UpdateRunsOperations added parameter top in method list_by_fleet
• Added operation group FleetManagedNamespacesOperations
• Added operation group GatesOperations

Breaking Changes

• 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 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
• Model FleetMemberUpdate moved instance variable group under property properties whose type is FleetMemberUpdateProperties
• Model FleetUpdateStrategy moved instance variable provisioning_state and strategy under property properties whose type is FleetUpdateStrategyProperties
• Model UpdateRun moved instance variable auto_upgrade_profile_id, managed_cluster_update, provisioning_state, status, strategy and update_strategy_id under property properties whose type is UpdateRunProperties
• Method AutoUpgradeProfilesOperations.begin_create_or_update replaced positional_or_keyword parameters if_match/if_none_match with keyword_only parameters etag/match_condition
• Method AutoUpgradeProfilesOperations.begin_delete replaced positional_or_keyword parameter if_match with keyword_only parameters etag/match_condition
• Method FleetMembersOperations.begin_create replaced positional_or_keyword parameters if_match/if_none_match with keyword_only parameters etag/match_condition
• Method FleetMembersOperations.begin_delete replaced positional_or_keyword parameter if_match with keyword_only parameters etag/match_condition
• Method FleetMembersOperations.begin_update replaced positional_or_keyword parameter if_match with keyword_only parameters etag/match_condition
• Method FleetUpdateStrategiesOperations.begin_create_or_update replaced positional_or_keyword parameters if_match/if_none_match with keyword_only parameters etag/match_condition
• Method FleetUpdateStrategiesOperations.begin_delete replaced positional_or_keyword parameter if_match with keyword_only parameters etag/match_condition
• Method FleetsOperations.begin_create_or_update replaced positional_or_keyword parameters if_match/if_none_match with keyword_only parameters etag/match_condition
• Method FleetsOperations.begin_delete replaced positional_or_keyword parameter if_match with keyword_only parameters etag/match_condition
• Method FleetsOperations.begin_update replaced positional_or_keyword parameter if_match with keyword_only parameters etag/match_condition
• Method UpdateRunsOperations.begin_create_or_update replaced positional_or_keyword parameters if_match/if_none_match with keyword_only parameters etag/match_condition
• Method UpdateRunsOperations.begin_delete replaced positional_or_keyword parameter if_match with keyword_only parameters etag/match_condition
• Method UpdateRunsOperations.begin_skip replaced positional_or_keyword parameter if_match with keyword_only parameters etag/match_condition
• Method UpdateRunsOperations.begin_start replaced positional_or_keyword parameter if_match with keyword_only parameters etag/match_condition
• Method UpdateRunsOperations.begin_stop replaced positional_or_keyword parameter if_match with keyword_only parameters etag/match_condition

Other Changes

• Deleted model AutoUpgradeProfileListResult/FleetListResult/FleetMemberListResult/FleetUpdateStrategyListResult/OperationListResult/UpdateRunListResult which actually were not used by SDK users

4.0.0b4 (2026-05-28)

Features Added

• Client ContainerServiceFleetMgmtClient added operation group cluster_mesh_profiles
• Model FleetMemberProperties added property mesh_properties
• Added model CiliumProperties
• Added model ClusterMeshProfile
• Added model ClusterMeshProfileProperties
• Added enum ClusterMeshProfileProvisioningState
• Added model ClusterMeshProfileStatus
• Added enum ClusterMeshState
• Added model MemberSelector
• Added enum MeshMemberState
• Added model MeshMemberStatus
• Added model MeshProperties
• Added operation group ClusterMeshProfilesOperations

4.0.0b3 (2026-03-24)

Features Added

• Model UpdateGroup added property max_concurrency
• Model UpdateGroupStatus added property max_concurrency
• Model UpdateStage added property max_concurrency
• Model UpdateStageStatus added property max_concurrency
• Operation group AutoUpgradeProfilesOperations added parameter top in method list_by_fleet
• Operation group AutoUpgradeProfilesOperations added parameter skip_token in method list_by_fleet
• Operation group FleetMembersOperations added parameter top in method list_by_fleet
• Operation group FleetMembersOperations added parameter skip_token in method list_by_fleet
• Operation group FleetMembersOperations added parameter filter in method list_by_fleet
• Operation group FleetUpdateStrategiesOperations added parameter top in method list_by_fleet
• Operation group FleetUpdateStrategiesOperations added parameter skip_token in method list_by_fleet
• Operation group FleetsOperations added parameter top in method list_by_subscription
• Operation group FleetsOperations added parameter skip_token in method list_by_subscription
• Operation group GatesOperations added parameter filter in method list_by_fleet
• Operation group GatesOperations added parameter top in method list_by_fleet
• Operation group GatesOperations added parameter skip_token in method list_by_fleet
• Operation group UpdateRunsOperations added parameter top in method list_by_fleet
• Operation group UpdateRunsOperations added parameter skip_token in method list_by_fleet

4.0.0b2 (2025-12-03)

Features Added

• Model ContainerServiceFleetMgmtClient added parameter cloud_setting in method __init__
• Client ContainerServiceFleetMgmtClient added operation group fleet_managed_namespaces
• Added enum AdoptionPolicy
• Added model Affinity
• Added model ClusterAffinity
• Added model ClusterResourcePlacementSpec
• Added model ClusterSelector
• Added model ClusterSelectorTerm
• Added enum DeletePolicy
• Added model FleetManagedNamespace
• Added model FleetManagedNamespacePatch
• Added model FleetManagedNamespaceProperties
• Added enum FleetManagedNamespaceProvisioningState
• Added model FleetManagedNamespaceStatus
• Added model LabelSelector
• Added enum LabelSelectorOperator
• Added model LabelSelectorRequirement
• Added model ManagedNamespaceProperties
• Added model NetworkPolicy
• Added model PlacementPolicy
• Added model PlacementProfile
• Added enum PlacementType
• Added enum PolicyRule
• Added model PropagationPolicy
• Added enum PropagationType
• Added model PropertySelector
• Added enum PropertySelectorOperator
• Added model PropertySelectorRequirement
• Added model ResourceQuota
• Added enum TaintEffect
• Added model Toleration
• Added enum TolerationOperator
• Added operation group FleetManagedNamespacesOperations

4.0.0b1 (2025-08-04)

Features Added

• Client ContainerServiceFleetMgmtClient added operation group gates
• Model UpdateGroup added property before_gates
• Model UpdateGroup added property after_gates
• Model UpdateGroupStatus added property before_gates
• Model UpdateGroupStatus added property after_gates
• Model UpdateStage added property before_gates
• Model UpdateStage added property after_gates
• Model UpdateStageStatus added property before_gates
• Model UpdateStageStatus added property after_gates
• Enum UpdateState added member PENDING
• Enum UpgradeChannel added member TARGET_KUBERNETES_VERSION
• Added model FleetMemberUpdateProperties
• Added model Gate
• Added model GateConfiguration
• Added model GatePatch
• Added model GatePatchProperties
• Added model GateProperties
• Added enum GateProvisioningState
• Added enum GateState
• Added model GateTarget
• Added enum GateType
• Added enum Timing
• Added model UpdateRunGateStatus
• Added model UpdateRunGateTargetProperties
• Added operation group GatesOperations

Breaking Changes

• This version introduces new hybrid models which have dual dictionary and model nature. And 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 mgration.
• Model FleetMemberUpdate deleted or renamed its instance variable group
• Method AutoUpgradeProfilesOperations.begin_create_or_update renamed positional_or_keyword parameters if_match/if_none_match to keyword_only parameters etag/match_condition
• Method AutoUpgradeProfilesOperations.begin_delete renamed positional_or_keyword parameter if_match to keyword_only parameters etag/match_condition
• Method FleetMembersOperations.begin_create renamed positional_or_keyword parameters if_match/if_none_match to keyword_only parameters etag/match_condition
• Method FleetMembersOperations.begin_delete renamed positional_or_keyword parameter if_match to keyword_only parameters etag/match_condition
• Method FleetMembersOperations.begin_update renamed positional_or_keyword parameter if_match to keyword_only parameters etag/match_condition
• Method FleetUpdateStrategiesOperations.begin_create_or_update renamed positional_or_keyword parameters if_match/if_none_match to keyword_only parameters etag/match_condition
• Method FleetUpdateStrategiesOperations.begin_delete renamed positional_or_keyword parameter if_match to keyword_only parameters etag/match_condition
• Method FleetsOperations.begin_create_or_update renamed positional_or_keyword parameters if_match/if_none_match to keyword_only parameters etag/match_condition
• Method FleetsOperations.begin_delete renamed positional_or_keyword parameter if_match to keyword_only parameters etag/match_condition
• Method FleetsOperations.begin_update renamed positional_or_keyword parameter if_match to keyword_only parameters etag/match_condition
• Method UpdateRunsOperations.begin_create_or_update renamed positional_or_keyword parameters if_match/if_none_match to keyword_only parameters etag/match_condition
• Method UpdateRunsOperations.begin_delete renamed positional_or_keyword parameter if_match to keyword_only parameters etag/match_condition
• Method UpdateRunsOperations.begin_skip renamed positional_or_keyword parameter if_match to keyword_only parameters etag/match_condition
• Method UpdateRunsOperations.begin_start renamed positional_or_keyword parameter if_match to keyword_only parameters etag/match_condition
• Method UpdateRunsOperations.begin_stop renamed positional_or_keyword parameter if_match to keyword_only parameters etag/match_condition

3.1.0 (2025-05-08)

Features Added

• Client ContainerServiceFleetMgmtClient added operation group auto_upgrade_profiles
• Client ContainerServiceFleetMgmtClient added operation group auto_upgrade_profile_operations
• Model APIServerAccessProfile added property enable_vnet_integration
• Model APIServerAccessProfile added property subnet_id
• Model Fleet added property status
• Model FleetMember added property status
• Model NodeImageSelection added property custom_node_image_versions
• Enum NodeImageSelectionType added member CUSTOM
• Model UpdateRun added property auto_upgrade_profile_id
• Added enum AutoUpgradeLastTriggerStatus
• Added model AutoUpgradeNodeImageSelection
• Added enum AutoUpgradeNodeImageSelectionType
• Added model AutoUpgradeProfile
• Added model AutoUpgradeProfileListResult
• Added enum AutoUpgradeProfileProvisioningState
• Added model AutoUpgradeProfileStatus
• Added model FleetMemberStatus
• Added model FleetStatus
• Added model GenerateResponse
• Added enum UpgradeChannel
• Added operation group AutoUpgradeProfileOperationsOperations
• Added operation group AutoUpgradeProfilesOperations

3.0.0 (2024-10-31)

Breaking Changes

• This package now only targets the latest Api-Version available on Azure and removes APIs of other Api-Version. After this change, the package can have much smaller size. If your application requires a specific and non-latest Api-Version, it's recommended to pin this package to the previous released version; If your application always only use latest Api-Version, please ignore this change.

2.1.0 (2024-10-21)

Features Added

• Added operation group AutoUpgradeProfilesOperations
• Model NodeImageSelection has a new parameter custom_node_image_versions

2.0.0 (2024-05-20)

Breaking Changes

• Model APIServerAccessProfile no longer has parameter enable_vnet_integration
• Model APIServerAccessProfile no longer has parameter subnet_id

1.1.0 (2024-04-03)

Features Added

• Added operation UpdateRunsOperations.begin_skip
• Model Fleet has a new parameter hub_profile

1.0.0 (2023-10-27)

Breaking Changes

• Model Fleet no longer has parameter hub_profile

1.0.0b3 (2023-10-23)

Features Added

• Added operation group FleetUpdateStrategiesOperations
• Model AgentProfile has a new parameter vm_size
• Model FleetHubProfile has a new parameter portal_fqdn
• Model UpdateRun has a new parameter update_strategy_id

1.0.0b2 (2023-09-12)

Features Added

• Model Fleet has a new parameter identity
• Model FleetHubProfile has a new parameter agent_profile
• Model FleetHubProfile has a new parameter api_server_access_profile
• Model FleetPatch has a new parameter identity
• Model ManagedClusterUpdate has a new parameter node_image_selection
• Model MemberUpdateStatus has a new parameter message
• Model UpdateRunStatus has a new parameter node_image_selection

Breaking Changes

• Renamed operation FleetMembersOperations.update to FleetMembersOperations.begin_update
• Renamed operation FleetsOperations.update to FleetsOperations.begin_update

1.0.0b1 (2023-06-16)

• Initial Release