com.pulumi.azure.compute.kotlin.DiskPoolIscsiTarget.kt Maven / Gradle / Ivy
Go to download
Show more of this group Show more artifacts with this name
Show all versions of pulumi-azure-kotlin Show documentation
Show all versions of pulumi-azure-kotlin Show documentation
Build cloud applications and infrastructure by combining the safety and reliability of infrastructure as code with the power of the Kotlin programming language.
@file:Suppress("NAME_SHADOWING", "DEPRECATION")
package com.pulumi.azure.compute.kotlin
import com.pulumi.core.Output
import com.pulumi.kotlin.KotlinCustomResource
import com.pulumi.kotlin.PulumiTagMarker
import com.pulumi.kotlin.ResourceMapper
import com.pulumi.kotlin.options.CustomResourceOptions
import com.pulumi.kotlin.options.CustomResourceOptionsBuilder
import com.pulumi.resources.Resource
import kotlin.Boolean
import kotlin.Int
import kotlin.String
import kotlin.Suppress
import kotlin.Unit
import kotlin.collections.List
/**
* Builder for [DiskPoolIscsiTarget].
*/
@PulumiTagMarker
public class DiskPoolIscsiTargetResourceBuilder internal constructor() {
public var name: String? = null
public var args: DiskPoolIscsiTargetArgs = DiskPoolIscsiTargetArgs()
public var opts: CustomResourceOptions = CustomResourceOptions()
/**
* @param name The _unique_ name of the resulting resource.
*/
public fun name(`value`: String) {
this.name = value
}
/**
* @param block The arguments to use to populate this resource's properties.
*/
public suspend fun args(block: suspend DiskPoolIscsiTargetArgsBuilder.() -> Unit) {
val builder = DiskPoolIscsiTargetArgsBuilder()
block(builder)
this.args = builder.build()
}
/**
* @param block A bag of options that control this resource's behavior.
*/
public suspend fun opts(block: suspend CustomResourceOptionsBuilder.() -> Unit) {
this.opts = com.pulumi.kotlin.options.CustomResourceOptions.opts(block)
}
internal fun build(): DiskPoolIscsiTarget {
val builtJavaResource = com.pulumi.azure.compute.DiskPoolIscsiTarget(
this.name,
this.args.toJava(),
this.opts.toJava(),
)
return DiskPoolIscsiTarget(builtJavaResource)
}
}
/**
* Manages an iSCSI Target.
* !> **Note:** Azure are officially [halting](https://learn.microsoft.com/en-us/azure/azure-vmware/attach-disk-pools-to-azure-vmware-solution-hosts?tabs=azure-cli) the preview of Azure Disk Pools, and it **will not** be made generally available. New customers will not be able to register the Microsoft.StoragePool resource provider on their subscription and deploy new Disk Pools. Existing subscriptions registered with Microsoft.StoragePool may continue to deploy and manage disk pools for the time being.
* !> **Note:** Each Disk Pool can have a maximum of 1 iSCSI Target.
* ## Example Usage
*
* ```typescript
* import * as pulumi from "@pulumi/pulumi";
* import * as azure from "@pulumi/azure";
* import * as azuread from "@pulumi/azuread";
* const exampleResourceGroup = new azure.core.ResourceGroup("example", {
* name: "example",
* location: "West Europe",
* });
* const exampleVirtualNetwork = new azure.network.VirtualNetwork("example", {
* name: "example-network",
* resourceGroupName: exampleResourceGroup.name,
* location: exampleResourceGroup.location,
* addressSpaces: ["10.0.0.0/16"],
* });
* const exampleSubnet = new azure.network.Subnet("example", {
* name: "example-subnet",
* resourceGroupName: exampleResourceGroup.name,
* virtualNetworkName: exampleVirtualNetwork.name,
* addressPrefixes: ["10.0.0.0/24"],
* delegations: [{
* name: "diskspool",
* serviceDelegation: {
* actions: ["Microsoft.Network/virtualNetworks/read"],
* name: "Microsoft.StoragePool/diskPools",
* },
* }],
* });
* const exampleDiskPool = new azure.compute.DiskPool("example", {
* name: "example-pool",
* resourceGroupName: exampleResourceGroup.name,
* location: exampleResourceGroup.location,
* subnetId: exampleSubnet.id,
* zones: ["1"],
* skuName: "Basic_B1",
* });
* const exampleManagedDisk = new azure.compute.ManagedDisk("example", {
* name: "example-disk",
* resourceGroupName: exampleResourceGroup.name,
* location: exampleResourceGroup.location,
* createOption: "Empty",
* storageAccountType: "Premium_LRS",
* diskSizeGb: 4,
* maxShares: 2,
* zone: "1",
* });
* const example = azuread.getServicePrincipal({
* displayName: "StoragePool Resource Provider",
* });
* const roles = [
* "Disk Pool Operator",
* "Virtual Machine Contributor",
* ];
* const exampleAssignment: azure.authorization.Assignment[] = [];
* for (const range = {value: 0}; range.value < roles.length; range.value++) {
* exampleAssignment.push(new azure.authorization.Assignment(`example-${range.value}`, {
* principalId: example.then(example => example.id),
* roleDefinitionName: roles[range.value],
* scope: exampleManagedDisk.id,
* }));
* }
* const exampleDiskPoolManagedDiskAttachment = new azure.compute.DiskPoolManagedDiskAttachment("example", {
* diskPoolId: exampleDiskPool.id,
* managedDiskId: exampleManagedDisk.id,
* });
* const exampleDiskPoolIscsiTarget = new azure.compute.DiskPoolIscsiTarget("example", {
* name: "example",
* aclMode: "Dynamic",
* disksPoolId: exampleDiskPool.id,
* targetIqn: "iqn.2021-11.com.microsoft:test",
* });
* ```
* ```python
* import pulumi
* import pulumi_azure as azure
* import pulumi_azuread as azuread
* example_resource_group = azure.core.ResourceGroup("example",
* name="example",
* location="West Europe")
* example_virtual_network = azure.network.VirtualNetwork("example",
* name="example-network",
* resource_group_name=example_resource_group.name,
* location=example_resource_group.location,
* address_spaces=["10.0.0.0/16"])
* example_subnet = azure.network.Subnet("example",
* name="example-subnet",
* resource_group_name=example_resource_group.name,
* virtual_network_name=example_virtual_network.name,
* address_prefixes=["10.0.0.0/24"],
* delegations=[azure.network.SubnetDelegationArgs(
* name="diskspool",
* service_delegation=azure.network.SubnetDelegationServiceDelegationArgs(
* actions=["Microsoft.Network/virtualNetworks/read"],
* name="Microsoft.StoragePool/diskPools",
* ),
* )])
* example_disk_pool = azure.compute.DiskPool("example",
* name="example-pool",
* resource_group_name=example_resource_group.name,
* location=example_resource_group.location,
* subnet_id=example_subnet.id,
* zones=["1"],
* sku_name="Basic_B1")
* example_managed_disk = azure.compute.ManagedDisk("example",
* name="example-disk",
* resource_group_name=example_resource_group.name,
* location=example_resource_group.location,
* create_option="Empty",
* storage_account_type="Premium_LRS",
* disk_size_gb=4,
* max_shares=2,
* zone="1")
* example = azuread.get_service_principal(display_name="StoragePool Resource Provider")
* roles = [
* "Disk Pool Operator",
* "Virtual Machine Contributor",
* ]
* example_assignment = []
* for range in [{"value": i} for i in range(0, len(roles))]:
* example_assignment.append(azure.authorization.Assignment(f"example-{range['value']}",
* principal_id=example.id,
* role_definition_name=roles[range["value"]],
* scope=example_managed_disk.id))
* example_disk_pool_managed_disk_attachment = azure.compute.DiskPoolManagedDiskAttachment("example",
* disk_pool_id=example_disk_pool.id,
* managed_disk_id=example_managed_disk.id)
* example_disk_pool_iscsi_target = azure.compute.DiskPoolIscsiTarget("example",
* name="example",
* acl_mode="Dynamic",
* disks_pool_id=example_disk_pool.id,
* target_iqn="iqn.2021-11.com.microsoft:test")
* ```
* ```csharp
* using System.Collections.Generic;
* using System.Linq;
* using Pulumi;
* using Azure = Pulumi.Azure;
* using AzureAD = Pulumi.AzureAD;
* return await Deployment.RunAsync(() =>
* {
* var exampleResourceGroup = new Azure.Core.ResourceGroup("example", new()
* {
* Name = "example",
* Location = "West Europe",
* });
* var exampleVirtualNetwork = new Azure.Network.VirtualNetwork("example", new()
* {
* Name = "example-network",
* ResourceGroupName = exampleResourceGroup.Name,
* Location = exampleResourceGroup.Location,
* AddressSpaces = new[]
* {
* "10.0.0.0/16",
* },
* });
* var exampleSubnet = new Azure.Network.Subnet("example", new()
* {
* Name = "example-subnet",
* ResourceGroupName = exampleResourceGroup.Name,
* VirtualNetworkName = exampleVirtualNetwork.Name,
* AddressPrefixes = new[]
* {
* "10.0.0.0/24",
* },
* Delegations = new[]
* {
* new Azure.Network.Inputs.SubnetDelegationArgs
* {
* Name = "diskspool",
* ServiceDelegation = new Azure.Network.Inputs.SubnetDelegationServiceDelegationArgs
* {
* Actions = new[]
* {
* "Microsoft.Network/virtualNetworks/read",
* },
* Name = "Microsoft.StoragePool/diskPools",
* },
* },
* },
* });
* var exampleDiskPool = new Azure.Compute.DiskPool("example", new()
* {
* Name = "example-pool",
* ResourceGroupName = exampleResourceGroup.Name,
* Location = exampleResourceGroup.Location,
* SubnetId = exampleSubnet.Id,
* Zones = new[]
* {
* "1",
* },
* SkuName = "Basic_B1",
* });
* var exampleManagedDisk = new Azure.Compute.ManagedDisk("example", new()
* {
* Name = "example-disk",
* ResourceGroupName = exampleResourceGroup.Name,
* Location = exampleResourceGroup.Location,
* CreateOption = "Empty",
* StorageAccountType = "Premium_LRS",
* DiskSizeGb = 4,
* MaxShares = 2,
* Zone = "1",
* });
* var example = AzureAD.GetServicePrincipal.Invoke(new()
* {
* DisplayName = "StoragePool Resource Provider",
* });
* var roles = new[]
* {
* "Disk Pool Operator",
* "Virtual Machine Contributor",
* };
* var exampleAssignment = new List();
* for (var rangeIndex = 0; rangeIndex < roles.Length; rangeIndex++)
* {
* var range = new { Value = rangeIndex };
* exampleAssignment.Add(new Azure.Authorization.Assignment($"example-{range.Value}", new()
* {
* PrincipalId = example.Apply(getServicePrincipalResult => getServicePrincipalResult.Id),
* RoleDefinitionName = roles[range.Value],
* Scope = exampleManagedDisk.Id,
* }));
* }
* var exampleDiskPoolManagedDiskAttachment = new Azure.Compute.DiskPoolManagedDiskAttachment("example", new()
* {
* DiskPoolId = exampleDiskPool.Id,
* ManagedDiskId = exampleManagedDisk.Id,
* });
* var exampleDiskPoolIscsiTarget = new Azure.Compute.DiskPoolIscsiTarget("example", new()
* {
* Name = "example",
* AclMode = "Dynamic",
* DisksPoolId = exampleDiskPool.Id,
* TargetIqn = "iqn.2021-11.com.microsoft:test",
* });
* });
* ```
* ```go
* package main
* import (
* "github.com/pulumi/pulumi-azure/sdk/v5/go/azure/authorization"
* "github.com/pulumi/pulumi-azure/sdk/v5/go/azure/compute"
* "github.com/pulumi/pulumi-azure/sdk/v5/go/azure/core"
* "github.com/pulumi/pulumi-azure/sdk/v5/go/azure/network"
* "github.com/pulumi/pulumi-azuread/sdk/v5/go/azuread"
* "github.com/pulumi/pulumi/sdk/v3/go/pulumi"
* )
* func main() {
* pulumi.Run(func(ctx *pulumi.Context) error {
* exampleResourceGroup, err := core.NewResourceGroup(ctx, "example", &core.ResourceGroupArgs{
* Name: pulumi.String("example"),
* Location: pulumi.String("West Europe"),
* })
* if err != nil {
* return err
* }
* exampleVirtualNetwork, err := network.NewVirtualNetwork(ctx, "example", &network.VirtualNetworkArgs{
* Name: pulumi.String("example-network"),
* ResourceGroupName: exampleResourceGroup.Name,
* Location: exampleResourceGroup.Location,
* AddressSpaces: pulumi.StringArray{
* pulumi.String("10.0.0.0/16"),
* },
* })
* if err != nil {
* return err
* }
* exampleSubnet, err := network.NewSubnet(ctx, "example", &network.SubnetArgs{
* Name: pulumi.String("example-subnet"),
* ResourceGroupName: exampleResourceGroup.Name,
* VirtualNetworkName: exampleVirtualNetwork.Name,
* AddressPrefixes: pulumi.StringArray{
* pulumi.String("10.0.0.0/24"),
* },
* Delegations: network.SubnetDelegationArray{
* &network.SubnetDelegationArgs{
* Name: pulumi.String("diskspool"),
* ServiceDelegation: &network.SubnetDelegationServiceDelegationArgs{
* Actions: pulumi.StringArray{
* pulumi.String("Microsoft.Network/virtualNetworks/read"),
* },
* Name: pulumi.String("Microsoft.StoragePool/diskPools"),
* },
* },
* },
* })
* if err != nil {
* return err
* }
* exampleDiskPool, err := compute.NewDiskPool(ctx, "example", &compute.DiskPoolArgs{
* Name: pulumi.String("example-pool"),
* ResourceGroupName: exampleResourceGroup.Name,
* Location: exampleResourceGroup.Location,
* SubnetId: exampleSubnet.ID(),
* Zones: pulumi.StringArray{
* pulumi.String("1"),
* },
* SkuName: pulumi.String("Basic_B1"),
* })
* if err != nil {
* return err
* }
* exampleManagedDisk, err := compute.NewManagedDisk(ctx, "example", &compute.ManagedDiskArgs{
* Name: pulumi.String("example-disk"),
* ResourceGroupName: exampleResourceGroup.Name,
* Location: exampleResourceGroup.Location,
* CreateOption: pulumi.String("Empty"),
* StorageAccountType: pulumi.String("Premium_LRS"),
* DiskSizeGb: pulumi.Int(4),
* MaxShares: pulumi.Int(2),
* Zone: pulumi.String("1"),
* })
* if err != nil {
* return err
* }
* example, err := azuread.LookupServicePrincipal(ctx, &azuread.LookupServicePrincipalArgs{
* DisplayName: pulumi.StringRef("StoragePool Resource Provider"),
* }, nil)
* if err != nil {
* return err
* }
* roles := []string{
* "Disk Pool Operator",
* "Virtual Machine Contributor",
* }
* var exampleAssignment []*authorization.Assignment
* for index := 0; index < len(roles); index++ {
* key0 := index
* val0 := index
* __res, err := authorization.NewAssignment(ctx, fmt.Sprintf("example-%v", key0), &authorization.AssignmentArgs{
* PrincipalId: pulumi.String(example.Id),
* RoleDefinitionName: roles[val0],
* Scope: exampleManagedDisk.ID(),
* })
* if err != nil {
* return err
* }
* exampleAssignment = append(exampleAssignment, __res)
* }
* _, err = compute.NewDiskPoolManagedDiskAttachment(ctx, "example", &compute.DiskPoolManagedDiskAttachmentArgs{
* DiskPoolId: exampleDiskPool.ID(),
* ManagedDiskId: exampleManagedDisk.ID(),
* })
* if err != nil {
* return err
* }
* _, err = compute.NewDiskPoolIscsiTarget(ctx, "example", &compute.DiskPoolIscsiTargetArgs{
* Name: pulumi.String("example"),
* AclMode: pulumi.String("Dynamic"),
* DisksPoolId: exampleDiskPool.ID(),
* TargetIqn: pulumi.String("iqn.2021-11.com.microsoft:test"),
* })
* if err != nil {
* return err
* }
* return nil
* })
* }
* ```
* ```java
* package generated_program;
* import com.pulumi.Context;
* import com.pulumi.Pulumi;
* import com.pulumi.core.Output;
* import com.pulumi.azure.core.ResourceGroup;
* import com.pulumi.azure.core.ResourceGroupArgs;
* import com.pulumi.azure.network.VirtualNetwork;
* import com.pulumi.azure.network.VirtualNetworkArgs;
* import com.pulumi.azure.network.Subnet;
* import com.pulumi.azure.network.SubnetArgs;
* import com.pulumi.azure.network.inputs.SubnetDelegationArgs;
* import com.pulumi.azure.network.inputs.SubnetDelegationServiceDelegationArgs;
* import com.pulumi.azure.compute.DiskPool;
* import com.pulumi.azure.compute.DiskPoolArgs;
* import com.pulumi.azure.compute.ManagedDisk;
* import com.pulumi.azure.compute.ManagedDiskArgs;
* import com.pulumi.azuread.AzureadFunctions;
* import com.pulumi.azuread.inputs.GetServicePrincipalArgs;
* import com.pulumi.azure.authorization.Assignment;
* import com.pulumi.azure.authorization.AssignmentArgs;
* import com.pulumi.azure.compute.DiskPoolManagedDiskAttachment;
* import com.pulumi.azure.compute.DiskPoolManagedDiskAttachmentArgs;
* import com.pulumi.azure.compute.DiskPoolIscsiTarget;
* import com.pulumi.azure.compute.DiskPoolIscsiTargetArgs;
* import com.pulumi.codegen.internal.KeyedValue;
* 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 exampleResourceGroup = new ResourceGroup("exampleResourceGroup", ResourceGroupArgs.builder()
* .name("example")
* .location("West Europe")
* .build());
* var exampleVirtualNetwork = new VirtualNetwork("exampleVirtualNetwork", VirtualNetworkArgs.builder()
* .name("example-network")
* .resourceGroupName(exampleResourceGroup.name())
* .location(exampleResourceGroup.location())
* .addressSpaces("10.0.0.0/16")
* .build());
* var exampleSubnet = new Subnet("exampleSubnet", SubnetArgs.builder()
* .name("example-subnet")
* .resourceGroupName(exampleResourceGroup.name())
* .virtualNetworkName(exampleVirtualNetwork.name())
* .addressPrefixes("10.0.0.0/24")
* .delegations(SubnetDelegationArgs.builder()
* .name("diskspool")
* .serviceDelegation(SubnetDelegationServiceDelegationArgs.builder()
* .actions("Microsoft.Network/virtualNetworks/read")
* .name("Microsoft.StoragePool/diskPools")
* .build())
* .build())
* .build());
* var exampleDiskPool = new DiskPool("exampleDiskPool", DiskPoolArgs.builder()
* .name("example-pool")
* .resourceGroupName(exampleResourceGroup.name())
* .location(exampleResourceGroup.location())
* .subnetId(exampleSubnet.id())
* .zones("1")
* .skuName("Basic_B1")
* .build());
* var exampleManagedDisk = new ManagedDisk("exampleManagedDisk", ManagedDiskArgs.builder()
* .name("example-disk")
* .resourceGroupName(exampleResourceGroup.name())
* .location(exampleResourceGroup.location())
* .createOption("Empty")
* .storageAccountType("Premium_LRS")
* .diskSizeGb(4)
* .maxShares(2)
* .zone("1")
* .build());
* final var example = AzureadFunctions.getServicePrincipal(GetServicePrincipalArgs.builder()
* .displayName("StoragePool Resource Provider")
* .build());
* final var roles =
* "Disk Pool Operator",
* "Virtual Machine Contributor";
* for (var i = 0; i < roles.length(); i++) {
* new Assignment("exampleAssignment-" + i, AssignmentArgs.builder()
* .principalId(example.applyValue(getServicePrincipalResult -> getServicePrincipalResult.id()))
* .roleDefinitionName(roles[range.value()])
* .scope(exampleManagedDisk.id())
* .build());
* }
* var exampleDiskPoolManagedDiskAttachment = new DiskPoolManagedDiskAttachment("exampleDiskPoolManagedDiskAttachment", DiskPoolManagedDiskAttachmentArgs.builder()
* .diskPoolId(exampleDiskPool.id())
* .managedDiskId(exampleManagedDisk.id())
* .build());
* var exampleDiskPoolIscsiTarget = new DiskPoolIscsiTarget("exampleDiskPoolIscsiTarget", DiskPoolIscsiTargetArgs.builder()
* .name("example")
* .aclMode("Dynamic")
* .disksPoolId(exampleDiskPool.id())
* .targetIqn("iqn.2021-11.com.microsoft:test")
* .build());
* }
* }
* ```
*
* ## Import
* iSCSI Targets can be imported using the `resource id`, e.g.
* ```sh
* $ pulumi import azure:compute/diskPoolIscsiTarget:DiskPoolIscsiTarget example /subscriptions/12345678-1234-9876-4563-123456789012/resourceGroups/group1/providers/Microsoft.StoragePool/diskPools/pool1/iscsiTargets/iscsiTarget1
* ```
*/
public class DiskPoolIscsiTarget internal constructor(
override val javaResource: com.pulumi.azure.compute.DiskPoolIscsiTarget,
) : KotlinCustomResource(javaResource, DiskPoolIscsiTargetMapper) {
/**
* Mode for Target connectivity. The only supported value is `Dynamic` for now. Changing this forces a new iSCSI Target to be created.
*/
public val aclMode: Output
get() = javaResource.aclMode().applyValue({ args0 -> args0 })
/**
* The ID of the Disk Pool. Changing this forces a new iSCSI Target to be created.
*/
public val disksPoolId: Output
get() = javaResource.disksPoolId().applyValue({ args0 -> args0 })
/**
* List of private IPv4 addresses to connect to the iSCSI Target.
*/
public val endpoints: Output>
get() = javaResource.endpoints().applyValue({ args0 -> args0.map({ args0 -> args0 }) })
/**
* The name of the iSCSI Target. The name can only contain lowercase letters, numbers, periods, or hyphens, and length should between [5-223]. Changing this forces a new iSCSI Target to be created.
*/
public val name: Output
get() = javaResource.name().applyValue({ args0 -> args0 })
/**
* The port used by iSCSI Target portal group.
*/
public val port: Output
get() = javaResource.port().applyValue({ args0 -> args0 })
/**
* ISCSI Target IQN (iSCSI Qualified Name); example: `iqn.2005-03.org.iscsi:server`. IQN should follow the format `iqn.yyyy-mm..[:xyz]`; supported characters include alphanumeric characters in lower case, hyphen, dot and colon, and the length should between `4` and `223`. Changing this forces a new iSCSI Target to be created.
*/
public val targetIqn: Output?
get() = javaResource.targetIqn().applyValue({ args0 -> args0.map({ args0 -> args0 }).orElse(null) })
}
public object DiskPoolIscsiTargetMapper : ResourceMapper {
override fun supportsMappingOfType(javaResource: Resource): Boolean =
com.pulumi.azure.compute.DiskPoolIscsiTarget::class == javaResource::class
override fun map(javaResource: Resource): DiskPoolIscsiTarget = DiskPoolIscsiTarget(
javaResource
as com.pulumi.azure.compute.DiskPoolIscsiTarget,
)
}
/**
* @see [DiskPoolIscsiTarget].
* @param name The _unique_ name of the resulting resource.
* @param block Builder for [DiskPoolIscsiTarget].
*/
public suspend fun diskPoolIscsiTarget(
name: String,
block: suspend DiskPoolIscsiTargetResourceBuilder.() -> Unit,
): DiskPoolIscsiTarget {
val builder = DiskPoolIscsiTargetResourceBuilder()
builder.name(name)
block(builder)
return builder.build()
}
/**
* @see [DiskPoolIscsiTarget].
* @param name The _unique_ name of the resulting resource.
*/
public fun diskPoolIscsiTarget(name: String): DiskPoolIscsiTarget {
val builder = DiskPoolIscsiTargetResourceBuilder()
builder.name(name)
return builder.build()
}
© 2015 - 2025 Weber Informatics LLC | Privacy Policy