|
| 1 | +# Microsoft Azure DeploymentStacks management client library for .NET |
| 2 | + |
| 3 | +An Azure deployment stack is a resource that enables you to manage a group of Azure resources as a single, cohesive unit. When you submit a Bicep file or an Azure Resource Manager JSON template (ARM JSON template) to a deployment stack, you define the resources that the stack manages. If you remove a resource from the template, it can be detached or deleted based on the specified actionOnUnmanage behavior of the deployment stack. You can restrict access to the deployment stack using Azure role-based access control (Azure RBAC), similar to other Azure resources. |
| 4 | + |
| 5 | +This library follows the [new Azure SDK guidelines](https://azure.github.io/azure-sdk/general_introduction.html), and provides many core capabilities: |
| 6 | + |
| 7 | + - Support MSAL.NET, Azure.Identity is out of box for supporting MSAL.NET. |
| 8 | + - Support [OpenTelemetry](https://opentelemetry.io/) for distributed tracing. |
| 9 | + - HTTP pipeline with custom policies. |
| 10 | + - Better error-handling. |
| 11 | + - Support uniform telemetry across all languages. |
| 12 | + |
| 13 | +## Getting started |
| 14 | + |
| 15 | +### Install the package |
| 16 | + |
| 17 | +Install the Microsoft Azure DeploymentStacks management library for .NET with [NuGet](https://www.nuget.org/): |
| 18 | + |
| 19 | +```dotnetcli |
| 20 | +dotnet add package Azure.ResourceManager.Resources.DeploymentStacks --prerelease |
| 21 | +``` |
| 22 | + |
| 23 | +### Prerequisites |
| 24 | + |
| 25 | +* You must have an [Microsoft Azure subscription](https://azure.microsoft.com/free/dotnet/). |
| 26 | + |
| 27 | +### Authenticate the Client |
| 28 | + |
| 29 | +To create an authenticated client and start interacting with Microsoft Azure resources, see the [quickstart guide here](https://github.com/Azure/azure-sdk-for-net/blob/main/doc/dev/mgmt_quickstart.md). |
| 30 | + |
| 31 | +## Key concepts |
| 32 | + |
| 33 | +Key concepts of the Microsoft Azure SDK for .NET can be found [here](https://azure.github.io/azure-sdk/dotnet_introduction.html) |
| 34 | + |
| 35 | +## Documentation |
| 36 | + |
| 37 | +Documentation is available to help you learn how to use this package: |
| 38 | + |
| 39 | +- [Quickstart](https://github.com/Azure/azure-sdk-for-net/blob/main/doc/dev/mgmt_quickstart.md). |
| 40 | +- [API References](https://docs.microsoft.com/dotnet/api/?view=azure-dotnet). |
| 41 | +- [Authentication](https://github.com/Azure/azure-sdk-for-net/blob/main/sdk/identity/Azure.Identity/README.md). |
| 42 | + |
| 43 | +## Examples |
| 44 | + |
| 45 | +Code samples for using the management library for .NET can be found in the following locations |
| 46 | +- [.NET Management Library Code Samples](https://aka.ms/azuresdk-net-mgmt-samples) |
| 47 | + |
| 48 | +## Troubleshooting |
| 49 | + |
| 50 | +- File an issue via [GitHub Issues](https://github.com/Azure/azure-sdk-for-net/issues). |
| 51 | +- Check [previous questions](https://stackoverflow.com/questions/tagged/azure+.net) or ask new ones on Stack Overflow using Azure and .NET tags. |
| 52 | + |
| 53 | +## Next steps |
| 54 | + |
| 55 | +For more information about Microsoft Azure SDK, see [this website](https://azure.github.io/azure-sdk/). |
| 56 | + |
| 57 | +## Contributing |
| 58 | + |
| 59 | +For details on contributing to this repository, see the [contributing |
| 60 | +guide][cg]. |
| 61 | + |
| 62 | +This project welcomes contributions and suggestions. Most contributions |
| 63 | +require you to agree to a Contributor License Agreement (CLA) declaring |
| 64 | +that you have the right to, and actually do, grant us the rights to use |
| 65 | +your contribution. For details, visit <https://cla.microsoft.com>. |
| 66 | + |
| 67 | +When you submit a pull request, a CLA-bot will automatically determine |
| 68 | +whether you need to provide a CLA and decorate the PR appropriately |
| 69 | +(for example, label, comment). Follow the instructions provided by the |
| 70 | +bot. You'll only need to do this action once across all repositories |
| 71 | +using our CLA. |
| 72 | + |
| 73 | +This project has adopted the [Microsoft Open Source Code of Conduct][coc]. For |
| 74 | +more information, see the [Code of Conduct FAQ][coc_faq] or contact |
| 75 | +<[email protected]> with any other questions or comments. |
| 76 | + |
| 77 | +<!-- LINKS --> |
| 78 | +[cg]: https://github.com/Azure/azure-sdk-for-net/blob/main/sdk/resourcemanager/Azure.ResourceManager/docs/CONTRIBUTING.md |
| 79 | +[coc]: https://opensource.microsoft.com/codeofconduct/ |
| 80 | +[coc_faq]: https://opensource.microsoft.com/codeofconduct/faq/ |
0 commit comments