Microsoft Azure SDK for Python

This is the Microsoft Azure Chaos 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-chaos
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.chaos import ChaosManagementClient
import os

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

Examples

Code samples for this package can be found at:

• Search Chaos 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

3.0.0b2 (2026-07-28)

Features Added

• Client ChaosManagementClient added operation group connections
• Model PermissionError added property error_message
• Model ScenarioConfigurationProperties added property resource_targeting
• Model ScenarioRunProperties added property excluded_resources
• Model ScenarioRunProperties added property resource_snapshot_id
• Model ValidationProperties added property excluded_resources
• Model ValidationProperties added property resources
• Model WorkspaceEvaluationProperties added property num_templates_evaluated_cancelled
• Model WorkspaceEvaluationProperties added property num_templates_evaluated_failed
• Model WorkspaceEvaluationProperties added property num_templates_evaluated_succeeded
• Model WorkspaceEvaluationProperties added property num_templates_to_evaluate
• Model WorkspaceEvaluationProperties added property resource_snapshot_id
• Added model Connection
• Added enum ConnectionKind
• Added model ConnectionProperties
• Added enum ConnectionStatus
• Added model ResourceTargeting
• Added model ResourceTargetingCriteria
• Added model TemplateEvaluationResultItem
• Added model WorkspaceDiscovery
• Added model WorkspaceDiscoveryProperties
• Added enum WorkspaceDiscoveryStatus
• Operation group ScenarioConfigurationsOperations added method begin_execute
• Operation group ScenarioRunsOperations added method begin_cancel
• Operation group WorkspacesOperations added method begin_discover
• Operation group WorkspacesOperations added method begin_evaluate
• Added operation group ConnectionsOperations

Breaking Changes

• 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
• Model WorkspaceEvaluationProperties deleted or renamed its instance variable num_scenarios_to_evaluate
• Deleted or renamed model ConfigurationExclusions
• Deleted or renamed model ConfigurationFilters
• Deleted or renamed model ScenarioEvaluationResultItem
• Deleted or renamed method ScenarioConfigurationsOperations.execute
• Deleted or renamed method ScenarioRunsOperations.cancel
• Deleted or renamed method WorkspacesOperations.begin_refresh_recommendations

3.0.0b1 (2026-05-06)

Features Added

• Client ChaosManagementClient added parameter cloud_setting in method __init__
• Client ChaosManagementClient added method send_request
• Client ChaosManagementClient added operation group private_accesses
• Client ChaosManagementClient added operation group actions
• Client ChaosManagementClient added operation group action_versions
• Client ChaosManagementClient added operation group workspaces
• Client ChaosManagementClient added operation group discovered_resources
• Client ChaosManagementClient added operation group scenarios
• Client ChaosManagementClient added operation group scenario_runs
• Client ChaosManagementClient added operation group scenario_configurations
• Model ExperimentExecutionDetailsProperties added property provisioning_state
• Enum ProvisioningState added member RUNNING
• Added model Action
• Added model ActionDependency
• Added enum ActionDependencyType
• Added enum ActionKind
• Added enum ActionLifecycle
• Added model ActionProperties
• Added model ActionSupportedTargetType
• Added model ActionVersion
• Added model ConfigurationExclusions
• Added model ConfigurationFilters
• Added model CustomerDataStorageProperties
• Added model DiscoveredResource
• Added model DiscoveredResourceProperties
• Added model EntraIdentity
• Added model ExternalResource
• Added model FixResourcePermissionsRequest
• Added model OperationError
• Added enum ParameterType
• Added model PermissionError
• Added model PermissionsFix
• Added model PermissionsFixProperties
• Added enum PermissionsFixState
• Added model PermissionsFixSummary
• Added model PhysicalToLogicalZoneMapping
• Added model PrivateAccess
• Added model PrivateAccessPatch
• Added model PrivateAccessProperties
• Added model PrivateEndpoint
• Added model PrivateEndpointConnection
• Added model PrivateEndpointConnectionProperties
• Added enum PrivateEndpointServiceConnectionStatus
• Added model PrivateLinkResource
• Added model PrivateLinkResourceListResult
• Added model PrivateLinkResourceProperties
• Added model PrivateLinkServiceConnectionState
• Added enum PublicNetworkAccessOption
• Added model Recommendation
• Added enum RecommendationStatus
• Added model ResourceStateError
• Added model RoleAssignmentError
• Added model RoleAssignmentResult
• Added enum RoleAssignmentStatus
• Added model RunAfter
• Added enum RunAfterBehavior
• Added model Scenario
• Added model ScenarioAction
• Added model ScenarioConfiguration
• Added model ScenarioConfigurationProperties
• Added model ScenarioErrors
• Added model ScenarioEvaluationResultItem
• Added model ScenarioParameter
• Added model ScenarioProperties
• Added model ScenarioRun
• Added model ScenarioRunProperties
• Added model ScenarioRunResource
• Added enum ScenarioRunState
• Added model ScenarioRunSummaryAction
• Added enum ScenarioSummaryState
• Added enum ScenarioValidationState
• Added model Validation
• Added model ValidationProperties
• Added model Workspace
• Added model WorkspaceEvaluation
• Added model WorkspaceEvaluationProperties
• Added enum WorkspaceEvaluationStatus
• Added model WorkspaceProperties
• Added model WorkspaceUpdate
• Added model ZoneResolutionInfo
• Added model ZoneResolutionMapping
• Added enum ZoneResolutionMode
• Added operation group ActionVersionsOperations
• Added operation group ActionsOperations
• Added operation group DiscoveredResourcesOperations
• Added operation group PrivateAccessesOperations
• Added operation group ScenarioConfigurationsOperations
• Added operation group ScenarioRunsOperations
• Added operation group ScenariosOperations
• Added operation group WorkspacesOperations

Breaking Changes

• For the method breakings, please refer to https://aka.ms/azsdk/python/migrate/operations for migration.
• Method CapabilitiesOperations.list changed its parameter continuation_token_parameter from positional_or_keyword to keyword_only
• Method CapabilityTypesOperations.list changed its parameter continuation_token_parameter from positional_or_keyword to keyword_only
• Method ExperimentsOperations.list changed its parameter running/continuation_token_parameter from positional_or_keyword to keyword_only
• Method ExperimentsOperations.list_all changed its parameter running/continuation_token_parameter from positional_or_keyword to keyword_only
• Method TargetTypesOperations.list changed its parameter continuation_token_parameter from positional_or_keyword to keyword_only
• Method TargetsOperations.list changed its parameter continuation_token_parameter from positional_or_keyword to keyword_only

2.0.0 (2025-06-12)

Features Added

• Model CapabilityType added property required_azure_role_definition_ids
• Model ExperimentExecution added property system_data
• Model ExperimentExecutionDetails added property properties
• Model Resource added property system_data
• Model TrackedResource added property system_data
• Added enum ExperimentActionType
• Added model ManagedServiceIdentity
• Added enum ManagedServiceIdentityType
• Added model OperationStatusResult
• Added model ProxyResource

Breaking Changes

• Model CapabilityType deleted or renamed its instance variable location
• Model ExperimentExecutionDetails deleted or renamed its instance variable status
• Model ExperimentExecutionDetails deleted or renamed its instance variable started_at
• Model ExperimentExecutionDetails deleted or renamed its instance variable stopped_at
• Model ExperimentExecutionDetails deleted or renamed its instance variable failure_reason
• Model ExperimentExecutionDetails deleted or renamed its instance variable last_action_at
• Model ExperimentExecutionDetails deleted or renamed its instance variable run_information
• Model TargetType deleted or renamed its instance variable location
• Deleted or renamed model ExperimentExecutionProperties
• Deleted or renamed model OperationStatus
• Deleted or renamed model ResourceIdentity
• Deleted or renamed model ResourceIdentityType
• Method CapabilitiesOperations.create_or_update renamed its parameter capability to resource
• Method CapabilityTypesOperations.get renamed its parameter location_name to location
• Method CapabilityTypesOperations.list renamed its parameter location_name to location
• Method ExperimentsOperations.begin_create_or_update renamed its parameter experiment to resource
• Method ExperimentsOperations.begin_update renamed its parameter experiment to properties
• Method OperationStatusesOperations.get renamed its parameter async_operation_id to operation_id
• Method TargetTypesOperations.get renamed its parameter location_name to location
• Method TargetTypesOperations.list renamed its parameter location_name to location
• Method TargetsOperations.create_or_update renamed its parameter target to resource

1.1.0 (2024-03-04)

Features Added

• Model ExperimentUpdate has a new parameter tags

1.0.0 (2023-11-20)

Features Added

• Added operation ExperimentsOperations.execution_details
• Added operation ExperimentsOperations.get_execution
• Added operation ExperimentsOperations.list_all_executions
• Added operation group OperationStatusesOperations
• Model Experiment has a new parameter provisioning_state
• Model ExperimentExecutionDetails has a new parameter last_action_at
• Model ExperimentExecutionDetails has a new parameter started_at
• Model ExperimentExecutionDetails has a new parameter stopped_at

Breaking Changes

• Model Experiment no longer has parameter start_on_creation
• Model ExperimentExecutionDetails no longer has parameter created_date_time
• Model ExperimentExecutionDetails no longer has parameter experiment_id
• Model ExperimentExecutionDetails no longer has parameter last_action_date_time
• Model ExperimentExecutionDetails no longer has parameter start_date_time
• Model ExperimentExecutionDetails no longer has parameter stop_date_time
• Removed operation ExperimentsOperations.get_execution_details
• Removed operation ExperimentsOperations.get_status
• Removed operation ExperimentsOperations.list_all_statuses
• Removed operation ExperimentsOperations.list_execution_details
• Renamed operation ExperimentsOperations.cancel to ExperimentsOperations.begin_cancel
• Renamed operation ExperimentsOperations.create_or_update to ExperimentsOperations.begin_create_or_update
• Renamed operation ExperimentsOperations.delete to ExperimentsOperations.begin_delete
• Renamed operation ExperimentsOperations.start to ExperimentsOperations.begin_start
• Renamed operation ExperimentsOperations.update to ExperimentsOperations.begin_update

1.0.0b7 (2023-08-18)

Features Added

• Added operation ExperimentsOperations.update
• Model CapabilityType has a new parameter azure_rbac_actions
• Model CapabilityType has a new parameter azure_rbac_data_actions
• Model ResourceIdentity has a new parameter user_assigned_identities
• Model Selector has a new parameter additional_properties

Breaking Changes

• Model Selector no longer has parameter targets

1.0.0b6 (2022-12-14)

Features Added

• Model Selector has a new parameter filter

1.0.0b5 (2022-08-01)

Features

• Added operation ExperimentsOperations.cancel
• Added operation ExperimentsOperations.create_or_update
• Model CapabilityType has a new parameter kind
• Model CapabilityType has a new parameter runtime_properties

Breaking changes

• Removed operation ExperimentsOperations.begin_cancel
• Removed operation ExperimentsOperations.begin_create_or_update

1.0.0b4 (2022-06-28)

Features

• Model ActionStatus has a new parameter action_id
• Model ActionStatus has a new parameter action_name
• Model BranchStatus has a new parameter branch_id
• Model BranchStatus has a new parameter branch_name
• Model ExperimentExecutionActionTargetDetailsProperties has a new parameter target_completed_time
• Model ExperimentExecutionActionTargetDetailsProperties has a new parameter target_failed_time
• Model ExperimentExecutionDetails has a new parameter created_date_time
• Model ExperimentExecutionDetails has a new parameter last_action_date_time
• Model ExperimentExecutionDetails has a new parameter start_date_time
• Model ExperimentExecutionDetails has a new parameter stop_date_time
• Model StepStatus has a new parameter step_id
• Model StepStatus has a new parameter step_name

Breaking changes

• Model ActionStatus no longer has parameter id
• Model ActionStatus no longer has parameter name
• Model BranchStatus no longer has parameter id
• Model BranchStatus no longer has parameter name
• Model ExperimentExecutionActionTargetDetailsProperties no longer has parameter completed_date_utc
• Model ExperimentExecutionActionTargetDetailsProperties no longer has parameter failed_date_utc
• Model ExperimentExecutionDetails no longer has parameter created_date_utc
• Model ExperimentExecutionDetails no longer has parameter last_action_date_utc
• Model ExperimentExecutionDetails no longer has parameter start_date_utc
• Model ExperimentExecutionDetails no longer has parameter stop_date_utc
• Model StepStatus no longer has parameter id
• Model StepStatus no longer has parameter name

1.0.0b3 (2022-05-07)

Features

• Model ActionStatus has a new parameter end_time
• Model ActionStatus has a new parameter start_time

1.0.0b2 (2021-10-25)

Features

• Modified client name

1.0.0b1 (2021-10-21)

• Initial Release