1. Packages
  2. Oracle Cloud Infrastructure
  3. API Docs
  4. Core
  5. getByoipRange
Oracle Cloud Infrastructure v2.3.0 published on Wednesday, Jul 17, 2024 by Pulumi

oci.Core.getByoipRange

Explore with Pulumi AI

oci logo
Oracle Cloud Infrastructure v2.3.0 published on Wednesday, Jul 17, 2024 by Pulumi

    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)
    // Output-based functions aren't available in Java yet
    
    fn::invoke:
      function: oci:Core/getByoipRange:getByoipRange
      arguments:
        # arguments dictionary

    The following arguments are supported:

    ByoipRangeId string
    The OCID of the ByoipRange resource containing the BYOIP CIDR block.
    ByoipRangeId string
    The OCID of the ByoipRange resource containing the BYOIP CIDR block.
    byoipRangeId String
    The OCID of the ByoipRange resource containing the BYOIP CIDR block.
    byoipRangeId string
    The OCID of the ByoipRange resource containing the BYOIP CIDR block.
    byoip_range_id str
    The OCID of the ByoipRange resource containing the BYOIP CIDR block.
    byoipRangeId String
    The OCID of the ByoipRange resource containing the BYOIP CIDR block.

    getByoipRange Result

    The following output properties are available:

    ByoipRangeId string
    The OCID of the ByoipRange resource to which the CIDR block belongs.
    ByoipRangeVcnIpv6allocations List<GetByoipRangeByoipRangeVcnIpv6allocation>
    A list of ByoipRangeVcnIpv6AllocationSummary objects.
    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.
    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 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 ByoipRange resource's current status.
    State string
    The ByoipRange resource's current state.
    TimeAdvertised string
    The date and time the ByoipRange resource 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 ByoipRange resource was created, in the format defined by RFC3339. Example: 2016-08-25T21:10:29.600Z
    TimeValidated string
    The date and time the ByoipRange resource was validated, in the format defined by RFC3339. Example: 2016-08-25T21:10:29.600Z
    TimeWithdrawn string
    The date and time the ByoipRange resource 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.
    ByoipRangeId string
    The OCID of the ByoipRange resource to which the CIDR block belongs.
    ByoipRangeVcnIpv6allocations []GetByoipRangeByoipRangeVcnIpv6allocation
    A list of ByoipRangeVcnIpv6AllocationSummary objects.
    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.
    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 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 ByoipRange resource's current status.
    State string
    The ByoipRange resource's current state.
    TimeAdvertised string
    The date and time the ByoipRange resource 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 ByoipRange resource was created, in the format defined by RFC3339. Example: 2016-08-25T21:10:29.600Z
    TimeValidated string
    The date and time the ByoipRange resource was validated, in the format defined by RFC3339. Example: 2016-08-25T21:10:29.600Z
    TimeWithdrawn string
    The date and time the ByoipRange resource 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.
    byoipRangeId String
    The OCID of the ByoipRange resource to which the CIDR block belongs.
    byoipRangeVcnIpv6allocations List<GetByoipRangeByoipRangeVcnIpv6allocation>
    A list of ByoipRangeVcnIpv6AllocationSummary objects.
    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.
    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 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 ByoipRange resource's current status.
    state String
    The ByoipRange resource's current state.
    timeAdvertised String
    The date and time the ByoipRange resource 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 ByoipRange resource was created, in the format defined by RFC3339. Example: 2016-08-25T21:10:29.600Z
    timeValidated String
    The date and time the ByoipRange resource was validated, in the format defined by RFC3339. Example: 2016-08-25T21:10:29.600Z
    timeWithdrawn String
    The date and time the ByoipRange resource 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.
    byoipRangeId string
    The OCID of the ByoipRange resource to which the CIDR block belongs.
    byoipRangeVcnIpv6allocations GetByoipRangeByoipRangeVcnIpv6allocation[]
    A list of ByoipRangeVcnIpv6AllocationSummary objects.
    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.
    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 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 ByoipRange resource's current status.
    state string
    The ByoipRange resource's current state.
    timeAdvertised string
    The date and time the ByoipRange resource 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 ByoipRange resource was created, in the format defined by RFC3339. Example: 2016-08-25T21:10:29.600Z
    timeValidated string
    The date and time the ByoipRange resource was validated, in the format defined by RFC3339. Example: 2016-08-25T21:10:29.600Z
    timeWithdrawn string
    The date and time the ByoipRange resource 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_id str
    The OCID of the ByoipRange resource to which the CIDR block belongs.
    byoip_range_vcn_ipv6allocations Sequence[core.GetByoipRangeByoipRangeVcnIpv6allocation]
    A list of ByoipRangeVcnIpv6AllocationSummary objects.
    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.
    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 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 ByoipRange resource's current status.
    state str
    The ByoipRange resource's current state.
    time_advertised str
    The date and time the ByoipRange resource 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 ByoipRange resource was created, in the format defined by RFC3339. Example: 2016-08-25T21:10:29.600Z
    time_validated str
    The date and time the ByoipRange resource was validated, in the format defined by RFC3339. Example: 2016-08-25T21:10:29.600Z
    time_withdrawn str
    The date and time the ByoipRange resource 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.
    byoipRangeId String
    The OCID of the ByoipRange resource to which the CIDR block belongs.
    byoipRangeVcnIpv6allocations List<Property Map>
    A list of ByoipRangeVcnIpv6AllocationSummary objects.
    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.
    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 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 ByoipRange resource's current status.
    state String
    The ByoipRange resource's current state.
    timeAdvertised String
    The date and time the ByoipRange resource 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 ByoipRange resource was created, in the format defined by RFC3339. Example: 2016-08-25T21:10:29.600Z
    timeValidated String
    The date and time the ByoipRange resource was validated, in the format defined by RFC3339. Example: 2016-08-25T21:10:29.600Z
    timeWithdrawn String
    The date and time the ByoipRange resource 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

    ByoipRangeId string
    The OCID of the ByoipRange resource 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 Vcn resource to which the ByoipRange belongs.
    ByoipRangeId string
    The OCID of the ByoipRange resource 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 Vcn resource to which the ByoipRange belongs.
    byoipRangeId String
    The OCID of the ByoipRange resource 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 Vcn resource to which the ByoipRange belongs.
    byoipRangeId string
    The OCID of the ByoipRange resource 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 Vcn resource to which the ByoipRange belongs.
    byoip_range_id str
    The OCID of the ByoipRange resource 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 Vcn resource to which the ByoipRange belongs.
    byoipRangeId String
    The OCID of the ByoipRange resource 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 Vcn resource to which the ByoipRange belongs.

    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.3.0 published on Wednesday, Jul 17, 2024 by Pulumi