getEipAddresses

This data source provides the Eip Addresses of the current Alibaba Cloud user.

NOTE: Available in v1.126.0+.

Example Usage

Basic Usage

import * as pulumi from "@pulumi/pulumi";
import * as alicloud from "@pulumi/alicloud";
const example = alicloud.ecs.getEipAddresses({
ids: ["eip-bp1jvx5ki6c********"],
nameRegex: "the_resource_name",
});
export const firstEipAddressId = example.then(example => example.addresses?.[0]?.id);
import pulumi
import pulumi_alicloud as alicloud
example = alicloud.ecs.get_eip_addresses(ids=["eip-bp1jvx5ki6c********"],
name_regex="the_resource_name")
pulumi.export("firstEipAddressId", example.addresses[0].id)
using System.Collections.Generic;
using System.Linq;
using Pulumi;
using AliCloud = Pulumi.AliCloud;
return await Deployment.RunAsync(() =>
{
var example = AliCloud.Ecs.GetEipAddresses.Invoke(new()
{
Ids = new[]
{
"eip-bp1jvx5ki6c********",
},
NameRegex = "the_resource_name",
});
return new Dictionary<string, object?>
{
["firstEipAddressId"] = example&#46;Apply(getEipAddressesResult => getEipAddressesResult&#46;Addresses[0]?.Id),
};
});
package main
import (
"github.com/pulumi/pulumi-alicloud/sdk/v3/go/alicloud/ecs"
"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)
func main() {
pulumi.Run(func(ctx *pulumi.Context) error {
example, err := ecs.GetEipAddresses(ctx, &ecs.GetEipAddressesArgs{
Ids: []string{
"eip-bp1jvx5ki6c********",
},
NameRegex: pulumi.StringRef("the_resource_name"),
}, nil)
if err != nil {
return err
}
ctx.Export("firstEipAddressId", example.Addresses[0].Id)
return nil
})
}
package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.alicloud.ecs.EcsFunctions;
import com.pulumi.alicloud.ecs.inputs.GetEipAddressesArgs;
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 = EcsFunctions.getEipAddresses(GetEipAddressesArgs.builder()
.ids("eip-bp1jvx5ki6c********")
.nameRegex("the_resource_name")
.build());
ctx.export("firstEipAddressId", example.addresses()[0].id());
}
}
variables:
example:
fn::invoke:
function: alicloud:ecs:getEipAddresses
arguments:
ids:
- eip-bp1jvx5ki6c********
nameRegex: the_resource_name
outputs:
firstEipAddressId: ${example.addresses[0].id}

Return

A collection of values returned by getEipAddresses.

Parameters

argument

A collection of arguments for invoking getEipAddresses.


suspend fun getEipAddresses(addressName: String? = null, associatedInstanceId: String? = null, associatedInstanceType: String? = null, dryRun: Boolean? = null, enableDetails: Boolean? = null, ids: List<String>? = null, includeReservationData: Boolean? = null, ipAddress: String? = null, ipAddresses: List<String>? = null, isp: String? = null, lockReason: String? = null, nameRegex: String? = null, outputFile: String? = null, paymentType: String? = null, resourceGroupId: String? = null, segmentInstanceId: String? = null, status: String? = null, tags: Map<String, String>? = null): GetEipAddressesResult

Return

A collection of values returned by getEipAddresses.

Parameters

addressName

The eip name.

associatedInstanceId

The associated instance id.

associatedInstanceType

The associated instance type.

dryRun

The dry run.

enableDetails

Default to true. Set it to false can hide the tags to output.

ids

A list of Address IDs.

includeReservationData

The include reservation data. Valid values: BGP and BGP_PRO.

ipAddress

The eip address.

ipAddresses
isp

The Internet service provider (ISP). Valid values BGP and BGP_PRO.

lockReason

The lock reason.

nameRegex

A regex string to filter results by Address name.

outputFile

File name where to save data source results (after running pulumi preview).

paymentType

The billing method of the EIP. Valid values: Subscription and PayAsYouGo.

resourceGroupId

The ID of the resource group.

segmentInstanceId

The IDs of the contiguous EIPs. This value is returned only when contiguous EIPs are specified.

status

The status of the EIP. Valid values: Associating: The EIP is being associated. Unassociating: The EIP is being disassociated. InUse: The EIP is allocated. Available:The EIP is available.

tags

A mapping of tags to assign to the resource.

See also


Return

A collection of values returned by getEipAddresses.

Parameters

argument

Builder for com.pulumi.alicloud.ecs.kotlin.inputs.GetEipAddressesPlainArgs.

See also