Skip to content

Commit 657cc16

Browse files
author
Hovsep
authored
Release 1.6 notes. (#171)
1 parent 9935f0a commit 657cc16

File tree

3 files changed

+197
-24
lines changed

3 files changed

+197
-24
lines changed

README.md

+45-22
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11

22
# Azure Management Libraries for .NET
33

4-
This README is based on the released stable version (1.4). If you are looking for other releases, see [More Information](#more-information)
4+
This README is based on the released stable version (1.6). If you are looking for other releases, see [More Information](#more-information)
55

66
The Azure Management Libraries for .NET is a higher-level, object-oriented API for managing Azure resources. Libraries are built on the lower-level, request-response style [auto generated clients](https://github.com/Azure/azure-sdk-for-net/tree/AutoRest) and can run side-by-side with [auto generated clients](https://github.com/Azure/azure-sdk-for-net/tree/AutoRest).
77

@@ -20,8 +20,8 @@ The Azure Management Libraries for .NET is a higher-level, object-oriented API f
2020
* [Contribute code](#contribute-code)
2121
* [More information](#more-information)
2222

23-
## Feature Availability and Road Map ##
24-
:triangular_flag_on_post: *as of Version 1.4*
23+
## Feature Availability and Road Map
24+
:triangular_flag_on_post: *as of Version 1.6*
2525

2626
<table>
2727
<tr>
@@ -38,8 +38,8 @@ The Azure Management Libraries for .NET is a higher-level, object-oriented API f
3838
</tr>
3939
<tr>
4040
<td>Storage</td>
41-
<td>Storage accounts<br>Encryption</td>
42-
<td></td>
41+
<td>Storage accounts<br>Encryption (<i>deprecated</i>)</td>
42+
<td>Encryption (Blob)<br>Encryption (File)</td>
4343
<td></td>
4444
</tr>
4545
<tr>
@@ -57,8 +57,8 @@ The Azure Management Libraries for .NET is a higher-level, object-oriented API f
5757
<tr>
5858
<td>More services</td>
5959
<td>Resource Manager<br>Key Vault<br>Redis<br>CDN<br>Batch<br>Service bus</td>
60-
<td valign="top">Web apps<br>Function Apps<br>Graph RBAC<br>Cosmos DB<br>Search</td>
61-
<td valign="top">Monitor<br>Data Lake<br>Batch AI</td>
60+
<td valign="top">Web apps<br>Function Apps<br>Graph RBAC<br>Cosmos DB<br>Monitor<br>Batch AI<br>Search</td>
61+
<td valign="top">Data Lake</td>
6262
</tr>
6363
<tr>
6464
<td>Fundamentals</td>
@@ -72,7 +72,7 @@ The Azure Management Libraries for .NET is a higher-level, object-oriented API f
7272
7373
## Code snippets and samples
7474

75-
#### Azure Authentication
75+
### Azure Authentication
7676

7777
The `Azure` class is the simplest entry point for creating and interacting with Azure resources.
7878

@@ -161,10 +161,12 @@ var virtualMachineScaleSet = azure.VirtualMachineScaleSets.Define(vmssName)
161161
<li><a href="https://github.com/Azure-Samples/managed-disk-dotnet-create-virtual-machine-using-specialized-disk-from-snapshot">Create virtual machine using specialized VHD from snapshot</a></li>
162162
<li><a href="https://github.com/Azure-Samples/managed-disk-dotnet-convert-existing-virtual-machines-to-use-managed-disks">Convert virtual machines to use managed disks</a></li>
163163
<li><a href="https://github.com/Azure-Samples/compute-dotnet-manage-virtual-machine-with-unmanaged-disks">Manage virtual machine with unmanaged disks</a></li>
164-
<li><a href="https://github.com/Azure-Samples/aad-dotnet-manage-resources-from-vm-with-msi">Manage Azure resources from a virtual machine with managed service identity (MSI)</a></li>
164+
<li><a href="https://github.com/Azure-Samples/aad-dotnet-manage-resources-from-vm-with-msi">Manage Azure resources from a virtual machine with system assigned managed service identity (MSI)</a></li>
165165
<li><a href="https://github.com/Azure-Samples/compute-dotnet-manage-vm-from-vm-with-msi-credentials">Manage Azure resources from a virtual machine with managed service identity (MSI) credentials</a></li>
166+
<li><a href="https://github.com/Azure-Samples/compute-dotnet-manage-user-assigned-msi-enabled-virtual-machine">Manage Azure resources from a virtual machine with system assigned managed service identity (MSI)</a></li>
166167
<li><a href="https://github.com/Azure-Samples/compute-dotnet-manage-vms-in-availability-zones">Manage virtual machines in availability zones</a></li>
167168
<li><a href="https://github.com/Azure-Samples/compute-dotnet-manage-vmss-in-availability-zones">Manage virtual machine scale sets in availability zones</a></li>
169+
<li><a href="https://github.com/Azure-Samples/compute-dotnet-list-compute-skus">List compute SKUs</a></li>
168170
</ul></td>
169171
</tr>
170172
<tr>
@@ -183,8 +185,7 @@ var virtualMachineScaleSet = azure.VirtualMachineScaleSets.Define(vmssName)
183185
<li><a href="https://github.com/Azure-Samples/compute-dotnet-manage-virtual-machine-scale-sets-async">Manage virtual machine scale sets (behind an Internet facing load balancer) asynchronously</a></li>
184186
<li><a href="https://github.com/Azure-Samples/compute-dotnet-manage-virtual-machine-scale-set-with-unmanaged-disks">Manage virtual machine scale sets with unmanaged disks</a></li>
185187
</ul></td>
186-
</tr>
187-
<tr>
188+
</tr>
188189
</table>
189190

190191
### Networking
@@ -279,6 +280,7 @@ var applicationGateway = azure.ApplicationGateways.Define("myFirstAppGateway")
279280
<li><a href="https://github.com/Azure-Samples/network-dotnet-use-network-watcher-to-check-connectivity">Use network watcher to check connectivity between virtual machines in peered networks</a></li>
280281
<li><a href="https://github.com/Azure-Samples/network-dotnet-manage-virtual-network-with-site-to-site-vpn-connection">Manage virtual network with site-to-site VPN connection</a></li>
281282
<li><a href="https://github.com/Azure-Samples/network-dotnet-manage-virtual-network-to-virtual-network-vpn-connection">Manage virtual network to virtual network VPN connection</a></li>
283+
<li><a href="https://github.com/Azure-Samples/network-dotnet-manage-vpn-client-connection">Manage client to virtual network VPN connection</a></li>
282284
</ul>
283285
</td>
284286
</tr>
@@ -319,7 +321,7 @@ You can create a Web App instance by using another `define() … create()` metho
319321
var webApp = azure.WebApps.Define(appName)
320322
.WithRegion(Region.USWest)
321323
.WithNewResourceGroup(rgName)
322-
.WithNewFreeAppServicePlan()
324+
.WithNewWindowsPlan(PricingTier.StandardS1)
323325
.Create();
324326
```
325327

@@ -342,6 +344,7 @@ var webApp = azure.WebApps.Define(appName)
342344
<li><a href="https://github.com/Azure-Samples/app-service-dotnet-manage-storage-connections-for-web-apps">Manage storage connections for Web apps</a></li>
343345
<li><a href="https://github.com/Azure-Samples/app-service-dotnet-manage-data-connections-for-web-apps">Manage data connections (such as SQL database and Redis cache) for Web apps</a></li>
344346
<li><a href="https://github.com/Azure-Samples/app-service-dotnet-manage-authentication-for-web-apps">Manage authentication for Web apps</a></li>
347+
<li><a href="https://github.com/Azure-Samples/app-service-dotnet-access-key-vault-by-msi-for-web-apps">Safegaurd Web app secrets in Key Vault</a></li>
345348
</ul></td>
346349
</tr>
347350
<tr>
@@ -363,18 +366,19 @@ var webApp = azure.WebApps.Define(appName)
363366
<li><a href="https://github.com/Azure-Samples/app-service-dotnet-manage-functions-with-custom-domains">Manage functions with custom domains</a></li>
364367
<li><a href="https://github.com/Azure-Samples/app-service-dotnet-configure-deployment-sources-for-functions">Configure deployment sources for functions</a></li>
365368
<li><a href="https://github.com/Azure-Samples/app-service-dotnet-manage-authentication-for-functions">Manage authentication for functions</a></li>
369+
<li><a href="https://github.com/Azure-Samples/app-service-dotnet-manage-logs-for-function-apps">Get function logs</a></li>
366370
</ul></td>
367371
</tr>
368372
</table>
369373

370374
### Databases and Storage
371375

372-
#### Create a Cosmos DB with DocumentDB Programming Model
376+
#### Create a Cosmos DB with CosmosDB Programming Model
373377

374378
You can create a Cosmos DB account by using a `define() … create()` method chain.
375379

376380
```csharp
377-
var documentDBAccount = azure.DocumentDBAccounts.Define(docDBName)
381+
var documentDBAccount = azure.CosmosDBAccounts.Define(cosmosDBName)
378382
.WithRegion(Region.USEast)
379383
.WithNewResourceGroup(rgName)
380384
.WithKind(DatabaseAccountKind.GlobalDocumentDB)
@@ -418,6 +422,7 @@ var database = sqlServer.Databases.Define(databaseName)
418422
<td><ul style="list-style-type:circle">
419423
<li><a href="https://github.com/Azure-Samples/storage-dotnet-manage-storage-accounts">Manage storage accounts</a></li>
420424
<li><a href="https://github.com/Azure-Samples/storage-dotnet-manage-storage-accounts-async">Manage storage accounts asynchronously</a></li>
425+
<li><a href="https://github.com/Azure-Samples/storage-dotnet-manage-storage-account-network-rules">Manage network rules of a storage account</a></li>
421426
</ul></td>
422427
</tr>
423428
<tr>
@@ -432,10 +437,10 @@ var database = sqlServer.Databases.Define(databaseName)
432437
<tr>
433438
<td>Cosmos DB</td>
434439
<td><ul style="list-style-type:circle">
435-
<li><a href="https://github.com/Azure-Samples/cosmosdb-dotnet-create-documentdb-and-configure-for-high-availability">Create a DocumentDB and configure it for high availability</a></li>
436-
<li><a href="https://github.com/Azure-Samples/cosmosdb-dotnet-create-documentdb-and-configure-for-eventual-consistency">Create a DocumentDB and configure it with eventual consistency</a></li>
437-
<li><a href="https://github.com/Azure-Samples/cosmosdb-dotnet-create-documentdb-and-configure-firewall">Create a DocumentDB, configure it for high availability and create a firewall to limit access from an approved set of IP addresses</li>
438-
<li><a href="https://github.com/Azure-Samples/cosmosdb-dotnet-create-documentdb-and-get-mongodb-connection-string">Create a DocumentDB and get MongoDB connection string</li>
440+
<li><a href="https://github.com/Azure-Samples/cosmosdb-dotnet-create-documentdb-and-configure-for-high-availability">Create a CosmosDB and configure it for high availability</a></li>
441+
<li><a href="https://github.com/Azure-Samples/cosmosdb-dotnet-create-documentdb-and-configure-for-eventual-consistency">Create a CosmosDB and configure it with eventual consistency</a></li>
442+
<li><a href="https://github.com/Azure-Samples/cosmosdb-dotnet-create-documentdb-and-configure-firewall">Create a CosmosDB, configure it for high availability and create a firewall to limit access from an approved set of IP addresses</li>
443+
<li><a href="https://github.com/Azure-Samples/cosmosdb-dotnet-create-documentdb-and-get-mongodb-connection-string">Create a CosmosDB and get MongoDB connection string</li>
439444
</ul></td>
440445
</tr>
441446
</table>
@@ -509,6 +514,13 @@ var database = sqlServer.Databases.Define(databaseName)
509514
</ul></td>
510515
</tr>
511516

517+
<tr>
518+
<td>Monitor</td>
519+
<td><ul style="list-style-type:circle">
520+
<li><a href="https://github.com/Azure-Samples/monitor-dotnet-query-metrics-activitylogs">Get metrics and activity logs for a resource</a></li>
521+
</ul></td>
522+
</tr>
523+
512524
<tr>
513525
<td>CDN</td>
514526
<td><ul style="list-style-type:circle">
@@ -522,6 +534,13 @@ var database = sqlServer.Databases.Define(databaseName)
522534
<li><a href="https://github.com/Azure-Samples/batch-dotnet-manage-batch-accounts">Manage batch accounts</a></li>
523535
</ul></td>
524536
</tr>
537+
<tr>
538+
<td>Batch AI</td>
539+
<td><ul style="list-style-type:circle">
540+
<li><a href="https://github.com/Azure-Samples/batchai-dotnet-run-batchai-job">Create Batch AI cluster and execute AI job</a></li>
541+
</ul></td>
542+
</tr>
543+
525544
<tr>
526545
<td>Search</td>
527546
<td><ul style="list-style-type:circle">
@@ -534,13 +553,14 @@ var database = sqlServer.Databases.Define(databaseName)
534553

535554
### Latest stable release
536555

537-
**1.4** release builds are available on NuGet:
556+
**1.6** release builds are available on NuGet:
538557

539-
|Azure Management Library | Package name | Stable (1.4 release) |
558+
|Azure Management Library | Package name | Stable (1.6 release) |
540559
|---------------------------------------------|-----------------------------------------------------|------------------------|
541560
|Azure Management Client (wrapper package) | `Microsoft.Azure.Management.Fluent` | [![NuGet](https://img.shields.io/nuget/v/Microsoft.Azure.Management.Fluent.svg?style=flat-square&label=nuget)](https://www.nuget.org/packages/Microsoft.Azure.Management.Fluent/) |
542561
|App Service (Web Apps and Functions) | `Microsoft.Azure.Management.AppService.Fluent` | [![NuGet](https://img.shields.io/nuget/v/Microsoft.Azure.Management.AppService.Fluent.svg?style=flat-square&label=nuget)](https://www.nuget.org/packages/Microsoft.Azure.Management.AppService.Fluent/) |
543562
|Batch | `Microsoft.Azure.Management.Batch.Fluent` | [![NuGet](https://img.shields.io/nuget/v/Microsoft.Azure.Management.Batch.Fluent.svg?style=flat-square&label=nuget)](https://www.nuget.org/packages/Microsoft.Azure.Management.Batch.Fluent/) |
563+
|Batch AI | `Microsoft.Azure.Management.BatchAI.Fluent` | [![NuGet](https://img.shields.io/nuget/v/Microsoft.Azure.Management.BatchAI.Fluent.svg?style=flat-square&label=nuget)](https://www.nuget.org/packages/Microsoft.Azure.Management.BatchAI.Fluent/) |
544564
|CDN | `Microsoft.Azure.Management.Cdn.Fluent` | [![NuGet](https://img.shields.io/nuget/v/Microsoft.Azure.Management.Cdn.Fluent.svg?style=flat-square&label=nuget)](https://www.nuget.org/packages/Microsoft.Azure.Management.Cdn.Fluent/) |
545565
|Virtual Machines, Virtual Machine Scale Sets, Azure Container Services| `Microsoft.Azure.Management.Compute.Fluent` | [![NuGet](https://img.shields.io/nuget/v/Microsoft.Azure.Management.Compute.Fluent.svg?style=flat-square&label=nuget)](https://www.nuget.org/packages/Microsoft.Azure.Management.Compute.Fluent/) |
546566
|Container Instance | `Microsoft.Azure.Management.ContainerInstance.Fluent`| [![NuGet](https://img.shields.io/nuget/v/Microsoft.Azure.Management.ContainerInstance.Fluent.svg?style=flat-square&label=nuget)](https://www.nuget.org/packages/Microsoft.Azure.Management.ContainerInstance.Fluent/) |
@@ -551,6 +571,8 @@ var database = sqlServer.Databases.Define(databaseName)
551571
|Graph RBAC | `Microsoft.Azure.Management.Graph.RBAC.Fluent` | [![NuGet](https://img.shields.io/nuget/v/Microsoft.Azure.Management.Graph.RBAC.Fluent.svg?style=flat-square&label=nuget)](https://www.nuget.org/packages/Microsoft.Azure.Management.Graph.RBAC.Fluent/) |
552572
|Key Vault | `Microsoft.Azure.Management.KeyVault.Fluent` | [![NuGet](https://img.shields.io/nuget/v/Microsoft.Azure.Management.KeyVault.Fluent.svg?style=flat-square&label=nuget)](https://www.nuget.org/packages/Microsoft.Azure.Management.KeyVault.Fluent/) |
553573
|Locks | `Microsoft.Azure.Management.Locks.Fluent` | [![NuGet](https://img.shields.io/nuget/v/Microsoft.Azure.Management.Locks.Fluent.svg?style=flat-square&label=nuget)](https://www.nuget.org/packages/Microsoft.Azure.Management.Locks.Fluent/) |
574+
|Monitor | `Microsoft.Azure.Management.Monitor.Fluent` | [![NuGet](https://img.shields.io/nuget/v/Microsoft.Azure.Management.Monitor.Fluent.svg?style=flat-square&label=nuget)](https://www.nuget.org/packages/Microsoft.Azure.Management.Monitor.Fluent/) |
575+
|Msi | `Microsoft.Azure.Management.Msi.Fluent` | [![NuGet](https://img.shields.io/nuget/v/Microsoft.Azure.Management.Msi.Fluent.svg?style=flat-square&label=nuget)](https://www.nuget.org/packages/Microsoft.Azure.Management.Msi.Fluent/) |
554576
|Networking | `Microsoft.Azure.Management.Network.Fluent` | [![NuGet](https://img.shields.io/nuget/v/Microsoft.Azure.Management.Network.Fluent.svg?style=flat-square&label=nuget)](https://www.nuget.org/packages/Microsoft.Azure.Management.Network.Fluent/) |
555577
|Redis Cache | `Microsoft.Azure.Management.Redis.Fluent` | [![NuGet](https://img.shields.io/nuget/v/Microsoft.Azure.Management.Redis.Fluent.svg?style=flat-square&label=nuget)](https://www.nuget.org/packages/Microsoft.Azure.Management.Redis.Fluent/) |
556578
|Resource Manager | `Microsoft.Azure.Management.ResourceManager.Fluent` | [![NuGet](https://img.shields.io/nuget/v/Microsoft.Azure.Management.ResourceManager.Fluent.svg?style=flat-square&label=nuget)](https://www.nuget.org/packages/Microsoft.Azure.Management.ResourceManager.Fluent/) |
@@ -569,7 +591,7 @@ var database = sqlServer.Databases.Define(databaseName)
569591

570592
## Upgrading from older versions
571593

572-
If you are migrating your code from 1.3.x to 1.4.x, you can use these release notes for [preparing your code for 1.4 from 1.3](./notes/prepare-for-1.4.md).
594+
If you are migrating your code from 1.4.x to 1.6.x, you can use these release notes for [preparing your code for 1.6 from 1.4](./notes/prepare-for-1.6.md).
573595

574596
In general, Azure Libraries for .Net follow [semantic versioning](http://semver.org/), so user code should continue working in a compatible fashion between minor versions of the same major version release train, with the following caveats:
575597

@@ -604,6 +626,7 @@ If you would like to become an active contributor to this project please follow
604626

605627
| Version | SHA1 | Remarks |
606628
|-------------------|-------------------------------------------------------------------------------------------|-------------------------------------------------------|
629+
| 1.6 | [1.6](https://github.com/Azure/azure-libraries-for-net/releases/tag/Fluent-v1.6) | Tagged release for 1.6 version of Azure management libraries |
607630
| 1.4 | [1.4](https://github.com/Azure/azure-libraries-for-net/releases/tag/Fluent-v1.4) | Tagged release for 1.4 version of Azure management libraries |
608631
| 1.3 | [1.3](https://github.com/Azure/azure-libraries-for-net/releases/tag/Fluent-v1.3) | Tagged release for 1.3 version of Azure management libraries |
609632
| 1.2 | [1.2](https://github.com/Azure/azure-sdk-for-net/releases/tag/Fluent-v1.2) | Tagged release for 1.2 version of Azure management libraries |
@@ -612,7 +635,7 @@ If you would like to become an active contributor to this project please follow
612635
| 1.0.0-beta5 | [1.0.0-beta5](https://github.com/Azure/azure-sdk-for-net/releases/tag/Fluent-v1.0.0-beta5) | Tagged release for 1.0.0-beta5 version of Azure management libraries |
613636
| 1.0.0-beta4 | [1.0.0-beta4](https://github.com/Azure/azure-sdk-for-net/releases/tag/Fluent-v1.0.0-beta4) | Tagged release for 1.0.0-beta4 version of Azure management libraries |
614637
| 1.0.0-beta3 | [1.0.0-beta3](https://github.com/Azure/azure-sdk-for-net/releases/tag/Fluent-v1.0.0-beta3) | Tagged release for 1.0.0-beta3 version of Azure management libraries |
615-
| AutoRest | [AutoRest](https://github.com/selvasingh/azure-sdk-for-net/tree/AutoRest) | Main branch for AutoRest generated raw clients |
638+
| AutoRest | [AutoRest](https://github.com/Azure/azure-sdk-for-net/tree/AutoRest) | Main branch for AutoRest generated raw clients |
616639

617640
---
618641

notes/prepare-for-1.4.md

+2-2
Original file line numberDiff line numberDiff line change
@@ -1,12 +1,12 @@
11
# Prepare for Azure Management Libraries for .NET 1.4.0 #
22

3-
Steps to migrate code that uses Azure Management Libraries for .NET from 1.4 to 1.4 ...
3+
Steps to migrate code that uses Azure Management Libraries for .NET from 1.3 to 1.4 ...
44

55
> If this note missed any breaking changes, please open a pull request.
66
77
V1.4 is backwards compatible with V1.3 in the APIs intended for public use that reached the general availability (stable) stage in V1.x.
88

9-
Some breaking changes There were no breaking changes introduced even in APIs that were still in Beta in V1.2, as indicated by their inheritance from the `IBeta` interface.
9+
There were no breaking changes introduced even in APIs that were still in Beta in V1.2, as indicated by their inheritance from the `IBeta` interface.
1010

1111
## Renames/Removals
1212

0 commit comments

Comments
 (0)