1. Packages
  2. Oracle Cloud Infrastructure
  3. API Docs
  4. Bastion
  5. getBastions
Oracle Cloud Infrastructure v3.9.0 published on Wednesday, Sep 24, 2025 by Pulumi
pulumi/pulumi-oci

oci.Bastion.getBastions

Deploy with Pulumi
oci logo
Oracle Cloud Infrastructure v3.9.0 published on Wednesday, Sep 24, 2025 by Pulumi
pulumi/pulumi-oci

    This data source provides the list of Bastions in Oracle Cloud Infrastructure Bastion service.

    Retrieves a list of BastionSummary objects in a compartment. Bastions provide secured, public access to target resources in the cloud that you cannot otherwise reach from the internet.

    Example Usage

    import * as pulumi from "@pulumi/pulumi";
import * as oci from "@pulumi/oci";

const testBastions = oci.Bastion.getBastions({
    compartmentId: compartmentId,
    bastionId: testBastion.id,
    bastionLifecycleState: bastionBastionLifecycleState,
    name: bastionName,
});

    import pulumi
import pulumi_oci as oci

test_bastions = oci.Bastion.get_bastions(compartment_id=compartment_id,
    bastion_id=test_bastion["id"],
    bastion_lifecycle_state=bastion_bastion_lifecycle_state,
    name=bastion_name)

    package main

import (
	"github.com/pulumi/pulumi-oci/sdk/v3/go/oci/bastion"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_, err := bastion.GetBastions(ctx, &bastion.GetBastionsArgs{
			CompartmentId:         compartmentId,
			BastionId:             pulumi.StringRef(testBastion.Id),
			BastionLifecycleState: pulumi.StringRef(bastionBastionLifecycleState),
			Name:                  pulumi.StringRef(bastionName),
		}, 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 testBastions = Oci.Bastion.GetBastions.Invoke(new()
    {
        CompartmentId = compartmentId,
        BastionId = testBastion.Id,
        BastionLifecycleState = bastionBastionLifecycleState,
        Name = bastionName,
    });

});

    package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.oci.Bastion.BastionFunctions;
import com.pulumi.oci.Bastion.inputs.GetBastionsArgs;
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 testBastions = BastionFunctions.getBastions(GetBastionsArgs.builder()
            .compartmentId(compartmentId)
            .bastionId(testBastion.id())
            .bastionLifecycleState(bastionBastionLifecycleState)
            .name(bastionName)
            .build());

    }
}

    variables:
  testBastions:
    fn::invoke:
      function: oci:Bastion:getBastions
      arguments:
        compartmentId: ${compartmentId}
        bastionId: ${testBastion.id}
        bastionLifecycleState: ${bastionBastionLifecycleState}
        name: ${bastionName}

    Using getBastions

    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 getBastions(args: GetBastionsArgs, opts?: InvokeOptions): Promise<GetBastionsResult>
function getBastionsOutput(args: GetBastionsOutputArgs, opts?: InvokeOptions): Output<GetBastionsResult>
    def get_bastions(bastion_id: Optional[str] = None,
                 bastion_lifecycle_state: Optional[str] = None,
                 compartment_id: Optional[str] = None,
                 filters: Optional[Sequence[GetBastionsFilter]] = None,
                 name: Optional[str] = None,
                 opts: Optional[InvokeOptions] = None) -> GetBastionsResult
def get_bastions_output(bastion_id: Optional[pulumi.Input[str]] = None,
                 bastion_lifecycle_state: Optional[pulumi.Input[str]] = None,
                 compartment_id: Optional[pulumi.Input[str]] = None,
                 filters: Optional[pulumi.Input[Sequence[pulumi.Input[GetBastionsFilterArgs]]]] = None,
                 name: Optional[pulumi.Input[str]] = None,
                 opts: Optional[InvokeOptions] = None) -> Output[GetBastionsResult]
    func GetBastions(ctx *Context, args *GetBastionsArgs, opts ...InvokeOption) (*GetBastionsResult, error)
func GetBastionsOutput(ctx *Context, args *GetBastionsOutputArgs, opts ...InvokeOption) GetBastionsResultOutput

    > Note: This function is named GetBastions in the Go SDK.

    public static class GetBastions 
{
    public static Task<GetBastionsResult> InvokeAsync(GetBastionsArgs args, InvokeOptions? opts = null)
    public static Output<GetBastionsResult> Invoke(GetBastionsInvokeArgs args, InvokeOptions? opts = null)
}
    public static CompletableFuture<GetBastionsResult> getBastions(GetBastionsArgs args, InvokeOptions options)
public static Output<GetBastionsResult> getBastions(GetBastionsArgs args, InvokeOptions options)

    fn::invoke:
  function: oci:Bastion/getBastions:getBastions
  arguments:
    # arguments dictionary

    The following arguments are supported:

    CompartmentId string
    The unique identifier (OCID) of the compartment in which to list resources.
    BastionId string
    The unique identifier (OCID) of the bastion in which to list resources.
    BastionLifecycleState string
    A filter to return only resources their lifecycleState matches the given lifecycleState.
    Filters List<GetBastionsFilter>
    Name string
    A filter to return only resources that match the entire name given.
    CompartmentId string
    The unique identifier (OCID) of the compartment in which to list resources.
    BastionId string
    The unique identifier (OCID) of the bastion in which to list resources.
    BastionLifecycleState string
    A filter to return only resources their lifecycleState matches the given lifecycleState.
    Filters []GetBastionsFilter
    Name string
    A filter to return only resources that match the entire name given.
    compartmentId String
    The unique identifier (OCID) of the compartment in which to list resources.
    bastionId String
    The unique identifier (OCID) of the bastion in which to list resources.
    bastionLifecycleState String
    A filter to return only resources their lifecycleState matches the given lifecycleState.
    filters List<GetsFilter>
    name String
    A filter to return only resources that match the entire name given.
    compartmentId string
    The unique identifier (OCID) of the compartment in which to list resources.
    bastionId string
    The unique identifier (OCID) of the bastion in which to list resources.
    bastionLifecycleState string
    A filter to return only resources their lifecycleState matches the given lifecycleState.
    filters GetBastionsFilter[]
    name string
    A filter to return only resources that match the entire name given.
    compartment_id str
    The unique identifier (OCID) of the compartment in which to list resources.
    bastion_id str
    The unique identifier (OCID) of the bastion in which to list resources.
    bastion_lifecycle_state str
    A filter to return only resources their lifecycleState matches the given lifecycleState.
    filters Sequence[GetBastionsFilter]
    name str
    A filter to return only resources that match the entire name given.
    compartmentId String
    The unique identifier (OCID) of the compartment in which to list resources.
    bastionId String
    The unique identifier (OCID) of the bastion in which to list resources.
    bastionLifecycleState String
    A filter to return only resources their lifecycleState matches the given lifecycleState.
    filters List<Property Map>
    name String
    A filter to return only resources that match the entire name given.

    getBastions Result

    The following output properties are available:

    Bastions List<GetBastionsBastion>
    The list of bastions.
    CompartmentId string
    The unique identifier (OCID) of the compartment where the bastion is located.
    Id string
    The provider-assigned unique ID for this managed resource.
    BastionId string
    BastionLifecycleState string
    Filters List<GetBastionsFilter>
    Name string
    The name of the bastion, which can't be changed after creation.
    Bastions []GetBastionsBastion
    The list of bastions.
    CompartmentId string
    The unique identifier (OCID) of the compartment where the bastion is located.
    Id string
    The provider-assigned unique ID for this managed resource.
    BastionId string
    BastionLifecycleState string
    Filters []GetBastionsFilter
    Name string
    The name of the bastion, which can't be changed after creation.
    bastions List<Gets>
    The list of bastions.
    compartmentId String
    The unique identifier (OCID) of the compartment where the bastion is located.
    id String
    The provider-assigned unique ID for this managed resource.
    bastionId String
    bastionLifecycleState String
    filters List<GetsFilter>
    name String
    The name of the bastion, which can't be changed after creation.
    bastions GetBastionsBastion[]
    The list of bastions.
    compartmentId string
    The unique identifier (OCID) of the compartment where the bastion is located.
    id string
    The provider-assigned unique ID for this managed resource.
    bastionId string
    bastionLifecycleState string
    filters GetBastionsFilter[]
    name string
    The name of the bastion, which can't be changed after creation.
    bastions Sequence[GetBastionsBastion]
    The list of bastions.
    compartment_id str
    The unique identifier (OCID) of the compartment where the bastion is located.
    id str
    The provider-assigned unique ID for this managed resource.
    bastion_id str
    bastion_lifecycle_state str
    filters Sequence[GetBastionsFilter]
    name str
    The name of the bastion, which can't be changed after creation.
    bastions List<Property Map>
    The list of bastions.
    compartmentId String
    The unique identifier (OCID) of the compartment where the bastion is located.
    id String
    The provider-assigned unique ID for this managed resource.
    bastionId String
    bastionLifecycleState String
    filters List<Property Map>
    name String
    The name of the bastion, which can't be changed after creation.

    Supporting Types

    GetBastionsBastion

    BastionType string
    The type of bastion.
    ClientCidrBlockAllowLists List<string>
    A list of address ranges in CIDR notation that you want to allow to connect to sessions hosted by this bastion.
    CompartmentId string
    The unique identifier (OCID) of the compartment in which to list resources.
    DefinedTags Dictionary<string, string>
    Defined tags for this resource. Each key is predefined and scoped to a namespace. Example: {"foo-namespace.bar-key": "value"}
    DnsProxyStatus string
    Flag to enable FQDN and SOCKS5 Proxy Support. Example: ENABLED, DISABLED
    FreeformTags Dictionary<string, string>
    Simple key-value pair that is applied without any predefined name, type or scope. Exists for cross-compatibility only. Example: {"bar-key": "value"}
    Id string
    The unique identifier (OCID) of the bastion, which can't be changed after creation.
    LifecycleDetails string
    A message describing the current state in more detail.
    MaxSessionTtlInSeconds int
    The maximum amount of time that any session on the bastion can remain active.
    MaxSessionsAllowed int
    The maximum number of active sessions allowed on the bastion.
    Name string
    A filter to return only resources that match the entire name given.
    PhoneBookEntry string
    The phonebook entry of the customer's team, which can't be changed after creation. Not applicable to standard bastions.
    PrivateEndpointIpAddress string
    The private IP address of the created private endpoint.
    State string
    The current state of the bastion.
    StaticJumpHostIpAddresses List<string>
    A list of IP addresses of the hosts that the bastion has access to. Not applicable to standard bastions.
    SystemTags Dictionary<string, string>
    Usage of system tag keys. These predefined keys are scoped to namespaces. Example: {"orcl-cloud.free-tier-retained": "true"}
    TargetSubnetId string
    The unique identifier (OCID) of the subnet that the bastion connects to.
    TargetVcnId string
    The unique identifier (OCID) of the virtual cloud network (VCN) that the bastion connects to.
    TimeCreated string
    The time the bastion was created. Format is defined by RFC3339. Example: 2020-01-25T21:10:29.600Z
    TimeUpdated string
    The time the bastion was updated. Format is defined by RFC3339. Example: 2020-01-25T21:10:29.600Z
    BastionType string
    The type of bastion.
    ClientCidrBlockAllowLists []string
    A list of address ranges in CIDR notation that you want to allow to connect to sessions hosted by this bastion.
    CompartmentId string
    The unique identifier (OCID) of the compartment in which to list resources.
    DefinedTags map[string]string
    Defined tags for this resource. Each key is predefined and scoped to a namespace. Example: {"foo-namespace.bar-key": "value"}
    DnsProxyStatus string
    Flag to enable FQDN and SOCKS5 Proxy Support. Example: ENABLED, DISABLED
    FreeformTags map[string]string
    Simple key-value pair that is applied without any predefined name, type or scope. Exists for cross-compatibility only. Example: {"bar-key": "value"}
    Id string
    The unique identifier (OCID) of the bastion, which can't be changed after creation.
    LifecycleDetails string
    A message describing the current state in more detail.
    MaxSessionTtlInSeconds int
    The maximum amount of time that any session on the bastion can remain active.
    MaxSessionsAllowed int
    The maximum number of active sessions allowed on the bastion.
    Name string
    A filter to return only resources that match the entire name given.
    PhoneBookEntry string
    The phonebook entry of the customer's team, which can't be changed after creation. Not applicable to standard bastions.
    PrivateEndpointIpAddress string
    The private IP address of the created private endpoint.
    State string
    The current state of the bastion.
    StaticJumpHostIpAddresses []string
    A list of IP addresses of the hosts that the bastion has access to. Not applicable to standard bastions.
    SystemTags map[string]string
    Usage of system tag keys. These predefined keys are scoped to namespaces. Example: {"orcl-cloud.free-tier-retained": "true"}
    TargetSubnetId string
    The unique identifier (OCID) of the subnet that the bastion connects to.
    TargetVcnId string
    The unique identifier (OCID) of the virtual cloud network (VCN) that the bastion connects to.
    TimeCreated string
    The time the bastion was created. Format is defined by RFC3339. Example: 2020-01-25T21:10:29.600Z
    TimeUpdated string
    The time the bastion was updated. Format is defined by RFC3339. Example: 2020-01-25T21:10:29.600Z
    bastionType String
    The type of bastion.
    clientCidrBlockAllowLists List<String>
    A list of address ranges in CIDR notation that you want to allow to connect to sessions hosted by this bastion.
    compartmentId String
    The unique identifier (OCID) of the compartment in which to list resources.
    definedTags Map<String,String>
    Defined tags for this resource. Each key is predefined and scoped to a namespace. Example: {"foo-namespace.bar-key": "value"}
    dnsProxyStatus String
    Flag to enable FQDN and SOCKS5 Proxy Support. Example: ENABLED, DISABLED
    freeformTags Map<String,String>
    Simple key-value pair that is applied without any predefined name, type or scope. Exists for cross-compatibility only. Example: {"bar-key": "value"}
    id String
    The unique identifier (OCID) of the bastion, which can't be changed after creation.
    lifecycleDetails String
    A message describing the current state in more detail.
    maxSessionTtlInSeconds Integer
    The maximum amount of time that any session on the bastion can remain active.
    maxSessionsAllowed Integer
    The maximum number of active sessions allowed on the bastion.
    name String
    A filter to return only resources that match the entire name given.
    phoneBookEntry String
    The phonebook entry of the customer's team, which can't be changed after creation. Not applicable to standard bastions.
    privateEndpointIpAddress String
    The private IP address of the created private endpoint.
    state String
    The current state of the bastion.
    staticJumpHostIpAddresses List<String>
    A list of IP addresses of the hosts that the bastion has access to. Not applicable to standard bastions.
    systemTags Map<String,String>
    Usage of system tag keys. These predefined keys are scoped to namespaces. Example: {"orcl-cloud.free-tier-retained": "true"}
    targetSubnetId String
    The unique identifier (OCID) of the subnet that the bastion connects to.
    targetVcnId String
    The unique identifier (OCID) of the virtual cloud network (VCN) that the bastion connects to.
    timeCreated String
    The time the bastion was created. Format is defined by RFC3339. Example: 2020-01-25T21:10:29.600Z
    timeUpdated String
    The time the bastion was updated. Format is defined by RFC3339. Example: 2020-01-25T21:10:29.600Z
    bastionType string
    The type of bastion.
    clientCidrBlockAllowLists string[]
    A list of address ranges in CIDR notation that you want to allow to connect to sessions hosted by this bastion.
    compartmentId string
    The unique identifier (OCID) of the compartment in which to list resources.
    definedTags {[key: string]: string}
    Defined tags for this resource. Each key is predefined and scoped to a namespace. Example: {"foo-namespace.bar-key": "value"}
    dnsProxyStatus string
    Flag to enable FQDN and SOCKS5 Proxy Support. Example: ENABLED, DISABLED
    freeformTags {[key: string]: string}
    Simple key-value pair that is applied without any predefined name, type or scope. Exists for cross-compatibility only. Example: {"bar-key": "value"}
    id string
    The unique identifier (OCID) of the bastion, which can't be changed after creation.
    lifecycleDetails string
    A message describing the current state in more detail.
    maxSessionTtlInSeconds number
    The maximum amount of time that any session on the bastion can remain active.
    maxSessionsAllowed number
    The maximum number of active sessions allowed on the bastion.
    name string
    A filter to return only resources that match the entire name given.
    phoneBookEntry string
    The phonebook entry of the customer's team, which can't be changed after creation. Not applicable to standard bastions.
    privateEndpointIpAddress string
    The private IP address of the created private endpoint.
    state string
    The current state of the bastion.
    staticJumpHostIpAddresses string[]
    A list of IP addresses of the hosts that the bastion has access to. Not applicable to standard bastions.
    systemTags {[key: string]: string}
    Usage of system tag keys. These predefined keys are scoped to namespaces. Example: {"orcl-cloud.free-tier-retained": "true"}
    targetSubnetId string
    The unique identifier (OCID) of the subnet that the bastion connects to.
    targetVcnId string
    The unique identifier (OCID) of the virtual cloud network (VCN) that the bastion connects to.
    timeCreated string
    The time the bastion was created. Format is defined by RFC3339. Example: 2020-01-25T21:10:29.600Z
    timeUpdated string
    The time the bastion was updated. Format is defined by RFC3339. Example: 2020-01-25T21:10:29.600Z
    bastion_type str
    The type of bastion.
    client_cidr_block_allow_lists Sequence[str]
    A list of address ranges in CIDR notation that you want to allow to connect to sessions hosted by this bastion.
    compartment_id str
    The unique identifier (OCID) of the compartment in which to list resources.
    defined_tags Mapping[str, str]
    Defined tags for this resource. Each key is predefined and scoped to a namespace. Example: {"foo-namespace.bar-key": "value"}
    dns_proxy_status str
    Flag to enable FQDN and SOCKS5 Proxy Support. Example: ENABLED, DISABLED
    freeform_tags Mapping[str, str]
    Simple key-value pair that is applied without any predefined name, type or scope. Exists for cross-compatibility only. Example: {"bar-key": "value"}
    id str
    The unique identifier (OCID) of the bastion, which can't be changed after creation.
    lifecycle_details str
    A message describing the current state in more detail.
    max_session_ttl_in_seconds int
    The maximum amount of time that any session on the bastion can remain active.
    max_sessions_allowed int
    The maximum number of active sessions allowed on the bastion.
    name str
    A filter to return only resources that match the entire name given.
    phone_book_entry str
    The phonebook entry of the customer's team, which can't be changed after creation. Not applicable to standard bastions.
    private_endpoint_ip_address str
    The private IP address of the created private endpoint.
    state str
    The current state of the bastion.
    static_jump_host_ip_addresses Sequence[str]
    A list of IP addresses of the hosts that the bastion has access to. Not applicable to standard bastions.
    system_tags Mapping[str, str]
    Usage of system tag keys. These predefined keys are scoped to namespaces. Example: {"orcl-cloud.free-tier-retained": "true"}
    target_subnet_id str
    The unique identifier (OCID) of the subnet that the bastion connects to.
    target_vcn_id str
    The unique identifier (OCID) of the virtual cloud network (VCN) that the bastion connects to.
    time_created str
    The time the bastion was created. Format is defined by RFC3339. Example: 2020-01-25T21:10:29.600Z
    time_updated str
    The time the bastion was updated. Format is defined by RFC3339. Example: 2020-01-25T21:10:29.600Z
    bastionType String
    The type of bastion.
    clientCidrBlockAllowLists List<String>
    A list of address ranges in CIDR notation that you want to allow to connect to sessions hosted by this bastion.
    compartmentId String
    The unique identifier (OCID) of the compartment in which to list resources.
    definedTags Map<String>
    Defined tags for this resource. Each key is predefined and scoped to a namespace. Example: {"foo-namespace.bar-key": "value"}
    dnsProxyStatus String
    Flag to enable FQDN and SOCKS5 Proxy Support. Example: ENABLED, DISABLED
    freeformTags Map<String>
    Simple key-value pair that is applied without any predefined name, type or scope. Exists for cross-compatibility only. Example: {"bar-key": "value"}
    id String
    The unique identifier (OCID) of the bastion, which can't be changed after creation.
    lifecycleDetails String
    A message describing the current state in more detail.
    maxSessionTtlInSeconds Number
    The maximum amount of time that any session on the bastion can remain active.
    maxSessionsAllowed Number
    The maximum number of active sessions allowed on the bastion.
    name String
    A filter to return only resources that match the entire name given.
    phoneBookEntry String
    The phonebook entry of the customer's team, which can't be changed after creation. Not applicable to standard bastions.
    privateEndpointIpAddress String
    The private IP address of the created private endpoint.
    state String
    The current state of the bastion.
    staticJumpHostIpAddresses List<String>
    A list of IP addresses of the hosts that the bastion has access to. Not applicable to standard bastions.
    systemTags Map<String>
    Usage of system tag keys. These predefined keys are scoped to namespaces. Example: {"orcl-cloud.free-tier-retained": "true"}
    targetSubnetId String
    The unique identifier (OCID) of the subnet that the bastion connects to.
    targetVcnId String
    The unique identifier (OCID) of the virtual cloud network (VCN) that the bastion connects to.
    timeCreated String
    The time the bastion was created. Format is defined by RFC3339. Example: 2020-01-25T21:10:29.600Z
    timeUpdated String
    The time the bastion was updated. Format is defined by RFC3339. Example: 2020-01-25T21:10:29.600Z

    GetBastionsFilter

    Name string
    A filter to return only resources that match the entire name given.
    Values List<string>
    Regex bool
    Name string
    A filter to return only resources that match the entire name given.
    Values []string
    Regex bool
    name String
    A filter to return only resources that match the entire name given.
    values List<String>
    regex Boolean
    name string
    A filter to return only resources that match the entire name given.
    values string[]
    regex boolean
    name str
    A filter to return only resources that match the entire name given.
    values Sequence[str]
    regex bool
    name String
    A filter to return only resources that match the entire name given.
    values List<String>
    regex Boolean

    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 v3.9.0 published on Wednesday, Sep 24, 2025 by Pulumi
    pulumi/pulumi-oci
      Meet Neo: Your AI Platform Teammate