@microsoft/terraform-cdk-constructs 0.0.3-pre.7 → 1.2.0

package/LICENSE

@@ -1,21 +1,19 @@
-    MIT License
+Copyright (c) 2025 Microsoft
 
-    Copyright (c) Microsoft Corporation.
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
 
-    Permission is hereby granted, free of charge, to any person obtaining a copy
-    of this software and associated documentation files (the "Software"), to deal
-    in the Software without restriction, including without limitation the rights
-    to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-    copies of the Software, and to permit persons to whom the Software is
-    furnished to do so, subject to the following conditions:
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
 
-    The above copyright notice and this permission notice shall be included in all
-    copies or substantial portions of the Software.
-
-    THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-    IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-    FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-    AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-    LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-    OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-    SOFTWARE
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,129 +1,233 @@
 # Azure Terraform CDK Constructs
-Welcome to the Azure Terraform CDK Constructs project! This library offers a comprehensive suite of L2 Constructs designed to simplify and enhance the experience of building and managing Azure infrastructure with the Cloud Development Kit for Terraform (CDKTF).
 
-## Benefits of Using L2 Constructs
+Welcome to the Azure Terraform CDK Constructs project! This library offers Azure L2 Constructs using the AZAPI provider for direct Azure REST API access, providing immediate access to new Azure features and API versions.
 
-With L2 Constructs, you get the following benefits:
+## 🚀 Version 1.0.0 - AZAPI Provider Migration
 
-- **Abstraction**: Higher-level abstractions over Azure resources make your infrastructure code more declarative and easier to understand.
-- **Reusability**: Encapsulate common patterns and best practices in your infrastructure code, promoting reusability across different projects and teams.
-- **Rapid Development**: Accelerate your cloud development process with pre-built constructs that have been tested for common use cases, allowing you to focus on your unique application logic.
-- **Direct IDE Integration**: Access detailed documentation directly within your Integrated Development Environment (IDE), streamlining your development workflow: ![alt text](./docs/images/ide-documentation.png)
+**Breaking Change Notice:** Version 1.0.0 represents a major architectural shift from AzureRM provider to AZAPI provider. This migration provides:
 
+- **Direct Azure REST API Access**: No dependency on AzureRM provider
+- **Immediate Feature Access**: Get new Azure features as soon as they're available in Azure APIs
+- **Version-Specific Implementations**: Multiple API versions supported for each service
+- **Enhanced Type Safety**: Improved IDE support and compile-time validation
+- **Included Provider Bindings**: AZAPI provider classes are included - no need to generate bindings
 
-## Quick Example
+## Benefits of Using AZAPI L2 Constructs
 
-This is a quick example that showcases the simplicity and power of L2 Constructs. We'll create a storage account, add a container to it, and then upload a blob—all with a few lines of intuitive, object-oriented code:
+With AZAPI L2 Constructs, you get the following benefits:
 
-```typescript
+- **Direct API Access**: Bypass provider limitations and access Azure REST APIs directly
+- **Version Flexibility**: Choose specific API versions for your resources
+- **Rapid Feature Adoption**: Access new Azure features immediately without waiting for provider updates
+- **Enhanced Abstraction**: Higher-level abstractions over Azure resources with type safety
+- **Built-in Monitoring**: One-line setup for comprehensive monitoring with customizable alerts and diagnostic settings
+- **Schema Validation**: Automatic validation of properties against Azure API schemas
+- **Reusability**: Encapsulate common patterns and best practices in your infrastructure code
+- **Testing Utilities**: Helper functions for integration tests including naming conventions, metadata, and resource cleanup
+- **Direct IDE Integration**: Access detailed documentation directly within your IDE
+- **Zero Provider Setup**: AZAPI provider bindings included in the package
 
-// Create a new instance of a storage account as an object
-const sa = new azcdk.azure_storageaccount.Account(stack, "storageaccount", {
-  name: "testStorageAccount",
-  location: "eastus",
-});
+## Currently Supported Services
 
-// Add a container to the storage account by calling a method on the storage account object
-const container = sa.addContainer("testcontainer");
+### Compute
 
-// Add a blob to the container by calling a method on the container object
-// The path "../../../test.txt" points to the source file to be uploaded as a blob
-container.addBlob("testblob.txt", "../../../test.txt");
-```
+| Service | API Versions | Monitoring Support | Status |
+|---------|-------------|-------------------|--------|
+| [Virtual Machines](./src/azure-virtualmachine/README.md) | 2024-07-01, 2024-11-01, 2025-04-01 | ✅ Built-in | ✅ Available |
+| [AKS Clusters](./src/azure-aks/README.md) | 2025-05-01, 2025-07-01, 2025-08-01 | ✅ Built-in | ✅ Available |
+| [Virtual Machine Scale Sets](./src/azure-vmss/README.md) | 2025-01-02, 2025-02-01, 2025-04-01 | ✅ Built-in | ✅ Available |
 
+### Networking
 
+| Service | API Versions | Status |
+|---------|-------------|--------|
+| [Virtual Networks](./src/azure-virtualnetwork/README.md) | 2024-07-01, 2024-10-01, 2025-01-01 | ✅ Available |
+| [Subnets](./src/azure-subnet/README.md) | 2024-07-01, 2024-10-01, 2025-01-01 | ✅ Available |
+| [Network Interfaces](./src/azure-networkinterface/README.md) | 2024-07-01, 2024-10-01, 2025-01-01 | ✅ Available |
+| [Network Security Groups](./src/azure-networksecuritygroup/README.md) | 2024-07-01, 2024-10-01, 2025-01-01 | ✅ Available |
+| [Public IP Addresses](./src/azure-publicipaddress/README.md) | 2024-07-01, 2024-10-01, 2025-01-01 | ✅ Available |
 
-## Getting Started
+### Monitoring & Alerting
+
+| Service | API Versions | Status |
+|---------|-------------|--------|
+| [Action Groups](./src/azure-actiongroup/README.md) | 2021-09-01 | ✅ Available |
+| [Metric Alerts](./src/azure-metricalert/README.md) | 2018-03-01 | ✅ Available |
+| [Activity Log Alerts](./src/azure-activitylogalert/README.md) | 2020-10-01 | ✅ Available |
+| [Diagnostic Settings](./src/azure-diagnosticsettings/README.md) | 2016-09-01, 2021-05-01-preview | ✅ Available |
+
+### Foundation
 
-This guide will walk you through the process of using the Azure L2 Constructs to define and provision infrastructure on Azure. 
+| Service | API Versions | Status |
+|---------|-------------|--------|
+| [Resource Groups](./src/azure-resourcegroup/README.md) | 2024-11-01, 2025-01-01, 2025-03-01 | ✅ Available |
+| [Storage Accounts](./src/azure-storageaccount/README.md) | 2023-01-01, 2023-05-01, 2024-01-01 | ✅ Available |
+
+## Quick Example
+
+Create Azure resources using AZAPI provider:
+
+```typescript
+import * as azcdk from "@microsoft/terraform-cdk-constructs";
+import { Construct } from 'constructs';
+import { App, TerraformStack } from 'cdktf';
+
+class AzureAppInfra extends TerraformStack {
+  constructor(scope: Construct, name: string) {
+    super(scope, name);
+
+    // Create a new Azure Resource Group using AZAPI
+    const rg = new azcdk.azure_resourcegroup.ResourceGroup(this, "resourcegroup", {
+      name: "rg-myapp-prod",
+      location: "eastus",
+      tags: {
+        environment: "production",
+        project: "myapp"
+      }
+    });
+
+    // Create a Storage Account
+    new azcdk.azure_storageaccount.StorageAccount(this, "storage", {
+      name: "mystorageaccount",
+      location: "eastus",
+      resourceGroupId: rg.id,
+      sku: { name: "Standard_LRS" }
+    });
+  }
+}
+
+const app = new App();
+new AzureAppInfra(app, 'cdk');
+app.synth();
+```
+
+## Getting Started
 
 ### Prerequisites
-Make sure you have Node.js and npm installed on your machine. These will be used to install the CDK for Terraform and Azure provider packages.
+- Node.js and npm installed (for TypeScript/JavaScript)
+- Azure CLI configured with appropriate permissions
 
 ### Installation
 
-First, install the CDK for Terraform CLI globally using npm:
+Install the CDK for Terraform CLI globally:
 
 ```sh
 npm install -g cdktf-cli
 ```
 
-Next, initialize a new CDK for Terraform project with TypeScript template:
+Initialize a new CDK for Terraform project:
 ```sh
 cdktf init --template="TypeScript" --local
 ```
-Install the AzureRM provider for CDKTF:
+
+Install the Microsoft Terraform CDK constructs (includes AZAPI provider bindings):
 
 ```sh
-npm install @cdktf/provider-azurerm
+npm install @microsoft/terraform-cdk-constructs
 ```
 
-Then, add the Microsoft Terraform CDK constructs for Azure:
+That's it! The AZAPI provider classes are included in the package, so you don't need to configure additional providers or generate bindings.
 
-```sh
-npm install @micrsoft/terraform-cdk-constructs
+## Built-in Monitoring & Alerting
 
+Azure L2 Constructs include comprehensive monitoring capabilities that can be enabled with a single method call. The monitoring framework automatically creates metric alerts, diagnostic settings, and activity log alerts for supported resources.
+
+### Quick Example
+
+```typescript
+import { VirtualMachine } from "@microsoft/terraform-cdk-constructs/azure-virtualmachine";
+import { ActionGroup } from "@microsoft/terraform-cdk-constructs/azure-actiongroup";
+
+// Enable monitoring with one line
+const vm = new VirtualMachine(this, "vm", {
+  name: "my-vm",
+  // ... VM configuration ...
+  monitoring: VirtualMachine.defaultMonitoring(actionGroup.id, workspaceId),
+});
 ```
 
+### Supported Resources
+
+| Resource | Monitoring Documentation |
+|----------|-------------------------|
+| Virtual Machines | [VM Monitoring Guide](./src/azure-virtualmachine/README.md#monitoring) |
+| AKS Clusters | [AKS Monitoring Guide](./src/azure-aks/README.md#monitoring) |
+| Virtual Machine Scale Sets | [VMSS Monitoring Guide](./src/azure-vmss/README.md#monitoring) |
+| Storage Accounts | [Storage Monitoring Guide](./src/azure-storageaccount/README.md#monitoring) |
+
+See the [Monitoring Guide](./docs/monitoring-guide.md) for comprehensive documentation on monitoring capabilities, customization options, and best practices.
+
+## Networking Constructs
+
+Build complete Azure networking infrastructure with type-safe constructs that provide automatic validation and version management.
+
+### Available Components
+
+| Component | Documentation |
+|-----------|--------------|
+| [Virtual Networks](./src/azure-virtualnetwork/README.md) | Define address spaces and network isolation with custom DNS and DDoS protection |
+| [Subnets](./src/azure-subnet/README.md) | Segment networks with service endpoints, delegations, and NSG association |
+| [Network Interfaces](./src/azure-networkinterface/README.md) | Attach to VMs with static/dynamic IPs and accelerated networking |
+| [Network Security Groups](./src/azure-networksecuritygroup/README.md) | Control traffic with inbound/outbound security rules |
+| [Public IP Addresses](./src/azure-publicipaddress/README.md) | Expose resources with static/dynamic allocation |
+
+See individual service documentation for detailed configuration examples and best practices.
 
-### Example 1: Creating a Storage Account
-Now let's create a simple Azure storage account. The following TypeScript snippet defines a storage account resource using the CDKTF:
+## Version-Specific Usage
+
+You can use specific API versions for fine-grained control:
 
 ```typescript
-// Import necessary modules and classes
-import * as azcdk from "@microsoft/terraform-cdk-constructs";
-import { Construct } from 'constructs';
-import { App, TerraformStack } from 'cdktf';
-import { AzurermProvider } from "@cdktf/provider-azurerm/lib/provider";
+// Use latest version (recommended) - automatically resolves to newest API version
+import { ResourceGroup } from "@microsoft/terraform-cdk-constructs/azure-resourcegroup";
+import { StorageAccount } from "@microsoft/terraform-cdk-constructs/azure-storageaccount";
 
-// Define a new Terraform stack
-class AzureAppInfra extends TerraformStack {
- constructor(scope: Construct, name: string) {
-   super(scope, name);
-
-   // Initialize Azure provider
-   new AzurermProvider(this, "azureFeature", { features: {} });
-
-   // Create a new Azure storage account with the specified name and location
-   new azcdk.azure_storageaccount.Account(this, "storageaccount", {
-     name: "test42348808",
-     location: "eastus",
-   });
- }
-}
+// Or specify explicit API version for version pinning
+const rg = new ResourceGroup(this, "rg", {
+  name: "my-resource-group",
+  location: "eastus",
+  apiVersion: "2025-03-01"  // Pin to specific version
+});
 
-// Initialize the CDK app and synthesize Terraform configurations
-const app = new App();
-new AzureAppInfra(app, 'cdk');
-app.synth();
+const storage = new StorageAccount(this, "storage", {
+  name: "mystorageaccount",
+  location: "eastus",
+  resourceGroupId: rg.id,
+  sku: { name: "Standard_LRS" },
+  apiVersion: "2024-01-01"  // Pin to specific version
+});
 ```
-After defining your infrastructure, generate the Terraform configuration files:
+
+## Migration from v0.x
+
+If you're migrating from version 0.x (AzureRM-based), please see our [Versioning and Migrations User Guide](./docs/versioning-and-migrations-user-guide.md) for detailed instructions.
+
+## Deployment
+
+Generate Terraform configuration:
 ```sh
 cdktf synth
 ```
-Finally, deploy your infrastructure to Azure:
 
+Deploy your infrastructure:
 ```sh
 cdktf deploy
 ```
-## Supported Languages
 
-Currently, our CDK L2 constructs are available in the following languages:
-
-| Language   | Status       |
-|------------|--------------|
-| TypeScript | Available    |
-| Python     | Coming soon  |
-| Java       | Coming soon  |
-| Go         | Coming soon  |
-| C#         | Coming soon  |
+## Supported Languages
 
-Stay tuned for updates as we work to expand support to other popular programming languages!
+Thanks to JSII, this library is available in multiple programming languages:
 
+| Language   | Package | Status |
+|------------|---------|--------|
+| TypeScript/JavaScript | [`@microsoft/terraform-cdk-constructs`](https://www.npmjs.com/package/@microsoft/terraform-cdk-constructs) | ✅ Available |
+| Python     | [`microsoft-cdktfconstructs`](https://pypi.org/project/microsoft-cdktfconstructs/) | ✅ Available |
+| Java       | [`com.microsoft.terraformcdkconstructs`](https://search.maven.org/artifact/com.microsoft.terraformcdkconstructs/cdktf-azure-constructs) | ✅ Available |
+| C#/.NET    | [`Microsoft.Cdktf.Azure.TFConstructs`](https://www.nuget.org/packages/Microsoft.Cdktf.Azure.TFConstructs) | ✅ Available |
 
 ## Contributing
 
-This project welcomes contributions and suggestions.  Most contributions require you to agree to a
+This project welcomes contributions and suggestions. Most contributions require you to agree to a
 Contributor License Agreement (CLA) declaring that you have the right to, and actually do, grant us
 the rights to use your contribution. For details, visit https://cla.opensource.microsoft.com.
 
@@ -135,13 +239,20 @@ This project has adopted the [Microsoft Open Source Code of Conduct](https://ope
 For more information see the [Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/) or
 contact [opencode@microsoft.com](mailto:opencode@microsoft.com) with any additional questions or comments.
 
-We welcome contributions to this project! See our documentation on [how to get started contributing](./docs/CONTRIBUTING.md). 
+We welcome contributions to this project! See our documentation on [how to get started contributing](./CONTRIBUTING.md).
 
-## Code Spaces
+## Documentation
+
+- [Architecture Documentation](./docs/ARCHITECTURE.md) - High-level architecture and design patterns
+- [Monitoring Guide](./docs/monitoring-guide.md) - Comprehensive monitoring and alerting documentation
+- [Versioning and Migrations User Guide](./docs/versioning-and-migrations-user-guide.md) - API version management and migration guidance
+- [Testing Guide](./docs/testing.md) - Testing practices and utilities
+- [Design Guide](./docs/design_guide.md) - Module design guidelines
+- [API Documentation](./API.md) - Complete API reference
 
-To open this repository in a Code Space, click the button below:
+## Code Spaces
 
-[![Open in Code Spaces](https://img.shields.io/badge/Open%20in%20Code%20Spaces-Terraform%20Azure%20CDK%20Modules%20Project-blue?logo=github)](https://github.com/microsoft/terraform-azure-cdk-modules/codespaces)
+[![Open in GitHub Codespaces](https://img.shields.io/badge/Open%20in%20GitHub%20Codespaces-blue?logo=github)](https://github.com/Azure/terraform-cdk-constructs/codespaces)
 
 ## Trademarks
 

package/cdktf.json

@@ -1,7 +1,7 @@
 {
   "language": "typescript",
   "app": "npx ts-node ./src/examples/AzureResourceGroup.ts",
-  "terraformProviders": ["Azure/azapi@~> 0.6.0","random@~> 3.5.1"],
+  "terraformProviders": ["Azure/azapi@~> 2.7.0","random@~> 3.5.1"],
   "projectId": "1b5f16bd-67ac-4af6-a33f-7bcafff141eb",
   "context": {
     "excludeStackIdFromLogicalIds": "true",