Docs Home Pulumi IaC Pulumi ESC Pulumi Insights Pulumi Cloud Packages Tutorials
  1. Packages
  2. Oracle Cloud Infrastructure
  3. API Docs
  4. DatabaseManagement
  5. getExternalAsmInstances
Oracle Cloud Infrastructure v2.33.0 published on Thursday, May 1, 2025 by Pulumi
pulumi/pulumi-oci

oci.DatabaseManagement.getExternalAsmInstances

Explore with Pulumi AI

oci logo
Oracle Cloud Infrastructure v2.33.0 published on Thursday, May 1, 2025 by Pulumi
pulumi/pulumi-oci

    This data source provides the list of External Asm Instances in Oracle Cloud Infrastructure Database Management service.

    Lists the ASM instances in the specified external ASM.

    Example Usage

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

const testExternalAsmInstances = oci.DatabaseManagement.getExternalAsmInstances({
    compartmentId: compartmentId,
    displayName: externalAsmInstanceDisplayName,
    externalAsmId: testExternalAsm.id,
});

    import pulumi
import pulumi_oci as oci

test_external_asm_instances = oci.DatabaseManagement.get_external_asm_instances(compartment_id=compartment_id,
    display_name=external_asm_instance_display_name,
    external_asm_id=test_external_asm["id"])

    package main

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

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_, err := databasemanagement.GetExternalAsmInstances(ctx, &databasemanagement.GetExternalAsmInstancesArgs{
			CompartmentId: pulumi.StringRef(compartmentId),
			DisplayName:   pulumi.StringRef(externalAsmInstanceDisplayName),
			ExternalAsmId: pulumi.StringRef(testExternalAsm.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 testExternalAsmInstances = Oci.DatabaseManagement.GetExternalAsmInstances.Invoke(new()
    {
        CompartmentId = compartmentId,
        DisplayName = externalAsmInstanceDisplayName,
        ExternalAsmId = testExternalAsm.Id,
    });

});

    package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.oci.DatabaseManagement.DatabaseManagementFunctions;
import com.pulumi.oci.DatabaseManagement.inputs.GetExternalAsmInstancesArgs;
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 testExternalAsmInstances = DatabaseManagementFunctions.getExternalAsmInstances(GetExternalAsmInstancesArgs.builder()
            .compartmentId(compartmentId)
            .displayName(externalAsmInstanceDisplayName)
            .externalAsmId(testExternalAsm.id())
            .build());

    }
}

    variables:
  testExternalAsmInstances:
    fn::invoke:
      function: oci:DatabaseManagement:getExternalAsmInstances
      arguments:
        compartmentId: ${compartmentId}
        displayName: ${externalAsmInstanceDisplayName}
        externalAsmId: ${testExternalAsm.id}

    Using getExternalAsmInstances

    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 getExternalAsmInstances(args: GetExternalAsmInstancesArgs, opts?: InvokeOptions): Promise<GetExternalAsmInstancesResult>
function getExternalAsmInstancesOutput(args: GetExternalAsmInstancesOutputArgs, opts?: InvokeOptions): Output<GetExternalAsmInstancesResult>
    def get_external_asm_instances(compartment_id: Optional[str] = None,
                               display_name: Optional[str] = None,
                               external_asm_id: Optional[str] = None,
                               filters: Optional[Sequence[GetExternalAsmInstancesFilter]] = None,
                               opts: Optional[InvokeOptions] = None) -> GetExternalAsmInstancesResult
def get_external_asm_instances_output(compartment_id: Optional[pulumi.Input[str]] = None,
                               display_name: Optional[pulumi.Input[str]] = None,
                               external_asm_id: Optional[pulumi.Input[str]] = None,
                               filters: Optional[pulumi.Input[Sequence[pulumi.Input[GetExternalAsmInstancesFilterArgs]]]] = None,
                               opts: Optional[InvokeOptions] = None) -> Output[GetExternalAsmInstancesResult]
    func GetExternalAsmInstances(ctx *Context, args *GetExternalAsmInstancesArgs, opts ...InvokeOption) (*GetExternalAsmInstancesResult, error)
func GetExternalAsmInstancesOutput(ctx *Context, args *GetExternalAsmInstancesOutputArgs, opts ...InvokeOption) GetExternalAsmInstancesResultOutput

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

    public static class GetExternalAsmInstances 
{
    public static Task<GetExternalAsmInstancesResult> InvokeAsync(GetExternalAsmInstancesArgs args, InvokeOptions? opts = null)
    public static Output<GetExternalAsmInstancesResult> Invoke(GetExternalAsmInstancesInvokeArgs args, InvokeOptions? opts = null)
}
    public static CompletableFuture<GetExternalAsmInstancesResult> getExternalAsmInstances(GetExternalAsmInstancesArgs args, InvokeOptions options)
public static Output<GetExternalAsmInstancesResult> getExternalAsmInstances(GetExternalAsmInstancesArgs args, InvokeOptions options)

    fn::invoke:
  function: oci:DatabaseManagement/getExternalAsmInstances:getExternalAsmInstances
  arguments:
    # arguments dictionary

    The following arguments are supported:

    CompartmentId string
    The OCID of the compartment.
    DisplayName string
    A filter to only return the resources that match the entire display name.
    ExternalAsmId string
    The OCID of the external ASM.
    Filters List<GetExternalAsmInstancesFilter>
    CompartmentId string
    The OCID of the compartment.
    DisplayName string
    A filter to only return the resources that match the entire display name.
    ExternalAsmId string
    The OCID of the external ASM.
    Filters []GetExternalAsmInstancesFilter
    compartmentId String
    The OCID of the compartment.
    displayName String
    A filter to only return the resources that match the entire display name.
    externalAsmId String
    The OCID of the external ASM.
    filters List<GetExternalAsmInstancesFilter>
    compartmentId string
    The OCID of the compartment.
    displayName string
    A filter to only return the resources that match the entire display name.
    externalAsmId string
    The OCID of the external ASM.
    filters GetExternalAsmInstancesFilter[]
    compartment_id str
    The OCID of the compartment.
    display_name str
    A filter to only return the resources that match the entire display name.
    external_asm_id str
    The OCID of the external ASM.
    filters Sequence[GetExternalAsmInstancesFilter]
    compartmentId String
    The OCID of the compartment.
    displayName String
    A filter to only return the resources that match the entire display name.
    externalAsmId String
    The OCID of the external ASM.
    filters List<Property Map>

    getExternalAsmInstances Result

    The following output properties are available:

    ExternalAsmInstanceCollections List<GetExternalAsmInstancesExternalAsmInstanceCollection>
    The list of external_asm_instance_collection.
    Id string
    The provider-assigned unique ID for this managed resource.
    CompartmentId string
    The OCID of the compartment.
    DisplayName string
    The user-friendly name for the ASM instance. The name does not have to be unique.
    ExternalAsmId string
    The OCID of the external ASM that the ASM instance belongs to.
    Filters List<GetExternalAsmInstancesFilter>
    ExternalAsmInstanceCollections []GetExternalAsmInstancesExternalAsmInstanceCollection
    The list of external_asm_instance_collection.
    Id string
    The provider-assigned unique ID for this managed resource.
    CompartmentId string
    The OCID of the compartment.
    DisplayName string
    The user-friendly name for the ASM instance. The name does not have to be unique.
    ExternalAsmId string
    The OCID of the external ASM that the ASM instance belongs to.
    Filters []GetExternalAsmInstancesFilter
    externalAsmInstanceCollections List<GetExternalAsmInstancesExternalAsmInstanceCollection>
    The list of external_asm_instance_collection.
    id String
    The provider-assigned unique ID for this managed resource.
    compartmentId String
    The OCID of the compartment.
    displayName String
    The user-friendly name for the ASM instance. The name does not have to be unique.
    externalAsmId String
    The OCID of the external ASM that the ASM instance belongs to.
    filters List<GetExternalAsmInstancesFilter>
    externalAsmInstanceCollections GetExternalAsmInstancesExternalAsmInstanceCollection[]
    The list of external_asm_instance_collection.
    id string
    The provider-assigned unique ID for this managed resource.
    compartmentId string
    The OCID of the compartment.
    displayName string
    The user-friendly name for the ASM instance. The name does not have to be unique.
    externalAsmId string
    The OCID of the external ASM that the ASM instance belongs to.
    filters GetExternalAsmInstancesFilter[]
    external_asm_instance_collections Sequence[GetExternalAsmInstancesExternalAsmInstanceCollection]
    The list of external_asm_instance_collection.
    id str
    The provider-assigned unique ID for this managed resource.
    compartment_id str
    The OCID of the compartment.
    display_name str
    The user-friendly name for the ASM instance. The name does not have to be unique.
    external_asm_id str
    The OCID of the external ASM that the ASM instance belongs to.
    filters Sequence[GetExternalAsmInstancesFilter]
    externalAsmInstanceCollections List<Property Map>
    The list of external_asm_instance_collection.
    id String
    The provider-assigned unique ID for this managed resource.
    compartmentId String
    The OCID of the compartment.
    displayName String
    The user-friendly name for the ASM instance. The name does not have to be unique.
    externalAsmId String
    The OCID of the external ASM that the ASM instance belongs to.
    filters List<Property Map>

    Supporting Types

    GetExternalAsmInstancesExternalAsmInstanceCollection

    GetExternalAsmInstancesExternalAsmInstanceCollectionItem

    AdrHomeDirectory string
    The Automatic Diagnostic Repository (ADR) home directory for the ASM instance.
    CompartmentId string
    The OCID of the compartment.
    ComponentName string
    The name of the external ASM instance.
    DefinedTags Dictionary<string, string>
    Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags. Example: {"Operations.CostCenter": "42"}
    DisplayName string
    A filter to only return the resources that match the entire display name.
    ExternalAsmId string
    The OCID of the external ASM.
    ExternalAsmInstanceId string
    ExternalDbNodeId string
    The OCID of the external DB node on which the ASM instance is running.
    ExternalDbSystemId string
    The OCID of the external DB system that the ASM instance is a part of.
    FreeformTags Dictionary<string, string>
    Free-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. For more information, see Resource Tags. Example: {"Department": "Finance"}
    HostName string
    The name of the host on which the ASM instance is running.
    Id string
    The OCID of the external ASM instance.
    LifecycleDetails string
    Additional information about the current lifecycle state.
    State string
    The current lifecycle state of the external ASM instance.
    SystemTags Dictionary<string, string>
    System tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags. System tags can be viewed by users, but can only be created by the system. Example: {"orcl-cloud.free-tier-retained": "true"}
    TimeCreated string
    The date and time the external ASM instance was created.
    TimeUpdated string
    The date and time the external ASM instance was last updated.
    AdrHomeDirectory string
    The Automatic Diagnostic Repository (ADR) home directory for the ASM instance.
    CompartmentId string
    The OCID of the compartment.
    ComponentName string
    The name of the external ASM instance.
    DefinedTags map[string]string
    Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags. Example: {"Operations.CostCenter": "42"}
    DisplayName string
    A filter to only return the resources that match the entire display name.
    ExternalAsmId string
    The OCID of the external ASM.
    ExternalAsmInstanceId string
    ExternalDbNodeId string
    The OCID of the external DB node on which the ASM instance is running.
    ExternalDbSystemId string
    The OCID of the external DB system that the ASM instance is a part of.
    FreeformTags map[string]string
    Free-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. For more information, see Resource Tags. Example: {"Department": "Finance"}
    HostName string
    The name of the host on which the ASM instance is running.
    Id string
    The OCID of the external ASM instance.
    LifecycleDetails string
    Additional information about the current lifecycle state.
    State string
    The current lifecycle state of the external ASM instance.
    SystemTags map[string]string
    System tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags. System tags can be viewed by users, but can only be created by the system. Example: {"orcl-cloud.free-tier-retained": "true"}
    TimeCreated string
    The date and time the external ASM instance was created.
    TimeUpdated string
    The date and time the external ASM instance was last updated.
    adrHomeDirectory String
    The Automatic Diagnostic Repository (ADR) home directory for the ASM instance.
    compartmentId String
    The OCID of the compartment.
    componentName String
    The name of the external ASM instance.
    definedTags Map<String,String>
    Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags. Example: {"Operations.CostCenter": "42"}
    displayName String
    A filter to only return the resources that match the entire display name.
    externalAsmId String
    The OCID of the external ASM.
    externalAsmInstanceId String
    externalDbNodeId String
    The OCID of the external DB node on which the ASM instance is running.
    externalDbSystemId String
    The OCID of the external DB system that the ASM instance is a part of.
    freeformTags Map<String,String>
    Free-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. For more information, see Resource Tags. Example: {"Department": "Finance"}
    hostName String
    The name of the host on which the ASM instance is running.
    id String
    The OCID of the external ASM instance.
    lifecycleDetails String
    Additional information about the current lifecycle state.
    state String
    The current lifecycle state of the external ASM instance.
    systemTags Map<String,String>
    System tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags. System tags can be viewed by users, but can only be created by the system. Example: {"orcl-cloud.free-tier-retained": "true"}
    timeCreated String
    The date and time the external ASM instance was created.
    timeUpdated String
    The date and time the external ASM instance was last updated.
    adrHomeDirectory string
    The Automatic Diagnostic Repository (ADR) home directory for the ASM instance.
    compartmentId string
    The OCID of the compartment.
    componentName string
    The name of the external ASM instance.
    definedTags {[key: string]: string}
    Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags. Example: {"Operations.CostCenter": "42"}
    displayName string
    A filter to only return the resources that match the entire display name.
    externalAsmId string
    The OCID of the external ASM.
    externalAsmInstanceId string
    externalDbNodeId string
    The OCID of the external DB node on which the ASM instance is running.
    externalDbSystemId string
    The OCID of the external DB system that the ASM instance is a part of.
    freeformTags {[key: string]: string}
    Free-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. For more information, see Resource Tags. Example: {"Department": "Finance"}
    hostName string
    The name of the host on which the ASM instance is running.
    id string
    The OCID of the external ASM instance.
    lifecycleDetails string
    Additional information about the current lifecycle state.
    state string
    The current lifecycle state of the external ASM instance.
    systemTags {[key: string]: string}
    System tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags. System tags can be viewed by users, but can only be created by the system. Example: {"orcl-cloud.free-tier-retained": "true"}
    timeCreated string
    The date and time the external ASM instance was created.
    timeUpdated string
    The date and time the external ASM instance was last updated.
    adr_home_directory str
    The Automatic Diagnostic Repository (ADR) home directory for the ASM instance.
    compartment_id str
    The OCID of the compartment.
    component_name str
    The name of the external ASM instance.
    defined_tags Mapping[str, str]
    Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags. Example: {"Operations.CostCenter": "42"}
    display_name str
    A filter to only return the resources that match the entire display name.
    external_asm_id str
    The OCID of the external ASM.
    external_asm_instance_id str
    external_db_node_id str
    The OCID of the external DB node on which the ASM instance is running.
    external_db_system_id str
    The OCID of the external DB system that the ASM instance is a part of.
    freeform_tags Mapping[str, str]
    Free-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. For more information, see Resource Tags. Example: {"Department": "Finance"}
    host_name str
    The name of the host on which the ASM instance is running.
    id str
    The OCID of the external ASM instance.
    lifecycle_details str
    Additional information about the current lifecycle state.
    state str
    The current lifecycle state of the external ASM instance.
    system_tags Mapping[str, str]
    System tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags. System tags can be viewed by users, but can only be created by the system. Example: {"orcl-cloud.free-tier-retained": "true"}
    time_created str
    The date and time the external ASM instance was created.
    time_updated str
    The date and time the external ASM instance was last updated.
    adrHomeDirectory String
    The Automatic Diagnostic Repository (ADR) home directory for the ASM instance.
    compartmentId String
    The OCID of the compartment.
    componentName String
    The name of the external ASM instance.
    definedTags Map<String>
    Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags. Example: {"Operations.CostCenter": "42"}
    displayName String
    A filter to only return the resources that match the entire display name.
    externalAsmId String
    The OCID of the external ASM.
    externalAsmInstanceId String
    externalDbNodeId String
    The OCID of the external DB node on which the ASM instance is running.
    externalDbSystemId String
    The OCID of the external DB system that the ASM instance is a part of.
    freeformTags Map<String>
    Free-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. For more information, see Resource Tags. Example: {"Department": "Finance"}
    hostName String
    The name of the host on which the ASM instance is running.
    id String
    The OCID of the external ASM instance.
    lifecycleDetails String
    Additional information about the current lifecycle state.
    state String
    The current lifecycle state of the external ASM instance.
    systemTags Map<String>
    System tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags. System tags can be viewed by users, but can only be created by the system. Example: {"orcl-cloud.free-tier-retained": "true"}
    timeCreated String
    The date and time the external ASM instance was created.
    timeUpdated String
    The date and time the external ASM instance was last updated.

    GetExternalAsmInstancesFilter

    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.
    oci logo
    Oracle Cloud Infrastructure v2.33.0 published on Thursday, May 1, 2025 by Pulumi
    pulumi/pulumi-oci