# Microsoft Azure SDK for Python
This is the Microsoft Azure Service Fabric Client Library.
This package has been tested with Python 2.7, 3.5, 3.6, 3.7 and 3.8.
For a more complete view of Azure libraries, see the [azure sdk python release](https://aka.ms/azsdk/python/all).
# Usage
For code examples, see [Service Fabric](https://docs.microsoft.com/python/api/overview/azure/servicefabric) on docs.microsoft.com.
# Provide Feedback
If you encounter any bugs or have suggestions, please file an issue in the
[Issues](https://github.com/Azure/azure-sdk-for-python/issues)
section of the project.

# Release History
## 8.2.0.0 (2021-12-14)
**Features**
**Breaking changes**
Added new operations:
- Added operation ServiceFabricClientAPIsOperationsMixin.validate_cluster_upgrade
- Added operation ServiceFabricClientAPIsOperationsMixin.update_application
- Added operation ServiceFabricClientAPIsOperationsMixin.move_auxiliary_replica
Added new models:
- ApplicationUpdateDescription
- CurrentUpgradeUnitsProgressInfo
- ServiceHostUpgradeImpact
- UpgradeDomainDeployedApplicationsHealthEvaluation
- UpgradeUnitInfo
- UpgradeUnitState
- ValidateClusterUpgradeResult
## 8.0.0.0 (2021-05-03)
**Features**
- Model ApplicationUpgradeDescription has a new parameter managed_application_identity
- Model StatelessServiceUpdateDescription has a new parameter instance_lifecycle_description
- Model StatelessServiceUpdateDescription has a new parameter tags_for_running
- Model StatelessServiceUpdateDescription has a new parameter service_dns_name
- Model StatelessServiceUpdateDescription has a new parameter tags_for_placement
- Model StatelessServiceUpdateDescription has a new parameter instance_restart_wait_duration_seconds
- Model ServiceDescription has a new parameter tags_required_to_place
- Model ServiceDescription has a new parameter tags_required_to_run
- Model ServiceUpdateDescription has a new parameter tags_for_placement
- Model ServiceUpdateDescription has a new parameter tags_for_running
- Model ServiceUpdateDescription has a new parameter service_dns_name
- Model StatefulServiceDescription has a new parameter replica_lifecycle_description
- Model StatefulServiceDescription has a new parameter tags_required_to_place
- Model StatefulServiceDescription has a new parameter tags_required_to_run
- Model StatelessServiceDescription has a new parameter instance_lifecycle_description
- Model StatelessServiceDescription has a new parameter instance_restart_wait_duration_seconds
- Model StatelessServiceDescription has a new parameter tags_required_to_place
- Model StatelessServiceDescription has a new parameter tags_required_to_run
- Model ClusterHealthPolicy has a new parameter node_type_health_policy_map
- Model NodeInfo has a new parameter node_tags
- Model StatefulServiceUpdateDescription has a new parameter replica_lifecycle_description
- Model StatefulServiceUpdateDescription has a new parameter tags_for_placement
- Model StatefulServiceUpdateDescription has a new parameter tags_for_running
- Model StatefulServiceUpdateDescription has a new parameter service_dns_name
- Model ApplicationInfo has a new parameter managed_application_identity
- Added operation ServiceFabricClientAPIsOperationsMixin.add_node_tags
- Added operation ServiceFabricClientAPIsOperationsMixin.move_instance
- Added operation ServiceFabricClientAPIsOperationsMixin.remove_node_tags
- Added operation ServiceFabricClientAPIsOperationsMixin.get_loaded_partition_info_list
**Breaking changes**
- Operation ServiceFabricClientAPIsOperationsMixin.create_backup_policy has a new signature
- Operation ServiceFabricClientAPIsOperationsMixin.update_backup_policy has a new signature
- Model AverageServiceLoadScalingTrigger has a new required parameter use_only_primary_load
## 7.2.0.46 (2020-10-29)
**Features**
- Added `update_partition_load` method to update the loads of provided partitions.
## 7.1.0.45 (2020-05-14)
**Bugfix**
- Fix ContainerCodePackageProperties entrypoint to entry_point
## 7.0.0.0 (2019-12-13)
This is re-release of 6.6.0.0 to match the actual API version used
internally
## 6.6.0.0 (2019-12-07)
**Features**
- Model StartClusterUpgradeDescription has a new parameter
instance_close_delay_duration_in_seconds
- Model Setting has a new parameter type
- Model ApplicationUpgradeDescription has a new parameter
instance_close_delay_duration_in_seconds
- Model HealthEvent has a new parameter health_report_id
- Model HealthInformation has a new parameter health_report_id
- Model StatelessServiceDescription has a new parameter flags
- Model StatelessServiceDescription has a new parameter
min_instance_count
- Model StatelessServiceDescription has a new parameter
min_instance_percentage
- Model StatelessServiceDescription has a new parameter
instance_close_delay_duration_seconds
- Model StatefulServiceDescription has a new parameter
service_placement_time_limit_seconds
- Model ImageRegistryCredential has a new parameter password_type
- Model ContainerCodePackageProperties has a new parameter
liveness_probe
- Model ContainerCodePackageProperties has a new parameter
readiness_probe
- Model ServiceResourceDescription has a new parameter
execution_policy
- Model ServiceResourceDescription has a new parameter dns_name
- Model StatefulServiceUpdateDescription has a new parameter
service_placement_time_limit_seconds
- Model EnvironmentVariable has a new parameter type
- Model StatelessServicePartitionInfo has a new parameter
min_instance_percentage
- Model StatelessServicePartitionInfo has a new parameter
min_instance_count
- Model RollingUpgradeUpdateDescription has a new parameter
instance_close_delay_duration_in_seconds
- Model ServiceProperties has a new parameter execution_policy
- Model ServiceProperties has a new parameter dns_name
- Model StatelessServiceUpdateDescription has a new parameter
min_instance_percentage
- Model StatelessServiceUpdateDescription has a new parameter
min_instance_count
- Model StatelessServiceUpdateDescription has a new parameter
instance_close_delay_duration_seconds
- Added operation MeshApplicationOperations.get_upgrade_progress
- Added operation
ServiceFabricClientAPIsOperationsMixin.remove_configuration_overrides
- Added operation
ServiceFabricClientAPIsOperationsMixin.get_image_store_info
- Added operation
ServiceFabricClientAPIsOperationsMixin.get_configuration_overrides
- Added operation
ServiceFabricClientAPIsOperationsMixin.add_configuration_parameter_overrides
## 6.5.0.0 (2019-06-17)
**Features**
- Model ApplicationDescription has a new parameter
managed_application_identity
- Model ApplicationUpgradeDescription has a new parameter sort_order
- Model NodeLoadMetricInformation has a new parameter
planned_node_load_removal
- Model NodeLoadMetricInformation has a new parameter
current_node_load
- Model NodeLoadMetricInformation has a new parameter
buffered_node_capacity_remaining
- Model NodeLoadMetricInformation has a new parameter
node_capacity_remaining
- Model StartClusterUpgradeDescription has a new parameter sort_order
- Model ApplicationResourceDescription has a new parameter identity
- Model ServiceResourceDescription has a new parameter identity_refs
- Model ClusterUpgradeDescriptionObject has a new parameter
sort_order
- Model ServiceProperties has a new parameter identity_refs
**Breaking changes**
- Model ChaosStartedEvent no longer has parameter
wait_time_between_fautls_in_seconds
- Model ChaosStartedEvent has a new required parameter
wait_time_between_faults_in_seconds
## 6.4.0.0 (2018-12-07)
**Bugfixes**
- Numerous improvements to descriptions and help texts
**Features**
- Add command to get cluster load
- Add command to get cluster version
- Add mesh gateway support
- Add mesh support
- Add command for rolling back compose deployment upgrades
- Various new parameters added.
## 6.3.0.0 (2018-07-27)
**Bugfixes**
- Numerous improvements to descriptions and help texts
**Features**
- Add application health policies parameter for config upgrade
- Query to get nodes now supports specification to limit number of
returned items
## 6.2.0.0 (2018-05-10)
**General Breaking changes**
This version uses a next-generation code generator that *might*
introduce breaking changes.
- Model signatures now use only keyword-argument syntax. All
positional arguments must be re-written as keyword-arguments. To
keep auto-completion in most cases, models are now generated for
Python 2 and Python 3. Python 3 uses the "*" syntax for
keyword-only arguments.
- Enum types now use the "str" mixin (class AzureEnum(str, Enum)) to
improve the behavior when unrecognized enum values are encountered.
While this is not a breaking change, the distinctions are important,
and are documented here:
<https://docs.python.org/3/library/enum.html#others> At a glance:
- "is" should not be used at all.
- "format" will return the string value, where "%s" string
formatting will return `NameOfEnum.stringvalue`. Format syntax
should be prefered.
- New Long Running Operation:
- Return type changes from
`msrestazure.azure_operation.AzureOperationPoller` to
`msrest.polling.LROPoller`. External API is the same.
- Return type is now **always** a `msrest.polling.LROPoller`,
regardless of the optional parameters used.
- The behavior has changed when using `raw=True`. Instead of
returning the initial call result as `ClientRawResponse`,
without polling, now this returns an LROPoller. After polling,
the final resource will be returned as a `ClientRawResponse`.
- New `polling` parameter. The default behavior is
`Polling=True` which will poll using ARM algorithm. When
`Polling=False`, the response of the initial call will be
returned without polling.
- `polling` parameter accepts instances of subclasses of
`msrest.polling.PollingMethod`.
- `add_done_callback` will no longer raise if called after
polling is finished, but will instead execute the callback right
away.
**Bugfixes**
- Numerous fixes to descriptions and help text of entities
- Compatibility of the sdist with wheel 0.31.0
**Features**
- Add support for invoking container APIs
- Add option to fetch container logs from exited containers
- Query to get chaos events now supports specification to limit number
of returned items
- Client class can be used as a context manager to keep the underlying
HTTP session open for performance
## 6.1.2.9 (2018-02-05)
**Bugfixes**
- Numerous fixes to descriptions and help text of entities
**Features**
- Chaos service now supports a target filter
- Application types can now be provisioned and created in external
stores
- Added Orchestration Service internal support APIs
- Added container deployment management APIs
## 6.1.1.9 (2018-01-23)
This version was broken and has been removed from PyPI.
## 6.0.2 (2017-10-26)
**Bugfixes**
- remove application_type_version in
get_application_type_info_list_by_name
- fix application_type_definition_kind_filter default value from
65535 to 0
**Features**
- add create_name, get_name_exists_info, delete_name,
get_sub_name_info_list, get_property_info_list,
put_property, get_property_info, delete_property,
submit_property_batch
## 6.0.1 (2017-09-28)
**Bug fix**
- Fix some unexpected exceptions
## 6.0 (2017-09-22)
- Stable 6.0 api
## 6.0.0rc1 (2017-09-16)
- Release candidate for Service Fabric 6.0 runtime
## 5.6.130 (2017-05-04)
- Initial Release