1. Packages
  2. Outscale Provider
  3. API Docs
  4. PublicIp
outscale 1.1.0 published on Thursday, Apr 3, 2025 by outscale

outscale.PublicIp

Explore with Pulumi AI

Manages a public IP.

For more information on this resource, see the User Guide.
For more information on this resource actions, see the API documentation.

Example Usage

import * as pulumi from "@pulumi/pulumi";
import * as outscale from "@pulumi/outscale";

const publicIp01 = new outscale.PublicIp("publicIp01", {});
Copy
import pulumi
import pulumi_outscale as outscale

public_ip01 = outscale.PublicIp("publicIp01")
Copy
package main

import (
	"github.com/pulumi/pulumi-terraform-provider/sdks/go/outscale/outscale"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_, err := outscale.NewPublicIp(ctx, "publicIp01", nil)
		if err != nil {
			return err
		}
		return nil
	})
}
Copy
using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Outscale = Pulumi.Outscale;

return await Deployment.RunAsync(() => 
{
    var publicIp01 = new Outscale.PublicIp("publicIp01");

});
Copy
package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.outscale.PublicIp;
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 publicIp01 = new PublicIp("publicIp01");

    }
}
Copy
resources:
  publicIp01:
    type: outscale:PublicIp
Copy

Create PublicIp Resource

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

Constructor syntax

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

@overload
def PublicIp(resource_name: str,
             opts: Optional[ResourceOptions] = None,
             outscale_public_ip_id: Optional[str] = None,
             tags: Optional[Sequence[PublicIpTagArgs]] = None,
             timeouts: Optional[PublicIpTimeoutsArgs] = None)
func NewPublicIp(ctx *Context, name string, args *PublicIpArgs, opts ...ResourceOption) (*PublicIp, error)
public PublicIp(string name, PublicIpArgs? args = null, CustomResourceOptions? opts = null)
public PublicIp(String name, PublicIpArgs args)
public PublicIp(String name, PublicIpArgs args, CustomResourceOptions options)
type: outscale:PublicIp
properties: # The arguments to resource properties.
options: # Bag of options to control resource's behavior.

Parameters

name This property is required. string
The unique name of the resource.
args PublicIpArgs
The arguments to resource properties.
opts CustomResourceOptions
Bag of options to control resource's behavior.
resource_name This property is required. str
The unique name of the resource.
args PublicIpArgs
The arguments to resource properties.
opts ResourceOptions
Bag of options to control resource's behavior.
ctx Context
Context object for the current deployment.
name This property is required. string
The unique name of the resource.
args PublicIpArgs
The arguments to resource properties.
opts ResourceOption
Bag of options to control resource's behavior.
name This property is required. string
The unique name of the resource.
args PublicIpArgs
The arguments to resource properties.
opts CustomResourceOptions
Bag of options to control resource's behavior.
name This property is required. String
The unique name of the resource.
args This property is required. PublicIpArgs
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 publicIpResource = new Outscale.PublicIp("publicIpResource", new()
{
    OutscalePublicIpId = "string",
    Tags = new[]
    {
        new Outscale.Inputs.PublicIpTagArgs
        {
            Key = "string",
            Value = "string",
        },
    },
    Timeouts = new Outscale.Inputs.PublicIpTimeoutsArgs
    {
        Create = "string",
        Delete = "string",
    },
});
Copy
example, err := outscale.NewPublicIp(ctx, "publicIpResource", &outscale.PublicIpArgs{
	OutscalePublicIpId: pulumi.String("string"),
	Tags: outscale.PublicIpTagArray{
		&outscale.PublicIpTagArgs{
			Key:   pulumi.String("string"),
			Value: pulumi.String("string"),
		},
	},
	Timeouts: &outscale.PublicIpTimeoutsArgs{
		Create: pulumi.String("string"),
		Delete: pulumi.String("string"),
	},
})
Copy
var publicIpResource = new PublicIp("publicIpResource", PublicIpArgs.builder()
    .outscalePublicIpId("string")
    .tags(PublicIpTagArgs.builder()
        .key("string")
        .value("string")
        .build())
    .timeouts(PublicIpTimeoutsArgs.builder()
        .create("string")
        .delete("string")
        .build())
    .build());
Copy
public_ip_resource = outscale.PublicIp("publicIpResource",
    outscale_public_ip_id="string",
    tags=[{
        "key": "string",
        "value": "string",
    }],
    timeouts={
        "create": "string",
        "delete": "string",
    })
Copy
const publicIpResource = new outscale.PublicIp("publicIpResource", {
    outscalePublicIpId: "string",
    tags: [{
        key: "string",
        value: "string",
    }],
    timeouts: {
        create: "string",
        "delete": "string",
    },
});
Copy
type: outscale:PublicIp
properties:
    outscalePublicIpId: string
    tags:
        - key: string
          value: string
    timeouts:
        create: string
        delete: string
Copy

PublicIp 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 PublicIp resource accepts the following input properties:

OutscalePublicIpId string
Tags List<PublicIpTag>
A tag to add to this resource. You can specify this argument several times.
Timeouts PublicIpTimeouts
OutscalePublicIpId string
Tags []PublicIpTagArgs
A tag to add to this resource. You can specify this argument several times.
Timeouts PublicIpTimeoutsArgs
outscalePublicIpId String
tags List<PublicIpTag>
A tag to add to this resource. You can specify this argument several times.
timeouts PublicIpTimeouts
outscalePublicIpId string
tags PublicIpTag[]
A tag to add to this resource. You can specify this argument several times.
timeouts PublicIpTimeouts
outscale_public_ip_id str
tags Sequence[PublicIpTagArgs]
A tag to add to this resource. You can specify this argument several times.
timeouts PublicIpTimeoutsArgs
outscalePublicIpId String
tags List<Property Map>
A tag to add to this resource. You can specify this argument several times.
timeouts Property Map

Outputs

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

Id string
The provider-assigned unique ID for this managed resource.
LinkPublicIpId string
(Required in a Net) The ID representing the association of the public IP with the VM or the NIC.
NicAccountId string
The account ID of the owner of the NIC.
NicId string
The ID of the NIC the public IP is associated with (if any).
PrivateIp string
The private IP associated with the public IP.
PublicIp string
The public IP.
PublicIpId string
The allocation ID of the public IP.
RequestId string
VmId string
The ID of the VM the public IP is associated with (if any).
Id string
The provider-assigned unique ID for this managed resource.
LinkPublicIpId string
(Required in a Net) The ID representing the association of the public IP with the VM or the NIC.
NicAccountId string
The account ID of the owner of the NIC.
NicId string
The ID of the NIC the public IP is associated with (if any).
PrivateIp string
The private IP associated with the public IP.
PublicIp string
The public IP.
PublicIpId string
The allocation ID of the public IP.
RequestId string
VmId string
The ID of the VM the public IP is associated with (if any).
id String
The provider-assigned unique ID for this managed resource.
linkPublicIpId String
(Required in a Net) The ID representing the association of the public IP with the VM or the NIC.
nicAccountId String
The account ID of the owner of the NIC.
nicId String
The ID of the NIC the public IP is associated with (if any).
privateIp String
The private IP associated with the public IP.
publicIp String
The public IP.
publicIpId String
The allocation ID of the public IP.
requestId String
vmId String
The ID of the VM the public IP is associated with (if any).
id string
The provider-assigned unique ID for this managed resource.
linkPublicIpId string
(Required in a Net) The ID representing the association of the public IP with the VM or the NIC.
nicAccountId string
The account ID of the owner of the NIC.
nicId string
The ID of the NIC the public IP is associated with (if any).
privateIp string
The private IP associated with the public IP.
publicIp string
The public IP.
publicIpId string
The allocation ID of the public IP.
requestId string
vmId string
The ID of the VM the public IP is associated with (if any).
id str
The provider-assigned unique ID for this managed resource.
link_public_ip_id str
(Required in a Net) The ID representing the association of the public IP with the VM or the NIC.
nic_account_id str
The account ID of the owner of the NIC.
nic_id str
The ID of the NIC the public IP is associated with (if any).
private_ip str
The private IP associated with the public IP.
public_ip str
The public IP.
public_ip_id str
The allocation ID of the public IP.
request_id str
vm_id str
The ID of the VM the public IP is associated with (if any).
id String
The provider-assigned unique ID for this managed resource.
linkPublicIpId String
(Required in a Net) The ID representing the association of the public IP with the VM or the NIC.
nicAccountId String
The account ID of the owner of the NIC.
nicId String
The ID of the NIC the public IP is associated with (if any).
privateIp String
The private IP associated with the public IP.
publicIp String
The public IP.
publicIpId String
The allocation ID of the public IP.
requestId String
vmId String
The ID of the VM the public IP is associated with (if any).

Look up Existing PublicIp Resource

Get an existing PublicIp 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?: PublicIpState, opts?: CustomResourceOptions): PublicIp
@staticmethod
def get(resource_name: str,
        id: str,
        opts: Optional[ResourceOptions] = None,
        link_public_ip_id: Optional[str] = None,
        nic_account_id: Optional[str] = None,
        nic_id: Optional[str] = None,
        outscale_public_ip_id: Optional[str] = None,
        private_ip: Optional[str] = None,
        public_ip: Optional[str] = None,
        public_ip_id: Optional[str] = None,
        request_id: Optional[str] = None,
        tags: Optional[Sequence[PublicIpTagArgs]] = None,
        timeouts: Optional[PublicIpTimeoutsArgs] = None,
        vm_id: Optional[str] = None) -> PublicIp
func GetPublicIp(ctx *Context, name string, id IDInput, state *PublicIpState, opts ...ResourceOption) (*PublicIp, error)
public static PublicIp Get(string name, Input<string> id, PublicIpState? state, CustomResourceOptions? opts = null)
public static PublicIp get(String name, Output<String> id, PublicIpState state, CustomResourceOptions options)
resources:  _:    type: outscale:PublicIp    get:      id: ${id}
name This property is required.
The unique name of the resulting resource.
id This property is required.
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 This property is required.
The unique name of the resulting resource.
id This property is required.
The unique provider ID of the resource to lookup.
name This property is required.
The unique name of the resulting resource.
id This property is required.
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 This property is required.
The unique name of the resulting resource.
id This property is required.
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 This property is required.
The unique name of the resulting resource.
id This property is required.
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:
LinkPublicIpId string
(Required in a Net) The ID representing the association of the public IP with the VM or the NIC.
NicAccountId string
The account ID of the owner of the NIC.
NicId string
The ID of the NIC the public IP is associated with (if any).
OutscalePublicIpId string
PrivateIp string
The private IP associated with the public IP.
PublicIp string
The public IP.
PublicIpId string
The allocation ID of the public IP.
RequestId string
Tags List<PublicIpTag>
A tag to add to this resource. You can specify this argument several times.
Timeouts PublicIpTimeouts
VmId string
The ID of the VM the public IP is associated with (if any).
LinkPublicIpId string
(Required in a Net) The ID representing the association of the public IP with the VM or the NIC.
NicAccountId string
The account ID of the owner of the NIC.
NicId string
The ID of the NIC the public IP is associated with (if any).
OutscalePublicIpId string
PrivateIp string
The private IP associated with the public IP.
PublicIp string
The public IP.
PublicIpId string
The allocation ID of the public IP.
RequestId string
Tags []PublicIpTagArgs
A tag to add to this resource. You can specify this argument several times.
Timeouts PublicIpTimeoutsArgs
VmId string
The ID of the VM the public IP is associated with (if any).
linkPublicIpId String
(Required in a Net) The ID representing the association of the public IP with the VM or the NIC.
nicAccountId String
The account ID of the owner of the NIC.
nicId String
The ID of the NIC the public IP is associated with (if any).
outscalePublicIpId String
privateIp String
The private IP associated with the public IP.
publicIp String
The public IP.
publicIpId String
The allocation ID of the public IP.
requestId String
tags List<PublicIpTag>
A tag to add to this resource. You can specify this argument several times.
timeouts PublicIpTimeouts
vmId String
The ID of the VM the public IP is associated with (if any).
linkPublicIpId string
(Required in a Net) The ID representing the association of the public IP with the VM or the NIC.
nicAccountId string
The account ID of the owner of the NIC.
nicId string
The ID of the NIC the public IP is associated with (if any).
outscalePublicIpId string
privateIp string
The private IP associated with the public IP.
publicIp string
The public IP.
publicIpId string
The allocation ID of the public IP.
requestId string
tags PublicIpTag[]
A tag to add to this resource. You can specify this argument several times.
timeouts PublicIpTimeouts
vmId string
The ID of the VM the public IP is associated with (if any).
link_public_ip_id str
(Required in a Net) The ID representing the association of the public IP with the VM or the NIC.
nic_account_id str
The account ID of the owner of the NIC.
nic_id str
The ID of the NIC the public IP is associated with (if any).
outscale_public_ip_id str
private_ip str
The private IP associated with the public IP.
public_ip str
The public IP.
public_ip_id str
The allocation ID of the public IP.
request_id str
tags Sequence[PublicIpTagArgs]
A tag to add to this resource. You can specify this argument several times.
timeouts PublicIpTimeoutsArgs
vm_id str
The ID of the VM the public IP is associated with (if any).
linkPublicIpId String
(Required in a Net) The ID representing the association of the public IP with the VM or the NIC.
nicAccountId String
The account ID of the owner of the NIC.
nicId String
The ID of the NIC the public IP is associated with (if any).
outscalePublicIpId String
privateIp String
The private IP associated with the public IP.
publicIp String
The public IP.
publicIpId String
The allocation ID of the public IP.
requestId String
tags List<Property Map>
A tag to add to this resource. You can specify this argument several times.
timeouts Property Map
vmId String
The ID of the VM the public IP is associated with (if any).

Supporting Types

PublicIpTag
, PublicIpTagArgs

Key string
The key of the tag, with a minimum of 1 character.
Value string
The value of the tag, between 0 and 255 characters.
Key string
The key of the tag, with a minimum of 1 character.
Value string
The value of the tag, between 0 and 255 characters.
key String
The key of the tag, with a minimum of 1 character.
value String
The value of the tag, between 0 and 255 characters.
key string
The key of the tag, with a minimum of 1 character.
value string
The value of the tag, between 0 and 255 characters.
key str
The key of the tag, with a minimum of 1 character.
value str
The value of the tag, between 0 and 255 characters.
key String
The key of the tag, with a minimum of 1 character.
value String
The value of the tag, between 0 and 255 characters.

PublicIpTimeouts
, PublicIpTimeoutsArgs

Create string
Delete string
Create string
Delete string
create String
delete String
create string
delete string
create str
delete str
create String
delete String

Import

A public IP can be imported using its ID. For example:

console

$ pulumi import outscale:index/publicIp:PublicIp ImportedPublicIp eipalloc-12345678
Copy

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

Package Details

Repository
outscale outscale/terraform-provider-outscale
License
Notes
This Pulumi package is based on the outscale Terraform Provider.