Oracle Cloud Infrastructure v2.19.0 published on Thursday, Dec 12, 2024 by Pulumi
oci.Core.getIpv6s
Explore with Pulumi AI
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<Get
Ipv6s Filter> - Ip
Address string - An IP address. This could be either IPv4 or IPv6, depending on the resource. Example:
10.0.3.3
- Subnet
Id string - The OCID of the subnet.
- Vnic
Id string - The OCID of the VNIC.
- Filters
[]Get
Ipv6s Filter - Ip
Address string - An IP address. This could be either IPv4 or IPv6, depending on the resource. Example:
10.0.3.3
- Subnet
Id string - The OCID of the subnet.
- Vnic
Id string - The OCID of the VNIC.
- filters
List<Get
Ipv6s Filter> - ip
Address String - An IP address. This could be either IPv4 or IPv6, depending on the resource. Example:
10.0.3.3
- subnet
Id String - The OCID of the subnet.
- vnic
Id String - The OCID of the VNIC.
- filters
Get
Ipv6s Filter[] - ip
Address string - An IP address. This could be either IPv4 or IPv6, depending on the resource. Example:
10.0.3.3
- subnet
Id string - The OCID of the subnet.
- vnic
Id string - The OCID of the VNIC.
- filters
Sequence[core.
Get Ipv6s Filter] - 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>
- ip
Address String - An IP address. This could be either IPv4 or IPv6, depending on the resource. Example:
10.0.3.3
- subnet
Id String - The OCID of the subnet.
- vnic
Id 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<Get
Ipv6s Ipv6> - The list of ipv6s.
- Filters
List<Get
Ipv6s Filter> - Ip
Address string - The IPv6 address of the
IPv6
object. The address is within the IPv6 CIDR block of the VNIC's subnet (see theipv6CidrBlock
attribute for the Subnet object. Example:2001:0db8:0123:1111:abcd:ef01:2345:6789
- Subnet
Id string - The OCID of the subnet the VNIC is in.
- Vnic
Id 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
[]Get
Ipv6s Ipv6 - The list of ipv6s.
- Filters
[]Get
Ipv6s Filter - Ip
Address string - The IPv6 address of the
IPv6
object. The address is within the IPv6 CIDR block of the VNIC's subnet (see theipv6CidrBlock
attribute for the Subnet object. Example:2001:0db8:0123:1111:abcd:ef01:2345:6789
- Subnet
Id string - The OCID of the subnet the VNIC is in.
- Vnic
Id 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<Get
Ipv6s Ipv6> - The list of ipv6s.
- filters
List<Get
Ipv6s Filter> - ip
Address String - The IPv6 address of the
IPv6
object. The address is within the IPv6 CIDR block of the VNIC's subnet (see theipv6CidrBlock
attribute for the Subnet object. Example:2001:0db8:0123:1111:abcd:ef01:2345:6789
- subnet
Id String - The OCID of the subnet the VNIC is in.
- vnic
Id 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
Get
Ipv6s Ipv6[] - The list of ipv6s.
- filters
Get
Ipv6s Filter[] - ip
Address string - The IPv6 address of the
IPv6
object. The address is within the IPv6 CIDR block of the VNIC's subnet (see theipv6CidrBlock
attribute for the Subnet object. Example:2001:0db8:0123:1111:abcd:ef01:2345:6789
- subnet
Id string - The OCID of the subnet the VNIC is in.
- vnic
Id 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.
Get Ipv6s Ipv6] - The list of ipv6s.
- filters
Sequence[core.
Get Ipv6s Filter] - ip_
address str - The IPv6 address of the
IPv6
object. The address is within the IPv6 CIDR block of the VNIC's subnet (see theipv6CidrBlock
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>
- ip
Address String - The IPv6 address of the
IPv6
object. The address is within the IPv6 CIDR block of the VNIC's subnet (see theipv6CidrBlock
attribute for the Subnet object. Example:2001:0db8:0123:1111:abcd:ef01:2345:6789
- subnet
Id String - The OCID of the subnet the VNIC is in.
- vnic
Id String - The OCID of the VNIC the IPv6 is assigned to. The VNIC and IPv6 must be in the same subnet.
Supporting Types
GetIpv6sFilter
GetIpv6sIpv6
- Compartment
Id string - The OCID of the compartment containing the IPv6. This is the same as the VNIC's compartment.
- 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"}
- Display
Name string - A user-friendly name. Does not have to be unique, and it's changeable. Avoid entering confidential information.
- 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.
- Ip
Address string - An IP address. This could be either IPv4 or IPv6, depending on the resource. Example:
10.0.3.3
- Ipv6subnet
Cidr string - State string
- The IPv6's current state.
- Subnet
Id string - The OCID of the subnet.
- Time
Created string - The date and time the IPv6 was created, in the format defined by RFC3339. Example:
2016-08-25T21:10:29.600Z
- Vnic
Id string - The OCID of the VNIC.
- Compartment
Id string - The OCID of the compartment containing the IPv6. This is the same as the VNIC's compartment.
- 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"}
- Display
Name string - A user-friendly name. Does not have to be unique, and it's changeable. Avoid entering confidential information.
- 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.
- Ip
Address string - An IP address. This could be either IPv4 or IPv6, depending on the resource. Example:
10.0.3.3
- Ipv6subnet
Cidr string - State string
- The IPv6's current state.
- Subnet
Id string - The OCID of the subnet.
- Time
Created string - The date and time the IPv6 was created, in the format defined by RFC3339. Example:
2016-08-25T21:10:29.600Z
- Vnic
Id string - The OCID of the VNIC.
- compartment
Id String - The OCID of the compartment containing the IPv6. This is the same as the VNIC's compartment.
- 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"}
- display
Name String - A user-friendly name. Does not have to be unique, and it's changeable. Avoid entering confidential information.
- 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.
- ip
Address String - An IP address. This could be either IPv4 or IPv6, depending on the resource. Example:
10.0.3.3
- ipv6subnet
Cidr String - state String
- The IPv6's current state.
- subnet
Id String - The OCID of the subnet.
- time
Created String - The date and time the IPv6 was created, in the format defined by RFC3339. Example:
2016-08-25T21:10:29.600Z
- vnic
Id String - The OCID of the VNIC.
- compartment
Id string - The OCID of the compartment containing the IPv6. This is the same as the VNIC's compartment.
- {[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"}
- display
Name string - A user-friendly name. Does not have to be unique, and it's changeable. Avoid entering confidential information.
- {[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.
- ip
Address string - An IP address. This could be either IPv4 or IPv6, depending on the resource. Example:
10.0.3.3
- ipv6subnet
Cidr string - state string
- The IPv6's current state.
- subnet
Id string - The OCID of the subnet.
- time
Created string - The date and time the IPv6 was created, in the format defined by RFC3339. Example:
2016-08-25T21:10:29.600Z
- vnic
Id 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.
- 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.
- 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.
- compartment
Id String - The OCID of the compartment containing the IPv6. This is the same as the VNIC's compartment.
- 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"}
- display
Name String - A user-friendly name. Does not have to be unique, and it's changeable. Avoid entering confidential information.
- 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.
- ip
Address String - An IP address. This could be either IPv4 or IPv6, depending on the resource. Example:
10.0.3.3
- ipv6subnet
Cidr String - state String
- The IPv6's current state.
- subnet
Id String - The OCID of the subnet.
- time
Created String - The date and time the IPv6 was created, in the format defined by RFC3339. Example:
2016-08-25T21:10:29.600Z
- vnic
Id 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.