Docs Home Pulumi IaC Pulumi ESC Pulumi Insights Pulumi Cloud Packages Tutorials
  1. Packages
  2. Oracle Cloud Infrastructure
  3. API Docs
  4. DatabaseManagement
  5. ExternalAsm
Oracle Cloud Infrastructure v2.29.0 published on Wednesday, Apr 9, 2025 by Pulumi
pulumi/pulumi-oci

oci.DatabaseManagement.ExternalAsm

Explore with Pulumi AI

Oracle Cloud Infrastructure v2.29.0 published on Wednesday, Apr 9, 2025 by Pulumi
pulumi/pulumi-oci

This resource provides the External Asm resource in Oracle Cloud Infrastructure Database Management service.

Updates the external ASM specified by externalAsmId.

Create ExternalAsm Resource

Resources are created with functions called constructors. To learn more about declaring and configuring resources, see Resources.

Constructor syntax

new ExternalAsm(name: string, args: ExternalAsmArgs, opts?: CustomResourceOptions);
@overload
def ExternalAsm(resource_name: str,
                args: ExternalAsmArgs,
                opts: Optional[ResourceOptions] = None)

@overload
def ExternalAsm(resource_name: str,
                opts: Optional[ResourceOptions] = None,
                external_asm_id: Optional[str] = None,
                defined_tags: Optional[Mapping[str, str]] = None,
                external_connector_id: Optional[str] = None,
                freeform_tags: Optional[Mapping[str, str]] = None)
func NewExternalAsm(ctx *Context, name string, args ExternalAsmArgs, opts ...ResourceOption) (*ExternalAsm, error)
public ExternalAsm(string name, ExternalAsmArgs args, CustomResourceOptions? opts = null)
public ExternalAsm(String name, ExternalAsmArgs args)
public ExternalAsm(String name, ExternalAsmArgs args, CustomResourceOptions options)

type: oci:DatabaseManagement:ExternalAsm
properties: # The arguments to resource properties.
options: # Bag of options to control resource's behavior.

Parameters

name This property is required. string
The unique name of the resource.
args This property is required. ExternalAsmArgs
The arguments to resource properties.
opts CustomResourceOptions
Bag of options to control resource's behavior.
resource_name This property is required. str
The unique name of the resource.
args This property is required. ExternalAsmArgs
The arguments to resource properties.
opts ResourceOptions
Bag of options to control resource's behavior.
ctx Context
Context object for the current deployment.
name This property is required. string
The unique name of the resource.
args This property is required. ExternalAsmArgs
The arguments to resource properties.
opts ResourceOption
Bag of options to control resource's behavior.
name This property is required. string
The unique name of the resource.
args This property is required. ExternalAsmArgs
The arguments to resource properties.
opts CustomResourceOptions
Bag of options to control resource's behavior.
name This property is required. String
The unique name of the resource.
args This property is required. ExternalAsmArgs
The arguments to resource properties.
options CustomResourceOptions
Bag of options to control resource's behavior.

Constructor example

The following reference example uses placeholder values for all input properties.

var externalAsmResource = new Oci.DatabaseManagement.ExternalAsm("externalAsmResource", new()
{
    ExternalAsmId = "string",
    DefinedTags = 
    {
        { "string", "string" },
    },
    ExternalConnectorId = "string",
    FreeformTags = 
    {
        { "string", "string" },
    },
});
Copy
example, err := DatabaseManagement.NewExternalAsm(ctx, "externalAsmResource", &DatabaseManagement.ExternalAsmArgs{
	ExternalAsmId: pulumi.String("string"),
	DefinedTags: pulumi.StringMap{
		"string": pulumi.String("string"),
	},
	ExternalConnectorId: pulumi.String("string"),
	FreeformTags: pulumi.StringMap{
		"string": pulumi.String("string"),
	},
})
Copy
var externalAsmResource = new ExternalAsm("externalAsmResource", ExternalAsmArgs.builder()
    .externalAsmId("string")
    .definedTags(Map.of("string", "string"))
    .externalConnectorId("string")
    .freeformTags(Map.of("string", "string"))
    .build());
Copy
external_asm_resource = oci.database_management.ExternalAsm("externalAsmResource",
    external_asm_id="string",
    defined_tags={
        "string": "string",
    },
    external_connector_id="string",
    freeform_tags={
        "string": "string",
    })
Copy
const externalAsmResource = new oci.databasemanagement.ExternalAsm("externalAsmResource", {
    externalAsmId: "string",
    definedTags: {
        string: "string",
    },
    externalConnectorId: "string",
    freeformTags: {
        string: "string",
    },
});
Copy
type: oci:DatabaseManagement:ExternalAsm
properties:
    definedTags:
        string: string
    externalAsmId: string
    externalConnectorId: string
    freeformTags:
        string: string
Copy

ExternalAsm Resource Properties

To learn more about resource properties and how to use them, see Inputs and Outputs in the Architecture and Concepts docs.

Inputs

In Python, inputs that are objects can be passed either as argument classes or as dictionary literals.

The ExternalAsm resource accepts the following input properties:

ExternalAsmId
This property is required.
Changes to this property will trigger replacement.
string
The OCID of the external ASM.
DefinedTags Dictionary<string, string>
(Updatable) Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags. Example: {"Operations.CostCenter": "42"}
ExternalConnectorId string
(Updatable) The OCID of the external connector.
FreeformTags Dictionary<string, string>

(Updatable) 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"}

** IMPORTANT ** Any change to a property that does not support update will force the destruction and recreation of the resource with the new property values

ExternalAsmId
This property is required.
Changes to this property will trigger replacement.
string
The OCID of the external ASM.
DefinedTags map[string]string
(Updatable) Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags. Example: {"Operations.CostCenter": "42"}
ExternalConnectorId string
(Updatable) The OCID of the external connector.
FreeformTags map[string]string

(Updatable) 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"}

** IMPORTANT ** Any change to a property that does not support update will force the destruction and recreation of the resource with the new property values

externalAsmId
This property is required.
Changes to this property will trigger replacement.
String
The OCID of the external ASM.
definedTags Map<String,String>
(Updatable) Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags. Example: {"Operations.CostCenter": "42"}
externalConnectorId String
(Updatable) The OCID of the external connector.
freeformTags Map<String,String>

(Updatable) 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"}

** IMPORTANT ** Any change to a property that does not support update will force the destruction and recreation of the resource with the new property values

externalAsmId
This property is required.
Changes to this property will trigger replacement.
string
The OCID of the external ASM.
definedTags {[key: string]: string}
(Updatable) Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags. Example: {"Operations.CostCenter": "42"}
externalConnectorId string
(Updatable) The OCID of the external connector.
freeformTags {[key: string]: string}

(Updatable) 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"}

** IMPORTANT ** Any change to a property that does not support update will force the destruction and recreation of the resource with the new property values

external_asm_id
This property is required.
Changes to this property will trigger replacement.
str
The OCID of the external ASM.
defined_tags Mapping[str, str]
(Updatable) Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags. Example: {"Operations.CostCenter": "42"}
external_connector_id str
(Updatable) The OCID of the external connector.
freeform_tags Mapping[str, str]

(Updatable) 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"}

** IMPORTANT ** Any change to a property that does not support update will force the destruction and recreation of the resource with the new property values

externalAsmId
This property is required.
Changes to this property will trigger replacement.
String
The OCID of the external ASM.
definedTags Map<String>
(Updatable) Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags. Example: {"Operations.CostCenter": "42"}
externalConnectorId String
(Updatable) The OCID of the external connector.
freeformTags Map<String>

(Updatable) 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"}

** IMPORTANT ** Any change to a property that does not support update will force the destruction and recreation of the resource with the new property values

Outputs

All input properties are implicitly available as output properties. Additionally, the ExternalAsm resource produces the following output properties:

AdditionalDetails Dictionary<string, string>
The additional details of the external ASM defined in {"key": "value"} format. Example: {"bar-key": "value"}
CompartmentId string
The OCID of the compartment in which the external database resides.
ComponentName string
The name of the external ASM.
DisplayName string
The user-friendly name for the database. The name does not have to be unique.
ExternalDbSystemId string
The OCID of the external DB system that the ASM is a part of.
GridHome string
The directory in which ASM is installed. This is the same directory in which Oracle Grid Infrastructure is installed.
Id string
The provider-assigned unique ID for this managed resource.
IsCluster bool
Indicates whether the ASM is a cluster ASM or not.
IsFlexEnabled bool
Indicates whether Oracle Flex ASM is enabled or not.
LifecycleDetails string
Additional information about the current lifecycle state.
ServicedDatabases List<ExternalAsmServicedDatabase>
The list of databases that are serviced by the ASM.
State string
The current lifecycle state of the external ASM.
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 was created.
TimeUpdated string
The date and time the external ASM was last updated.
Version string
The ASM version.
AdditionalDetails map[string]string
The additional details of the external ASM defined in {"key": "value"} format. Example: {"bar-key": "value"}
CompartmentId string
The OCID of the compartment in which the external database resides.
ComponentName string
The name of the external ASM.
DisplayName string
The user-friendly name for the database. The name does not have to be unique.
ExternalDbSystemId string
The OCID of the external DB system that the ASM is a part of.
GridHome string
The directory in which ASM is installed. This is the same directory in which Oracle Grid Infrastructure is installed.
Id string
The provider-assigned unique ID for this managed resource.
IsCluster bool
Indicates whether the ASM is a cluster ASM or not.
IsFlexEnabled bool
Indicates whether Oracle Flex ASM is enabled or not.
LifecycleDetails string
Additional information about the current lifecycle state.
ServicedDatabases []ExternalAsmServicedDatabase
The list of databases that are serviced by the ASM.
State string
The current lifecycle state of the external ASM.
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 was created.
TimeUpdated string
The date and time the external ASM was last updated.
Version string
The ASM version.
additionalDetails Map<String,String>
The additional details of the external ASM defined in {"key": "value"} format. Example: {"bar-key": "value"}
compartmentId String
The OCID of the compartment in which the external database resides.
componentName String
The name of the external ASM.
displayName String
The user-friendly name for the database. The name does not have to be unique.
externalDbSystemId String
The OCID of the external DB system that the ASM is a part of.
gridHome String
The directory in which ASM is installed. This is the same directory in which Oracle Grid Infrastructure is installed.
id String
The provider-assigned unique ID for this managed resource.
isCluster Boolean
Indicates whether the ASM is a cluster ASM or not.
isFlexEnabled Boolean
Indicates whether Oracle Flex ASM is enabled or not.
lifecycleDetails String
Additional information about the current lifecycle state.
servicedDatabases List<ExternalAsmServicedDatabase>
The list of databases that are serviced by the ASM.
state String
The current lifecycle state of the external ASM.
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 was created.
timeUpdated String
The date and time the external ASM was last updated.
version String
The ASM version.
additionalDetails {[key: string]: string}
The additional details of the external ASM defined in {"key": "value"} format. Example: {"bar-key": "value"}
compartmentId string
The OCID of the compartment in which the external database resides.
componentName string
The name of the external ASM.
displayName string
The user-friendly name for the database. The name does not have to be unique.
externalDbSystemId string
The OCID of the external DB system that the ASM is a part of.
gridHome string
The directory in which ASM is installed. This is the same directory in which Oracle Grid Infrastructure is installed.
id string
The provider-assigned unique ID for this managed resource.
isCluster boolean
Indicates whether the ASM is a cluster ASM or not.
isFlexEnabled boolean
Indicates whether Oracle Flex ASM is enabled or not.
lifecycleDetails string
Additional information about the current lifecycle state.
servicedDatabases ExternalAsmServicedDatabase[]
The list of databases that are serviced by the ASM.
state string
The current lifecycle state of the external ASM.
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 was created.
timeUpdated string
The date and time the external ASM was last updated.
version string
The ASM version.
additional_details Mapping[str, str]
The additional details of the external ASM defined in {"key": "value"} format. Example: {"bar-key": "value"}
compartment_id str
The OCID of the compartment in which the external database resides.
component_name str
The name of the external ASM.
display_name str
The user-friendly name for the database. The name does not have to be unique.
external_db_system_id str
The OCID of the external DB system that the ASM is a part of.
grid_home str
The directory in which ASM is installed. This is the same directory in which Oracle Grid Infrastructure is installed.
id str
The provider-assigned unique ID for this managed resource.
is_cluster bool
Indicates whether the ASM is a cluster ASM or not.
is_flex_enabled bool
Indicates whether Oracle Flex ASM is enabled or not.
lifecycle_details str
Additional information about the current lifecycle state.
serviced_databases Sequence[databasemanagement.ExternalAsmServicedDatabase]
The list of databases that are serviced by the ASM.
state str
The current lifecycle state of the external ASM.
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 was created.
time_updated str
The date and time the external ASM was last updated.
version str
The ASM version.
additionalDetails Map<String>
The additional details of the external ASM defined in {"key": "value"} format. Example: {"bar-key": "value"}
compartmentId String
The OCID of the compartment in which the external database resides.
componentName String
The name of the external ASM.
displayName String
The user-friendly name for the database. The name does not have to be unique.
externalDbSystemId String
The OCID of the external DB system that the ASM is a part of.
gridHome String
The directory in which ASM is installed. This is the same directory in which Oracle Grid Infrastructure is installed.
id String
The provider-assigned unique ID for this managed resource.
isCluster Boolean
Indicates whether the ASM is a cluster ASM or not.
isFlexEnabled Boolean
Indicates whether Oracle Flex ASM is enabled or not.
lifecycleDetails String
Additional information about the current lifecycle state.
servicedDatabases List<Property Map>
The list of databases that are serviced by the ASM.
state String
The current lifecycle state of the external ASM.
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 was created.
timeUpdated String
The date and time the external ASM was last updated.
version String
The ASM version.

Look up Existing ExternalAsm Resource

Get an existing ExternalAsm resource’s state with the given name, ID, and optional extra properties used to qualify the lookup.

public static get(name: string, id: Input<ID>, state?: ExternalAsmState, opts?: CustomResourceOptions): ExternalAsm
@staticmethod
def get(resource_name: str,
        id: str,
        opts: Optional[ResourceOptions] = None,
        additional_details: Optional[Mapping[str, str]] = None,
        compartment_id: Optional[str] = None,
        component_name: Optional[str] = None,
        defined_tags: Optional[Mapping[str, str]] = None,
        display_name: Optional[str] = None,
        external_asm_id: Optional[str] = None,
        external_connector_id: Optional[str] = None,
        external_db_system_id: Optional[str] = None,
        freeform_tags: Optional[Mapping[str, str]] = None,
        grid_home: Optional[str] = None,
        is_cluster: Optional[bool] = None,
        is_flex_enabled: Optional[bool] = None,
        lifecycle_details: Optional[str] = None,
        serviced_databases: Optional[Sequence[_databasemanagement.ExternalAsmServicedDatabaseArgs]] = None,
        state: Optional[str] = None,
        system_tags: Optional[Mapping[str, str]] = None,
        time_created: Optional[str] = None,
        time_updated: Optional[str] = None,
        version: Optional[str] = None) -> ExternalAsm
func GetExternalAsm(ctx *Context, name string, id IDInput, state *ExternalAsmState, opts ...ResourceOption) (*ExternalAsm, error)
public static ExternalAsm Get(string name, Input<string> id, ExternalAsmState? state, CustomResourceOptions? opts = null)
public static ExternalAsm get(String name, Output<String> id, ExternalAsmState state, CustomResourceOptions options)
resources:  _:    type: oci:DatabaseManagement:ExternalAsm    get:      id: ${id}
name This property is required.
The unique name of the resulting resource.
id This property is required.
The unique provider ID of the resource to lookup.
state
Any extra arguments used during the lookup.
opts
A bag of options that control this resource's behavior.
resource_name This property is required.
The unique name of the resulting resource.
id This property is required.
The unique provider ID of the resource to lookup.
name This property is required.
The unique name of the resulting resource.
id This property is required.
The unique provider ID of the resource to lookup.
state
Any extra arguments used during the lookup.
opts
A bag of options that control this resource's behavior.
name This property is required.
The unique name of the resulting resource.
id This property is required.
The unique provider ID of the resource to lookup.
state
Any extra arguments used during the lookup.
opts
A bag of options that control this resource's behavior.
name This property is required.
The unique name of the resulting resource.
id This property is required.
The unique provider ID of the resource to lookup.
state
Any extra arguments used during the lookup.
opts
A bag of options that control this resource's behavior.
The following state arguments are supported:
AdditionalDetails Dictionary<string, string>
The additional details of the external ASM defined in {"key": "value"} format. Example: {"bar-key": "value"}
CompartmentId string
The OCID of the compartment in which the external database resides.
ComponentName string
The name of the external ASM.
DefinedTags Dictionary<string, string>
(Updatable) 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
The user-friendly name for the database. The name does not have to be unique.
ExternalAsmId Changes to this property will trigger replacement. string
The OCID of the external ASM.
ExternalConnectorId string
(Updatable) The OCID of the external connector.
ExternalDbSystemId string
The OCID of the external DB system that the ASM is a part of.
FreeformTags Dictionary<string, string>

(Updatable) 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"}

** IMPORTANT ** Any change to a property that does not support update will force the destruction and recreation of the resource with the new property values

GridHome string
The directory in which ASM is installed. This is the same directory in which Oracle Grid Infrastructure is installed.
IsCluster bool
Indicates whether the ASM is a cluster ASM or not.
IsFlexEnabled bool
Indicates whether Oracle Flex ASM is enabled or not.
LifecycleDetails string
Additional information about the current lifecycle state.
ServicedDatabases List<ExternalAsmServicedDatabase>
The list of databases that are serviced by the ASM.
State string
The current lifecycle state of the external ASM.
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 was created.
TimeUpdated string
The date and time the external ASM was last updated.
Version string
The ASM version.
AdditionalDetails map[string]string
The additional details of the external ASM defined in {"key": "value"} format. Example: {"bar-key": "value"}
CompartmentId string
The OCID of the compartment in which the external database resides.
ComponentName string
The name of the external ASM.
DefinedTags map[string]string
(Updatable) 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
The user-friendly name for the database. The name does not have to be unique.
ExternalAsmId Changes to this property will trigger replacement. string
The OCID of the external ASM.
ExternalConnectorId string
(Updatable) The OCID of the external connector.
ExternalDbSystemId string
The OCID of the external DB system that the ASM is a part of.
FreeformTags map[string]string

(Updatable) 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"}

** IMPORTANT ** Any change to a property that does not support update will force the destruction and recreation of the resource with the new property values

GridHome string
The directory in which ASM is installed. This is the same directory in which Oracle Grid Infrastructure is installed.
IsCluster bool
Indicates whether the ASM is a cluster ASM or not.
IsFlexEnabled bool
Indicates whether Oracle Flex ASM is enabled or not.
LifecycleDetails string
Additional information about the current lifecycle state.
ServicedDatabases []ExternalAsmServicedDatabaseArgs
The list of databases that are serviced by the ASM.
State string
The current lifecycle state of the external ASM.
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 was created.
TimeUpdated string
The date and time the external ASM was last updated.
Version string
The ASM version.
additionalDetails Map<String,String>
The additional details of the external ASM defined in {"key": "value"} format. Example: {"bar-key": "value"}
compartmentId String
The OCID of the compartment in which the external database resides.
componentName String
The name of the external ASM.
definedTags Map<String,String>
(Updatable) 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
The user-friendly name for the database. The name does not have to be unique.
externalAsmId Changes to this property will trigger replacement. String
The OCID of the external ASM.
externalConnectorId String
(Updatable) The OCID of the external connector.
externalDbSystemId String
The OCID of the external DB system that the ASM is a part of.
freeformTags Map<String,String>

(Updatable) 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"}

** IMPORTANT ** Any change to a property that does not support update will force the destruction and recreation of the resource with the new property values

gridHome String
The directory in which ASM is installed. This is the same directory in which Oracle Grid Infrastructure is installed.
isCluster Boolean
Indicates whether the ASM is a cluster ASM or not.
isFlexEnabled Boolean
Indicates whether Oracle Flex ASM is enabled or not.
lifecycleDetails String
Additional information about the current lifecycle state.
servicedDatabases List<ExternalAsmServicedDatabase>
The list of databases that are serviced by the ASM.
state String
The current lifecycle state of the external ASM.
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 was created.
timeUpdated String
The date and time the external ASM was last updated.
version String
The ASM version.
additionalDetails {[key: string]: string}
The additional details of the external ASM defined in {"key": "value"} format. Example: {"bar-key": "value"}
compartmentId string
The OCID of the compartment in which the external database resides.
componentName string
The name of the external ASM.
definedTags {[key: string]: string}
(Updatable) 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
The user-friendly name for the database. The name does not have to be unique.
externalAsmId Changes to this property will trigger replacement. string
The OCID of the external ASM.
externalConnectorId string
(Updatable) The OCID of the external connector.
externalDbSystemId string
The OCID of the external DB system that the ASM is a part of.
freeformTags {[key: string]: string}

(Updatable) 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"}

** IMPORTANT ** Any change to a property that does not support update will force the destruction and recreation of the resource with the new property values

gridHome string
The directory in which ASM is installed. This is the same directory in which Oracle Grid Infrastructure is installed.
isCluster boolean
Indicates whether the ASM is a cluster ASM or not.
isFlexEnabled boolean
Indicates whether Oracle Flex ASM is enabled or not.
lifecycleDetails string
Additional information about the current lifecycle state.
servicedDatabases ExternalAsmServicedDatabase[]
The list of databases that are serviced by the ASM.
state string
The current lifecycle state of the external ASM.
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 was created.
timeUpdated string
The date and time the external ASM was last updated.
version string
The ASM version.
additional_details Mapping[str, str]
The additional details of the external ASM defined in {"key": "value"} format. Example: {"bar-key": "value"}
compartment_id str
The OCID of the compartment in which the external database resides.
component_name str
The name of the external ASM.
defined_tags Mapping[str, str]
(Updatable) 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
The user-friendly name for the database. The name does not have to be unique.
external_asm_id Changes to this property will trigger replacement. str
The OCID of the external ASM.
external_connector_id str
(Updatable) The OCID of the external connector.
external_db_system_id str
The OCID of the external DB system that the ASM is a part of.
freeform_tags Mapping[str, str]

(Updatable) 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"}

** IMPORTANT ** Any change to a property that does not support update will force the destruction and recreation of the resource with the new property values

grid_home str
The directory in which ASM is installed. This is the same directory in which Oracle Grid Infrastructure is installed.
is_cluster bool
Indicates whether the ASM is a cluster ASM or not.
is_flex_enabled bool
Indicates whether Oracle Flex ASM is enabled or not.
lifecycle_details str
Additional information about the current lifecycle state.
serviced_databases Sequence[databasemanagement.ExternalAsmServicedDatabaseArgs]
The list of databases that are serviced by the ASM.
state str
The current lifecycle state of the external ASM.
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 was created.
time_updated str
The date and time the external ASM was last updated.
version str
The ASM version.
additionalDetails Map<String>
The additional details of the external ASM defined in {"key": "value"} format. Example: {"bar-key": "value"}
compartmentId String
The OCID of the compartment in which the external database resides.
componentName String
The name of the external ASM.
definedTags Map<String>
(Updatable) 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
The user-friendly name for the database. The name does not have to be unique.
externalAsmId Changes to this property will trigger replacement. String
The OCID of the external ASM.
externalConnectorId String
(Updatable) The OCID of the external connector.
externalDbSystemId String
The OCID of the external DB system that the ASM is a part of.
freeformTags Map<String>

(Updatable) 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"}

** IMPORTANT ** Any change to a property that does not support update will force the destruction and recreation of the resource with the new property values

gridHome String
The directory in which ASM is installed. This is the same directory in which Oracle Grid Infrastructure is installed.
isCluster Boolean
Indicates whether the ASM is a cluster ASM or not.
isFlexEnabled Boolean
Indicates whether Oracle Flex ASM is enabled or not.
lifecycleDetails String
Additional information about the current lifecycle state.
servicedDatabases List<Property Map>
The list of databases that are serviced by the ASM.
state String
The current lifecycle state of the external ASM.
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 was created.
timeUpdated String
The date and time the external ASM was last updated.
version String
The ASM version.

Supporting Types

ExternalAsmServicedDatabase
, ExternalAsmServicedDatabaseArgs

CompartmentId string
The OCID of the compartment in which the external database resides.
DatabaseSubType string
The subtype of Oracle Database. Indicates whether the database is a Container Database, Pluggable Database, Non-container Database, Autonomous Database, or Autonomous Container Database.
DatabaseType string
The type of Oracle Database installation.
DbUniqueName string
The unique name of the external database.
DiskGroups List<string>
The list of ASM disk groups used by the database.
DisplayName string
The user-friendly name for the database. The name does not have to be unique.
Id string
The OCID of the external database.
IsManaged bool
Indicates whether the database is a Managed Database or not.
CompartmentId string
The OCID of the compartment in which the external database resides.
DatabaseSubType string
The subtype of Oracle Database. Indicates whether the database is a Container Database, Pluggable Database, Non-container Database, Autonomous Database, or Autonomous Container Database.
DatabaseType string
The type of Oracle Database installation.
DbUniqueName string
The unique name of the external database.
DiskGroups []string
The list of ASM disk groups used by the database.
DisplayName string
The user-friendly name for the database. The name does not have to be unique.
Id string
The OCID of the external database.
IsManaged bool
Indicates whether the database is a Managed Database or not.
compartmentId String
The OCID of the compartment in which the external database resides.
databaseSubType String
The subtype of Oracle Database. Indicates whether the database is a Container Database, Pluggable Database, Non-container Database, Autonomous Database, or Autonomous Container Database.
databaseType String
The type of Oracle Database installation.
dbUniqueName String
The unique name of the external database.
diskGroups List<String>
The list of ASM disk groups used by the database.
displayName String
The user-friendly name for the database. The name does not have to be unique.
id String
The OCID of the external database.
isManaged Boolean
Indicates whether the database is a Managed Database or not.
compartmentId string
The OCID of the compartment in which the external database resides.
databaseSubType string
The subtype of Oracle Database. Indicates whether the database is a Container Database, Pluggable Database, Non-container Database, Autonomous Database, or Autonomous Container Database.
databaseType string
The type of Oracle Database installation.
dbUniqueName string
The unique name of the external database.
diskGroups string[]
The list of ASM disk groups used by the database.
displayName string
The user-friendly name for the database. The name does not have to be unique.
id string
The OCID of the external database.
isManaged boolean
Indicates whether the database is a Managed Database or not.
compartment_id str
The OCID of the compartment in which the external database resides.
database_sub_type str
The subtype of Oracle Database. Indicates whether the database is a Container Database, Pluggable Database, Non-container Database, Autonomous Database, or Autonomous Container Database.
database_type str
The type of Oracle Database installation.
db_unique_name str
The unique name of the external database.
disk_groups Sequence[str]
The list of ASM disk groups used by the database.
display_name str
The user-friendly name for the database. The name does not have to be unique.
id str
The OCID of the external database.
is_managed bool
Indicates whether the database is a Managed Database or not.
compartmentId String
The OCID of the compartment in which the external database resides.
databaseSubType String
The subtype of Oracle Database. Indicates whether the database is a Container Database, Pluggable Database, Non-container Database, Autonomous Database, or Autonomous Container Database.
databaseType String
The type of Oracle Database installation.
dbUniqueName String
The unique name of the external database.
diskGroups List<String>
The list of ASM disk groups used by the database.
displayName String
The user-friendly name for the database. The name does not have to be unique.
id String
The OCID of the external database.
isManaged Boolean
Indicates whether the database is a Managed Database or not.

Import

ExternalAsms can be imported using the id, e.g.

$ pulumi import oci:DatabaseManagement/externalAsm:ExternalAsm test_external_asm "id"
Copy

To learn more about importing existing cloud resources, see Importing resources.

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
pulumi/pulumi-oci