Oracle Cloud Infrastructure v2.33.0 published on Thursday, May 1, 2025 by Pulumi
oci.Core.getByoipRange
Explore with Pulumi AI
This data source provides details about a specific Byoip Range resource in Oracle Cloud Infrastructure Core service.
Gets the ByoipRange resource. You must specify the OCID.
Example Usage
import * as pulumi from "@pulumi/pulumi";
import * as oci from "@pulumi/oci";
const testByoipRange = oci.Core.getByoipRange({
    byoipRangeId: testByoipRangeOciCoreByoipRange.id,
});
import pulumi
import pulumi_oci as oci
test_byoip_range = oci.Core.get_byoip_range(byoip_range_id=test_byoip_range_oci_core_byoip_range["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.GetByoipRange(ctx, &core.GetByoipRangeArgs{
			ByoipRangeId: testByoipRangeOciCoreByoipRange.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 testByoipRange = Oci.Core.GetByoipRange.Invoke(new()
    {
        ByoipRangeId = testByoipRangeOciCoreByoipRange.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.GetByoipRangeArgs;
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 testByoipRange = CoreFunctions.getByoipRange(GetByoipRangeArgs.builder()
            .byoipRangeId(testByoipRangeOciCoreByoipRange.id())
            .build());
    }
}
variables:
  testByoipRange:
    fn::invoke:
      function: oci:Core:getByoipRange
      arguments:
        byoipRangeId: ${testByoipRangeOciCoreByoipRange.id}
Using getByoipRange
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 getByoipRange(args: GetByoipRangeArgs, opts?: InvokeOptions): Promise<GetByoipRangeResult>
function getByoipRangeOutput(args: GetByoipRangeOutputArgs, opts?: InvokeOptions): Output<GetByoipRangeResult>def get_byoip_range(byoip_range_id: Optional[str] = None,
                    opts: Optional[InvokeOptions] = None) -> GetByoipRangeResult
def get_byoip_range_output(byoip_range_id: Optional[pulumi.Input[str]] = None,
                    opts: Optional[InvokeOptions] = None) -> Output[GetByoipRangeResult]func GetByoipRange(ctx *Context, args *GetByoipRangeArgs, opts ...InvokeOption) (*GetByoipRangeResult, error)
func GetByoipRangeOutput(ctx *Context, args *GetByoipRangeOutputArgs, opts ...InvokeOption) GetByoipRangeResultOutput> Note: This function is named GetByoipRange in the Go SDK.
public static class GetByoipRange 
{
    public static Task<GetByoipRangeResult> InvokeAsync(GetByoipRangeArgs args, InvokeOptions? opts = null)
    public static Output<GetByoipRangeResult> Invoke(GetByoipRangeInvokeArgs args, InvokeOptions? opts = null)
}public static CompletableFuture<GetByoipRangeResult> getByoipRange(GetByoipRangeArgs args, InvokeOptions options)
public static Output<GetByoipRangeResult> getByoipRange(GetByoipRangeArgs args, InvokeOptions options)
fn::invoke:
  function: oci:Core/getByoipRange:getByoipRange
  arguments:
    # arguments dictionaryThe following arguments are supported:
- ByoipRange stringId 
- The OCID of the ByoipRangeresource containing the BYOIP CIDR block.
- ByoipRange stringId 
- The OCID of the ByoipRangeresource containing the BYOIP CIDR block.
- byoipRange StringId 
- The OCID of the ByoipRangeresource containing the BYOIP CIDR block.
- byoipRange stringId 
- The OCID of the ByoipRangeresource containing the BYOIP CIDR block.
- byoip_range_ strid 
- The OCID of the ByoipRangeresource containing the BYOIP CIDR block.
- byoipRange StringId 
- The OCID of the ByoipRangeresource containing the BYOIP CIDR block.
getByoipRange Result
The following output properties are available:
- ByoipRange stringId 
- The OCID of the ByoipRangeresource to which the CIDR block belongs.
- ByoipRange List<GetVcn Ipv6allocations Byoip Range Byoip Range Vcn Ipv6allocation> 
- A list of ByoipRangeVcnIpv6AllocationSummaryobjects.
- CidrBlock string
- The public IPv4 CIDR block being imported from on-premises to the Oracle cloud.
- CompartmentId string
- The OCID of the compartment containing the BYOIP CIDR block.
- 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.
- 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 provider-assigned unique ID for this managed resource.
- Ipv6cidrBlock string
- The IPv6 prefix being imported to the Oracle cloud. This prefix must be /48 or larger, and can be subdivided into sub-ranges used across multiple VCNs. A BYOIPv6 prefix can be also assigned across multiple VCNs, and each VCN must be /64 or larger. You may specify a ULA or private IPv6 prefix of /64 or larger to use in the VCN. IPv6-enabled subnets will remain a fixed /64 in size.
- LifecycleDetails string
- The ByoipRangeresource's current status.
- OriginAsns List<GetByoip Range Origin Asn> 
- Information about the origin asn.
- State string
- The ByoipRangeresource's current state.
- TimeAdvertised string
- The date and time the ByoipRangeresource was advertised to the internet by BGP, in the format defined by RFC3339. Example:2016-08-25T21:10:29.600Z
- TimeCreated string
- The date and time the ByoipRangeresource was created, in the format defined by RFC3339. Example:2016-08-25T21:10:29.600Z
- TimeValidated string
- The date and time the ByoipRangeresource was validated, in the format defined by RFC3339. Example:2016-08-25T21:10:29.600Z
- TimeWithdrawn string
- The date and time the ByoipRangeresource was withdrawn from advertisement by BGP to the internet, in the format defined by RFC3339. Example:2016-08-25T21:10:29.600Z
- ValidationToken string
- The validation token is an internally-generated ASCII string used in the validation process. See Importing a CIDR block for details.
- ByoipRange stringId 
- The OCID of the ByoipRangeresource to which the CIDR block belongs.
- ByoipRange []GetVcn Ipv6allocations Byoip Range Byoip Range Vcn Ipv6allocation 
- A list of ByoipRangeVcnIpv6AllocationSummaryobjects.
- CidrBlock string
- The public IPv4 CIDR block being imported from on-premises to the Oracle cloud.
- CompartmentId string
- The OCID of the compartment containing the BYOIP CIDR block.
- 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.
- 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 provider-assigned unique ID for this managed resource.
- Ipv6cidrBlock string
- The IPv6 prefix being imported to the Oracle cloud. This prefix must be /48 or larger, and can be subdivided into sub-ranges used across multiple VCNs. A BYOIPv6 prefix can be also assigned across multiple VCNs, and each VCN must be /64 or larger. You may specify a ULA or private IPv6 prefix of /64 or larger to use in the VCN. IPv6-enabled subnets will remain a fixed /64 in size.
- LifecycleDetails string
- The ByoipRangeresource's current status.
- OriginAsns []GetByoip Range Origin Asn 
- Information about the origin asn.
- State string
- The ByoipRangeresource's current state.
- TimeAdvertised string
- The date and time the ByoipRangeresource was advertised to the internet by BGP, in the format defined by RFC3339. Example:2016-08-25T21:10:29.600Z
- TimeCreated string
- The date and time the ByoipRangeresource was created, in the format defined by RFC3339. Example:2016-08-25T21:10:29.600Z
- TimeValidated string
- The date and time the ByoipRangeresource was validated, in the format defined by RFC3339. Example:2016-08-25T21:10:29.600Z
- TimeWithdrawn string
- The date and time the ByoipRangeresource was withdrawn from advertisement by BGP to the internet, in the format defined by RFC3339. Example:2016-08-25T21:10:29.600Z
- ValidationToken string
- The validation token is an internally-generated ASCII string used in the validation process. See Importing a CIDR block for details.
- byoipRange StringId 
- The OCID of the ByoipRangeresource to which the CIDR block belongs.
- byoipRange List<GetVcn Ipv6allocations Byoip Range Byoip Range Vcn Ipv6allocation> 
- A list of ByoipRangeVcnIpv6AllocationSummaryobjects.
- cidrBlock String
- The public IPv4 CIDR block being imported from on-premises to the Oracle cloud.
- compartmentId String
- The OCID of the compartment containing the BYOIP CIDR block.
- 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.
- 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 provider-assigned unique ID for this managed resource.
- ipv6cidrBlock String
- The IPv6 prefix being imported to the Oracle cloud. This prefix must be /48 or larger, and can be subdivided into sub-ranges used across multiple VCNs. A BYOIPv6 prefix can be also assigned across multiple VCNs, and each VCN must be /64 or larger. You may specify a ULA or private IPv6 prefix of /64 or larger to use in the VCN. IPv6-enabled subnets will remain a fixed /64 in size.
- lifecycleDetails String
- The ByoipRangeresource's current status.
- originAsns List<GetByoip Range Origin Asn> 
- Information about the origin asn.
- state String
- The ByoipRangeresource's current state.
- timeAdvertised String
- The date and time the ByoipRangeresource was advertised to the internet by BGP, in the format defined by RFC3339. Example:2016-08-25T21:10:29.600Z
- timeCreated String
- The date and time the ByoipRangeresource was created, in the format defined by RFC3339. Example:2016-08-25T21:10:29.600Z
- timeValidated String
- The date and time the ByoipRangeresource was validated, in the format defined by RFC3339. Example:2016-08-25T21:10:29.600Z
- timeWithdrawn String
- The date and time the ByoipRangeresource was withdrawn from advertisement by BGP to the internet, in the format defined by RFC3339. Example:2016-08-25T21:10:29.600Z
- validationToken String
- The validation token is an internally-generated ASCII string used in the validation process. See Importing a CIDR block for details.
- byoipRange stringId 
- The OCID of the ByoipRangeresource to which the CIDR block belongs.
- byoipRange GetVcn Ipv6allocations Byoip Range Byoip Range Vcn Ipv6allocation[] 
- A list of ByoipRangeVcnIpv6AllocationSummaryobjects.
- cidrBlock string
- The public IPv4 CIDR block being imported from on-premises to the Oracle cloud.
- compartmentId string
- The OCID of the compartment containing the BYOIP CIDR block.
- {[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.
- {[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 provider-assigned unique ID for this managed resource.
- ipv6cidrBlock string
- The IPv6 prefix being imported to the Oracle cloud. This prefix must be /48 or larger, and can be subdivided into sub-ranges used across multiple VCNs. A BYOIPv6 prefix can be also assigned across multiple VCNs, and each VCN must be /64 or larger. You may specify a ULA or private IPv6 prefix of /64 or larger to use in the VCN. IPv6-enabled subnets will remain a fixed /64 in size.
- lifecycleDetails string
- The ByoipRangeresource's current status.
- originAsns GetByoip Range Origin Asn[] 
- Information about the origin asn.
- state string
- The ByoipRangeresource's current state.
- timeAdvertised string
- The date and time the ByoipRangeresource was advertised to the internet by BGP, in the format defined by RFC3339. Example:2016-08-25T21:10:29.600Z
- timeCreated string
- The date and time the ByoipRangeresource was created, in the format defined by RFC3339. Example:2016-08-25T21:10:29.600Z
- timeValidated string
- The date and time the ByoipRangeresource was validated, in the format defined by RFC3339. Example:2016-08-25T21:10:29.600Z
- timeWithdrawn string
- The date and time the ByoipRangeresource was withdrawn from advertisement by BGP to the internet, in the format defined by RFC3339. Example:2016-08-25T21:10:29.600Z
- validationToken string
- The validation token is an internally-generated ASCII string used in the validation process. See Importing a CIDR block for details.
- byoip_range_ strid 
- The OCID of the ByoipRangeresource to which the CIDR block belongs.
- byoip_range_ Sequence[Getvcn_ ipv6allocations Byoip Range Byoip Range Vcn Ipv6allocation] 
- A list of ByoipRangeVcnIpv6AllocationSummaryobjects.
- cidr_block str
- The public IPv4 CIDR block being imported from on-premises to the Oracle cloud.
- compartment_id str
- The OCID of the compartment containing the BYOIP CIDR block.
- 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 provider-assigned unique ID for this managed resource.
- ipv6cidr_block str
- The IPv6 prefix being imported to the Oracle cloud. This prefix must be /48 or larger, and can be subdivided into sub-ranges used across multiple VCNs. A BYOIPv6 prefix can be also assigned across multiple VCNs, and each VCN must be /64 or larger. You may specify a ULA or private IPv6 prefix of /64 or larger to use in the VCN. IPv6-enabled subnets will remain a fixed /64 in size.
- lifecycle_details str
- The ByoipRangeresource's current status.
- origin_asns Sequence[GetByoip Range Origin Asn] 
- Information about the origin asn.
- state str
- The ByoipRangeresource's current state.
- time_advertised str
- The date and time the ByoipRangeresource was advertised to the internet by BGP, in the format defined by RFC3339. Example:2016-08-25T21:10:29.600Z
- time_created str
- The date and time the ByoipRangeresource was created, in the format defined by RFC3339. Example:2016-08-25T21:10:29.600Z
- time_validated str
- The date and time the ByoipRangeresource was validated, in the format defined by RFC3339. Example:2016-08-25T21:10:29.600Z
- time_withdrawn str
- The date and time the ByoipRangeresource was withdrawn from advertisement by BGP to the internet, in the format defined by RFC3339. Example:2016-08-25T21:10:29.600Z
- validation_token str
- The validation token is an internally-generated ASCII string used in the validation process. See Importing a CIDR block for details.
- byoipRange StringId 
- The OCID of the ByoipRangeresource to which the CIDR block belongs.
- byoipRange List<Property Map>Vcn Ipv6allocations 
- A list of ByoipRangeVcnIpv6AllocationSummaryobjects.
- cidrBlock String
- The public IPv4 CIDR block being imported from on-premises to the Oracle cloud.
- compartmentId String
- The OCID of the compartment containing the BYOIP CIDR block.
- 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.
- 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 provider-assigned unique ID for this managed resource.
- ipv6cidrBlock String
- The IPv6 prefix being imported to the Oracle cloud. This prefix must be /48 or larger, and can be subdivided into sub-ranges used across multiple VCNs. A BYOIPv6 prefix can be also assigned across multiple VCNs, and each VCN must be /64 or larger. You may specify a ULA or private IPv6 prefix of /64 or larger to use in the VCN. IPv6-enabled subnets will remain a fixed /64 in size.
- lifecycleDetails String
- The ByoipRangeresource's current status.
- originAsns List<Property Map>
- Information about the origin asn.
- state String
- The ByoipRangeresource's current state.
- timeAdvertised String
- The date and time the ByoipRangeresource was advertised to the internet by BGP, in the format defined by RFC3339. Example:2016-08-25T21:10:29.600Z
- timeCreated String
- The date and time the ByoipRangeresource was created, in the format defined by RFC3339. Example:2016-08-25T21:10:29.600Z
- timeValidated String
- The date and time the ByoipRangeresource was validated, in the format defined by RFC3339. Example:2016-08-25T21:10:29.600Z
- timeWithdrawn String
- The date and time the ByoipRangeresource was withdrawn from advertisement by BGP to the internet, in the format defined by RFC3339. Example:2016-08-25T21:10:29.600Z
- validationToken String
- The validation token is an internally-generated ASCII string used in the validation process. See Importing a CIDR block for details.
Supporting Types
GetByoipRangeByoipRangeVcnIpv6allocation      
- ByoipRange stringId 
- The OCID of the ByoipRangeresource containing the BYOIP CIDR block.
- CompartmentId string
- The OCID of the compartment containing the BYOIP CIDR block.
- Ipv6cidrBlock string
- The IPv6 prefix being imported to the Oracle cloud. This prefix must be /48 or larger, and can be subdivided into sub-ranges used across multiple VCNs. A BYOIPv6 prefix can be also assigned across multiple VCNs, and each VCN must be /64 or larger. You may specify a ULA or private IPv6 prefix of /64 or larger to use in the VCN. IPv6-enabled subnets will remain a fixed /64 in size.
- VcnId string
- The OCID of the Vcnresource to which the ByoipRange belongs.
- ByoipRange stringId 
- The OCID of the ByoipRangeresource containing the BYOIP CIDR block.
- CompartmentId string
- The OCID of the compartment containing the BYOIP CIDR block.
- Ipv6cidrBlock string
- The IPv6 prefix being imported to the Oracle cloud. This prefix must be /48 or larger, and can be subdivided into sub-ranges used across multiple VCNs. A BYOIPv6 prefix can be also assigned across multiple VCNs, and each VCN must be /64 or larger. You may specify a ULA or private IPv6 prefix of /64 or larger to use in the VCN. IPv6-enabled subnets will remain a fixed /64 in size.
- VcnId string
- The OCID of the Vcnresource to which the ByoipRange belongs.
- byoipRange StringId 
- The OCID of the ByoipRangeresource containing the BYOIP CIDR block.
- compartmentId String
- The OCID of the compartment containing the BYOIP CIDR block.
- ipv6cidrBlock String
- The IPv6 prefix being imported to the Oracle cloud. This prefix must be /48 or larger, and can be subdivided into sub-ranges used across multiple VCNs. A BYOIPv6 prefix can be also assigned across multiple VCNs, and each VCN must be /64 or larger. You may specify a ULA or private IPv6 prefix of /64 or larger to use in the VCN. IPv6-enabled subnets will remain a fixed /64 in size.
- vcnId String
- The OCID of the Vcnresource to which the ByoipRange belongs.
- byoipRange stringId 
- The OCID of the ByoipRangeresource containing the BYOIP CIDR block.
- compartmentId string
- The OCID of the compartment containing the BYOIP CIDR block.
- ipv6cidrBlock string
- The IPv6 prefix being imported to the Oracle cloud. This prefix must be /48 or larger, and can be subdivided into sub-ranges used across multiple VCNs. A BYOIPv6 prefix can be also assigned across multiple VCNs, and each VCN must be /64 or larger. You may specify a ULA or private IPv6 prefix of /64 or larger to use in the VCN. IPv6-enabled subnets will remain a fixed /64 in size.
- vcnId string
- The OCID of the Vcnresource to which the ByoipRange belongs.
- byoip_range_ strid 
- The OCID of the ByoipRangeresource containing the BYOIP CIDR block.
- compartment_id str
- The OCID of the compartment containing the BYOIP CIDR block.
- ipv6cidr_block str
- The IPv6 prefix being imported to the Oracle cloud. This prefix must be /48 or larger, and can be subdivided into sub-ranges used across multiple VCNs. A BYOIPv6 prefix can be also assigned across multiple VCNs, and each VCN must be /64 or larger. You may specify a ULA or private IPv6 prefix of /64 or larger to use in the VCN. IPv6-enabled subnets will remain a fixed /64 in size.
- vcn_id str
- The OCID of the Vcnresource to which the ByoipRange belongs.
- byoipRange StringId 
- The OCID of the ByoipRangeresource containing the BYOIP CIDR block.
- compartmentId String
- The OCID of the compartment containing the BYOIP CIDR block.
- ipv6cidrBlock String
- The IPv6 prefix being imported to the Oracle cloud. This prefix must be /48 or larger, and can be subdivided into sub-ranges used across multiple VCNs. A BYOIPv6 prefix can be also assigned across multiple VCNs, and each VCN must be /64 or larger. You may specify a ULA or private IPv6 prefix of /64 or larger to use in the VCN. IPv6-enabled subnets will remain a fixed /64 in size.
- vcnId String
- The OCID of the Vcnresource to which the ByoipRange belongs.
GetByoipRangeOriginAsn    
- AsPath intPrepend Length 
- The as path prepend length.
- Asn string
- The Autonomous System Number (ASN) you are importing to the Oracle cloud.
- ByoasnId string
- The OCID of the Byoasnresource.
- AsPath intPrepend Length 
- The as path prepend length.
- Asn string
- The Autonomous System Number (ASN) you are importing to the Oracle cloud.
- ByoasnId string
- The OCID of the Byoasnresource.
- asPath IntegerPrepend Length 
- The as path prepend length.
- asn String
- The Autonomous System Number (ASN) you are importing to the Oracle cloud.
- byoasnId String
- The OCID of the Byoasnresource.
- asPath numberPrepend Length 
- The as path prepend length.
- asn string
- The Autonomous System Number (ASN) you are importing to the Oracle cloud.
- byoasnId string
- The OCID of the Byoasnresource.
- as_path_ intprepend_ length 
- The as path prepend length.
- asn str
- The Autonomous System Number (ASN) you are importing to the Oracle cloud.
- byoasn_id str
- The OCID of the Byoasnresource.
- asPath NumberPrepend Length 
- The as path prepend length.
- asn String
- The Autonomous System Number (ASN) you are importing to the Oracle cloud.
- byoasnId String
- The OCID of the Byoasnresource.
Package Details
- Repository
- oci pulumi/pulumi-oci
- License
- Apache-2.0
- Notes
- This Pulumi package is based on the ociTerraform Provider.