← All packages

Oracle Cloud Infrastructure

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

Source code

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.