1. Packages
  2. Oracle Cloud Infrastructure
  3. API Docs
  4. DatabaseManagement
  5. getExternalAsmInstances
Oracle Cloud Infrastructure v2.29.0 published on Wednesday, Apr 9, 2025 by Pulumi

oci.DatabaseManagement.getExternalAsmInstances

Explore with Pulumi AI

Oracle Cloud Infrastructure v2.29.0 published on Wednesday, Apr 9, 2025 by Pulumi

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,
});
Copy
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"])
Copy
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
	})
}
Copy
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,
    });

});
Copy
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());

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

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>
Copy
def get_external_asm_instances(compartment_id: Optional[str] = None,
                               display_name: Optional[str] = None,
                               external_asm_id: Optional[str] = None,
                               filters: Optional[Sequence[_databasemanagement.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[_databasemanagement.GetExternalAsmInstancesFilterArgs]]]] = None,
                               opts: Optional[InvokeOptions] = None) -> Output[GetExternalAsmInstancesResult]
Copy
func GetExternalAsmInstances(ctx *Context, args *GetExternalAsmInstancesArgs, opts ...InvokeOption) (*GetExternalAsmInstancesResult, error)
func GetExternalAsmInstancesOutput(ctx *Context, args *GetExternalAsmInstancesOutputArgs, opts ...InvokeOption) GetExternalAsmInstancesResultOutput
Copy

> 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)
}
Copy
public static CompletableFuture<GetExternalAsmInstancesResult> getExternalAsmInstances(GetExternalAsmInstancesArgs args, InvokeOptions options)
public static Output<GetExternalAsmInstancesResult> getExternalAsmInstances(GetExternalAsmInstancesArgs args, InvokeOptions options)
Copy
fn::invoke:
  function: oci:DatabaseManagement/getExternalAsmInstances:getExternalAsmInstances
  arguments:
    # arguments dictionary
Copy

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 Changes to this property will trigger replacement. 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 Changes to this property will trigger replacement. []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 Changes to this property will trigger replacement. 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 Changes to this property will trigger replacement. 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 Changes to this property will trigger replacement. Sequence[databasemanagement.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 Changes to this property will trigger replacement. 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[databasemanagement.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[databasemanagement.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

items This property is required. List<Property Map>

GetExternalAsmInstancesExternalAsmInstanceCollectionItem

AdrHomeDirectory This property is required. string
The Automatic Diagnostic Repository (ADR) home directory for the ASM instance.
CompartmentId This property is required. string
The OCID of the compartment.
ComponentName This property is required. string
The name of the external ASM instance.
DefinedTags This property is required. 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 This property is required. string
A filter to only return the resources that match the entire display name.
ExternalAsmId This property is required. string
The OCID of the external ASM.
ExternalAsmInstanceId This property is required. string
ExternalDbNodeId This property is required. string
The OCID of the external DB node on which the ASM instance is running.
ExternalDbSystemId This property is required. string
The OCID of the external DB system that the ASM instance is a part of.
FreeformTags This property is required. 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 This property is required. string
The name of the host on which the ASM instance is running.
Id This property is required. string
The OCID of the external ASM instance.
LifecycleDetails This property is required. string
Additional information about the current lifecycle state.
State This property is required. string
The current lifecycle state of the external ASM instance.
SystemTags This property is required. 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 This property is required. string
The date and time the external ASM instance was created.
TimeUpdated This property is required. string
The date and time the external ASM instance was last updated.
AdrHomeDirectory This property is required. string
The Automatic Diagnostic Repository (ADR) home directory for the ASM instance.
CompartmentId This property is required. string
The OCID of the compartment.
ComponentName This property is required. string
The name of the external ASM instance.
DefinedTags This property is required. 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 This property is required. string
A filter to only return the resources that match the entire display name.
ExternalAsmId This property is required. string
The OCID of the external ASM.
ExternalAsmInstanceId This property is required. string
ExternalDbNodeId This property is required. string
The OCID of the external DB node on which the ASM instance is running.
ExternalDbSystemId This property is required. string
The OCID of the external DB system that the ASM instance is a part of.
FreeformTags This property is required. 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 This property is required. string
The name of the host on which the ASM instance is running.
Id This property is required. string
The OCID of the external ASM instance.
LifecycleDetails This property is required. string
Additional information about the current lifecycle state.
State This property is required. string
The current lifecycle state of the external ASM instance.
SystemTags This property is required. 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 This property is required. string
The date and time the external ASM instance was created.
TimeUpdated This property is required. string
The date and time the external ASM instance was last updated.
adrHomeDirectory This property is required. String
The Automatic Diagnostic Repository (ADR) home directory for the ASM instance.
compartmentId This property is required. String
The OCID of the compartment.
componentName This property is required. String
The name of the external ASM instance.
definedTags This property is required. 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 This property is required. String
A filter to only return the resources that match the entire display name.
externalAsmId This property is required. String
The OCID of the external ASM.
externalAsmInstanceId This property is required. String
externalDbNodeId This property is required. String
The OCID of the external DB node on which the ASM instance is running.
externalDbSystemId This property is required. String
The OCID of the external DB system that the ASM instance is a part of.
freeformTags This property is required. 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 This property is required. String
The name of the host on which the ASM instance is running.
id This property is required. String
The OCID of the external ASM instance.
lifecycleDetails This property is required. String
Additional information about the current lifecycle state.
state This property is required. String
The current lifecycle state of the external ASM instance.
systemTags This property is required. 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 This property is required. String
The date and time the external ASM instance was created.
timeUpdated This property is required. String
The date and time the external ASM instance was last updated.
adrHomeDirectory This property is required. string
The Automatic Diagnostic Repository (ADR) home directory for the ASM instance.
compartmentId This property is required. string
The OCID of the compartment.
componentName This property is required. string
The name of the external ASM instance.
definedTags This property is required. {[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 This property is required. string
A filter to only return the resources that match the entire display name.
externalAsmId This property is required. string
The OCID of the external ASM.
externalAsmInstanceId This property is required. string
externalDbNodeId This property is required. string
The OCID of the external DB node on which the ASM instance is running.
externalDbSystemId This property is required. string
The OCID of the external DB system that the ASM instance is a part of.
freeformTags This property is required. {[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 This property is required. string
The name of the host on which the ASM instance is running.
id This property is required. string
The OCID of the external ASM instance.
lifecycleDetails This property is required. string
Additional information about the current lifecycle state.
state This property is required. string
The current lifecycle state of the external ASM instance.
systemTags This property is required. {[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 This property is required. string
The date and time the external ASM instance was created.
timeUpdated This property is required. string
The date and time the external ASM instance was last updated.
adr_home_directory This property is required. str
The Automatic Diagnostic Repository (ADR) home directory for the ASM instance.
compartment_id This property is required. str
The OCID of the compartment.
component_name This property is required. str
The name of the external ASM instance.
defined_tags This property is required. 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 This property is required. str
A filter to only return the resources that match the entire display name.
external_asm_id This property is required. str
The OCID of the external ASM.
external_asm_instance_id This property is required. str
external_db_node_id This property is required. str
The OCID of the external DB node on which the ASM instance is running.
external_db_system_id This property is required. str
The OCID of the external DB system that the ASM instance is a part of.
freeform_tags This property is required. 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 This property is required. str
The name of the host on which the ASM instance is running.
id This property is required. str
The OCID of the external ASM instance.
lifecycle_details This property is required. str
Additional information about the current lifecycle state.
state This property is required. str
The current lifecycle state of the external ASM instance.
system_tags This property is required. 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 This property is required. str
The date and time the external ASM instance was created.
time_updated This property is required. str
The date and time the external ASM instance was last updated.
adrHomeDirectory This property is required. String
The Automatic Diagnostic Repository (ADR) home directory for the ASM instance.
compartmentId This property is required. String
The OCID of the compartment.
componentName This property is required. String
The name of the external ASM instance.
definedTags This property is required. 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 This property is required. String
A filter to only return the resources that match the entire display name.
externalAsmId This property is required. String
The OCID of the external ASM.
externalAsmInstanceId This property is required. String
externalDbNodeId This property is required. String
The OCID of the external DB node on which the ASM instance is running.
externalDbSystemId This property is required. String
The OCID of the external DB system that the ASM instance is a part of.
freeformTags This property is required. 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 This property is required. String
The name of the host on which the ASM instance is running.
id This property is required. String
The OCID of the external ASM instance.
lifecycleDetails This property is required. String
Additional information about the current lifecycle state.
state This property is required. String
The current lifecycle state of the external ASM instance.
systemTags This property is required. 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 This property is required. String
The date and time the external ASM instance was created.
timeUpdated This property is required. String
The date and time the external ASM instance was last updated.

GetExternalAsmInstancesFilter

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

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.29.0 published on Wednesday, Apr 9, 2025 by Pulumi