All Downloads are FREE. Search and download functionalities are using the official Maven repository.

com.pulumi.alicloud.vpc.kotlin.NatIp.kt Maven / Gradle / Ivy

Go to download

Build cloud applications and infrastructure by combining the safety and reliability of infrastructure as code with the power of the Kotlin programming language.

There is a newer version: 3.62.0.0
Show newest version
@file:Suppress("NAME_SHADOWING", "DEPRECATION")

package com.pulumi.alicloud.vpc.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.String
import kotlin.Suppress
import kotlin.Unit

/**
 * Builder for [NatIp].
 */
@PulumiTagMarker
public class NatIpResourceBuilder internal constructor() {
    public var name: String? = null

    public var args: NatIpArgs = NatIpArgs()

    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 NatIpArgsBuilder.() -> Unit) {
        val builder = NatIpArgsBuilder()
        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(): NatIp {
        val builtJavaResource = com.pulumi.alicloud.vpc.NatIp(
            this.name,
            this.args.toJava(),
            this.opts.toJava(),
        )
        return NatIp(builtJavaResource)
    }
}

/**
 * Provides a VPC Nat Ip resource.
 * For information about VPC Nat Ip and how to use it, see [What is Nat Ip](https://www.alibabacloud.com/help/doc-detail/281976.htm).
 * > **NOTE:** Available in v1.136.0+.
 * ## Example Usage
 * Basic Usage
 * 
 * ```typescript
 * import * as pulumi from "@pulumi/pulumi";
 * import * as alicloud from "@pulumi/alicloud";
 * const example = alicloud.getZones({
 *     availableResourceCreation: "VSwitch",
 * });
 * const exampleNetwork = new alicloud.vpc.Network("example", {
 *     vpcName: "terraform-example",
 *     cidrBlock: "172.16.0.0/12",
 * });
 * const exampleSwitch = new alicloud.vpc.Switch("example", {
 *     vpcId: exampleNetwork.id,
 *     cidrBlock: "172.16.0.0/21",
 *     zoneId: example.then(example => example.zones?.[0]?.id),
 *     vswitchName: "terraform-example",
 * });
 * const exampleNatGateway = new alicloud.vpc.NatGateway("example", {
 *     vpcId: exampleNetwork.id,
 *     internetChargeType: "PayByLcu",
 *     natGatewayName: "terraform-example",
 *     description: "terraform-example",
 *     natType: "Enhanced",
 *     vswitchId: exampleSwitch.id,
 *     networkType: "intranet",
 * });
 * const exampleNatIpCidr = new alicloud.vpc.NatIpCidr("example", {
 *     natIpCidr: "192.168.0.0/16",
 *     natGatewayId: exampleNatGateway.id,
 *     natIpCidrDescription: "terraform-example",
 *     natIpCidrName: "terraform-example",
 * });
 * const exampleNatIp = new alicloud.vpc.NatIp("example", {
 *     natIp: "192.168.0.37",
 *     natGatewayId: exampleNatGateway.id,
 *     natIpDescription: "example_value",
 *     natIpName: "example_value",
 *     natIpCidr: exampleNatIpCidr.natIpCidr,
 * });
 * ```
 * ```python
 * import pulumi
 * import pulumi_alicloud as alicloud
 * example = alicloud.get_zones(available_resource_creation="VSwitch")
 * example_network = alicloud.vpc.Network("example",
 *     vpc_name="terraform-example",
 *     cidr_block="172.16.0.0/12")
 * example_switch = alicloud.vpc.Switch("example",
 *     vpc_id=example_network.id,
 *     cidr_block="172.16.0.0/21",
 *     zone_id=example.zones[0].id,
 *     vswitch_name="terraform-example")
 * example_nat_gateway = alicloud.vpc.NatGateway("example",
 *     vpc_id=example_network.id,
 *     internet_charge_type="PayByLcu",
 *     nat_gateway_name="terraform-example",
 *     description="terraform-example",
 *     nat_type="Enhanced",
 *     vswitch_id=example_switch.id,
 *     network_type="intranet")
 * example_nat_ip_cidr = alicloud.vpc.NatIpCidr("example",
 *     nat_ip_cidr="192.168.0.0/16",
 *     nat_gateway_id=example_nat_gateway.id,
 *     nat_ip_cidr_description="terraform-example",
 *     nat_ip_cidr_name="terraform-example")
 * example_nat_ip = alicloud.vpc.NatIp("example",
 *     nat_ip="192.168.0.37",
 *     nat_gateway_id=example_nat_gateway.id,
 *     nat_ip_description="example_value",
 *     nat_ip_name="example_value",
 *     nat_ip_cidr=example_nat_ip_cidr.nat_ip_cidr)
 * ```
 * ```csharp
 * using System.Collections.Generic;
 * using System.Linq;
 * using Pulumi;
 * using AliCloud = Pulumi.AliCloud;
 * return await Deployment.RunAsync(() =>
 * {
 *     var example = AliCloud.GetZones.Invoke(new()
 *     {
 *         AvailableResourceCreation = "VSwitch",
 *     });
 *     var exampleNetwork = new AliCloud.Vpc.Network("example", new()
 *     {
 *         VpcName = "terraform-example",
 *         CidrBlock = "172.16.0.0/12",
 *     });
 *     var exampleSwitch = new AliCloud.Vpc.Switch("example", new()
 *     {
 *         VpcId = exampleNetwork.Id,
 *         CidrBlock = "172.16.0.0/21",
 *         ZoneId = example.Apply(getZonesResult => getZonesResult.Zones[0]?.Id),
 *         VswitchName = "terraform-example",
 *     });
 *     var exampleNatGateway = new AliCloud.Vpc.NatGateway("example", new()
 *     {
 *         VpcId = exampleNetwork.Id,
 *         InternetChargeType = "PayByLcu",
 *         NatGatewayName = "terraform-example",
 *         Description = "terraform-example",
 *         NatType = "Enhanced",
 *         VswitchId = exampleSwitch.Id,
 *         NetworkType = "intranet",
 *     });
 *     var exampleNatIpCidr = new AliCloud.Vpc.NatIpCidr("example", new()
 *     {
 *         NatIpCidrBlock = "192.168.0.0/16",
 *         NatGatewayId = exampleNatGateway.Id,
 *         NatIpCidrDescription = "terraform-example",
 *         NatIpCidrName = "terraform-example",
 *     });
 *     var exampleNatIp = new AliCloud.Vpc.NatIp("example", new()
 *     {
 *         NatIpAddress = "192.168.0.37",
 *         NatGatewayId = exampleNatGateway.Id,
 *         NatIpDescription = "example_value",
 *         NatIpName = "example_value",
 *         NatIpCidr = exampleNatIpCidr.NatIpCidrBlock,
 *     });
 * });
 * ```
 * ```go
 * package main
 * import (
 * 	"github.com/pulumi/pulumi-alicloud/sdk/v3/go/alicloud"
 * 	"github.com/pulumi/pulumi-alicloud/sdk/v3/go/alicloud/vpc"
 * 	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
 * )
 * func main() {
 * 	pulumi.Run(func(ctx *pulumi.Context) error {
 * 		example, err := alicloud.GetZones(ctx, &alicloud.GetZonesArgs{
 * 			AvailableResourceCreation: pulumi.StringRef("VSwitch"),
 * 		}, nil)
 * 		if err != nil {
 * 			return err
 * 		}
 * 		exampleNetwork, err := vpc.NewNetwork(ctx, "example", &vpc.NetworkArgs{
 * 			VpcName:   pulumi.String("terraform-example"),
 * 			CidrBlock: pulumi.String("172.16.0.0/12"),
 * 		})
 * 		if err != nil {
 * 			return err
 * 		}
 * 		exampleSwitch, err := vpc.NewSwitch(ctx, "example", &vpc.SwitchArgs{
 * 			VpcId:       exampleNetwork.ID(),
 * 			CidrBlock:   pulumi.String("172.16.0.0/21"),
 * 			ZoneId:      pulumi.String(example.Zones[0].Id),
 * 			VswitchName: pulumi.String("terraform-example"),
 * 		})
 * 		if err != nil {
 * 			return err
 * 		}
 * 		exampleNatGateway, err := vpc.NewNatGateway(ctx, "example", &vpc.NatGatewayArgs{
 * 			VpcId:              exampleNetwork.ID(),
 * 			InternetChargeType: pulumi.String("PayByLcu"),
 * 			NatGatewayName:     pulumi.String("terraform-example"),
 * 			Description:        pulumi.String("terraform-example"),
 * 			NatType:            pulumi.String("Enhanced"),
 * 			VswitchId:          exampleSwitch.ID(),
 * 			NetworkType:        pulumi.String("intranet"),
 * 		})
 * 		if err != nil {
 * 			return err
 * 		}
 * 		exampleNatIpCidr, err := vpc.NewNatIpCidr(ctx, "example", &vpc.NatIpCidrArgs{
 * 			NatIpCidr:            pulumi.String("192.168.0.0/16"),
 * 			NatGatewayId:         exampleNatGateway.ID(),
 * 			NatIpCidrDescription: pulumi.String("terraform-example"),
 * 			NatIpCidrName:        pulumi.String("terraform-example"),
 * 		})
 * 		if err != nil {
 * 			return err
 * 		}
 * 		_, err = vpc.NewNatIp(ctx, "example", &vpc.NatIpArgs{
 * 			NatIp:            pulumi.String("192.168.0.37"),
 * 			NatGatewayId:     exampleNatGateway.ID(),
 * 			NatIpDescription: pulumi.String("example_value"),
 * 			NatIpName:        pulumi.String("example_value"),
 * 			NatIpCidr:        exampleNatIpCidr.NatIpCidr,
 * 		})
 * 		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.alicloud.AlicloudFunctions;
 * import com.pulumi.alicloud.inputs.GetZonesArgs;
 * import com.pulumi.alicloud.vpc.Network;
 * import com.pulumi.alicloud.vpc.NetworkArgs;
 * import com.pulumi.alicloud.vpc.Switch;
 * import com.pulumi.alicloud.vpc.SwitchArgs;
 * import com.pulumi.alicloud.vpc.NatGateway;
 * import com.pulumi.alicloud.vpc.NatGatewayArgs;
 * import com.pulumi.alicloud.vpc.NatIpCidr;
 * import com.pulumi.alicloud.vpc.NatIpCidrArgs;
 * import com.pulumi.alicloud.vpc.NatIp;
 * import com.pulumi.alicloud.vpc.NatIpArgs;
 * 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) {
 *         final var example = AlicloudFunctions.getZones(GetZonesArgs.builder()
 *             .availableResourceCreation("VSwitch")
 *             .build());
 *         var exampleNetwork = new Network("exampleNetwork", NetworkArgs.builder()
 *             .vpcName("terraform-example")
 *             .cidrBlock("172.16.0.0/12")
 *             .build());
 *         var exampleSwitch = new Switch("exampleSwitch", SwitchArgs.builder()
 *             .vpcId(exampleNetwork.id())
 *             .cidrBlock("172.16.0.0/21")
 *             .zoneId(example.applyValue(getZonesResult -> getZonesResult.zones()[0].id()))
 *             .vswitchName("terraform-example")
 *             .build());
 *         var exampleNatGateway = new NatGateway("exampleNatGateway", NatGatewayArgs.builder()
 *             .vpcId(exampleNetwork.id())
 *             .internetChargeType("PayByLcu")
 *             .natGatewayName("terraform-example")
 *             .description("terraform-example")
 *             .natType("Enhanced")
 *             .vswitchId(exampleSwitch.id())
 *             .networkType("intranet")
 *             .build());
 *         var exampleNatIpCidr = new NatIpCidr("exampleNatIpCidr", NatIpCidrArgs.builder()
 *             .natIpCidr("192.168.0.0/16")
 *             .natGatewayId(exampleNatGateway.id())
 *             .natIpCidrDescription("terraform-example")
 *             .natIpCidrName("terraform-example")
 *             .build());
 *         var exampleNatIp = new NatIp("exampleNatIp", NatIpArgs.builder()
 *             .natIp("192.168.0.37")
 *             .natGatewayId(exampleNatGateway.id())
 *             .natIpDescription("example_value")
 *             .natIpName("example_value")
 *             .natIpCidr(exampleNatIpCidr.natIpCidr())
 *             .build());
 *     }
 * }
 * ```
 * ```yaml
 * resources:
 *   exampleNetwork:
 *     type: alicloud:vpc:Network
 *     name: example
 *     properties:
 *       vpcName: terraform-example
 *       cidrBlock: 172.16.0.0/12
 *   exampleSwitch:
 *     type: alicloud:vpc:Switch
 *     name: example
 *     properties:
 *       vpcId: ${exampleNetwork.id}
 *       cidrBlock: 172.16.0.0/21
 *       zoneId: ${example.zones[0].id}
 *       vswitchName: terraform-example
 *   exampleNatGateway:
 *     type: alicloud:vpc:NatGateway
 *     name: example
 *     properties:
 *       vpcId: ${exampleNetwork.id}
 *       internetChargeType: PayByLcu
 *       natGatewayName: terraform-example
 *       description: terraform-example
 *       natType: Enhanced
 *       vswitchId: ${exampleSwitch.id}
 *       networkType: intranet
 *   exampleNatIpCidr:
 *     type: alicloud:vpc:NatIpCidr
 *     name: example
 *     properties:
 *       natIpCidr: 192.168.0.0/16
 *       natGatewayId: ${exampleNatGateway.id}
 *       natIpCidrDescription: terraform-example
 *       natIpCidrName: terraform-example
 *   exampleNatIp:
 *     type: alicloud:vpc:NatIp
 *     name: example
 *     properties:
 *       natIp: 192.168.0.37
 *       natGatewayId: ${exampleNatGateway.id}
 *       natIpDescription: example_value
 *       natIpName: example_value
 *       natIpCidr: ${exampleNatIpCidr.natIpCidr}
 * variables:
 *   example:
 *     fn::invoke:
 *       Function: alicloud:getZones
 *       Arguments:
 *         availableResourceCreation: VSwitch
 * ```
 * 
 * ## Import
 * VPC Nat Ip can be imported using the id, e.g.
 * ```sh
 * $ pulumi import alicloud:vpc/natIp:NatIp example :
 * ```
 */
public class NatIp internal constructor(
    override val javaResource: com.pulumi.alicloud.vpc.NatIp,
) : KotlinCustomResource(javaResource, NatIpMapper) {
    /**
     * Specifies whether to check the validity of the request without actually making the request.
     */
    public val dryRun: Output
        get() = javaResource.dryRun().applyValue({ args0 -> args0 })

    /**
     * The ID of the Virtual Private Cloud (VPC) NAT gateway for which you want to create the NAT IP address.
     */
    public val natGatewayId: Output
        get() = javaResource.natGatewayId().applyValue({ args0 -> args0 })

    /**
     * The NAT IP address that you want to create. If you do not specify an IP address, the system selects a random IP address from the specified CIDR block.
     */
    public val natIp: Output
        get() = javaResource.natIp().applyValue({ args0 -> args0 })

    /**
     * NAT IP ADDRESS of the address segment.
     */
    public val natIpCidr: Output?
        get() = javaResource.natIpCidr().applyValue({ args0 -> args0.map({ args0 -> args0 }).orElse(null) })

    /**
     * The ID of the CIDR block to which the NAT IP address belongs.
     */
    public val natIpCidrId: Output?
        get() = javaResource.natIpCidrId().applyValue({ args0 ->
            args0.map({ args0 ->
                args0
            }).orElse(null)
        })

    /**
     * NAT IP ADDRESS description of information. Length is from `2` to `256` characters, must start with a letter or the Chinese at the beginning, but not at the` http://` Or `https://` at the beginning.
     */
    public val natIpDescription: Output?
        get() = javaResource.natIpDescription().applyValue({ args0 ->
            args0.map({ args0 ->
                args0
            }).orElse(null)
        })

    /**
     * Ihe ID of the Nat Ip.
     */
    public val natIpId: Output
        get() = javaResource.natIpId().applyValue({ args0 -> args0 })

    /**
     * NAT IP ADDRESS the name of the root directory. Length is from `2` to `128` characters, must start with a letter or the Chinese at the beginning can contain numbers, half a period (.), underscore (_) and dash (-). But do not start with `http://` or `https://` at the beginning.
     */
    public val natIpName: Output?
        get() = javaResource.natIpName().applyValue({ args0 -> args0.map({ args0 -> args0 }).orElse(null) })

    /**
     * The status of the NAT IP address. Valid values: `Available`, `Deleting`, `Creating` and `Deleted`.
     */
    public val status: Output
        get() = javaResource.status().applyValue({ args0 -> args0 })
}

public object NatIpMapper : ResourceMapper {
    override fun supportsMappingOfType(javaResource: Resource): Boolean =
        com.pulumi.alicloud.vpc.NatIp::class == javaResource::class

    override fun map(javaResource: Resource): NatIp = NatIp(
        javaResource as
            com.pulumi.alicloud.vpc.NatIp,
    )
}

/**
 * @see [NatIp].
 * @param name The _unique_ name of the resulting resource.
 * @param block Builder for [NatIp].
 */
public suspend fun natIp(name: String, block: suspend NatIpResourceBuilder.() -> Unit): NatIp {
    val builder = NatIpResourceBuilder()
    builder.name(name)
    block(builder)
    return builder.build()
}

/**
 * @see [NatIp].
 * @param name The _unique_ name of the resulting resource.
 */
public fun natIp(name: String): NatIp {
    val builder = NatIpResourceBuilder()
    builder.name(name)
    return builder.build()
}




© 2015 - 2024 Weber Informatics LLC | Privacy Policy