azure-mgmt-networkcloud 2.2.0
Microsoft Azure Networkcloud Management Client Library for Python
Requires Python: >=3.9
Keywords: azure, azure sdk

# Microsoft Azure SDK for Python

This is the Microsoft Azure Networkcloud Management Client Library.
This package has been tested with Python 3.9+.
For a more complete view of Azure libraries, see the [azure sdk python release](https://aka.ms/azsdk/python/all).

## _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.9+ is required to use this package.
- [Azure subscription](https://azure.microsoft.com/free/)

### Install the package

```bash
pip install azure-mgmt-networkcloud
pip install azure-identity
```

### Authentication

By default, [Azure Active Directory](https://aka.ms/awps/aad) 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:

```python
from azure.identity import DefaultAzureCredential
from azure.mgmt.networkcloud import NetworkCloudMgmtClient
import os

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

## Examples

Code samples for this package can be found at:
- [Search Networkcloud Management](https://docs.microsoft.com/samples/browse/?languages=python&term=Getting%20started%20-%20Managing&terms=Getting%20started%20-%20Managing) on docs.microsoft.com
- [Azure Python Mgmt SDK Samples Repo](https://aka.ms/azsdk/python/mgmt/samples)


## Troubleshooting

## Next steps

## 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

## 2.2.0 (2025-12-22)

### Features Added

  - Model `NetworkCloudMgmtClient` added parameter `cloud_setting` in method `__init__`
  - Model `BareMetalMachine` added property `action_states`
  - Model `BareMetalMachine` added property `ca_certificate`
  - Model `BareMetalMachineKeySet` added property `privilege_level_name`
  - Enum `BareMetalMachineKeySetPrivilegeLevel` added member `OTHER`
  - Model `BareMetalMachineReplaceParameters` added property `safeguard_mode`
  - Model `BareMetalMachineReplaceParameters` added property `storage_policy`
  - Model `CloudServicesNetwork` added property `storage_options`
  - Model `CloudServicesNetwork` added property `storage_status`
  - Model `CloudServicesNetworkPatchParameters` added property `storage_options`
  - Model `Cluster` added property `action_states`
  - Model `CommandOutputSettings` added property `overrides`
  - Model `SecretArchiveReference` added property `key_vault_uri`
  - Model `StorageAppliance` added property `ca_certificate`
  - Model `VirtualMachine` added property `identity`
  - Model `VirtualMachine` added property `network_data_content`
  - Model `VirtualMachine` added property `user_data_content`
  - Model `VirtualMachinePatchParameters` added property `identity`
  - Model `Volume` added property `allocated_size_mi_b`
  - Model `Volume` added property `storage_appliance_id`
  - Added model `ActionState`
  - Added enum `ActionStateStatus`
  - Added enum `BareMetalMachineReplaceSafeguardMode`
  - Added enum `BareMetalMachineReplaceStoragePolicy`
  - Added model `CertificateInfo`
  - Added enum `CloudServicesNetworkStorageMode`
  - Added model `CloudServicesNetworkStorageOptions`
  - Added model `CloudServicesNetworkStorageOptionsPatch`
  - Added model `CloudServicesNetworkStorageStatus`
  - Added enum `CloudServicesNetworkStorageStatusStatus`
  - Added model `CommandOutputOverride`
  - Added enum `CommandOutputType`
  - Added enum `RelayType`
  - Added model `StepState`
  - Added enum `StepStateStatus`
  - Added model `StorageApplianceCommandSpecification`
  - Added model `StorageApplianceRunReadCommandsParameters`
  - Added model `VirtualMachineAssignRelayParameters`
  - Operation group `BareMetalMachinesOperations` added method `begin_run_data_extracts_restricted`
  - Operation group `StorageAppliancesOperations` added method `begin_run_read_commands`
  - Operation group `VirtualMachinesOperations` added method `begin_assign_relay`

## 2.2.0b1 (2025-11-17)

### Features Added

  - Model `NetworkCloudMgmtClient` added parameter `cloud_setting` in method `__init__`
  - Model `BareMetalMachine` added property `action_states`
  - Model `BareMetalMachine` added property `ca_certificate`
  - Model `BareMetalMachineKeySet` added property `privilege_level_name`
  - Enum `BareMetalMachineKeySetPrivilegeLevel` added member `OTHER`
  - Model `BareMetalMachineReplaceParameters` added property `safeguard_mode`
  - Model `BareMetalMachineReplaceParameters` added property `storage_policy`
  - Model `CloudServicesNetwork` added property `storage_options`
  - Model `CloudServicesNetwork` added property `storage_status`
  - Model `CloudServicesNetworkPatchParameters` added property `storage_options`
  - Model `Cluster` added property `action_states`
  - Model `CommandOutputSettings` added property `overrides`
  - Model `SecretArchiveReference` added property `key_vault_uri`
  - Model `StorageAppliance` added property `ca_certificate`
  - Model `VirtualMachine` added property `identity`
  - Model `VirtualMachine` added property `network_data_content`
  - Model `VirtualMachine` added property `user_data_content`
  - Model `VirtualMachinePatchParameters` added property `identity`
  - Model `Volume` added property `allocated_size_mi_b`
  - Model `Volume` added property `storage_appliance_id`
  - Added model `ActionState`
  - Added enum `ActionStateStatus`
  - Added enum `BareMetalMachineReplaceSafeguardMode`
  - Added enum `BareMetalMachineReplaceStoragePolicy`
  - Added model `CertificateInfo`
  - Added enum `CloudServicesNetworkStorageMode`
  - Added model `CloudServicesNetworkStorageOptions`
  - Added model `CloudServicesNetworkStorageOptionsPatch`
  - Added model `CloudServicesNetworkStorageStatus`
  - Added enum `CloudServicesNetworkStorageStatusStatus`
  - Added model `CommandOutputOverride`
  - Added enum `CommandOutputType`
  - Added enum `RelayType`
  - Added model `StepState`
  - Added enum `StepStateStatus`
  - Added model `StorageApplianceCommandSpecification`
  - Added model `StorageApplianceRunReadCommandsParameters`
  - Added model `VirtualMachineAssignRelayParameters`
  - Operation group `BareMetalMachinesOperations` added method `begin_run_data_extracts_restricted`
  - Operation group `StorageAppliancesOperations` added method `begin_run_read_commands`
  - Operation group `VirtualMachinesOperations` added method `begin_assign_relay`

## 2.1.0 (2025-06-16)

### Features Added

  - All resources implement concurrency control via Etag/If-Match/If-None-Match parameters. As a result, customers who use create/patch/delete methods with positional arguments may need to adjust part of calls. It is recommended to switch to keyword based calls to avoid any future issues.
  - Model `AgentPool` added property `etag`
  - Model `BareMetalMachine` added property `etag`
  - Model `BareMetalMachineKeySet` added property `etag`
  - Model `BmcKeySet` added property `etag`
  - Model `CloudServicesNetwork` added property `etag`
  - Model `Cluster` added property `etag`
  - Model `Cluster` added property `analytics_output_settings`
  - Model `Cluster` added property `secret_archive_settings`
  - Model `Cluster` added property `vulnerability_scanning_settings`
  - Model `ClusterManager` added property `etag`
  - Model `ClusterMetricsConfiguration` added property `etag`
  - Model `ClusterPatchParameters` added property `analytics_output_settings`
  - Model `ClusterPatchParameters` added property `secret_archive_settings`
  - Model `ClusterPatchParameters` added property `vulnerability_scanning_settings`
  - Model `Console` added property `etag`
  - Model `KubernetesCluster` added property `etag`
  - Model `KubernetesClusterFeature` added property `etag`
  - Model `L2Network` added property `etag`
  - Model `L3Network` added property `etag`
  - Enum `OsDiskCreateOption` added member `PERSISTENT`
  - Model `Rack` added property `etag`
  - Model `StorageAppliance` added property `etag`
  - Enum `StorageApplianceDetailedStatus` added member `DEGRADED`
  - Model `TrunkedNetwork` added property `etag`
  - Model `VirtualMachine` added property `etag`
  - Model `VirtualMachine` added property `console_extended_location`
  - Enum `VirtualMachineDeviceModelType` added member `T3`
  - Model `Volume` added property `etag`
  - Added model `AnalyticsOutputSettings`
  - Added model `SecretArchiveSettings`
  - Added model `VulnerabilityScanningSettings`
  - Added enum `VulnerabilityScanningSettingsContainerScan`
  - Added model `VulnerabilityScanningSettingsPatch`

## 2.1.0b1 (2025-04-21)

### Features Added

  - Model `Cluster` added property `analytics_output_settings`
  - Model `Cluster` added property `secret_archive_settings`
  - Model `Cluster` added property `vulnerability_scanning_settings`
  - Model `ClusterPatchParameters` added property `analytics_output_settings`
  - Model `ClusterPatchParameters` added property `secret_archive_settings`
  - Model `ClusterPatchParameters` added property `vulnerability_scanning_settings`
  - Enum `OsDiskCreateOption` added member `PERSISTENT`
  - Enum `StorageApplianceDetailedStatus` added member `DEGRADED`
  - Model `VirtualMachine` added property `console_extended_location`
  - Enum `VirtualMachineDeviceModelType` added member `T3`
  - Added model `AnalyticsOutputSettings`
  - Added model `SecretArchiveSettings`
  - Added model `VulnerabilityScanningSettings`
  - Added enum `VulnerabilityScanningSettingsContainerScan`
  - Added model `VulnerabilityScanningSettingsPatch`

## 2.0.0 (2025-02-24)

### Features Added

  - Client `NetworkCloudMgmtClient` added operation group `kubernetes_cluster_features`
  - Model `AgentPoolPatchParameters` added property `administrator_configuration`
  - Model `AgentPoolUpgradeSettings` added property `drain_timeout`
  - Model `AgentPoolUpgradeSettings` added property `max_unavailable`
  - Model `BareMetalMachine` added property `machine_cluster_version`
  - Model `BareMetalMachine` added property `machine_roles`
  - Model `BareMetalMachine` added property `runtime_protection_status`
  - Model `BareMetalMachine` added property `secret_rotation_status`
  - Model `Cluster` added property `identity`
  - Model `Cluster` added property `command_output_settings`
  - Model `Cluster` added property `runtime_protection_configuration`
  - Model `Cluster` added property `secret_archive`
  - Model `Cluster` added property `update_strategy`
  - Enum `ClusterConnectionStatus` added member `DISCONNECTED`
  - Enum `ClusterDetailedStatus` added member `UPDATE_PAUSED`
  - Model `ClusterManager` added property `identity`
  - Model `ClusterManagerPatchParameters` added property `identity`
  - Model `ClusterPatchParameters` added property `identity`
  - Model `ClusterPatchParameters` added property `command_output_settings`
  - Model `ClusterPatchParameters` added property `runtime_protection_configuration`
  - Model `ClusterPatchParameters` added property `secret_archive`
  - Model `ClusterPatchParameters` added property `update_strategy`
  - Model `ControlPlaneNodePatchConfiguration` added property `administrator_configuration`
  - Model `KeySetUser` added property `user_principal_name`
  - Model `KubernetesClusterPatchParameters` added property `administrator_configuration`
  - Model `NetworkConfiguration` added property `l2_service_load_balancer_configuration`
  - Model `OperationStatusResult` added property `exit_code`
  - Model `OperationStatusResult` added property `output_head`
  - Model `OperationStatusResult` added property `result_ref`
  - Model `OperationStatusResult` added property `result_url`
  - Enum `RackSkuProvisioningState` added member `CANCELED`
  - Enum `RackSkuProvisioningState` added member `FAILED`
  - Model `StorageAppliance` added property `manufacturer`
  - Model `StorageAppliance` added property `model`
  - Model `StorageAppliance` added property `secret_rotation_status`
  - Model `StorageAppliance` added property `version`
  - Added model `AdministratorConfigurationPatch`
  - Added enum `ClusterContinueUpdateVersionMachineGroupTargetingMode`
  - Added model `ClusterContinueUpdateVersionParameters`
  - Added model `ClusterScanRuntimeParameters`
  - Added enum `ClusterScanRuntimeParametersScanActivity`
  - Added model `ClusterSecretArchive`
  - Added enum `ClusterSecretArchiveEnabled`
  - Added model `ClusterUpdateStrategy`
  - Added enum `ClusterUpdateStrategyType`
  - Added model `CommandOutputSettings`
  - Added model `IdentitySelector`
  - Added model `KubernetesClusterFeature`
  - Added enum `KubernetesClusterFeatureAvailabilityLifecycle`
  - Added enum `KubernetesClusterFeatureDetailedStatus`
  - Added model `KubernetesClusterFeatureList`
  - Added model `KubernetesClusterFeaturePatchParameters`
  - Added enum `KubernetesClusterFeatureProvisioningState`
  - Added enum `KubernetesClusterFeatureRequired`
  - Added model `L2ServiceLoadBalancerConfiguration`
  - Added model `ManagedServiceIdentity`
  - Added enum `ManagedServiceIdentitySelectorType`
  - Added enum `ManagedServiceIdentityType`
  - Added model `NodePoolAdministratorConfigurationPatch`
  - Added model `RuntimeProtectionConfiguration`
  - Added enum `RuntimeProtectionEnforcementLevel`
  - Added model `RuntimeProtectionStatus`
  - Added model `SecretArchiveReference`
  - Added model `SecretRotationStatus`
  - Added model `StringKeyValuePair`
  - Added model `UserAssignedIdentity`
  - Operation group `ClustersOperations` added method `begin_continue_update_version`
  - Operation group `ClustersOperations` added method `begin_scan_runtime`
  - Added operation group `KubernetesClusterFeaturesOperations`

### Breaking Changes

  - Parameter `max_surge` of method `AgentPoolUpgradeSettings` is now optional

## 2.0.0b1 (2024-11-21)

### Features Added

  - Client `NetworkCloudMgmtClient` added operation group `kubernetes_cluster_features`
  - Model `AgentPoolPatchParameters` added property `administrator_configuration`
  - Model `AgentPoolUpgradeSettings` added property `drain_timeout`
  - Model `AgentPoolUpgradeSettings` added property `max_unavailable`
  - Model `BareMetalMachine` added property `machine_cluster_version`
  - Model `BareMetalMachine` added property `machine_roles`
  - Model `BareMetalMachine` added property `runtime_protection_status`
  - Model `BareMetalMachine` added property `secret_rotation_status`
  - Model `Cluster` added property `identity`
  - Model `Cluster` added property `command_output_settings`
  - Model `Cluster` added property `runtime_protection_configuration`
  - Model `Cluster` added property `secret_archive`
  - Model `Cluster` added property `update_strategy`
  - Enum `ClusterConnectionStatus` added member `DISCONNECTED`
  - Enum `ClusterDetailedStatus` added member `UPDATE_PAUSED`
  - Model `ClusterManager` added property `identity`
  - Model `ClusterManagerPatchParameters` added property `identity`
  - Model `ClusterPatchParameters` added property `identity`
  - Model `ClusterPatchParameters` added property `command_output_settings`
  - Model `ClusterPatchParameters` added property `runtime_protection_configuration`
  - Model `ClusterPatchParameters` added property `secret_archive`
  - Model `ClusterPatchParameters` added property `update_strategy`
  - Model `ControlPlaneNodePatchConfiguration` added property `administrator_configuration`
  - Model `KeySetUser` added property `user_principal_name`
  - Model `KubernetesClusterPatchParameters` added property `administrator_configuration`
  - Model `NetworkConfiguration` added property `l2_service_load_balancer_configuration`
  - Model `OperationStatusResult` added property `exit_code`
  - Model `OperationStatusResult` added property `output_head`
  - Model `OperationStatusResult` added property `result_ref`
  - Model `OperationStatusResult` added property `result_url`
  - Enum `RackSkuProvisioningState` added member `CANCELED`
  - Enum `RackSkuProvisioningState` added member `FAILED`
  - Model `StorageAppliance` added property `manufacturer`
  - Model `StorageAppliance` added property `model`
  - Model `StorageAppliance` added property `secret_rotation_status`
  - Model `StorageAppliance` added property `version`
  - Added model `AdministratorConfigurationPatch`
  - Added enum `ClusterContinueUpdateVersionMachineGroupTargetingMode`
  - Added model `ClusterContinueUpdateVersionParameters`
  - Added model `ClusterScanRuntimeParameters`
  - Added enum `ClusterScanRuntimeParametersScanActivity`
  - Added model `ClusterSecretArchive`
  - Added enum `ClusterSecretArchiveEnabled`
  - Added model `ClusterUpdateStrategy`
  - Added enum `ClusterUpdateStrategyType`
  - Added model `CommandOutputSettings`
  - Added model `IdentitySelector`
  - Added model `KubernetesClusterFeature`
  - Added enum `KubernetesClusterFeatureAvailabilityLifecycle`
  - Added enum `KubernetesClusterFeatureDetailedStatus`
  - Added model `KubernetesClusterFeatureList`
  - Added model `KubernetesClusterFeaturePatchParameters`
  - Added enum `KubernetesClusterFeatureProvisioningState`
  - Added enum `KubernetesClusterFeatureRequired`
  - Added model `L2ServiceLoadBalancerConfiguration`
  - Added model `ManagedServiceIdentity`
  - Added enum `ManagedServiceIdentitySelectorType`
  - Added enum `ManagedServiceIdentityType`
  - Added model `NodePoolAdministratorConfigurationPatch`
  - Added model `RuntimeProtectionConfiguration`
  - Added enum `RuntimeProtectionEnforcementLevel`
  - Added model `RuntimeProtectionStatus`
  - Added model `SecretArchiveReference`
  - Added model `SecretRotationStatus`
  - Added model `StringKeyValuePair`
  - Added model `UserAssignedIdentity`
  - Operation group `ClustersOperations` added method `begin_continue_update_version`
  - Operation group `ClustersOperations` added method `begin_scan_runtime`
  - Added operation group `KubernetesClusterFeaturesOperations`

### Breaking Changes

  - Parameter `max_surge` of model `AgentPoolUpgradeSettings` is no longer required

## 1.0.0 (2023-08-18)

### Breaking Changes

  - Removed operation BareMetalMachinesOperations.begin_validate_hardware
  - Removed operation StorageAppliancesOperations.begin_run_read_commands
  - Removed operation VirtualMachinesOperations.begin_attach_volume
  - Removed operation VirtualMachinesOperations.begin_detach_volume

## 1.0.0b2 (2023-07-19)

### Features Added

  - Added operation BareMetalMachineKeySetsOperations.list_by_cluster
  - Added operation BmcKeySetsOperations.list_by_cluster
  - Added operation ConsolesOperations.list_by_virtual_machine
  - Added operation MetricsConfigurationsOperations.list_by_cluster
  - Added operation group AgentPoolsOperations
  - Added operation group KubernetesClustersOperations
  - Model BareMetalMachine has a new parameter associated_resource_ids
  - Model CloudServicesNetwork has a new parameter associated_resource_ids
  - Model L2Network has a new parameter associated_resource_ids
  - Model L3Network has a new parameter associated_resource_ids
  - Model TrunkedNetwork has a new parameter associated_resource_ids
  - Model VirtualMachine has a new parameter availability_zone

### Breaking Changes

  - Removed operation BareMetalMachineKeySetsOperations.list_by_resource_group
  - Removed operation BmcKeySetsOperations.list_by_resource_group
  - Removed operation ConsolesOperations.list_by_resource_group
  - Removed operation MetricsConfigurationsOperations.list_by_resource_group
  - Removed operation StorageAppliancesOperations.begin_validate_hardware
  - Removed operation group DefaultCniNetworksOperations
  - Removed operation group HybridAksClustersOperations

## 1.0.0b1 (2023-05-19)

* Initial Release