Oracle Cloud Infrastructure

v0.5.0 published on Monday, Sep 12, 2022 by Pulumi

getIpv6s

This data source provides the list of Ipv6s in Oracle Cloud Infrastructure Core service.

Lists the IPv6 objects based on one of these filters:

  • Subnet OCID.
  • VNIC OCID.
  • Both IPv6 address and subnet OCID: This lets you get an Ipv6 object based on its private IPv6 address (for example, 2001:0db8:0123:1111:abcd:ef01:2345:6789) and not its OCID. For comparison, GetIpv6 requires the OCID.

Example Usage

using System.Collections.Generic;
using Pulumi;
using Oci = Pulumi.Oci;

return await Deployment.RunAsync(() => 
{
    var testIpv6s = Oci.Core.GetIpv6s.Invoke(new()
    {
        IpAddress = @var.Ipv6_ip_address,
        SubnetId = oci_core_subnet.Test_subnet.Id,
        VnicId = oci_core_vnic_attachment.Test_vnic_attachment.Id,
    });

});
package main

import (
	"github.com/pulumi/pulumi-oci/sdk/go/oci/Core"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_, err := Core.GetIpv6s(ctx, &core.GetIpv6sArgs{
			IpAddress: pulumi.StringRef(_var.Ipv6_ip_address),
			SubnetId:  pulumi.StringRef(oci_core_subnet.Test_subnet.Id),
			VnicId:    pulumi.StringRef(oci_core_vnic_attachment.Test_vnic_attachment.Id),
		}, nil)
		if err != nil {
			return err
		}
		return nil
	})
}
package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.oci.Core.CoreFunctions;
import com.pulumi.oci.Core.inputs.GetIpv6sArgs;
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 testIpv6s = CoreFunctions.getIpv6s(GetIpv6sArgs.builder()
            .ipAddress(var_.ipv6_ip_address())
            .subnetId(oci_core_subnet.test_subnet().id())
            .vnicId(oci_core_vnic_attachment.test_vnic_attachment().id())
            .build());

    }
}
import pulumi
import pulumi_oci as oci

test_ipv6s = oci.Core.get_ipv6s(ip_address=var["ipv6_ip_address"],
    subnet_id=oci_core_subnet["test_subnet"]["id"],
    vnic_id=oci_core_vnic_attachment["test_vnic_attachment"]["id"])
import * as pulumi from "@pulumi/pulumi";
import * as oci from "@pulumi/oci";

const testIpv6s = oci.Core.getIpv6s({
    ipAddress: _var.ipv6_ip_address,
    subnetId: oci_core_subnet.test_subnet.id,
    vnicId: oci_core_vnic_attachment.test_vnic_attachment.id,
});
variables:
  testIpv6s:
    Fn::Invoke:
      Function: oci:Core:getIpv6s
      Arguments:
        ipAddress: ${var.ipv6_ip_address}
        subnetId: ${oci_core_subnet.test_subnet.id}
        vnicId: ${oci_core_vnic_attachment.test_vnic_attachment.id}

Using getIpv6s

Two invocation forms are available. The direct form accepts plain arguments and either blocks until the result value is available, or returns a Promise-wrapped result. The output form accepts Input-wrapped arguments and returns an Output-wrapped result.

function getIpv6s(args: GetIpv6sArgs, opts?: InvokeOptions): Promise<GetIpv6sResult>
function getIpv6sOutput(args: GetIpv6sOutputArgs, opts?: InvokeOptions): Output<GetIpv6sResult>
def get_ipv6s(filters: Optional[Sequence[_core.GetIpv6sFilter]] = None,
              ip_address: Optional[str] = None,
              subnet_id: Optional[str] = None,
              vnic_id: Optional[str] = None,
              opts: Optional[InvokeOptions] = None) -> GetIpv6sResult
def get_ipv6s_output(filters: Optional[pulumi.Input[Sequence[pulumi.Input[_core.GetIpv6sFilterArgs]]]] = None,
              ip_address: Optional[pulumi.Input[str]] = None,
              subnet_id: Optional[pulumi.Input[str]] = None,
              vnic_id: Optional[pulumi.Input[str]] = None,
              opts: Optional[InvokeOptions] = None) -> Output[GetIpv6sResult]
func GetIpv6s(ctx *Context, args *GetIpv6sArgs, opts ...InvokeOption) (*GetIpv6sResult, error)
func GetIpv6sOutput(ctx *Context, args *GetIpv6sOutputArgs, opts ...InvokeOption) GetIpv6sResultOutput

> Note: This function is named GetIpv6s in the Go SDK.

public static class GetIpv6s 
{
    public static Task<GetIpv6sResult> InvokeAsync(GetIpv6sArgs args, InvokeOptions? opts = null)
    public static Output<GetIpv6sResult> Invoke(GetIpv6sInvokeArgs args, InvokeOptions? opts = null)
}
public static CompletableFuture<GetIpv6sResult> getIpv6s(GetIpv6sArgs args, InvokeOptions options)
// Output-based functions aren't available in Java yet
fn::invoke:
  function: oci:Core/getIpv6s:getIpv6s
  arguments:
    # arguments dictionary

The following arguments are supported:

Filters List<GetIpv6sFilter>
IpAddress string

An IP address. This could be either IPv4 or IPv6, depending on the resource. Example: 10.0.3.3

SubnetId string

The OCID of the subnet.

VnicId string

The OCID of the VNIC.

Filters []GetIpv6sFilter
IpAddress string

An IP address. This could be either IPv4 or IPv6, depending on the resource. Example: 10.0.3.3

SubnetId string

The OCID of the subnet.

VnicId string

The OCID of the VNIC.

filters List<GetIpv6sFilter>
ipAddress String

An IP address. This could be either IPv4 or IPv6, depending on the resource. Example: 10.0.3.3

subnetId String

The OCID of the subnet.

vnicId String

The OCID of the VNIC.

filters GetIpv6sFilter[]
ipAddress string

An IP address. This could be either IPv4 or IPv6, depending on the resource. Example: 10.0.3.3

subnetId string

The OCID of the subnet.

vnicId string

The OCID of the VNIC.

filters GetIpv6sFilter]
ip_address str

An IP address. This could be either IPv4 or IPv6, depending on the resource. Example: 10.0.3.3

subnet_id str

The OCID of the subnet.

vnic_id str

The OCID of the VNIC.

filters List<Property Map>
ipAddress String

An IP address. This could be either IPv4 or IPv6, depending on the resource. Example: 10.0.3.3

subnetId String

The OCID of the subnet.

vnicId String

The OCID of the VNIC.

getIpv6s Result

The following output properties are available:

Id string

The provider-assigned unique ID for this managed resource.

Ipv6s List<GetIpv6sIpv6>

The list of ipv6s.

Filters List<GetIpv6sFilter>
IpAddress string

The IPv6 address of the IPv6 object. The address is within the IPv6 CIDR block of the VNIC's subnet (see the ipv6CidrBlock attribute for the Subnet object. Example: 2001:0db8:0123:1111:abcd:ef01:2345:6789

SubnetId string

The OCID of the subnet the VNIC is in.

VnicId string

The OCID of the VNIC the IPv6 is assigned to. The VNIC and IPv6 must be in the same subnet.

Id string

The provider-assigned unique ID for this managed resource.

Ipv6s []GetIpv6sIpv6

The list of ipv6s.

Filters []GetIpv6sFilter
IpAddress string

The IPv6 address of the IPv6 object. The address is within the IPv6 CIDR block of the VNIC's subnet (see the ipv6CidrBlock attribute for the Subnet object. Example: 2001:0db8:0123:1111:abcd:ef01:2345:6789

SubnetId string

The OCID of the subnet the VNIC is in.

VnicId string

The OCID of the VNIC the IPv6 is assigned to. The VNIC and IPv6 must be in the same subnet.

id String

The provider-assigned unique ID for this managed resource.

ipv6s List<GetIpv6sIpv6>

The list of ipv6s.

filters List<GetIpv6sFilter>
ipAddress String

The IPv6 address of the IPv6 object. The address is within the IPv6 CIDR block of the VNIC's subnet (see the ipv6CidrBlock attribute for the Subnet object. Example: 2001:0db8:0123:1111:abcd:ef01:2345:6789

subnetId String

The OCID of the subnet the VNIC is in.

vnicId String

The OCID of the VNIC the IPv6 is assigned to. The VNIC and IPv6 must be in the same subnet.

id string

The provider-assigned unique ID for this managed resource.

ipv6s GetIpv6sIpv6[]

The list of ipv6s.

filters GetIpv6sFilter[]
ipAddress string

The IPv6 address of the IPv6 object. The address is within the IPv6 CIDR block of the VNIC's subnet (see the ipv6CidrBlock attribute for the Subnet object. Example: 2001:0db8:0123:1111:abcd:ef01:2345:6789

subnetId string

The OCID of the subnet the VNIC is in.

vnicId string

The OCID of the VNIC the IPv6 is assigned to. The VNIC and IPv6 must be in the same subnet.

id str

The provider-assigned unique ID for this managed resource.

ipv6s GetIpv6sIpv6]

The list of ipv6s.

filters GetIpv6sFilter]
ip_address str

The IPv6 address of the IPv6 object. The address is within the IPv6 CIDR block of the VNIC's subnet (see the ipv6CidrBlock attribute for the Subnet object. Example: 2001:0db8:0123:1111:abcd:ef01:2345:6789

subnet_id str

The OCID of the subnet the VNIC is in.

vnic_id str

The OCID of the VNIC the IPv6 is assigned to. The VNIC and IPv6 must be in the same subnet.

id String

The provider-assigned unique ID for this managed resource.

ipv6s List<Property Map>

The list of ipv6s.

filters List<Property Map>
ipAddress String

The IPv6 address of the IPv6 object. The address is within the IPv6 CIDR block of the VNIC's subnet (see the ipv6CidrBlock attribute for the Subnet object. Example: 2001:0db8:0123:1111:abcd:ef01:2345:6789

subnetId String

The OCID of the subnet the VNIC is in.

vnicId String

The OCID of the VNIC the IPv6 is assigned to. The VNIC and IPv6 must be in the same subnet.

Supporting Types

GetIpv6sFilter

Name string
Values List<string>
Regex bool
Name string
Values []string
Regex bool
name String
values List<String>
regex Boolean
name string
values string[]
regex boolean
name str
values Sequence[str]
regex bool
name String
values List<String>
regex Boolean

GetIpv6sIpv6

CompartmentId string

The OCID of the compartment containing the IPv6. This is the same as the VNIC's compartment.

DefinedTags Dictionary<string, object>

Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags. Example: {"Operations.CostCenter": "42"}

DisplayName string

A user-friendly name. Does not have to be unique, and it's changeable. Avoid entering confidential information.

FreeformTags Dictionary<string, object>

Free-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. For more information, see Resource Tags. Example: {"Department": "Finance"}

Id string

The OCID of the IPv6.

IpAddress string

An IP address. This could be either IPv4 or IPv6, depending on the resource. Example: 10.0.3.3

Ipv6subnetCidr string
State string

The IPv6's current state.

SubnetId string

The OCID of the subnet.

TimeCreated string

The date and time the IPv6 was created, in the format defined by RFC3339. Example: 2016-08-25T21:10:29.600Z

VnicId string

The OCID of the VNIC.

CompartmentId string

The OCID of the compartment containing the IPv6. This is the same as the VNIC's compartment.

DefinedTags map[string]interface{}

Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags. Example: {"Operations.CostCenter": "42"}

DisplayName string

A user-friendly name. Does not have to be unique, and it's changeable. Avoid entering confidential information.

FreeformTags map[string]interface{}

Free-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. For more information, see Resource Tags. Example: {"Department": "Finance"}

Id string

The OCID of the IPv6.

IpAddress string

An IP address. This could be either IPv4 or IPv6, depending on the resource. Example: 10.0.3.3

Ipv6subnetCidr string
State string

The IPv6's current state.

SubnetId string

The OCID of the subnet.

TimeCreated string

The date and time the IPv6 was created, in the format defined by RFC3339. Example: 2016-08-25T21:10:29.600Z

VnicId string

The OCID of the VNIC.

compartmentId String

The OCID of the compartment containing the IPv6. This is the same as the VNIC's compartment.

definedTags Map<String,Object>

Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags. Example: {"Operations.CostCenter": "42"}

displayName String

A user-friendly name. Does not have to be unique, and it's changeable. Avoid entering confidential information.

freeformTags Map<String,Object>

Free-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. For more information, see Resource Tags. Example: {"Department": "Finance"}

id String

The OCID of the IPv6.

ipAddress String

An IP address. This could be either IPv4 or IPv6, depending on the resource. Example: 10.0.3.3

ipv6subnetCidr String
state String

The IPv6's current state.

subnetId String

The OCID of the subnet.

timeCreated String

The date and time the IPv6 was created, in the format defined by RFC3339. Example: 2016-08-25T21:10:29.600Z

vnicId String

The OCID of the VNIC.

compartmentId string

The OCID of the compartment containing the IPv6. This is the same as the VNIC's compartment.

definedTags {[key: string]: any}

Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags. Example: {"Operations.CostCenter": "42"}

displayName string

A user-friendly name. Does not have to be unique, and it's changeable. Avoid entering confidential information.

freeformTags {[key: string]: any}

Free-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. For more information, see Resource Tags. Example: {"Department": "Finance"}

id string

The OCID of the IPv6.

ipAddress string

An IP address. This could be either IPv4 or IPv6, depending on the resource. Example: 10.0.3.3

ipv6subnetCidr string
state string

The IPv6's current state.

subnetId string

The OCID of the subnet.

timeCreated string

The date and time the IPv6 was created, in the format defined by RFC3339. Example: 2016-08-25T21:10:29.600Z

vnicId string

The OCID of the VNIC.

compartment_id str

The OCID of the compartment containing the IPv6. This is the same as the VNIC's compartment.

defined_tags Mapping[str, Any]

Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags. Example: {"Operations.CostCenter": "42"}

display_name str

A user-friendly name. Does not have to be unique, and it's changeable. Avoid entering confidential information.

freeform_tags Mapping[str, Any]

Free-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. For more information, see Resource Tags. Example: {"Department": "Finance"}

id str

The OCID of the IPv6.

ip_address str

An IP address. This could be either IPv4 or IPv6, depending on the resource. Example: 10.0.3.3

ipv6subnet_cidr str
state str

The IPv6's current state.

subnet_id str

The OCID of the subnet.

time_created str

The date and time the IPv6 was created, in the format defined by RFC3339. Example: 2016-08-25T21:10:29.600Z

vnic_id str

The OCID of the VNIC.

compartmentId String

The OCID of the compartment containing the IPv6. This is the same as the VNIC's compartment.

definedTags Map<Any>

Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags. Example: {"Operations.CostCenter": "42"}

displayName String

A user-friendly name. Does not have to be unique, and it's changeable. Avoid entering confidential information.

freeformTags Map<Any>

Free-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. For more information, see Resource Tags. Example: {"Department": "Finance"}

id String

The OCID of the IPv6.

ipAddress String

An IP address. This could be either IPv4 or IPv6, depending on the resource. Example: 10.0.3.3

ipv6subnetCidr String
state String

The IPv6's current state.

subnetId String

The OCID of the subnet.

timeCreated String

The date and time the IPv6 was created, in the format defined by RFC3339. Example: 2016-08-25T21:10:29.600Z

vnicId String

The OCID of the VNIC.

Package Details

Repository
https://github.com/pulumi/pulumi-oci
License
Apache-2.0
Notes

This Pulumi package is based on the oci Terraform Provider.