Docs Home Pulumi IaC Pulumi ESC Pulumi Insights Pulumi Cloud Packages Tutorials
  1. Packages
  2. Scaleway
  3. API Docs
  4. ipam
  5. Ip
Scaleway v1.25.0 published on Saturday, Mar 22, 2025 by pulumiverse
pulumiverse/pulumi-scaleway

scaleway.ipam.Ip

Explore with Pulumi AI

scaleway logo
Scaleway v1.25.0 published on Saturday, Mar 22, 2025 by pulumiverse
pulumiverse/pulumi-scaleway

    Books and manages IPAM IPs.

    For more information about IPAM, see the main documentation.

    Example Usage

    Basic

    import * as pulumi from "@pulumi/pulumi";
import * as scaleway from "@pulumiverse/scaleway";

const vpc01 = new scaleway.network.Vpc("vpc01", {name: "my vpc"});
const pn01 = new scaleway.network.PrivateNetwork("pn01", {
    vpcId: vpc01.id,
    ipv4Subnet: {
        subnet: "172.16.32.0/22",
    },
});
const ip01 = new scaleway.ipam.Ip("ip01", {sources: [{
    privateNetworkId: pn01.id,
}]});

    import pulumi
import pulumiverse_scaleway as scaleway

vpc01 = scaleway.network.Vpc("vpc01", name="my vpc")
pn01 = scaleway.network.PrivateNetwork("pn01",
    vpc_id=vpc01.id,
    ipv4_subnet={
        "subnet": "172.16.32.0/22",
    })
ip01 = scaleway.ipam.Ip("ip01", sources=[{
    "private_network_id": pn01.id,
}])

    package main

import (
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
	"github.com/pulumiverse/pulumi-scaleway/sdk/go/scaleway/ipam"
	"github.com/pulumiverse/pulumi-scaleway/sdk/go/scaleway/network"
)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		vpc01, err := network.NewVpc(ctx, "vpc01", &network.VpcArgs{
			Name: pulumi.String("my vpc"),
		})
		if err != nil {
			return err
		}
		pn01, err := network.NewPrivateNetwork(ctx, "pn01", &network.PrivateNetworkArgs{
			VpcId: vpc01.ID(),
			Ipv4Subnet: &network.PrivateNetworkIpv4SubnetArgs{
				Subnet: pulumi.String("172.16.32.0/22"),
			},
		})
		if err != nil {
			return err
		}
		_, err = ipam.NewIp(ctx, "ip01", &ipam.IpArgs{
			Sources: ipam.IpSourceArray{
				&ipam.IpSourceArgs{
					PrivateNetworkId: pn01.ID(),
				},
			},
		})
		if err != nil {
			return err
		}
		return nil
	})
}

    using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Scaleway = Pulumiverse.Scaleway;

return await Deployment.RunAsync(() => 
{
    var vpc01 = new Scaleway.Network.Vpc("vpc01", new()
    {
        Name = "my vpc",
    });

    var pn01 = new Scaleway.Network.PrivateNetwork("pn01", new()
    {
        VpcId = vpc01.Id,
        Ipv4Subnet = new Scaleway.Network.Inputs.PrivateNetworkIpv4SubnetArgs
        {
            Subnet = "172.16.32.0/22",
        },
    });

    var ip01 = new Scaleway.Ipam.Ip("ip01", new()
    {
        Sources = new[]
        {
            new Scaleway.Ipam.Inputs.IpSourceArgs
            {
                PrivateNetworkId = pn01.Id,
            },
        },
    });

});

    package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.scaleway.network.Vpc;
import com.pulumi.scaleway.network.VpcArgs;
import com.pulumi.scaleway.network.PrivateNetwork;
import com.pulumi.scaleway.network.PrivateNetworkArgs;
import com.pulumi.scaleway.network.inputs.PrivateNetworkIpv4SubnetArgs;
import com.pulumi.scaleway.ipam.Ip;
import com.pulumi.scaleway.ipam.IpArgs;
import com.pulumi.scaleway.ipam.inputs.IpSourceArgs;
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 vpc01 = new Vpc("vpc01", VpcArgs.builder()
            .name("my vpc")
            .build());

        var pn01 = new PrivateNetwork("pn01", PrivateNetworkArgs.builder()
            .vpcId(vpc01.id())
            .ipv4Subnet(PrivateNetworkIpv4SubnetArgs.builder()
                .subnet("172.16.32.0/22")
                .build())
            .build());

        var ip01 = new Ip("ip01", IpArgs.builder()
            .sources(IpSourceArgs.builder()
                .privateNetworkId(pn01.id())
                .build())
            .build());

    }
}

    resources:
  vpc01:
    type: scaleway:network:Vpc
    properties:
      name: my vpc
  pn01:
    type: scaleway:network:PrivateNetwork
    properties:
      vpcId: ${vpc01.id}
      ipv4Subnet:
        subnet: 172.16.32.0/22
  ip01:
    type: scaleway:ipam:Ip
    properties:
      sources:
        - privateNetworkId: ${pn01.id}

    Request a specific IPv4 address

    import * as pulumi from "@pulumi/pulumi";
import * as scaleway from "@pulumiverse/scaleway";

const vpc01 = new scaleway.network.Vpc("vpc01", {name: "my vpc"});
const pn01 = new scaleway.network.PrivateNetwork("pn01", {
    vpcId: vpc01.id,
    ipv4Subnet: {
        subnet: "172.16.32.0/22",
    },
});
const ip01 = new scaleway.ipam.Ip("ip01", {
    address: "172.16.32.7",
    sources: [{
        privateNetworkId: pn01.id,
    }],
});

    import pulumi
import pulumiverse_scaleway as scaleway

vpc01 = scaleway.network.Vpc("vpc01", name="my vpc")
pn01 = scaleway.network.PrivateNetwork("pn01",
    vpc_id=vpc01.id,
    ipv4_subnet={
        "subnet": "172.16.32.0/22",
    })
ip01 = scaleway.ipam.Ip("ip01",
    address="172.16.32.7",
    sources=[{
        "private_network_id": pn01.id,
    }])

    package main

import (
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
	"github.com/pulumiverse/pulumi-scaleway/sdk/go/scaleway/ipam"
	"github.com/pulumiverse/pulumi-scaleway/sdk/go/scaleway/network"
)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		vpc01, err := network.NewVpc(ctx, "vpc01", &network.VpcArgs{
			Name: pulumi.String("my vpc"),
		})
		if err != nil {
			return err
		}
		pn01, err := network.NewPrivateNetwork(ctx, "pn01", &network.PrivateNetworkArgs{
			VpcId: vpc01.ID(),
			Ipv4Subnet: &network.PrivateNetworkIpv4SubnetArgs{
				Subnet: pulumi.String("172.16.32.0/22"),
			},
		})
		if err != nil {
			return err
		}
		_, err = ipam.NewIp(ctx, "ip01", &ipam.IpArgs{
			Address: pulumi.String("172.16.32.7"),
			Sources: ipam.IpSourceArray{
				&ipam.IpSourceArgs{
					PrivateNetworkId: pn01.ID(),
				},
			},
		})
		if err != nil {
			return err
		}
		return nil
	})
}

    using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Scaleway = Pulumiverse.Scaleway;

return await Deployment.RunAsync(() => 
{
    var vpc01 = new Scaleway.Network.Vpc("vpc01", new()
    {
        Name = "my vpc",
    });

    var pn01 = new Scaleway.Network.PrivateNetwork("pn01", new()
    {
        VpcId = vpc01.Id,
        Ipv4Subnet = new Scaleway.Network.Inputs.PrivateNetworkIpv4SubnetArgs
        {
            Subnet = "172.16.32.0/22",
        },
    });

    var ip01 = new Scaleway.Ipam.Ip("ip01", new()
    {
        Address = "172.16.32.7",
        Sources = new[]
        {
            new Scaleway.Ipam.Inputs.IpSourceArgs
            {
                PrivateNetworkId = pn01.Id,
            },
        },
    });

});

    package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.scaleway.network.Vpc;
import com.pulumi.scaleway.network.VpcArgs;
import com.pulumi.scaleway.network.PrivateNetwork;
import com.pulumi.scaleway.network.PrivateNetworkArgs;
import com.pulumi.scaleway.network.inputs.PrivateNetworkIpv4SubnetArgs;
import com.pulumi.scaleway.ipam.Ip;
import com.pulumi.scaleway.ipam.IpArgs;
import com.pulumi.scaleway.ipam.inputs.IpSourceArgs;
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 vpc01 = new Vpc("vpc01", VpcArgs.builder()
            .name("my vpc")
            .build());

        var pn01 = new PrivateNetwork("pn01", PrivateNetworkArgs.builder()
            .vpcId(vpc01.id())
            .ipv4Subnet(PrivateNetworkIpv4SubnetArgs.builder()
                .subnet("172.16.32.0/22")
                .build())
            .build());

        var ip01 = new Ip("ip01", IpArgs.builder()
            .address("172.16.32.7")
            .sources(IpSourceArgs.builder()
                .privateNetworkId(pn01.id())
                .build())
            .build());

    }
}

    resources:
  vpc01:
    type: scaleway:network:Vpc
    properties:
      name: my vpc
  pn01:
    type: scaleway:network:PrivateNetwork
    properties:
      vpcId: ${vpc01.id}
      ipv4Subnet:
        subnet: 172.16.32.0/22
  ip01:
    type: scaleway:ipam:Ip
    properties:
      address: 172.16.32.7
      sources:
        - privateNetworkId: ${pn01.id}

    Request an IPv6 address

    import * as pulumi from "@pulumi/pulumi";
import * as scaleway from "@pulumiverse/scaleway";

const vpc01 = new scaleway.network.Vpc("vpc01", {name: "my vpc"});
const pn01 = new scaleway.network.PrivateNetwork("pn01", {
    vpcId: vpc01.id,
    ipv6Subnets: [{
        subnet: "fd46:78ab:30b8:177c::/64",
    }],
});
const ip01 = new scaleway.ipam.Ip("ip01", {
    isIpv6: true,
    sources: [{
        privateNetworkId: pn01.id,
    }],
});

    import pulumi
import pulumiverse_scaleway as scaleway

vpc01 = scaleway.network.Vpc("vpc01", name="my vpc")
pn01 = scaleway.network.PrivateNetwork("pn01",
    vpc_id=vpc01.id,
    ipv6_subnets=[{
        "subnet": "fd46:78ab:30b8:177c::/64",
    }])
ip01 = scaleway.ipam.Ip("ip01",
    is_ipv6=True,
    sources=[{
        "private_network_id": pn01.id,
    }])

    package main

import (
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
	"github.com/pulumiverse/pulumi-scaleway/sdk/go/scaleway/ipam"
	"github.com/pulumiverse/pulumi-scaleway/sdk/go/scaleway/network"
)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		vpc01, err := network.NewVpc(ctx, "vpc01", &network.VpcArgs{
			Name: pulumi.String("my vpc"),
		})
		if err != nil {
			return err
		}
		pn01, err := network.NewPrivateNetwork(ctx, "pn01", &network.PrivateNetworkArgs{
			VpcId: vpc01.ID(),
			Ipv6Subnets: network.PrivateNetworkIpv6SubnetArray{
				&network.PrivateNetworkIpv6SubnetArgs{
					Subnet: pulumi.String("fd46:78ab:30b8:177c::/64"),
				},
			},
		})
		if err != nil {
			return err
		}
		_, err = ipam.NewIp(ctx, "ip01", &ipam.IpArgs{
			IsIpv6: pulumi.Bool(true),
			Sources: ipam.IpSourceArray{
				&ipam.IpSourceArgs{
					PrivateNetworkId: pn01.ID(),
				},
			},
		})
		if err != nil {
			return err
		}
		return nil
	})
}

    using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Scaleway = Pulumiverse.Scaleway;

return await Deployment.RunAsync(() => 
{
    var vpc01 = new Scaleway.Network.Vpc("vpc01", new()
    {
        Name = "my vpc",
    });

    var pn01 = new Scaleway.Network.PrivateNetwork("pn01", new()
    {
        VpcId = vpc01.Id,
        Ipv6Subnets = new[]
        {
            new Scaleway.Network.Inputs.PrivateNetworkIpv6SubnetArgs
            {
                Subnet = "fd46:78ab:30b8:177c::/64",
            },
        },
    });

    var ip01 = new Scaleway.Ipam.Ip("ip01", new()
    {
        IsIpv6 = true,
        Sources = new[]
        {
            new Scaleway.Ipam.Inputs.IpSourceArgs
            {
                PrivateNetworkId = pn01.Id,
            },
        },
    });

});

    package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.scaleway.network.Vpc;
import com.pulumi.scaleway.network.VpcArgs;
import com.pulumi.scaleway.network.PrivateNetwork;
import com.pulumi.scaleway.network.PrivateNetworkArgs;
import com.pulumi.scaleway.network.inputs.PrivateNetworkIpv6SubnetArgs;
import com.pulumi.scaleway.ipam.Ip;
import com.pulumi.scaleway.ipam.IpArgs;
import com.pulumi.scaleway.ipam.inputs.IpSourceArgs;
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 vpc01 = new Vpc("vpc01", VpcArgs.builder()
            .name("my vpc")
            .build());

        var pn01 = new PrivateNetwork("pn01", PrivateNetworkArgs.builder()
            .vpcId(vpc01.id())
            .ipv6Subnets(PrivateNetworkIpv6SubnetArgs.builder()
                .subnet("fd46:78ab:30b8:177c::/64")
                .build())
            .build());

        var ip01 = new Ip("ip01", IpArgs.builder()
            .isIpv6(true)
            .sources(IpSourceArgs.builder()
                .privateNetworkId(pn01.id())
                .build())
            .build());

    }
}

    resources:
  vpc01:
    type: scaleway:network:Vpc
    properties:
      name: my vpc
  pn01:
    type: scaleway:network:PrivateNetwork
    properties:
      vpcId: ${vpc01.id}
      ipv6Subnets:
        - subnet: fd46:78ab:30b8:177c::/64
  ip01:
    type: scaleway:ipam:Ip
    properties:
      isIpv6: true
      sources:
        - privateNetworkId: ${pn01.id}

    Book an IP for a custom resource

    import * as pulumi from "@pulumi/pulumi";
import * as scaleway from "@pulumiverse/scaleway";

const vpc01 = new scaleway.network.Vpc("vpc01", {name: "my vpc"});
const pn01 = new scaleway.network.PrivateNetwork("pn01", {
    vpcId: vpc01.id,
    ipv4Subnet: {
        subnet: "172.16.32.0/22",
    },
});
const ip01 = new scaleway.ipam.Ip("ip01", {
    address: "172.16.32.7",
    sources: [{
        privateNetworkId: pn01.id,
    }],
    customResources: [{
        macAddress: "bc:24:11:74:d0:6a",
    }],
});

    import pulumi
import pulumiverse_scaleway as scaleway

vpc01 = scaleway.network.Vpc("vpc01", name="my vpc")
pn01 = scaleway.network.PrivateNetwork("pn01",
    vpc_id=vpc01.id,
    ipv4_subnet={
        "subnet": "172.16.32.0/22",
    })
ip01 = scaleway.ipam.Ip("ip01",
    address="172.16.32.7",
    sources=[{
        "private_network_id": pn01.id,
    }],
    custom_resources=[{
        "mac_address": "bc:24:11:74:d0:6a",
    }])

    package main

import (
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
	"github.com/pulumiverse/pulumi-scaleway/sdk/go/scaleway/ipam"
	"github.com/pulumiverse/pulumi-scaleway/sdk/go/scaleway/network"
)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		vpc01, err := network.NewVpc(ctx, "vpc01", &network.VpcArgs{
			Name: pulumi.String("my vpc"),
		})
		if err != nil {
			return err
		}
		pn01, err := network.NewPrivateNetwork(ctx, "pn01", &network.PrivateNetworkArgs{
			VpcId: vpc01.ID(),
			Ipv4Subnet: &network.PrivateNetworkIpv4SubnetArgs{
				Subnet: pulumi.String("172.16.32.0/22"),
			},
		})
		if err != nil {
			return err
		}
		_, err = ipam.NewIp(ctx, "ip01", &ipam.IpArgs{
			Address: pulumi.String("172.16.32.7"),
			Sources: ipam.IpSourceArray{
				&ipam.IpSourceArgs{
					PrivateNetworkId: pn01.ID(),
				},
			},
			CustomResources: ipam.IpCustomResourceArray{
				&ipam.IpCustomResourceArgs{
					MacAddress: pulumi.String("bc:24:11:74:d0:6a"),
				},
			},
		})
		if err != nil {
			return err
		}
		return nil
	})
}

    using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Scaleway = Pulumiverse.Scaleway;

return await Deployment.RunAsync(() => 
{
    var vpc01 = new Scaleway.Network.Vpc("vpc01", new()
    {
        Name = "my vpc",
    });

    var pn01 = new Scaleway.Network.PrivateNetwork("pn01", new()
    {
        VpcId = vpc01.Id,
        Ipv4Subnet = new Scaleway.Network.Inputs.PrivateNetworkIpv4SubnetArgs
        {
            Subnet = "172.16.32.0/22",
        },
    });

    var ip01 = new Scaleway.Ipam.Ip("ip01", new()
    {
        Address = "172.16.32.7",
        Sources = new[]
        {
            new Scaleway.Ipam.Inputs.IpSourceArgs
            {
                PrivateNetworkId = pn01.Id,
            },
        },
        CustomResources = new[]
        {
            new Scaleway.Ipam.Inputs.IpCustomResourceArgs
            {
                MacAddress = "bc:24:11:74:d0:6a",
            },
        },
    });

});

    package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.scaleway.network.Vpc;
import com.pulumi.scaleway.network.VpcArgs;
import com.pulumi.scaleway.network.PrivateNetwork;
import com.pulumi.scaleway.network.PrivateNetworkArgs;
import com.pulumi.scaleway.network.inputs.PrivateNetworkIpv4SubnetArgs;
import com.pulumi.scaleway.ipam.Ip;
import com.pulumi.scaleway.ipam.IpArgs;
import com.pulumi.scaleway.ipam.inputs.IpSourceArgs;
import com.pulumi.scaleway.ipam.inputs.IpCustomResourceArgs;
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 vpc01 = new Vpc("vpc01", VpcArgs.builder()
            .name("my vpc")
            .build());

        var pn01 = new PrivateNetwork("pn01", PrivateNetworkArgs.builder()
            .vpcId(vpc01.id())
            .ipv4Subnet(PrivateNetworkIpv4SubnetArgs.builder()
                .subnet("172.16.32.0/22")
                .build())
            .build());

        var ip01 = new Ip("ip01", IpArgs.builder()
            .address("172.16.32.7")
            .sources(IpSourceArgs.builder()
                .privateNetworkId(pn01.id())
                .build())
            .customResources(IpCustomResourceArgs.builder()
                .macAddress("bc:24:11:74:d0:6a")
                .build())
            .build());

    }
}

    resources:
  vpc01:
    type: scaleway:network:Vpc
    properties:
      name: my vpc
  pn01:
    type: scaleway:network:PrivateNetwork
    properties:
      vpcId: ${vpc01.id}
      ipv4Subnet:
        subnet: 172.16.32.0/22
  ip01:
    type: scaleway:ipam:Ip
    properties:
      address: 172.16.32.7
      sources:
        - privateNetworkId: ${pn01.id}
      customResources:
        - macAddress: bc:24:11:74:d0:6a

    Create Ip Resource

    Resources are created with functions called constructors. To learn more about declaring and configuring resources, see Resources.

    Constructor syntax

    new Ip(name: string, args: IpArgs, opts?: CustomResourceOptions);
    @overload
def Ip(resource_name: str,
       args: IpArgs,
       opts: Optional[ResourceOptions] = None)

@overload
def Ip(resource_name: str,
       opts: Optional[ResourceOptions] = None,
       sources: Optional[Sequence[IpSourceArgs]] = None,
       address: Optional[str] = None,
       custom_resources: Optional[Sequence[IpCustomResourceArgs]] = None,
       is_ipv6: Optional[bool] = None,
       project_id: Optional[str] = None,
       region: Optional[str] = None,
       tags: Optional[Sequence[str]] = None)
    func NewIp(ctx *Context, name string, args IpArgs, opts ...ResourceOption) (*Ip, error)
    public Ip(string name, IpArgs args, CustomResourceOptions? opts = null)
    public Ip(String name, IpArgs args)
public Ip(String name, IpArgs args, CustomResourceOptions options)

    type: scaleway:ipam:Ip
properties: # The arguments to resource properties.
options: # Bag of options to control resource's behavior.

    Parameters

    name string
    The unique name of the resource.
    args IpArgs
    The arguments to resource properties.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    resource_name str
    The unique name of the resource.
    args IpArgs
    The arguments to resource properties.
    opts ResourceOptions
    Bag of options to control resource's behavior.
    ctx Context
    Context object for the current deployment.
    name string
    The unique name of the resource.
    args IpArgs
    The arguments to resource properties.
    opts ResourceOption
    Bag of options to control resource's behavior.
    name string
    The unique name of the resource.
    args IpArgs
    The arguments to resource properties.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    name String
    The unique name of the resource.
    args IpArgs
    The arguments to resource properties.
    options CustomResourceOptions
    Bag of options to control resource's behavior.

    Constructor example

    The following reference example uses placeholder values for all input properties.

    var exampleipResourceResourceFromIpamip = new Scaleway.Ipam.Ip("exampleipResourceResourceFromIpamip", new()
{
    Sources = new[]
    {
        new Scaleway.Ipam.Inputs.IpSourceArgs
        {
            PrivateNetworkId = "string",
            SubnetId = "string",
            Zonal = "string",
        },
    },
    Address = "string",
    CustomResources = new[]
    {
        new Scaleway.Ipam.Inputs.IpCustomResourceArgs
        {
            MacAddress = "string",
            Name = "string",
        },
    },
    IsIpv6 = false,
    ProjectId = "string",
    Region = "string",
    Tags = new[]
    {
        "string",
    },
});

    example, err := ipam.NewIp(ctx, "exampleipResourceResourceFromIpamip", &ipam.IpArgs{
	Sources: ipam.IpSourceArray{
		&ipam.IpSourceArgs{
			PrivateNetworkId: pulumi.String("string"),
			SubnetId:         pulumi.String("string"),
			Zonal:            pulumi.String("string"),
		},
	},
	Address: pulumi.String("string"),
	CustomResources: ipam.IpCustomResourceArray{
		&ipam.IpCustomResourceArgs{
			MacAddress: pulumi.String("string"),
			Name:       pulumi.String("string"),
		},
	},
	IsIpv6:    pulumi.Bool(false),
	ProjectId: pulumi.String("string"),
	Region:    pulumi.String("string"),
	Tags: pulumi.StringArray{
		pulumi.String("string"),
	},
})

    var exampleipResourceResourceFromIpamip = new Ip("exampleipResourceResourceFromIpamip", IpArgs.builder()
    .sources(IpSourceArgs.builder()
        .privateNetworkId("string")
        .subnetId("string")
        .zonal("string")
        .build())
    .address("string")
    .customResources(IpCustomResourceArgs.builder()
        .macAddress("string")
        .name("string")
        .build())
    .isIpv6(false)
    .projectId("string")
    .region("string")
    .tags("string")
    .build());

    exampleip_resource_resource_from_ipamip = scaleway.ipam.Ip("exampleipResourceResourceFromIpamip",
    sources=[{
        "private_network_id": "string",
        "subnet_id": "string",
        "zonal": "string",
    }],
    address="string",
    custom_resources=[{
        "mac_address": "string",
        "name": "string",
    }],
    is_ipv6=False,
    project_id="string",
    region="string",
    tags=["string"])

    const exampleipResourceResourceFromIpamip = new scaleway.ipam.Ip("exampleipResourceResourceFromIpamip", {
    sources: [{
        privateNetworkId: "string",
        subnetId: "string",
        zonal: "string",
    }],
    address: "string",
    customResources: [{
        macAddress: "string",
        name: "string",
    }],
    isIpv6: false,
    projectId: "string",
    region: "string",
    tags: ["string"],
});

    type: scaleway:ipam:Ip
properties:
    address: string
    customResources:
        - macAddress: string
          name: string
    isIpv6: false
    projectId: string
    region: string
    sources:
        - privateNetworkId: string
          subnetId: string
          zonal: string
    tags:
        - string

    Ip Resource Properties

    To learn more about resource properties and how to use them, see Inputs and Outputs in the Architecture and Concepts docs.

    Inputs

    In Python, inputs that are objects can be passed either as argument classes or as dictionary literals.

    The Ip resource accepts the following input properties:

    Sources List<Pulumiverse.Scaleway.Ipam.Inputs.IpSource>
    The source in which to book the IP.
    Address string
    Request a specific IP in the requested source pool
    CustomResources List<Pulumiverse.Scaleway.Ipam.Inputs.IpCustomResource>
    The custom resource in which to book the IP
    IsIpv6 bool
    Defines whether to request an IPv6 address instead of IPv4.
    ProjectId string
    project_id) The ID of the Project the IP is associated with.
    Region string
    region) The region of the IP.
    Tags List<string>
    The tags associated with the IP.
    Sources []IpSourceArgs
    The source in which to book the IP.
    Address string
    Request a specific IP in the requested source pool
    CustomResources []IpCustomResourceArgs
    The custom resource in which to book the IP
    IsIpv6 bool
    Defines whether to request an IPv6 address instead of IPv4.
    ProjectId string
    project_id) The ID of the Project the IP is associated with.
    Region string
    region) The region of the IP.
    Tags []string
    The tags associated with the IP.
    sources List<IpSource>
    The source in which to book the IP.
    address String
    Request a specific IP in the requested source pool
    customResources List<IpCustomResource>
    The custom resource in which to book the IP
    isIpv6 Boolean
    Defines whether to request an IPv6 address instead of IPv4.
    projectId String
    project_id) The ID of the Project the IP is associated with.
    region String
    region) The region of the IP.
    tags List<String>
    The tags associated with the IP.
    sources IpSource[]
    The source in which to book the IP.
    address string
    Request a specific IP in the requested source pool
    customResources IpCustomResource[]
    The custom resource in which to book the IP
    isIpv6 boolean
    Defines whether to request an IPv6 address instead of IPv4.
    projectId string
    project_id) The ID of the Project the IP is associated with.
    region string
    region) The region of the IP.
    tags string[]
    The tags associated with the IP.
    sources Sequence[IpSourceArgs]
    The source in which to book the IP.
    address str
    Request a specific IP in the requested source pool
    custom_resources Sequence[IpCustomResourceArgs]
    The custom resource in which to book the IP
    is_ipv6 bool
    Defines whether to request an IPv6 address instead of IPv4.
    project_id str
    project_id) The ID of the Project the IP is associated with.
    region str
    region) The region of the IP.
    tags Sequence[str]
    The tags associated with the IP.
    sources List<Property Map>
    The source in which to book the IP.
    address String
    Request a specific IP in the requested source pool
    customResources List<Property Map>
    The custom resource in which to book the IP
    isIpv6 Boolean
    Defines whether to request an IPv6 address instead of IPv4.
    projectId String
    project_id) The ID of the Project the IP is associated with.
    region String
    region) The region of the IP.
    tags List<String>
    The tags associated with the IP.

    Outputs

    All input properties are implicitly available as output properties. Additionally, the Ip resource produces the following output properties:

    CreatedAt string
    Date and time of IP's creation (RFC 3339 format).
    Id string
    The provider-assigned unique ID for this managed resource.
    Resources List<Pulumiverse.Scaleway.Ipam.Outputs.IpResource>
    The IP resource.
    Reverses List<Pulumiverse.Scaleway.Ipam.Outputs.IpReverse>
    The reverse DNS for this IP.
    UpdatedAt string
    Date and time of IP's last update (RFC 3339 format).
    Zone string
    The zone of the IP.
    CreatedAt string
    Date and time of IP's creation (RFC 3339 format).
    Id string
    The provider-assigned unique ID for this managed resource.
    Resources []IpResource
    The IP resource.
    Reverses []IpReverse
    The reverse DNS for this IP.
    UpdatedAt string
    Date and time of IP's last update (RFC 3339 format).
    Zone string
    The zone of the IP.
    createdAt String
    Date and time of IP's creation (RFC 3339 format).
    id String
    The provider-assigned unique ID for this managed resource.
    resources List<IpResource>
    The IP resource.
    reverses List<IpReverse>
    The reverse DNS for this IP.
    updatedAt String
    Date and time of IP's last update (RFC 3339 format).
    zone String
    The zone of the IP.
    createdAt string
    Date and time of IP's creation (RFC 3339 format).
    id string
    The provider-assigned unique ID for this managed resource.
    resources IpResource[]
    The IP resource.
    reverses IpReverse[]
    The reverse DNS for this IP.
    updatedAt string
    Date and time of IP's last update (RFC 3339 format).
    zone string
    The zone of the IP.
    created_at str
    Date and time of IP's creation (RFC 3339 format).
    id str
    The provider-assigned unique ID for this managed resource.
    resources Sequence[IpResource]
    The IP resource.
    reverses Sequence[IpReverse]
    The reverse DNS for this IP.
    updated_at str
    Date and time of IP's last update (RFC 3339 format).
    zone str
    The zone of the IP.
    createdAt String
    Date and time of IP's creation (RFC 3339 format).
    id String
    The provider-assigned unique ID for this managed resource.
    resources List<Property Map>
    The IP resource.
    reverses List<Property Map>
    The reverse DNS for this IP.
    updatedAt String
    Date and time of IP's last update (RFC 3339 format).
    zone String
    The zone of the IP.

    Look up Existing Ip Resource

    Get an existing Ip resource’s state with the given name, ID, and optional extra properties used to qualify the lookup.

    public static get(name: string, id: Input<ID>, state?: IpState, opts?: CustomResourceOptions): Ip
    @staticmethod
def get(resource_name: str,
        id: str,
        opts: Optional[ResourceOptions] = None,
        address: Optional[str] = None,
        created_at: Optional[str] = None,
        custom_resources: Optional[Sequence[IpCustomResourceArgs]] = None,
        is_ipv6: Optional[bool] = None,
        project_id: Optional[str] = None,
        region: Optional[str] = None,
        resources: Optional[Sequence[IpResourceArgs]] = None,
        reverses: Optional[Sequence[IpReverseArgs]] = None,
        sources: Optional[Sequence[IpSourceArgs]] = None,
        tags: Optional[Sequence[str]] = None,
        updated_at: Optional[str] = None,
        zone: Optional[str] = None) -> Ip
    func GetIp(ctx *Context, name string, id IDInput, state *IpState, opts ...ResourceOption) (*Ip, error)
    public static Ip Get(string name, Input<string> id, IpState? state, CustomResourceOptions? opts = null)
    public static Ip get(String name, Output<String> id, IpState state, CustomResourceOptions options)
    resources:  _:    type: scaleway:ipam:Ip    get:      id: ${id}
    name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    state
    Any extra arguments used during the lookup.
    opts
    A bag of options that control this resource's behavior.
    resource_name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    state
    Any extra arguments used during the lookup.
    opts
    A bag of options that control this resource's behavior.
    name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    state
    Any extra arguments used during the lookup.
    opts
    A bag of options that control this resource's behavior.
    name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    state
    Any extra arguments used during the lookup.
    opts
    A bag of options that control this resource's behavior.
    The following state arguments are supported:
    Address string
    Request a specific IP in the requested source pool
    CreatedAt string
    Date and time of IP's creation (RFC 3339 format).
    CustomResources List<Pulumiverse.Scaleway.Ipam.Inputs.IpCustomResource>
    The custom resource in which to book the IP
    IsIpv6 bool
    Defines whether to request an IPv6 address instead of IPv4.
    ProjectId string
    project_id) The ID of the Project the IP is associated with.
    Region string
    region) The region of the IP.
    Resources List<Pulumiverse.Scaleway.Ipam.Inputs.IpResource>
    The IP resource.
    Reverses List<Pulumiverse.Scaleway.Ipam.Inputs.IpReverse>
    The reverse DNS for this IP.
    Sources List<Pulumiverse.Scaleway.Ipam.Inputs.IpSource>
    The source in which to book the IP.
    Tags List<string>
    The tags associated with the IP.
    UpdatedAt string
    Date and time of IP's last update (RFC 3339 format).
    Zone string
    The zone of the IP.
    Address string
    Request a specific IP in the requested source pool
    CreatedAt string
    Date and time of IP's creation (RFC 3339 format).
    CustomResources []IpCustomResourceArgs
    The custom resource in which to book the IP
    IsIpv6 bool
    Defines whether to request an IPv6 address instead of IPv4.
    ProjectId string
    project_id) The ID of the Project the IP is associated with.
    Region string
    region) The region of the IP.
    Resources []IpResourceArgs
    The IP resource.
    Reverses []IpReverseArgs
    The reverse DNS for this IP.
    Sources []IpSourceArgs
    The source in which to book the IP.
    Tags []string
    The tags associated with the IP.
    UpdatedAt string
    Date and time of IP's last update (RFC 3339 format).
    Zone string
    The zone of the IP.
    address String
    Request a specific IP in the requested source pool
    createdAt String
    Date and time of IP's creation (RFC 3339 format).
    customResources List<IpCustomResource>
    The custom resource in which to book the IP
    isIpv6 Boolean
    Defines whether to request an IPv6 address instead of IPv4.
    projectId String
    project_id) The ID of the Project the IP is associated with.
    region String
    region) The region of the IP.
    resources List<IpResource>
    The IP resource.
    reverses List<IpReverse>
    The reverse DNS for this IP.
    sources List<IpSource>
    The source in which to book the IP.
    tags List<String>
    The tags associated with the IP.
    updatedAt String
    Date and time of IP's last update (RFC 3339 format).
    zone String
    The zone of the IP.
    address string
    Request a specific IP in the requested source pool
    createdAt string
    Date and time of IP's creation (RFC 3339 format).
    customResources IpCustomResource[]
    The custom resource in which to book the IP
    isIpv6 boolean
    Defines whether to request an IPv6 address instead of IPv4.
    projectId string
    project_id) The ID of the Project the IP is associated with.
    region string
    region) The region of the IP.
    resources IpResource[]
    The IP resource.
    reverses IpReverse[]
    The reverse DNS for this IP.
    sources IpSource[]
    The source in which to book the IP.
    tags string[]
    The tags associated with the IP.
    updatedAt string
    Date and time of IP's last update (RFC 3339 format).
    zone string
    The zone of the IP.
    address str
    Request a specific IP in the requested source pool
    created_at str
    Date and time of IP's creation (RFC 3339 format).
    custom_resources Sequence[IpCustomResourceArgs]
    The custom resource in which to book the IP
    is_ipv6 bool
    Defines whether to request an IPv6 address instead of IPv4.
    project_id str
    project_id) The ID of the Project the IP is associated with.
    region str
    region) The region of the IP.
    resources Sequence[IpResourceArgs]
    The IP resource.
    reverses Sequence[IpReverseArgs]
    The reverse DNS for this IP.
    sources Sequence[IpSourceArgs]
    The source in which to book the IP.
    tags Sequence[str]
    The tags associated with the IP.
    updated_at str
    Date and time of IP's last update (RFC 3339 format).
    zone str
    The zone of the IP.
    address String
    Request a specific IP in the requested source pool
    createdAt String
    Date and time of IP's creation (RFC 3339 format).
    customResources List<Property Map>
    The custom resource in which to book the IP
    isIpv6 Boolean
    Defines whether to request an IPv6 address instead of IPv4.
    projectId String
    project_id) The ID of the Project the IP is associated with.
    region String
    region) The region of the IP.
    resources List<Property Map>
    The IP resource.
    reverses List<Property Map>
    The reverse DNS for this IP.
    sources List<Property Map>
    The source in which to book the IP.
    tags List<String>
    The tags associated with the IP.
    updatedAt String
    Date and time of IP's last update (RFC 3339 format).
    zone String
    The zone of the IP.

    Supporting Types

    IpCustomResource, IpCustomResourceArgs

    MacAddress string
    The MAC address of the resource the IP is attached to.
    Name string
    The name of the resource the IP is attached to.
    MacAddress string
    The MAC address of the resource the IP is attached to.
    Name string
    The name of the resource the IP is attached to.
    macAddress String
    The MAC address of the resource the IP is attached to.
    name String
    The name of the resource the IP is attached to.
    macAddress string
    The MAC address of the resource the IP is attached to.
    name string
    The name of the resource the IP is attached to.
    mac_address str
    The MAC address of the resource the IP is attached to.
    name str
    The name of the resource the IP is attached to.
    macAddress String
    The MAC address of the resource the IP is attached to.
    name String
    The name of the resource the IP is attached to.

    IpResource, IpResourceArgs

    Id string
    The ID of the resource that the IP is attached to.
    MacAddress string
    The MAC address of the resource the IP is attached to.
    Name string
    The name of the resource the IP is attached to.
    Type string
    The type of resource the IP is attached to.
    Id string
    The ID of the resource that the IP is attached to.
    MacAddress string
    The MAC address of the resource the IP is attached to.
    Name string
    The name of the resource the IP is attached to.
    Type string
    The type of resource the IP is attached to.
    id String
    The ID of the resource that the IP is attached to.
    macAddress String
    The MAC address of the resource the IP is attached to.
    name String
    The name of the resource the IP is attached to.
    type String
    The type of resource the IP is attached to.
    id string
    The ID of the resource that the IP is attached to.
    macAddress string
    The MAC address of the resource the IP is attached to.
    name string
    The name of the resource the IP is attached to.
    type string
    The type of resource the IP is attached to.
    id str
    The ID of the resource that the IP is attached to.
    mac_address str
    The MAC address of the resource the IP is attached to.
    name str
    The name of the resource the IP is attached to.
    type str
    The type of resource the IP is attached to.
    id String
    The ID of the resource that the IP is attached to.
    macAddress String
    The MAC address of the resource the IP is attached to.
    name String
    The name of the resource the IP is attached to.
    type String
    The type of resource the IP is attached to.

    IpReverse, IpReverseArgs

    Address string
    The IP corresponding to the hostname
    Hostname string
    The reverse domain name.
    Address string
    The IP corresponding to the hostname
    Hostname string
    The reverse domain name.
    address String
    The IP corresponding to the hostname
    hostname String
    The reverse domain name.
    address string
    The IP corresponding to the hostname
    hostname string
    The reverse domain name.
    address str
    The IP corresponding to the hostname
    hostname str
    The reverse domain name.
    address String
    The IP corresponding to the hostname
    hostname String
    The reverse domain name.

    IpSource, IpSourceArgs

    PrivateNetworkId string
    The Private Network of the IP (if the IP is a private IP).
    SubnetId string
    The Private Network subnet of the IP (if the IP is a private IP).
    Zonal string
    The zone of the IP (if the IP is public and zoned, rather than private and/or regional)
    PrivateNetworkId string
    The Private Network of the IP (if the IP is a private IP).
    SubnetId string
    The Private Network subnet of the IP (if the IP is a private IP).
    Zonal string
    The zone of the IP (if the IP is public and zoned, rather than private and/or regional)
    privateNetworkId String
    The Private Network of the IP (if the IP is a private IP).
    subnetId String
    The Private Network subnet of the IP (if the IP is a private IP).
    zonal String
    The zone of the IP (if the IP is public and zoned, rather than private and/or regional)
    privateNetworkId string
    The Private Network of the IP (if the IP is a private IP).
    subnetId string
    The Private Network subnet of the IP (if the IP is a private IP).
    zonal string
    The zone of the IP (if the IP is public and zoned, rather than private and/or regional)
    private_network_id str
    The Private Network of the IP (if the IP is a private IP).
    subnet_id str
    The Private Network subnet of the IP (if the IP is a private IP).
    zonal str
    The zone of the IP (if the IP is public and zoned, rather than private and/or regional)
    privateNetworkId String
    The Private Network of the IP (if the IP is a private IP).
    subnetId String
    The Private Network subnet of the IP (if the IP is a private IP).
    zonal String
    The zone of the IP (if the IP is public and zoned, rather than private and/or regional)

    Import

    IPAM IPs can be imported using {region}/{id}, e.g.

    bash

    $ pulumi import scaleway:ipam/ip:Ip ip_demo fr-par/11111111-1111-1111-1111-111111111111

    To learn more about importing existing cloud resources, see Importing resources.

    Package Details

    Repository
    scaleway pulumiverse/pulumi-scaleway
    License
    Apache-2.0
    Notes
    This Pulumi package is based on the scaleway Terraform Provider.
    scaleway logo
    Scaleway v1.25.0 published on Saturday, Mar 22, 2025 by pulumiverse
    pulumiverse/pulumi-scaleway