CloudServicesNetwork

class CloudServicesNetwork : KotlinCustomResource

Upon creation, the additional services that are provided by the platform will be allocated and represented in the status of this resource. All resources associated with this cloud services network will be part of the same layer 2 (L2) isolation domain. At least one service network must be created but may be reused across many virtual machines and/or Hybrid AKS clusters. Uses Azure REST API version 2023-10-01-preview. In version 1.x of the Azure Native provider, it used API version 2022-12-12-preview. Other available API versions: 2023-07-01, 2024-06-01-preview, 2024-07-01, 2024-10-01-preview, 2025-02-01.

Example Usage

Create or update cloud services network

using System.Collections.Generic;
using System.Linq;
using Pulumi;
using AzureNative = Pulumi.AzureNative;
return await Deployment.RunAsync(() =>
{
var cloudServicesNetwork = new AzureNative.NetworkCloud.CloudServicesNetwork("cloudServicesNetwork", new()
{
AdditionalEgressEndpoints = new[]
{
new AzureNative.NetworkCloud.Inputs.EgressEndpointArgs
{
Category = "azure-resource-management",
Endpoints = new[]
{
new AzureNative.NetworkCloud.Inputs.EndpointDependencyArgs
{
DomainName = "https://storageaccountex.blob.core.windows.net",
Port = 443,
},
},
},
},
CloudServicesNetworkName = "cloudServicesNetworkName",
EnableDefaultEgressEndpoints = AzureNative.NetworkCloud.CloudServicesNetworkEnableDefaultEgressEndpoints.False,
ExtendedLocation = new AzureNative.NetworkCloud.Inputs.ExtendedLocationArgs
{
Name = "/subscriptions/123e4567-e89b-12d3-a456-426655440000/resourceGroups/resourceGroupName/providers/Microsoft.ExtendedLocation/customLocations/clusterExtendedLocationName",
Type = "CustomLocation",
},
Location = "location",
ResourceGroupName = "resourceGroupName",
Tags =
{
{ "key1", "myvalue1" },
{ "key2", "myvalue2" },
},
});
});
package main
import (
networkcloud "github.com/pulumi/pulumi-azure-native-sdk/networkcloud/v2"
"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)
func main() {
pulumi.Run(func(ctx *pulumi.Context) error {
_, err := networkcloud.NewCloudServicesNetwork(ctx, "cloudServicesNetwork", &networkcloud.CloudServicesNetworkArgs{
AdditionalEgressEndpoints: networkcloud.EgressEndpointArray{
&networkcloud.EgressEndpointArgs{
Category: pulumi.String("azure-resource-management"),
Endpoints: networkcloud.EndpointDependencyArray{
&networkcloud.EndpointDependencyArgs{
DomainName: pulumi.String("https://storageaccountex.blob.core.windows.net"),
Port: pulumi.Float64(443),
},
},
},
},
CloudServicesNetworkName: pulumi.String("cloudServicesNetworkName"),
EnableDefaultEgressEndpoints: pulumi.String(networkcloud.CloudServicesNetworkEnableDefaultEgressEndpointsFalse),
ExtendedLocation: &networkcloud.ExtendedLocationArgs{
Name: pulumi.String("/subscriptions/123e4567-e89b-12d3-a456-426655440000/resourceGroups/resourceGroupName/providers/Microsoft.ExtendedLocation/customLocations/clusterExtendedLocationName"),
Type: pulumi.String("CustomLocation"),
},
Location: pulumi.String("location"),
ResourceGroupName: pulumi.String("resourceGroupName"),
Tags: pulumi.StringMap{
"key1": pulumi.String("myvalue1"),
"key2": pulumi.String("myvalue2"),
},
})
if err != nil {
return err
}
return nil
})
}
package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.azurenative.networkcloud.CloudServicesNetwork;
import com.pulumi.azurenative.networkcloud.CloudServicesNetworkArgs;
import com.pulumi.azurenative.networkcloud.inputs.EgressEndpointArgs;
import com.pulumi.azurenative.networkcloud.inputs.ExtendedLocationArgs;
import java.util.List;
import java.util.ArrayList;
import java.util.Map;
import java.io.File;
import java.nio.file.Files;
import java.nio.file.Paths;
public class App {
public static void main(String[] args) {
Pulumi.run(App::stack);
}
public static void stack(Context ctx) {
var cloudServicesNetwork = new CloudServicesNetwork("cloudServicesNetwork", CloudServicesNetworkArgs.builder()
.additionalEgressEndpoints(EgressEndpointArgs.builder()
.category("azure-resource-management")
.endpoints(EndpointDependencyArgs.builder()
.domainName("https://storageaccountex.blob.core.windows.net")
.port(443)
.build())
.build())
.cloudServicesNetworkName("cloudServicesNetworkName")
.enableDefaultEgressEndpoints("False")
.extendedLocation(ExtendedLocationArgs.builder()
.name("/subscriptions/123e4567-e89b-12d3-a456-426655440000/resourceGroups/resourceGroupName/providers/Microsoft.ExtendedLocation/customLocations/clusterExtendedLocationName")
.type("CustomLocation")
.build())
.location("location")
.resourceGroupName("resourceGroupName")
.tags(Map.ofEntries(
Map.entry("key1", "myvalue1"),
Map.entry("key2", "myvalue2")
))
.build());
}
}

Import

An existing resource can be imported using its type token, name, and identifier, e.g.

$ pulumi import azure-native:networkcloud:CloudServicesNetwork cloudServicesNetworkName /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.NetworkCloud/cloudServicesNetworks/{cloudServicesNetworkName}

Properties

Link copied to clipboard

The list of egress endpoints. This allows for connection from a Hybrid AKS cluster to the specified endpoint.

Link copied to clipboard

The list of resource IDs for the other Microsoft.NetworkCloud resources that have attached this network.

Link copied to clipboard
val clusterId: Output<String>

The resource ID of the Network Cloud cluster this cloud services network is associated with.

Link copied to clipboard
val detailedStatus: Output<String>

The more detailed status of the cloud services network.

Link copied to clipboard

The descriptive message about the current detailed status.

Link copied to clipboard

The indicator of whether the platform default endpoints are allowed for the egress traffic.

Link copied to clipboard

The full list of additional and default egress endpoints that are currently enabled.

Link copied to clipboard

The extended location of the cluster associated with the resource.

Link copied to clipboard

Field Deprecated. These fields will be empty/omitted. The list of Hybrid AKS cluster resource IDs that are associated with this cloud services network.

Link copied to clipboard
val id: Output<String>
Link copied to clipboard
val interfaceName: Output<String>

The name of the interface that will be present in the virtual machine to represent this network.

Link copied to clipboard
val location: Output<String>

The geo-location where the resource lives

Link copied to clipboard
val name: Output<String>

The name of the resource

Link copied to clipboard

The provisioning state of the cloud services network.

Link copied to clipboard
val pulumiChildResources: Set<KotlinResource>
Link copied to clipboard
Link copied to clipboard
Link copied to clipboard

Azure Resource Manager metadata containing createdBy and modifiedBy information.

Link copied to clipboard
val tags: Output<Map<String, String>>?

Resource tags.

Link copied to clipboard
val type: Output<String>

The type of the resource. E.g. "Microsoft.Compute/virtualMachines" or "Microsoft.Storage/storageAccounts"

Link copied to clipboard
val urn: Output<String>
Link copied to clipboard

Field Deprecated. These fields will be empty/omitted. The list of virtual machine resource IDs, excluding any Hybrid AKS virtual machines, that are currently using this cloud services network.