oci logo
Oracle Cloud Infrastructure v0.12.0, Mar 17 23

oci.DataCatalog.getCatalogs

This data source provides the list of Catalogs in Oracle Cloud Infrastructure Data Catalog service.

Returns a list of all the data catalogs in the specified compartment.

Example Usage

using System.Collections.Generic;
using Pulumi;
using Oci = Pulumi.Oci;

return await Deployment.RunAsync(() => 
{
    var testCatalogs = Oci.DataCatalog.GetCatalogs.Invoke(new()
    {
        CompartmentId = @var.Compartment_id,
        DisplayName = @var.Catalog_display_name,
        State = @var.Catalog_state,
    });

});
package main

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

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_, err := DataCatalog.GetCatalogs(ctx, &datacatalog.GetCatalogsArgs{
			CompartmentId: _var.Compartment_id,
			DisplayName:   pulumi.StringRef(_var.Catalog_display_name),
			State:         pulumi.StringRef(_var.Catalog_state),
		}, nil)
		if err != nil {
			return err
		}
		return nil
	})
}
package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.oci.DataCatalog.DataCatalogFunctions;
import com.pulumi.oci.DataCatalog.inputs.GetCatalogsArgs;
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 testCatalogs = DataCatalogFunctions.getCatalogs(GetCatalogsArgs.builder()
            .compartmentId(var_.compartment_id())
            .displayName(var_.catalog_display_name())
            .state(var_.catalog_state())
            .build());

    }
}
import pulumi
import pulumi_oci as oci

test_catalogs = oci.DataCatalog.get_catalogs(compartment_id=var["compartment_id"],
    display_name=var["catalog_display_name"],
    state=var["catalog_state"])
import * as pulumi from "@pulumi/pulumi";
import * as oci from "@pulumi/oci";

const testCatalogs = oci.DataCatalog.getCatalogs({
    compartmentId: _var.compartment_id,
    displayName: _var.catalog_display_name,
    state: _var.catalog_state,
});
variables:
  testCatalogs:
    fn::invoke:
      Function: oci:DataCatalog:getCatalogs
      Arguments:
        compartmentId: ${var.compartment_id}
        displayName: ${var.catalog_display_name}
        state: ${var.catalog_state}

Using getCatalogs

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 getCatalogs(args: GetCatalogsArgs, opts?: InvokeOptions): Promise<GetCatalogsResult>
function getCatalogsOutput(args: GetCatalogsOutputArgs, opts?: InvokeOptions): Output<GetCatalogsResult>
def get_catalogs(compartment_id: Optional[str] = None,
                 display_name: Optional[str] = None,
                 filters: Optional[Sequence[_datacatalog.GetCatalogsFilter]] = None,
                 state: Optional[str] = None,
                 opts: Optional[InvokeOptions] = None) -> GetCatalogsResult
def get_catalogs_output(compartment_id: Optional[pulumi.Input[str]] = None,
                 display_name: Optional[pulumi.Input[str]] = None,
                 filters: Optional[pulumi.Input[Sequence[pulumi.Input[_datacatalog.GetCatalogsFilterArgs]]]] = None,
                 state: Optional[pulumi.Input[str]] = None,
                 opts: Optional[InvokeOptions] = None) -> Output[GetCatalogsResult]
func GetCatalogs(ctx *Context, args *GetCatalogsArgs, opts ...InvokeOption) (*GetCatalogsResult, error)
func GetCatalogsOutput(ctx *Context, args *GetCatalogsOutputArgs, opts ...InvokeOption) GetCatalogsResultOutput

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

public static class GetCatalogs 
{
    public static Task<GetCatalogsResult> InvokeAsync(GetCatalogsArgs args, InvokeOptions? opts = null)
    public static Output<GetCatalogsResult> Invoke(GetCatalogsInvokeArgs args, InvokeOptions? opts = null)
}
public static CompletableFuture<GetCatalogsResult> getCatalogs(GetCatalogsArgs args, InvokeOptions options)
// Output-based functions aren't available in Java yet
fn::invoke:
  function: oci:DataCatalog/getCatalogs:getCatalogs
  arguments:
    # arguments dictionary

The following arguments are supported:

CompartmentId string

The OCID of the compartment where you want to list resources.

DisplayName string

A filter to return only resources that match the entire display name given. The match is not case sensitive.

Filters List<GetCatalogsFilter>
State string

A filter to return only resources that match the specified lifecycle state. The value is case insensitive.

CompartmentId string

The OCID of the compartment where you want to list resources.

DisplayName string

A filter to return only resources that match the entire display name given. The match is not case sensitive.

Filters []GetCatalogsFilter
State string

A filter to return only resources that match the specified lifecycle state. The value is case insensitive.

compartmentId String

The OCID of the compartment where you want to list resources.

displayName String

A filter to return only resources that match the entire display name given. The match is not case sensitive.

filters List<GetCatalogsFilter>
state String

A filter to return only resources that match the specified lifecycle state. The value is case insensitive.

compartmentId string

The OCID of the compartment where you want to list resources.

displayName string

A filter to return only resources that match the entire display name given. The match is not case sensitive.

filters GetCatalogsFilter[]
state string

A filter to return only resources that match the specified lifecycle state. The value is case insensitive.

compartment_id str

The OCID of the compartment where you want to list resources.

display_name str

A filter to return only resources that match the entire display name given. The match is not case sensitive.

filters GetCatalogsFilter]
state str

A filter to return only resources that match the specified lifecycle state. The value is case insensitive.

compartmentId String

The OCID of the compartment where you want to list resources.

displayName String

A filter to return only resources that match the entire display name given. The match is not case sensitive.

filters List<Property Map>
state String

A filter to return only resources that match the specified lifecycle state. The value is case insensitive.

getCatalogs Result

The following output properties are available:

Catalogs List<GetCatalogsCatalog>

The list of catalogs.

CompartmentId string

Compartment identifier.

Id string

The provider-assigned unique ID for this managed resource.

DisplayName string

Data catalog identifier, which can be renamed.

Filters List<GetCatalogsFilter>
State string

The current state of the data catalog resource.

Catalogs []GetCatalogsCatalog

The list of catalogs.

CompartmentId string

Compartment identifier.

Id string

The provider-assigned unique ID for this managed resource.

DisplayName string

Data catalog identifier, which can be renamed.

Filters []GetCatalogsFilter
State string

The current state of the data catalog resource.

catalogs List<GetCatalogsCatalog>

The list of catalogs.

compartmentId String

Compartment identifier.

id String

The provider-assigned unique ID for this managed resource.

displayName String

Data catalog identifier, which can be renamed.

filters List<GetCatalogsFilter>
state String

The current state of the data catalog resource.

catalogs GetCatalogsCatalog[]

The list of catalogs.

compartmentId string

Compartment identifier.

id string

The provider-assigned unique ID for this managed resource.

displayName string

Data catalog identifier, which can be renamed.

filters GetCatalogsFilter[]
state string

The current state of the data catalog resource.

catalogs GetCatalogsCatalog]

The list of catalogs.

compartment_id str

Compartment identifier.

id str

The provider-assigned unique ID for this managed resource.

display_name str

Data catalog identifier, which can be renamed.

filters GetCatalogsFilter]
state str

The current state of the data catalog resource.

catalogs List<Property Map>

The list of catalogs.

compartmentId String

Compartment identifier.

id String

The provider-assigned unique ID for this managed resource.

displayName String

Data catalog identifier, which can be renamed.

filters List<Property Map>
state String

The current state of the data catalog resource.

Supporting Types

GetCatalogsCatalog

AttachedCatalogPrivateEndpoints List<string>

The list of private reverse connection endpoints attached to the catalog

CompartmentId string

The OCID of the compartment where you want to list resources.

DefinedTags Dictionary<string, object>

Usage of predefined tag keys. These predefined keys are scoped to namespaces. Example: {"foo-namespace.bar-key": "value"}

DisplayName string

A filter to return only resources that match the entire display name given. The match is not case sensitive.

FreeformTags Dictionary<string, object>

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

Unique identifier that is immutable on creation.

LifecycleDetails string

An message describing the current state in more detail. For example, it can be used to provide actionable information for a resource in 'Failed' state.

NumberOfObjects int

The number of data objects added to the data catalog. Please see the data catalog documentation for further information on how this is calculated.

ServiceApiUrl string

The REST front endpoint URL to the data catalog instance.

ServiceConsoleUrl string

The console front endpoint URL to the data catalog instance.

State string

A filter to return only resources that match the specified lifecycle state. The value is case insensitive.

TimeCreated string

The time the data catalog was created. An RFC3339 formatted datetime string.

TimeUpdated string

The time the data catalog was updated. An RFC3339 formatted datetime string.

AttachedCatalogPrivateEndpoints []string

The list of private reverse connection endpoints attached to the catalog

CompartmentId string

The OCID of the compartment where you want to list resources.

DefinedTags map[string]interface{}

Usage of predefined tag keys. These predefined keys are scoped to namespaces. Example: {"foo-namespace.bar-key": "value"}

DisplayName string

A filter to return only resources that match the entire display name given. The match is not case sensitive.

FreeformTags map[string]interface{}

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

Unique identifier that is immutable on creation.

LifecycleDetails string

An message describing the current state in more detail. For example, it can be used to provide actionable information for a resource in 'Failed' state.

NumberOfObjects int

The number of data objects added to the data catalog. Please see the data catalog documentation for further information on how this is calculated.

ServiceApiUrl string

The REST front endpoint URL to the data catalog instance.

ServiceConsoleUrl string

The console front endpoint URL to the data catalog instance.

State string

A filter to return only resources that match the specified lifecycle state. The value is case insensitive.

TimeCreated string

The time the data catalog was created. An RFC3339 formatted datetime string.

TimeUpdated string

The time the data catalog was updated. An RFC3339 formatted datetime string.

attachedCatalogPrivateEndpoints List<String>

The list of private reverse connection endpoints attached to the catalog

compartmentId String

The OCID of the compartment where you want to list resources.

definedTags Map<String,Object>

Usage of predefined tag keys. These predefined keys are scoped to namespaces. Example: {"foo-namespace.bar-key": "value"}

displayName String

A filter to return only resources that match the entire display name given. The match is not case sensitive.

freeformTags Map<String,Object>

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

Unique identifier that is immutable on creation.

lifecycleDetails String

An message describing the current state in more detail. For example, it can be used to provide actionable information for a resource in 'Failed' state.

numberOfObjects Integer

The number of data objects added to the data catalog. Please see the data catalog documentation for further information on how this is calculated.

serviceApiUrl String

The REST front endpoint URL to the data catalog instance.

serviceConsoleUrl String

The console front endpoint URL to the data catalog instance.

state String

A filter to return only resources that match the specified lifecycle state. The value is case insensitive.

timeCreated String

The time the data catalog was created. An RFC3339 formatted datetime string.

timeUpdated String

The time the data catalog was updated. An RFC3339 formatted datetime string.

attachedCatalogPrivateEndpoints string[]

The list of private reverse connection endpoints attached to the catalog

compartmentId string

The OCID of the compartment where you want to list resources.

definedTags {[key: string]: any}

Usage of predefined tag keys. These predefined keys are scoped to namespaces. Example: {"foo-namespace.bar-key": "value"}

displayName string

A filter to return only resources that match the entire display name given. The match is not case sensitive.

freeformTags {[key: string]: any}

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

Unique identifier that is immutable on creation.

lifecycleDetails string

An message describing the current state in more detail. For example, it can be used to provide actionable information for a resource in 'Failed' state.

numberOfObjects number

The number of data objects added to the data catalog. Please see the data catalog documentation for further information on how this is calculated.

serviceApiUrl string

The REST front endpoint URL to the data catalog instance.

serviceConsoleUrl string

The console front endpoint URL to the data catalog instance.

state string

A filter to return only resources that match the specified lifecycle state. The value is case insensitive.

timeCreated string

The time the data catalog was created. An RFC3339 formatted datetime string.

timeUpdated string

The time the data catalog was updated. An RFC3339 formatted datetime string.

attached_catalog_private_endpoints Sequence[str]

The list of private reverse connection endpoints attached to the catalog

compartment_id str

The OCID of the compartment where you want to list resources.

defined_tags Mapping[str, Any]

Usage of predefined tag keys. These predefined keys are scoped to namespaces. Example: {"foo-namespace.bar-key": "value"}

display_name str

A filter to return only resources that match the entire display name given. The match is not case sensitive.

freeform_tags Mapping[str, Any]

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

Unique identifier that is immutable on creation.

lifecycle_details str

An message describing the current state in more detail. For example, it can be used to provide actionable information for a resource in 'Failed' state.

number_of_objects int

The number of data objects added to the data catalog. Please see the data catalog documentation for further information on how this is calculated.

service_api_url str

The REST front endpoint URL to the data catalog instance.

service_console_url str

The console front endpoint URL to the data catalog instance.

state str

A filter to return only resources that match the specified lifecycle state. The value is case insensitive.

time_created str

The time the data catalog was created. An RFC3339 formatted datetime string.

time_updated str

The time the data catalog was updated. An RFC3339 formatted datetime string.

attachedCatalogPrivateEndpoints List<String>

The list of private reverse connection endpoints attached to the catalog

compartmentId String

The OCID of the compartment where you want to list resources.

definedTags Map<Any>

Usage of predefined tag keys. These predefined keys are scoped to namespaces. Example: {"foo-namespace.bar-key": "value"}

displayName String

A filter to return only resources that match the entire display name given. The match is not case sensitive.

freeformTags Map<Any>

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

Unique identifier that is immutable on creation.

lifecycleDetails String

An message describing the current state in more detail. For example, it can be used to provide actionable information for a resource in 'Failed' state.

numberOfObjects Number

The number of data objects added to the data catalog. Please see the data catalog documentation for further information on how this is calculated.

serviceApiUrl String

The REST front endpoint URL to the data catalog instance.

serviceConsoleUrl String

The console front endpoint URL to the data catalog instance.

state String

A filter to return only resources that match the specified lifecycle state. The value is case insensitive.

timeCreated String

The time the data catalog was created. An RFC3339 formatted datetime string.

timeUpdated String

The time the data catalog was updated. An RFC3339 formatted datetime string.

GetCatalogsFilter

Name string
Values List<string>
Regex bool
Name string
Values []string
Regex bool
name String
values List<String>
regex Boolean
name string
values string[]
regex boolean
name str
values Sequence[str]
regex bool
name String
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.