azure-mgmt-storagecache


Nameazure-mgmt-storagecache JSON
Version 3.0.1 PyPI version JSON
download
home_pageNone
SummaryMicrosoft Azure Storagecache Management Client Library for Python
upload_time2025-10-09 09:37:33
maintainerNone
docs_urlNone
authorNone
requires_python>=3.9
licenseNone
keywords azure azure sdk
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage
            # Microsoft Azure SDK for Python

This is the Microsoft Azure Storage Cache 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-storagecache
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.storagecache import StorageCacheManagementClient
import os

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

## Examples

Code samples for this package can be found at:
- [Search Storage Cache 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

## 3.0.1 (2025-10-09)

### Bugs Fixed

- Exclude `generated_samples` and `generated_tests` from wheel

## 3.0.0 (2025-09-25)

### Features Added

  - Model `StorageCacheManagementClient` added parameter `cloud_setting` in method `__init__`
  - Client `StorageCacheManagementClient` added operation group `auto_export_jobs`
  - Client `StorageCacheManagementClient` added operation group `auto_import_jobs`
  - Model `ImportJob` added property `admin_status`
  - Model `ImportJob` added property `imported_files`
  - Model `ImportJob` added property `imported_directories`
  - Model `ImportJob` added property `imported_symlinks`
  - Model `ImportJob` added property `preexisting_files`
  - Model `ImportJob` added property `preexisting_directories`
  - Model `ImportJob` added property `preexisting_symlinks`
  - Model `ImportJobUpdate` added property `admin_status`
  - Added model `AutoExportJob`
  - Added enum `AutoExportJobAdminStatus`
  - Added enum `AutoExportJobProvisioningStateType`
  - Added model `AutoExportJobUpdate`
  - Added model `AutoExportJobsListResult`
  - Added enum `AutoExportStatusType`
  - Added model `AutoImportJob`
  - Added enum `AutoImportJobPropertiesAdminStatus`
  - Added enum `AutoImportJobPropertiesProvisioningState`
  - Added model `AutoImportJobPropertiesStatusBlobSyncEvents`
  - Added enum `AutoImportJobState`
  - Added model `AutoImportJobUpdate`
  - Added enum `AutoImportJobUpdatePropertiesAdminStatus`
  - Added model `AutoImportJobsListResult`
  - Added enum `ImportJobAdminStatus`
  - Added operation group `AutoExportJobsOperations`
  - Added operation group `AutoImportJobsOperations`

### Breaking Changes

  - Parameter `conflict_resolution_mode` of method `ImportJob.__init__` is now optional
  - Deleted or renamed operation group `StorageCacheManagementClientOperationsMixin`

## 2.0.0 (2024-05-20)

### Features Added

  - Added operation group ImportJobsOperations
  - Model AmlFilesystem has a new parameter root_squash_settings
  - Model AmlFilesystemHsmSettings has a new parameter import_prefixes_initial
  - Model AmlFilesystemUpdate has a new parameter root_squash_settings
  - Model ErrorResponse has a new parameter error
  - Model AscOperation.error changes type from ErrorResponse to AscOperationErrorResponse

### Breaking Changes

  - Model ErrorResponse no longer has parameter code
  - Model ErrorResponse no longer has parameter message

## 1.6.0b1 (2024-02-22)

### Features Added

  - Model AmlFilesystem has a new parameter root_squash_settings
  - Model AmlFilesystemUpdate has a new parameter root_squash_settings

## 1.5.0 (2023-06-16)

### Features Added

  - Added operation group AmlFilesystemsOperations
  - Added operation group StorageCacheManagementClientOperationsMixin

## 1.4.0 (2023-02-15)

### Features Added

  - Added operation StorageTargetsOperations.begin_restore_defaults
  - Model BlobNfsTarget has a new parameter verification_timer
  - Model BlobNfsTarget has a new parameter write_back_timer
  - Model Nfs3Target has a new parameter verification_timer
  - Model Nfs3Target has a new parameter write_back_timer

### Breaking Changes

  - Renamed operation CachesOperations.update to CachesOperations.begin_update

## 1.4.0b1 (2022-12-12)

### Other Changes

  - Added generated samples in github repo
  - Drop support for python<3.7.0

## 1.3.0 (2022-07-07)

**Features**

  - Added operation CachesOperations.begin_pause_priming_job
  - Added operation CachesOperations.begin_resume_priming_job
  - Added operation CachesOperations.begin_space_allocation
  - Added operation CachesOperations.begin_start_priming_job
  - Added operation CachesOperations.begin_stop_priming_job
  - Model ApiOperationPropertiesServiceSpecification has a new parameter log_specifications
  - Model Cache has a new parameter priming_jobs
  - Model Cache has a new parameter space_allocation
  - Model Cache has a new parameter upgrade_settings
  - Model StorageTarget has a new parameter allocation_percentage

## 1.2.0 (2022-03-22)

**Features**

  - Added operation StorageTargetOperations.begin_invalidate
  - Added operation group AscUsagesOperations
  - Model Cache has a new parameter zones

## 1.1.0 (2021-09-30)

**Features**

  - Model StorageTarget has a new parameter state

## 1.0.0 (2021-07-29)

**Features**

  - Model CacheEncryptionSettings has a new parameter rotation_to_latest_key_version_enabled
  - Model CacheIdentity has a new parameter user_assigned_identities
  - Added operation group StorageTargetOperations

**Breaking changes**

  - Operation StorageTargetsOperations.begin_delete has a new signature

## 1.0.0b1 (2021-05-13)

This is beta preview version.

This version uses a next-generation code generator that introduces important breaking changes, but also important new features (like unified authentication and async programming).

**General breaking changes**

- Credential system has been completly revamped:

  - `azure.common.credentials` or `msrestazure.azure_active_directory` instances are no longer supported, use the `azure-identity` classes instead: https://pypi.org/project/azure-identity/
  - `credentials` parameter has been renamed `credential`

- The `config` attribute no longer exists on a client, configuration should be passed as kwarg. Example: `MyClient(credential, subscription_id, enable_logging=True)`. For a complete set of
  supported options, see the [parameters accept in init documentation of azure-core](https://github.com/Azure/azure-sdk-for-python/blob/main/sdk/core/azure-core/CLIENT_LIBRARY_DEVELOPER.md#available-policies)
- You can't import a `version` module anymore, use `__version__` instead
- Operations that used to return a `msrest.polling.LROPoller` now returns a `azure.core.polling.LROPoller` and are prefixed with `begin_`.
- Exceptions tree have been simplified and most exceptions are now `azure.core.exceptions.HttpResponseError` (`CloudError` has been removed).
- Most of the operation kwarg have changed. Some of the most noticeable:

  - `raw` has been removed. Equivalent feature can be found using `cls`, a callback that will give access to internal HTTP response for advanced user
  - For a complete set of
  supported options, see the [parameters accept in Request documentation of azure-core](https://github.com/Azure/azure-sdk-for-python/blob/main/sdk/core/azure-core/CLIENT_LIBRARY_DEVELOPER.md#available-policies)

**General new features**

- Type annotations support using `typing`. SDKs are mypy ready.
- This client has now stable and official support for async. Check the `aio` namespace of your package to find the async client.
- This client now support natively tracing library like OpenCensus or OpenTelemetry. See this [tracing quickstart](https://github.com/Azure/azure-sdk-for-python/tree/main/sdk/core/azure-core-tracing-opentelemetry) for an overview.

## 0.3.0 (2020-03-01)

**Features**

  - Model Cache has a new parameter security_settings
  - Model Cache has a new parameter network_settings
  - Model Cache has a new parameter identity
  - Model Cache has a new parameter encryption_settings

## 0.2.0 (2019-11-12)

**Features**

  - Added operation CachesOperations.create_or_update
  - Added operation StorageTargetsOperations.create_or_update

**Breaking changes**

  - Removed operation CachesOperations.create
  - Removed operation StorageTargetsOperations.create
  - Removed operation StorageTargetsOperations.update

## 0.1.0rc1 (2019-09-03)

  - Initial Release

            

Raw data

            {
    "_id": null,
    "home_page": null,
    "name": "azure-mgmt-storagecache",
    "maintainer": null,
    "docs_url": null,
    "requires_python": ">=3.9",
    "maintainer_email": null,
    "keywords": "azure, azure sdk",
    "author": null,
    "author_email": "Microsoft Corporation <azpysdkhelp@microsoft.com> License-Expression: MIT",
    "download_url": "https://files.pythonhosted.org/packages/ac/8f/25c4398c581221e6c92d66cf495ec91949ef14547c74d258549dc0b3cea2/azure_mgmt_storagecache-3.0.1.tar.gz",
    "platform": null,
    "description": "# Microsoft Azure SDK for Python\n\nThis is the Microsoft Azure Storage Cache Management Client Library.\nThis package has been tested with Python 3.9+.\nFor a more complete view of Azure libraries, see the [azure sdk python release](https://aka.ms/azsdk/python/all).\n\n## _Disclaimer_\n\n_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_\n\n## Getting started\n\n### Prerequisites\n\n- Python 3.9+ is required to use this package.\n- [Azure subscription](https://azure.microsoft.com/free/)\n\n### Install the package\n\n```bash\npip install azure-mgmt-storagecache\npip install azure-identity\n```\n\n### Authentication\n\nBy default, [Azure Active Directory](https://aka.ms/awps/aad) token authentication depends on correct configuration of the following environment variables.\n\n- `AZURE_CLIENT_ID` for Azure client ID.\n- `AZURE_TENANT_ID` for Azure tenant ID.\n- `AZURE_CLIENT_SECRET` for Azure client secret.\n\nIn addition, Azure subscription ID can be configured via environment variable `AZURE_SUBSCRIPTION_ID`.\n\nWith above configuration, client can be authenticated by following code:\n\n```python\nfrom azure.identity import DefaultAzureCredential\nfrom azure.mgmt.storagecache import StorageCacheManagementClient\nimport os\n\nsub_id = os.getenv(\"AZURE_SUBSCRIPTION_ID\")\nclient = StorageCacheManagementClient(credential=DefaultAzureCredential(), subscription_id=sub_id)\n```\n\n## Examples\n\nCode samples for this package can be found at:\n- [Search Storage Cache Management](https://docs.microsoft.com/samples/browse/?languages=python&term=Getting%20started%20-%20Managing&terms=Getting%20started%20-%20Managing) on docs.microsoft.com\n- [Azure Python Mgmt SDK Samples Repo](https://aka.ms/azsdk/python/mgmt/samples)\n\n\n## Troubleshooting\n\n## Next steps\n\n## Provide Feedback\n\nIf you encounter any bugs or have suggestions, please file an issue in the\n[Issues](https://github.com/Azure/azure-sdk-for-python/issues)\nsection of the project. \n\n# Release History\n\n## 3.0.1 (2025-10-09)\n\n### Bugs Fixed\n\n- Exclude `generated_samples` and `generated_tests` from wheel\n\n## 3.0.0 (2025-09-25)\n\n### Features Added\n\n  - Model `StorageCacheManagementClient` added parameter `cloud_setting` in method `__init__`\n  - Client `StorageCacheManagementClient` added operation group `auto_export_jobs`\n  - Client `StorageCacheManagementClient` added operation group `auto_import_jobs`\n  - Model `ImportJob` added property `admin_status`\n  - Model `ImportJob` added property `imported_files`\n  - Model `ImportJob` added property `imported_directories`\n  - Model `ImportJob` added property `imported_symlinks`\n  - Model `ImportJob` added property `preexisting_files`\n  - Model `ImportJob` added property `preexisting_directories`\n  - Model `ImportJob` added property `preexisting_symlinks`\n  - Model `ImportJobUpdate` added property `admin_status`\n  - Added model `AutoExportJob`\n  - Added enum `AutoExportJobAdminStatus`\n  - Added enum `AutoExportJobProvisioningStateType`\n  - Added model `AutoExportJobUpdate`\n  - Added model `AutoExportJobsListResult`\n  - Added enum `AutoExportStatusType`\n  - Added model `AutoImportJob`\n  - Added enum `AutoImportJobPropertiesAdminStatus`\n  - Added enum `AutoImportJobPropertiesProvisioningState`\n  - Added model `AutoImportJobPropertiesStatusBlobSyncEvents`\n  - Added enum `AutoImportJobState`\n  - Added model `AutoImportJobUpdate`\n  - Added enum `AutoImportJobUpdatePropertiesAdminStatus`\n  - Added model `AutoImportJobsListResult`\n  - Added enum `ImportJobAdminStatus`\n  - Added operation group `AutoExportJobsOperations`\n  - Added operation group `AutoImportJobsOperations`\n\n### Breaking Changes\n\n  - Parameter `conflict_resolution_mode` of method `ImportJob.__init__` is now optional\n  - Deleted or renamed operation group `StorageCacheManagementClientOperationsMixin`\n\n## 2.0.0 (2024-05-20)\n\n### Features Added\n\n  - Added operation group ImportJobsOperations\n  - Model AmlFilesystem has a new parameter root_squash_settings\n  - Model AmlFilesystemHsmSettings has a new parameter import_prefixes_initial\n  - Model AmlFilesystemUpdate has a new parameter root_squash_settings\n  - Model ErrorResponse has a new parameter error\n  - Model AscOperation.error changes type from ErrorResponse to AscOperationErrorResponse\n\n### Breaking Changes\n\n  - Model ErrorResponse no longer has parameter code\n  - Model ErrorResponse no longer has parameter message\n\n## 1.6.0b1 (2024-02-22)\n\n### Features Added\n\n  - Model AmlFilesystem has a new parameter root_squash_settings\n  - Model AmlFilesystemUpdate has a new parameter root_squash_settings\n\n## 1.5.0 (2023-06-16)\n\n### Features Added\n\n  - Added operation group AmlFilesystemsOperations\n  - Added operation group StorageCacheManagementClientOperationsMixin\n\n## 1.4.0 (2023-02-15)\n\n### Features Added\n\n  - Added operation StorageTargetsOperations.begin_restore_defaults\n  - Model BlobNfsTarget has a new parameter verification_timer\n  - Model BlobNfsTarget has a new parameter write_back_timer\n  - Model Nfs3Target has a new parameter verification_timer\n  - Model Nfs3Target has a new parameter write_back_timer\n\n### Breaking Changes\n\n  - Renamed operation CachesOperations.update to CachesOperations.begin_update\n\n## 1.4.0b1 (2022-12-12)\n\n### Other Changes\n\n  - Added generated samples in github repo\n  - Drop support for python<3.7.0\n\n## 1.3.0 (2022-07-07)\n\n**Features**\n\n  - Added operation CachesOperations.begin_pause_priming_job\n  - Added operation CachesOperations.begin_resume_priming_job\n  - Added operation CachesOperations.begin_space_allocation\n  - Added operation CachesOperations.begin_start_priming_job\n  - Added operation CachesOperations.begin_stop_priming_job\n  - Model ApiOperationPropertiesServiceSpecification has a new parameter log_specifications\n  - Model Cache has a new parameter priming_jobs\n  - Model Cache has a new parameter space_allocation\n  - Model Cache has a new parameter upgrade_settings\n  - Model StorageTarget has a new parameter allocation_percentage\n\n## 1.2.0 (2022-03-22)\n\n**Features**\n\n  - Added operation StorageTargetOperations.begin_invalidate\n  - Added operation group AscUsagesOperations\n  - Model Cache has a new parameter zones\n\n## 1.1.0 (2021-09-30)\n\n**Features**\n\n  - Model StorageTarget has a new parameter state\n\n## 1.0.0 (2021-07-29)\n\n**Features**\n\n  - Model CacheEncryptionSettings has a new parameter rotation_to_latest_key_version_enabled\n  - Model CacheIdentity has a new parameter user_assigned_identities\n  - Added operation group StorageTargetOperations\n\n**Breaking changes**\n\n  - Operation StorageTargetsOperations.begin_delete has a new signature\n\n## 1.0.0b1 (2021-05-13)\n\nThis is beta preview version.\n\nThis version uses a next-generation code generator that introduces important breaking changes, but also important new features (like unified authentication and async programming).\n\n**General breaking changes**\n\n- Credential system has been completly revamped:\n\n  - `azure.common.credentials` or `msrestazure.azure_active_directory` instances are no longer supported, use the `azure-identity` classes instead: https://pypi.org/project/azure-identity/\n  - `credentials` parameter has been renamed `credential`\n\n- The `config` attribute no longer exists on a client, configuration should be passed as kwarg. Example: `MyClient(credential, subscription_id, enable_logging=True)`. For a complete set of\n  supported options, see the [parameters accept in init documentation of azure-core](https://github.com/Azure/azure-sdk-for-python/blob/main/sdk/core/azure-core/CLIENT_LIBRARY_DEVELOPER.md#available-policies)\n- You can't import a `version` module anymore, use `__version__` instead\n- Operations that used to return a `msrest.polling.LROPoller` now returns a `azure.core.polling.LROPoller` and are prefixed with `begin_`.\n- Exceptions tree have been simplified and most exceptions are now `azure.core.exceptions.HttpResponseError` (`CloudError` has been removed).\n- Most of the operation kwarg have changed. Some of the most noticeable:\n\n  - `raw` has been removed. Equivalent feature can be found using `cls`, a callback that will give access to internal HTTP response for advanced user\n  - For a complete set of\n  supported options, see the [parameters accept in Request documentation of azure-core](https://github.com/Azure/azure-sdk-for-python/blob/main/sdk/core/azure-core/CLIENT_LIBRARY_DEVELOPER.md#available-policies)\n\n**General new features**\n\n- Type annotations support using `typing`. SDKs are mypy ready.\n- This client has now stable and official support for async. Check the `aio` namespace of your package to find the async client.\n- This client now support natively tracing library like OpenCensus or OpenTelemetry. See this [tracing quickstart](https://github.com/Azure/azure-sdk-for-python/tree/main/sdk/core/azure-core-tracing-opentelemetry) for an overview.\n\n## 0.3.0 (2020-03-01)\n\n**Features**\n\n  - Model Cache has a new parameter security_settings\n  - Model Cache has a new parameter network_settings\n  - Model Cache has a new parameter identity\n  - Model Cache has a new parameter encryption_settings\n\n## 0.2.0 (2019-11-12)\n\n**Features**\n\n  - Added operation CachesOperations.create_or_update\n  - Added operation StorageTargetsOperations.create_or_update\n\n**Breaking changes**\n\n  - Removed operation CachesOperations.create\n  - Removed operation StorageTargetsOperations.create\n  - Removed operation StorageTargetsOperations.update\n\n## 0.1.0rc1 (2019-09-03)\n\n  - Initial Release\n",
    "bugtrack_url": null,
    "license": null,
    "summary": "Microsoft Azure Storagecache Management Client Library for Python",
    "version": "3.0.1",
    "project_urls": {
        "repository": "https://github.com/Azure/azure-sdk-for-python"
    },
    "split_keywords": [
        "azure",
        " azure sdk"
    ],
    "urls": [
        {
            "comment_text": null,
            "digests": {
                "blake2b_256": "d369aca15c58aecba7e398b886c98be36f0bf08910a9197a782e38d6eab5ec38",
                "md5": "16d19f373b44815b510cc51ebe2c11a8",
                "sha256": "97ad993282bc4c7c57ea69e339c2084749101e06294e03cd62075bebf6130f10"
            },
            "downloads": -1,
            "filename": "azure_mgmt_storagecache-3.0.1-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "16d19f373b44815b510cc51ebe2c11a8",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.9",
            "size": 165872,
            "upload_time": "2025-10-09T09:37:34",
            "upload_time_iso_8601": "2025-10-09T09:37:34.849179Z",
            "url": "https://files.pythonhosted.org/packages/d3/69/aca15c58aecba7e398b886c98be36f0bf08910a9197a782e38d6eab5ec38/azure_mgmt_storagecache-3.0.1-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": null,
            "digests": {
                "blake2b_256": "ac8f25c4398c581221e6c92d66cf495ec91949ef14547c74d258549dc0b3cea2",
                "md5": "2f353a41b1df666a71e4086690200315",
                "sha256": "8a6e33f2ff8d610c96e1afdbc8b1adbf80a4da928eed494f5c3fa51bf876275d"
            },
            "downloads": -1,
            "filename": "azure_mgmt_storagecache-3.0.1.tar.gz",
            "has_sig": false,
            "md5_digest": "2f353a41b1df666a71e4086690200315",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.9",
            "size": 121518,
            "upload_time": "2025-10-09T09:37:33",
            "upload_time_iso_8601": "2025-10-09T09:37:33.426624Z",
            "url": "https://files.pythonhosted.org/packages/ac/8f/25c4398c581221e6c92d66cf495ec91949ef14547c74d258549dc0b3cea2/azure_mgmt_storagecache-3.0.1.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2025-10-09 09:37:33",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "Azure",
    "github_project": "azure-sdk-for-python",
    "travis_ci": false,
    "coveralls": true,
    "github_actions": true,
    "lcname": "azure-mgmt-storagecache"
}
        
Elapsed time: 3.27736s