Oracle Cloud Infrastructure
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 Pulumi;
using Oci = Pulumi.Oci;
class MyStack : Stack
{
public MyStack()
{
var testIpv6s = Output.Create(Oci.Core.GetIpv6s.InvokeAsync(new Oci.Core.GetIpv6sArgs
{
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
})
}
Coming soon!
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,
});
Coming soon!
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
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
Get
Ipv6s Ipv6] The list of ipv6s.
- filters
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, 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"}
- Display
Name string A user-friendly name. Does not have to be unique, and it's changeable. Avoid entering confidential information.
- 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.
- 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]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"}
- Display
Name string A user-friendly name. Does not have to be unique, and it's changeable. Avoid entering confidential information.
- 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.
- 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,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"}
- display
Name String A user-friendly name. Does not have to be unique, and it's changeable. Avoid entering confidential information.
- 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.
- 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]: 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 string A user-friendly name. Does not have to be unique, and it's changeable. Avoid entering confidential information.
- {[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.
- 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, 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.
- 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.
- compartment
Id String The OCID of the compartment containing the IPv6. This is the same as the VNIC's compartment.
- 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"}
- display
Name String A user-friendly name. Does not have to be unique, and it's changeable. Avoid entering confidential information.
- 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.
- 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
- https://github.com/pulumi/pulumi-oci
- License
- Apache-2.0
- Notes
This Pulumi package is based on the
oci
Terraform Provider.