pulumi-azure-native-kotlin/com.pulumi.azurenative.networkcloud.kotlin/Cluster

Cluster

class Cluster : KotlinCustomResource

API Version: 2022-12-12-preview.

Example Usage

Create or update cluster

using System.Collections.Generic;
using System.Linq;
using Pulumi;
using AzureNative = Pulumi.AzureNative;
return await Deployment.RunAsync(() =>
{
    var cluster = new AzureNative.NetworkCloud.Cluster("cluster", new()
    {
        AggregatorOrSingleRackDefinition = new AzureNative.NetworkCloud.Inputs.RackDefinitionArgs
        {
            BareMetalMachineConfigurationData = new[]
            {
                new AzureNative.NetworkCloud.Inputs.BareMetalMachineConfigurationDataArgs
                {
                    BmcCredentials = new AzureNative.NetworkCloud.Inputs.AdministrativeCredentialsArgs
                    {
                        Password = "{password}",
                        Username = "username",
                    },
                    BmcMacAddress = "AA:BB:CC:DD:EE:FF",
                    BootMacAddress = "00:BB:CC:DD:EE:FF",
                    MachineDetails = "extraDetails",
                    MachineName = "bmmName1",
                    RackSlot = 1,
                    SerialNumber = "BM1219XXX",
                },
                new AzureNative.NetworkCloud.Inputs.BareMetalMachineConfigurationDataArgs
                {
                    BmcCredentials = new AzureNative.NetworkCloud.Inputs.AdministrativeCredentialsArgs
                    {
                        Password = "{password}",
                        Username = "username",
                    },
                    BmcMacAddress = "AA:BB:CC:DD:EE:00",
                    BootMacAddress = "00:BB:CC:DD:EE:00",
                    MachineDetails = "extraDetails",
                    MachineName = "bmmName2",
                    RackSlot = 2,
                    SerialNumber = "BM1219YYY",
                },
            },
            NetworkRackId = "/subscriptions/subscriptionId/resourceGroups/resourceGroupName/providers/Microsoft.ManagedNetworkFabric/networkRacks/networkRackName",
            RackLocation = "Foo Datacenter, Floor 3, Aisle 9, Rack 2",
            RackSerialNumber = "AA1234",
            RackSkuId = "/subscriptions/subscriptionId/providers/Microsoft.NetworkCloud/rackSkus/rackSkuName",
            StorageApplianceConfigurationData = new[]
            {
                new AzureNative.NetworkCloud.Inputs.StorageApplianceConfigurationDataArgs
                {
                    AdminCredentials = new AzureNative.NetworkCloud.Inputs.AdministrativeCredentialsArgs
                    {
                        Password = "{password}",
                        Username = "username",
                    },
                    RackSlot = 1,
                    SerialNumber = "BM1219XXX",
                    StorageApplianceName = "vmName",
                },
            },
        },
        AnalyticsWorkspaceId = "/subscriptions/subscriptionId/resourceGroups/resourceGroupName/providers/microsoft.operationalInsights/workspaces/logAnalyticsWorkspaceName",
        ClusterLocation = "Foo Street, 3rd Floor, row 9",
        ClusterName = "clusterName",
        ClusterServicePrincipal = new AzureNative.NetworkCloud.Inputs.ServicePrincipalInformationArgs
        {
            ApplicationId = "12345678-1234-1234-1234-123456789012",
            Password = "{password}",
            PrincipalId = "00000008-0004-0004-0004-000000000012",
            TenantId = "80000000-4000-4000-4000-120000000000",
        },
        ClusterType = "SingleRack",
        ClusterVersion = "1.0.0",
        ComputeDeploymentThreshold = new AzureNative.NetworkCloud.Inputs.ValidationThresholdArgs
        {
            Grouping = "PerCluster",
            Type = "PercentSuccess",
            Value = 90,
        },
        ComputeRackDefinitions = new[]
        {
            new AzureNative.NetworkCloud.Inputs.RackDefinitionArgs
            {
                BareMetalMachineConfigurationData = new[]
                {
                    new AzureNative.NetworkCloud.Inputs.BareMetalMachineConfigurationDataArgs
                    {
                        BmcCredentials = new AzureNative.NetworkCloud.Inputs.AdministrativeCredentialsArgs
                        {
                            Password = "{password}",
                            Username = "username",
                        },
                        BmcMacAddress = "AA:BB:CC:DD:EE:FF",
                        BootMacAddress = "00:BB:CC:DD:EE:FF",
                        MachineDetails = "extraDetails",
                        MachineName = "bmmName1",
                        RackSlot = 1,
                        SerialNumber = "BM1219XXX",
                    },
                    new AzureNative.NetworkCloud.Inputs.BareMetalMachineConfigurationDataArgs
                    {
                        BmcCredentials = new AzureNative.NetworkCloud.Inputs.AdministrativeCredentialsArgs
                        {
                            Password = "{password}",
                            Username = "username",
                        },
                        BmcMacAddress = "AA:BB:CC:DD:EE:00",
                        BootMacAddress = "00:BB:CC:DD:EE:00",
                        MachineDetails = "extraDetails",
                        MachineName = "bmmName2",
                        RackSlot = 2,
                        SerialNumber = "BM1219YYY",
                    },
                },
                NetworkRackId = "/subscriptions/subscriptionId/resourceGroups/resourceGroupName/providers/Microsoft.ManagedNetworkFabric/networkRacks/networkRackName",
                RackLocation = "Foo Datacenter, Floor 3, Aisle 9, Rack 2",
                RackSerialNumber = "AA1234",
                RackSkuId = "/subscriptions/subscriptionId/providers/Microsoft.NetworkCloud/rackSkus/rackSkuName",
                StorageApplianceConfigurationData = new[]
                {
                    new AzureNative.NetworkCloud.Inputs.StorageApplianceConfigurationDataArgs
                    {
                        AdminCredentials = new AzureNative.NetworkCloud.Inputs.AdministrativeCredentialsArgs
                        {
                            Password = "{password}",
                            Username = "username",
                        },
                        RackSlot = 1,
                        SerialNumber = "BM1219XXX",
                        StorageApplianceName = "vmName",
                    },
                },
            },
        },
        ExtendedLocation = new AzureNative.NetworkCloud.Inputs.ExtendedLocationArgs
        {
            Name = "/subscriptions/subscriptionId/resourceGroups/resourceGroupName/providers/Microsoft.ExtendedLocation/customLocations/clusterManagerExtendedLocationName",
            Type = "CustomLocation",
        },
        Location = "location",
        ManagedResourceGroupConfiguration = new AzureNative.NetworkCloud.Inputs.ManagedResourceGroupConfigurationArgs
        {
            Location = "East US",
            Name = "my-managed-rg",
        },
        NetworkFabricId = "/subscriptions/subscriptionId/resourceGroups/resourceGroupName/providers/Microsoft.ManagedNetworkFabric/networkFabrics/fabricName",
        ResourceGroupName = "resourceGroupName",
        Tags =
        {
            { "key1", "myvalue1" },
            { "key2", "myvalue2" },
        },
    });
});
Content copied to clipboard
package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.azurenative.networkcloud.Cluster;
import com.pulumi.azurenative.networkcloud.ClusterArgs;
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 cluster = new Cluster("cluster", ClusterArgs.builder()
            .aggregatorOrSingleRackDefinition(Map.ofEntries(
                Map.entry("bareMetalMachineConfigurationData",
                    Map.ofEntries(
                        Map.entry("bmcCredentials", Map.ofEntries(
                            Map.entry("password", "{password}"),
                            Map.entry("username", "username")
                        )),
                        Map.entry("bmcMacAddress", "AA:BB:CC:DD:EE:FF"),
                        Map.entry("bootMacAddress", "00:BB:CC:DD:EE:FF"),
                        Map.entry("machineDetails", "extraDetails"),
                        Map.entry("machineName", "bmmName1"),
                        Map.entry("rackSlot", 1),
                        Map.entry("serialNumber", "BM1219XXX")
                    ),
                    Map.ofEntries(
                        Map.entry("bmcCredentials", Map.ofEntries(
                            Map.entry("password", "{password}"),
                            Map.entry("username", "username")
                        )),
                        Map.entry("bmcMacAddress", "AA:BB:CC:DD:EE:00"),
                        Map.entry("bootMacAddress", "00:BB:CC:DD:EE:00"),
                        Map.entry("machineDetails", "extraDetails"),
                        Map.entry("machineName", "bmmName2"),
                        Map.entry("rackSlot", 2),
                        Map.entry("serialNumber", "BM1219YYY")
                    )),
                Map.entry("networkRackId", "/subscriptions/subscriptionId/resourceGroups/resourceGroupName/providers/Microsoft.ManagedNetworkFabric/networkRacks/networkRackName"),
                Map.entry("rackLocation", "Foo Datacenter, Floor 3, Aisle 9, Rack 2"),
                Map.entry("rackSerialNumber", "AA1234"),
                Map.entry("rackSkuId", "/subscriptions/subscriptionId/providers/Microsoft.NetworkCloud/rackSkus/rackSkuName"),
                Map.entry("storageApplianceConfigurationData", Map.ofEntries(
                    Map.entry("adminCredentials", Map.ofEntries(
                        Map.entry("password", "{password}"),
                        Map.entry("username", "username")
                    )),
                    Map.entry("rackSlot", 1),
                    Map.entry("serialNumber", "BM1219XXX"),
                    Map.entry("storageApplianceName", "vmName")
                ))
            ))
            .analyticsWorkspaceId("/subscriptions/subscriptionId/resourceGroups/resourceGroupName/providers/microsoft.operationalInsights/workspaces/logAnalyticsWorkspaceName")
            .clusterLocation("Foo Street, 3rd Floor, row 9")
            .clusterName("clusterName")
            .clusterServicePrincipal(Map.ofEntries(
                Map.entry("applicationId", "12345678-1234-1234-1234-123456789012"),
                Map.entry("password", "{password}"),
                Map.entry("principalId", "00000008-0004-0004-0004-000000000012"),
                Map.entry("tenantId", "80000000-4000-4000-4000-120000000000")
            ))
            .clusterType("SingleRack")
            .clusterVersion("1.0.0")
            .computeDeploymentThreshold(Map.ofEntries(
                Map.entry("grouping", "PerCluster"),
                Map.entry("type", "PercentSuccess"),
                Map.entry("value", 90)
            ))
            .computeRackDefinitions(Map.ofEntries(
                Map.entry("bareMetalMachineConfigurationData",
                    Map.ofEntries(
                        Map.entry("bmcCredentials", Map.ofEntries(
                            Map.entry("password", "{password}"),
                            Map.entry("username", "username")
                        )),
                        Map.entry("bmcMacAddress", "AA:BB:CC:DD:EE:FF"),
                        Map.entry("bootMacAddress", "00:BB:CC:DD:EE:FF"),
                        Map.entry("machineDetails", "extraDetails"),
                        Map.entry("machineName", "bmmName1"),
                        Map.entry("rackSlot", 1),
                        Map.entry("serialNumber", "BM1219XXX")
                    ),
                    Map.ofEntries(
                        Map.entry("bmcCredentials", Map.ofEntries(
                            Map.entry("password", "{password}"),
                            Map.entry("username", "username")
                        )),
                        Map.entry("bmcMacAddress", "AA:BB:CC:DD:EE:00"),
                        Map.entry("bootMacAddress", "00:BB:CC:DD:EE:00"),
                        Map.entry("machineDetails", "extraDetails"),
                        Map.entry("machineName", "bmmName2"),
                        Map.entry("rackSlot", 2),
                        Map.entry("serialNumber", "BM1219YYY")
                    )),
                Map.entry("networkRackId", "/subscriptions/subscriptionId/resourceGroups/resourceGroupName/providers/Microsoft.ManagedNetworkFabric/networkRacks/networkRackName"),
                Map.entry("rackLocation", "Foo Datacenter, Floor 3, Aisle 9, Rack 2"),
                Map.entry("rackSerialNumber", "AA1234"),
                Map.entry("rackSkuId", "/subscriptions/subscriptionId/providers/Microsoft.NetworkCloud/rackSkus/rackSkuName"),
                Map.entry("storageApplianceConfigurationData", Map.ofEntries(
                    Map.entry("adminCredentials", Map.ofEntries(
                        Map.entry("password", "{password}"),
                        Map.entry("username", "username")
                    )),
                    Map.entry("rackSlot", 1),
                    Map.entry("serialNumber", "BM1219XXX"),
                    Map.entry("storageApplianceName", "vmName")
                ))
            ))
            .extendedLocation(Map.ofEntries(
                Map.entry("name", "/subscriptions/subscriptionId/resourceGroups/resourceGroupName/providers/Microsoft.ExtendedLocation/customLocations/clusterManagerExtendedLocationName"),
                Map.entry("type", "CustomLocation")
            ))
            .location("location")
            .managedResourceGroupConfiguration(Map.ofEntries(
                Map.entry("location", "East US"),
                Map.entry("name", "my-managed-rg")
            ))
            .networkFabricId("/subscriptions/subscriptionId/resourceGroups/resourceGroupName/providers/Microsoft.ManagedNetworkFabric/networkFabrics/fabricName")
            .resourceGroupName("resourceGroupName")
            .tags(Map.ofEntries(
                Map.entry("key1", "myvalue1"),
                Map.entry("key2", "myvalue2")
            ))
            .build());
    }
}
Content copied to clipboard

Import

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

$ pulumi import azure-native:networkcloud:Cluster clusterName /subscriptions/subscriptionId/resourceGroups/resourceGroupName/providers/Microsoft.NetworkCloud/clusters/clusterName
Content copied to clipboard

Properties

Link copied to clipboard
val aggregatorOrSingleRackDefinition: Output<RackDefinitionResponse>

The rack definition that is intended to reflect only a single rack in a single rack cluster, or an aggregator rack in a multi-rack cluster.

Link copied to clipboard
val analyticsWorkspaceId: Output<String>

The resource ID of the Log Analytics Workspace that will be used for storing relevant logs.

Link copied to clipboard
val availableUpgradeVersions: Output<List<ClusterAvailableUpgradeVersionResponse>>

The list of cluster runtime version upgrades available for this cluster.

Link copied to clipboard
val clusterCapacity: Output<ClusterCapacityResponse>

The capacity supported by this cluster.

Link copied to clipboard
val clusterConnectionStatus: Output<String>

The latest heartbeat status between the cluster manager and the cluster.

Link copied to clipboard
val clusterExtendedLocation: Output<ExtendedLocationResponse>

The extended location (custom location) that represents the cluster's control plane location. This extended location is used to route the requests of child objects of the cluster that are handled by the platform operator.

Link copied to clipboard
val clusterLocation: Output<String>?

The customer-provided location information to identify where the cluster resides.

Link copied to clipboard
val clusterManagerConnectionStatus: Output<String>

The latest connectivity status between cluster manager and the cluster.

Link copied to clipboard
val clusterManagerId: Output<String>

The resource ID of the cluster manager that manages this cluster. This is set by the Cluster Manager when the cluster is created.

Link copied to clipboard
val clusterServicePrincipal: Output<ServicePrincipalInformationResponse>?

The service principal to be used by the cluster during Arc Appliance installation.

Link copied to clipboard
val clusterType: Output<String>

The type of rack configuration for the cluster.

Link copied to clipboard
val clusterVersion: Output<String>

The current runtime version of the cluster.

Link copied to clipboard
val computeDeploymentThreshold: Output<ValidationThresholdResponse>?

The validation threshold indicating the allowable failures of compute machines during environment validation and deployment.

Link copied to clipboard
val computeRackDefinitions: Output<List<RackDefinitionResponse>>?

The list of rack definitions for the compute racks in a multi-rack cluster, or an empty list in a single-rack cluster.

Link copied to clipboard
val detailedStatus: Output<String>

The current detailed status of the cluster.

Link copied to clipboard
val detailedStatusMessage: Output<String>

The descriptive message about the detailed status.

Link copied to clipboard
val extendedLocation: Output<ExtendedLocationResponse>

The extended location of the cluster manager associated with the cluster.

Link copied to clipboard
val hybridAksExtendedLocation: Output<ExtendedLocationResponse>

The extended location (custom location) that represents the Hybrid AKS control plane location. This extended location is used when creating provisioned clusters (Hybrid AKS clusters).

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

The geo-location where the resource lives

Link copied to clipboard
val managedResourceGroupConfiguration: Output<ManagedResourceGroupConfigurationResponse>?

The configuration of the managed resource group associated with the resource.

Link copied to clipboard
val manualActionCount: Output<Double>

The count of Manual Action Taken (MAT) events that have not been validated.

Link copied to clipboard
val name: Output<String>

The name of the resource

Link copied to clipboard
val networkFabricId: Output<String>

The resource ID of the Network Fabric associated with the cluster.

Link copied to clipboard
val provisioningState: Output<String>

The provisioning state of the cluster.

Link copied to clipboard
val pulumiChildResources: Set<KotlinResource>
Link copied to clipboard
Link copied to clipboard
Link copied to clipboard
val supportExpiryDate: Output<String>

The support end date of the runtime version of the cluster.

Link copied to clipboard
val systemData: Output<SystemDataResponse>

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
val workloadResourceIds: Output<List<String>>

The list of workload resource IDs that are hosted within this cluster.