1. Packages
  2. Oracle Cloud Infrastructure
  3. API Docs
  4. Core
  5. getIpv6s
Oracle Cloud Infrastructure v2.19.0 published on Thursday, Dec 12, 2024 by Pulumi

oci.Core.getIpv6s

Explore with Pulumi AI

oci logo
Oracle Cloud Infrastructure v2.19.0 published on Thursday, Dec 12, 2024 by Pulumi

    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

    import * as pulumi from "@pulumi/pulumi";
    import * as oci from "@pulumi/oci";
    
    const testIpv6s = oci.Core.getIpv6s({
        ipAddress: ipv6IpAddress,
        subnetId: testSubnet.id,
        vnicId: testVnicAttachment.id,
    });
    
    import pulumi
    import pulumi_oci as oci
    
    test_ipv6s = oci.Core.get_ipv6s(ip_address=ipv6_ip_address,
        subnet_id=test_subnet["id"],
        vnic_id=test_vnic_attachment["id"])
    
    package main
    
    import (
    	"github.com/pulumi/pulumi-oci/sdk/v2/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(ipv6IpAddress),
    			SubnetId:  pulumi.StringRef(testSubnet.Id),
    			VnicId:    pulumi.StringRef(testVnicAttachment.Id),
    		}, nil)
    		if err != nil {
    			return err
    		}
    		return nil
    	})
    }
    
    using System.Collections.Generic;
    using System.Linq;
    using Pulumi;
    using Oci = Pulumi.Oci;
    
    return await Deployment.RunAsync(() => 
    {
        var testIpv6s = Oci.Core.GetIpv6s.Invoke(new()
        {
            IpAddress = ipv6IpAddress,
            SubnetId = testSubnet.Id,
            VnicId = testVnicAttachment.Id,
        });
    
    });
    
    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(ipv6IpAddress)
                .subnetId(testSubnet.id())
                .vnicId(testVnicAttachment.id())
                .build());
    
        }
    }
    
    variables:
      testIpv6s:
        fn::invoke:
          function: oci:Core:getIpv6s
          arguments:
            ipAddress: ${ipv6IpAddress}
            subnetId: ${testSubnet.id}
            vnicId: ${testVnicAttachment.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 Sequence[core.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 Sequence[core.GetIpv6sIpv6]
    The list of ipv6s.
    filters Sequence[core.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, string>
    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, string>
    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]string
    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]string
    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,String>
    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,String>
    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]: string}
    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]: string}
    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, str]
    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, str]
    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<String>
    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>
    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
    oci pulumi/pulumi-oci
    License
    Apache-2.0
    Notes
    This Pulumi package is based on the oci Terraform Provider.
    oci logo
    Oracle Cloud Infrastructure v2.19.0 published on Thursday, Dec 12, 2024 by Pulumi