1. Packages
  2. Oracle Cloud Infrastructure
  3. API Docs
  4. GloballyDistributedDatabase
  5. getPrivateEndpoints
Oracle Cloud Infrastructure v2.28.0 published on Thursday, Mar 27, 2025 by Pulumi

oci.GloballyDistributedDatabase.getPrivateEndpoints

Explore with Pulumi AI

Oracle Cloud Infrastructure v2.28.0 published on Thursday, Mar 27, 2025 by Pulumi

This data source provides the list of Private Endpoints in Oracle Cloud Infrastructure Globally Distributed Database service.

List of PrivateEndpoints.

Example Usage

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

const testPrivateEndpoints = oci.GloballyDistributedDatabase.getPrivateEndpoints({
    compartmentId: compartmentId,
    displayName: privateEndpointDisplayName,
    state: privateEndpointState,
});
Copy
import pulumi
import pulumi_oci as oci

test_private_endpoints = oci.GloballyDistributedDatabase.get_private_endpoints(compartment_id=compartment_id,
    display_name=private_endpoint_display_name,
    state=private_endpoint_state)
Copy
package main

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

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_, err := globallydistributeddatabase.GetPrivateEndpoints(ctx, &globallydistributeddatabase.GetPrivateEndpointsArgs{
			CompartmentId: compartmentId,
			DisplayName:   pulumi.StringRef(privateEndpointDisplayName),
			State:         pulumi.StringRef(privateEndpointState),
		}, nil)
		if err != nil {
			return err
		}
		return nil
	})
}
Copy
using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Oci = Pulumi.Oci;

return await Deployment.RunAsync(() => 
{
    var testPrivateEndpoints = Oci.GloballyDistributedDatabase.GetPrivateEndpoints.Invoke(new()
    {
        CompartmentId = compartmentId,
        DisplayName = privateEndpointDisplayName,
        State = privateEndpointState,
    });

});
Copy
package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.oci.GloballyDistributedDatabase.GloballyDistributedDatabaseFunctions;
import com.pulumi.oci.GloballyDistributedDatabase.inputs.GetPrivateEndpointsArgs;
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 testPrivateEndpoints = GloballyDistributedDatabaseFunctions.getPrivateEndpoints(GetPrivateEndpointsArgs.builder()
            .compartmentId(compartmentId)
            .displayName(privateEndpointDisplayName)
            .state(privateEndpointState)
            .build());

    }
}
Copy
variables:
  testPrivateEndpoints:
    fn::invoke:
      function: oci:GloballyDistributedDatabase:getPrivateEndpoints
      arguments:
        compartmentId: ${compartmentId}
        displayName: ${privateEndpointDisplayName}
        state: ${privateEndpointState}
Copy

Using getPrivateEndpoints

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 getPrivateEndpoints(args: GetPrivateEndpointsArgs, opts?: InvokeOptions): Promise<GetPrivateEndpointsResult>
function getPrivateEndpointsOutput(args: GetPrivateEndpointsOutputArgs, opts?: InvokeOptions): Output<GetPrivateEndpointsResult>
Copy
def get_private_endpoints(compartment_id: Optional[str] = None,
                          display_name: Optional[str] = None,
                          filters: Optional[Sequence[_globallydistributeddatabase.GetPrivateEndpointsFilter]] = None,
                          state: Optional[str] = None,
                          opts: Optional[InvokeOptions] = None) -> GetPrivateEndpointsResult
def get_private_endpoints_output(compartment_id: Optional[pulumi.Input[str]] = None,
                          display_name: Optional[pulumi.Input[str]] = None,
                          filters: Optional[pulumi.Input[Sequence[pulumi.Input[_globallydistributeddatabase.GetPrivateEndpointsFilterArgs]]]] = None,
                          state: Optional[pulumi.Input[str]] = None,
                          opts: Optional[InvokeOptions] = None) -> Output[GetPrivateEndpointsResult]
Copy
func GetPrivateEndpoints(ctx *Context, args *GetPrivateEndpointsArgs, opts ...InvokeOption) (*GetPrivateEndpointsResult, error)
func GetPrivateEndpointsOutput(ctx *Context, args *GetPrivateEndpointsOutputArgs, opts ...InvokeOption) GetPrivateEndpointsResultOutput
Copy

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

public static class GetPrivateEndpoints 
{
    public static Task<GetPrivateEndpointsResult> InvokeAsync(GetPrivateEndpointsArgs args, InvokeOptions? opts = null)
    public static Output<GetPrivateEndpointsResult> Invoke(GetPrivateEndpointsInvokeArgs args, InvokeOptions? opts = null)
}
Copy
public static CompletableFuture<GetPrivateEndpointsResult> getPrivateEndpoints(GetPrivateEndpointsArgs args, InvokeOptions options)
public static Output<GetPrivateEndpointsResult> getPrivateEndpoints(GetPrivateEndpointsArgs args, InvokeOptions options)
Copy
fn::invoke:
  function: oci:GloballyDistributedDatabase/getPrivateEndpoints:getPrivateEndpoints
  arguments:
    # arguments dictionary
Copy

The following arguments are supported:

CompartmentId This property is required. string
The ID of the compartment in which to list resources.
DisplayName string
A filter to return only private endpoint that match the entire name given. The match is not case sensitive.
Filters Changes to this property will trigger replacement. List<GetPrivateEndpointsFilter>
State string
A filter to return only resources their lifecycleState matches the given lifecycleState.
CompartmentId This property is required. string
The ID of the compartment in which to list resources.
DisplayName string
A filter to return only private endpoint that match the entire name given. The match is not case sensitive.
Filters Changes to this property will trigger replacement. []GetPrivateEndpointsFilter
State string
A filter to return only resources their lifecycleState matches the given lifecycleState.
compartmentId This property is required. String
The ID of the compartment in which to list resources.
displayName String
A filter to return only private endpoint that match the entire name given. The match is not case sensitive.
filters Changes to this property will trigger replacement. List<GetPrivateEndpointsFilter>
state String
A filter to return only resources their lifecycleState matches the given lifecycleState.
compartmentId This property is required. string
The ID of the compartment in which to list resources.
displayName string
A filter to return only private endpoint that match the entire name given. The match is not case sensitive.
filters Changes to this property will trigger replacement. GetPrivateEndpointsFilter[]
state string
A filter to return only resources their lifecycleState matches the given lifecycleState.
compartment_id This property is required. str
The ID of the compartment in which to list resources.
display_name str
A filter to return only private endpoint that match the entire name given. The match is not case sensitive.
filters Changes to this property will trigger replacement. Sequence[globallydistributeddatabase.GetPrivateEndpointsFilter]
state str
A filter to return only resources their lifecycleState matches the given lifecycleState.
compartmentId This property is required. String
The ID of the compartment in which to list resources.
displayName String
A filter to return only private endpoint that match the entire name given. The match is not case sensitive.
filters Changes to this property will trigger replacement. List<Property Map>
state String
A filter to return only resources their lifecycleState matches the given lifecycleState.

getPrivateEndpoints Result

The following output properties are available:

CompartmentId string
Identifier of the compartment in which private endpoint exists.
Id string
The provider-assigned unique ID for this managed resource.
PrivateEndpointCollections List<GetPrivateEndpointsPrivateEndpointCollection>
The list of private_endpoint_collection.
DisplayName string
PrivateEndpoint display name.
Filters List<GetPrivateEndpointsFilter>
State string
Lifecycle states for private endpoint.
CompartmentId string
Identifier of the compartment in which private endpoint exists.
Id string
The provider-assigned unique ID for this managed resource.
PrivateEndpointCollections []GetPrivateEndpointsPrivateEndpointCollection
The list of private_endpoint_collection.
DisplayName string
PrivateEndpoint display name.
Filters []GetPrivateEndpointsFilter
State string
Lifecycle states for private endpoint.
compartmentId String
Identifier of the compartment in which private endpoint exists.
id String
The provider-assigned unique ID for this managed resource.
privateEndpointCollections List<GetPrivateEndpointsPrivateEndpointCollection>
The list of private_endpoint_collection.
displayName String
PrivateEndpoint display name.
filters List<GetPrivateEndpointsFilter>
state String
Lifecycle states for private endpoint.
compartmentId string
Identifier of the compartment in which private endpoint exists.
id string
The provider-assigned unique ID for this managed resource.
privateEndpointCollections GetPrivateEndpointsPrivateEndpointCollection[]
The list of private_endpoint_collection.
displayName string
PrivateEndpoint display name.
filters GetPrivateEndpointsFilter[]
state string
Lifecycle states for private endpoint.
compartment_id str
Identifier of the compartment in which private endpoint exists.
id str
The provider-assigned unique ID for this managed resource.
private_endpoint_collections Sequence[globallydistributeddatabase.GetPrivateEndpointsPrivateEndpointCollection]
The list of private_endpoint_collection.
display_name str
PrivateEndpoint display name.
filters Sequence[globallydistributeddatabase.GetPrivateEndpointsFilter]
state str
Lifecycle states for private endpoint.
compartmentId String
Identifier of the compartment in which private endpoint exists.
id String
The provider-assigned unique ID for this managed resource.
privateEndpointCollections List<Property Map>
The list of private_endpoint_collection.
displayName String
PrivateEndpoint display name.
filters List<Property Map>
state String
Lifecycle states for private endpoint.

Supporting Types

GetPrivateEndpointsFilter

Name This property is required. string
Values This property is required. List<string>
Regex bool
Name This property is required. string
Values This property is required. []string
Regex bool
name This property is required. String
values This property is required. List<String>
regex Boolean
name This property is required. string
values This property is required. string[]
regex boolean
name This property is required. str
values This property is required. Sequence[str]
regex bool
name This property is required. String
values This property is required. List<String>
regex Boolean

GetPrivateEndpointsPrivateEndpointCollection

items This property is required. List<Property Map>

GetPrivateEndpointsPrivateEndpointCollectionItem

CompartmentId This property is required. string
The ID of the compartment in which to list resources.
DefinedTags This property is required. Dictionary<string, string>
Defined tags for this resource. Each key is predefined and scoped to a namespace. Example: {"foo-namespace.bar-key": "value"}
Description This property is required. string
PrivateEndpoint description.
DisplayName This property is required. string
A filter to return only private endpoint that match the entire name given. The match is not case sensitive.
FreeformTags This property is required. 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 This property is required. string
The identifier of the Private Endpoint.
LifecycleStateDetails This property is required. string
Detailed message for the lifecycle state.
NsgIds This property is required. List<string>
The OCIDs of the network security groups that the private endpoint belongs to.
PrivateIp This property is required. string
IP address of the Private Endpoint.
ProxyComputeInstanceId This property is required. string
The identifier of the proxy compute instance.
ReinstateProxyInstanceTrigger This property is required. int
ShardedDatabases This property is required. List<string>
The OCIDs of sharded databases that consumes the given private endpoint.
State This property is required. string
A filter to return only resources their lifecycleState matches the given lifecycleState.
SubnetId This property is required. string
Identifier of the subnet in which private endpoint exists.
SystemTags This property is required. Dictionary<string, string>
Usage of system tag keys. These predefined keys are scoped to namespaces. Example: {"orcl-cloud.free-tier-retained": "true"}
TimeCreated This property is required. string
The time the PrivateEndpoint was first created. An RFC3339 formatted datetime string
TimeUpdated This property is required. string
The time the Private Endpoint was last updated. An RFC3339 formatted datetime string
VcnId This property is required. string
Identifier of the VCN in which subnet exists.
CompartmentId This property is required. string
The ID of the compartment in which to list resources.
DefinedTags This property is required. map[string]string
Defined tags for this resource. Each key is predefined and scoped to a namespace. Example: {"foo-namespace.bar-key": "value"}
Description This property is required. string
PrivateEndpoint description.
DisplayName This property is required. string
A filter to return only private endpoint that match the entire name given. The match is not case sensitive.
FreeformTags This property is required. 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 This property is required. string
The identifier of the Private Endpoint.
LifecycleStateDetails This property is required. string
Detailed message for the lifecycle state.
NsgIds This property is required. []string
The OCIDs of the network security groups that the private endpoint belongs to.
PrivateIp This property is required. string
IP address of the Private Endpoint.
ProxyComputeInstanceId This property is required. string
The identifier of the proxy compute instance.
ReinstateProxyInstanceTrigger This property is required. int
ShardedDatabases This property is required. []string
The OCIDs of sharded databases that consumes the given private endpoint.
State This property is required. string
A filter to return only resources their lifecycleState matches the given lifecycleState.
SubnetId This property is required. string
Identifier of the subnet in which private endpoint exists.
SystemTags This property is required. map[string]string
Usage of system tag keys. These predefined keys are scoped to namespaces. Example: {"orcl-cloud.free-tier-retained": "true"}
TimeCreated This property is required. string
The time the PrivateEndpoint was first created. An RFC3339 formatted datetime string
TimeUpdated This property is required. string
The time the Private Endpoint was last updated. An RFC3339 formatted datetime string
VcnId This property is required. string
Identifier of the VCN in which subnet exists.
compartmentId This property is required. String
The ID of the compartment in which to list resources.
definedTags This property is required. Map<String,String>
Defined tags for this resource. Each key is predefined and scoped to a namespace. Example: {"foo-namespace.bar-key": "value"}
description This property is required. String
PrivateEndpoint description.
displayName This property is required. String
A filter to return only private endpoint that match the entire name given. The match is not case sensitive.
freeformTags This property is required. 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 This property is required. String
The identifier of the Private Endpoint.
lifecycleStateDetails This property is required. String
Detailed message for the lifecycle state.
nsgIds This property is required. List<String>
The OCIDs of the network security groups that the private endpoint belongs to.
privateIp This property is required. String
IP address of the Private Endpoint.
proxyComputeInstanceId This property is required. String
The identifier of the proxy compute instance.
reinstateProxyInstanceTrigger This property is required. Integer
shardedDatabases This property is required. List<String>
The OCIDs of sharded databases that consumes the given private endpoint.
state This property is required. String
A filter to return only resources their lifecycleState matches the given lifecycleState.
subnetId This property is required. String
Identifier of the subnet in which private endpoint exists.
systemTags This property is required. Map<String,String>
Usage of system tag keys. These predefined keys are scoped to namespaces. Example: {"orcl-cloud.free-tier-retained": "true"}
timeCreated This property is required. String
The time the PrivateEndpoint was first created. An RFC3339 formatted datetime string
timeUpdated This property is required. String
The time the Private Endpoint was last updated. An RFC3339 formatted datetime string
vcnId This property is required. String
Identifier of the VCN in which subnet exists.
compartmentId This property is required. string
The ID of the compartment in which to list resources.
definedTags This property is required. {[key: string]: string}
Defined tags for this resource. Each key is predefined and scoped to a namespace. Example: {"foo-namespace.bar-key": "value"}
description This property is required. string
PrivateEndpoint description.
displayName This property is required. string
A filter to return only private endpoint that match the entire name given. The match is not case sensitive.
freeformTags This property is required. {[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 This property is required. string
The identifier of the Private Endpoint.
lifecycleStateDetails This property is required. string
Detailed message for the lifecycle state.
nsgIds This property is required. string[]
The OCIDs of the network security groups that the private endpoint belongs to.
privateIp This property is required. string
IP address of the Private Endpoint.
proxyComputeInstanceId This property is required. string
The identifier of the proxy compute instance.
reinstateProxyInstanceTrigger This property is required. number
shardedDatabases This property is required. string[]
The OCIDs of sharded databases that consumes the given private endpoint.
state This property is required. string
A filter to return only resources their lifecycleState matches the given lifecycleState.
subnetId This property is required. string
Identifier of the subnet in which private endpoint exists.
systemTags This property is required. {[key: string]: string}
Usage of system tag keys. These predefined keys are scoped to namespaces. Example: {"orcl-cloud.free-tier-retained": "true"}
timeCreated This property is required. string
The time the PrivateEndpoint was first created. An RFC3339 formatted datetime string
timeUpdated This property is required. string
The time the Private Endpoint was last updated. An RFC3339 formatted datetime string
vcnId This property is required. string
Identifier of the VCN in which subnet exists.
compartment_id This property is required. str
The ID of the compartment in which to list resources.
defined_tags This property is required. Mapping[str, str]
Defined tags for this resource. Each key is predefined and scoped to a namespace. Example: {"foo-namespace.bar-key": "value"}
description This property is required. str
PrivateEndpoint description.
display_name This property is required. str
A filter to return only private endpoint that match the entire name given. The match is not case sensitive.
freeform_tags This property is required. 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 This property is required. str
The identifier of the Private Endpoint.
lifecycle_state_details This property is required. str
Detailed message for the lifecycle state.
nsg_ids This property is required. Sequence[str]
The OCIDs of the network security groups that the private endpoint belongs to.
private_ip This property is required. str
IP address of the Private Endpoint.
proxy_compute_instance_id This property is required. str
The identifier of the proxy compute instance.
reinstate_proxy_instance_trigger This property is required. int
sharded_databases This property is required. Sequence[str]
The OCIDs of sharded databases that consumes the given private endpoint.
state This property is required. str
A filter to return only resources their lifecycleState matches the given lifecycleState.
subnet_id This property is required. str
Identifier of the subnet in which private endpoint exists.
system_tags This property is required. Mapping[str, str]
Usage of system tag keys. These predefined keys are scoped to namespaces. Example: {"orcl-cloud.free-tier-retained": "true"}
time_created This property is required. str
The time the PrivateEndpoint was first created. An RFC3339 formatted datetime string
time_updated This property is required. str
The time the Private Endpoint was last updated. An RFC3339 formatted datetime string
vcn_id This property is required. str
Identifier of the VCN in which subnet exists.
compartmentId This property is required. String
The ID of the compartment in which to list resources.
definedTags This property is required. Map<String>
Defined tags for this resource. Each key is predefined and scoped to a namespace. Example: {"foo-namespace.bar-key": "value"}
description This property is required. String
PrivateEndpoint description.
displayName This property is required. String
A filter to return only private endpoint that match the entire name given. The match is not case sensitive.
freeformTags This property is required. 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 This property is required. String
The identifier of the Private Endpoint.
lifecycleStateDetails This property is required. String
Detailed message for the lifecycle state.
nsgIds This property is required. List<String>
The OCIDs of the network security groups that the private endpoint belongs to.
privateIp This property is required. String
IP address of the Private Endpoint.
proxyComputeInstanceId This property is required. String
The identifier of the proxy compute instance.
reinstateProxyInstanceTrigger This property is required. Number
shardedDatabases This property is required. List<String>
The OCIDs of sharded databases that consumes the given private endpoint.
state This property is required. String
A filter to return only resources their lifecycleState matches the given lifecycleState.
subnetId This property is required. String
Identifier of the subnet in which private endpoint exists.
systemTags This property is required. Map<String>
Usage of system tag keys. These predefined keys are scoped to namespaces. Example: {"orcl-cloud.free-tier-retained": "true"}
timeCreated This property is required. String
The time the PrivateEndpoint was first created. An RFC3339 formatted datetime string
timeUpdated This property is required. String
The time the Private Endpoint was last updated. An RFC3339 formatted datetime string
vcnId This property is required. String
Identifier of the VCN in which subnet exists.

Package Details

Repository
oci pulumi/pulumi-oci
License
Apache-2.0
Notes
This Pulumi package is based on the oci Terraform Provider.
Oracle Cloud Infrastructure v2.28.0 published on Thursday, Mar 27, 2025 by Pulumi