oci.DatabaseTools.DatabaseToolsConnection
Explore with Pulumi AI
This resource provides the Database Tools Connection resource in Oracle Cloud Infrastructure Database Tools service.
Creates a new Database Tools connection.
Create DatabaseToolsConnection Resource
Resources are created with functions called constructors. To learn more about declaring and configuring resources, see Resources.
Constructor syntax
new DatabaseToolsConnection(name: string, args: DatabaseToolsConnectionArgs, opts?: CustomResourceOptions);
@overload
def DatabaseToolsConnection(resource_name: str,
args: DatabaseToolsConnectionArgs,
opts: Optional[ResourceOptions] = None)
@overload
def DatabaseToolsConnection(resource_name: str,
opts: Optional[ResourceOptions] = None,
type: Optional[str] = None,
compartment_id: Optional[str] = None,
user_password: Optional[_databasetools.DatabaseToolsConnectionUserPasswordArgs] = None,
user_name: Optional[str] = None,
display_name: Optional[str] = None,
key_stores: Optional[Sequence[_databasetools.DatabaseToolsConnectionKeyStoreArgs]] = None,
freeform_tags: Optional[Mapping[str, str]] = None,
locks: Optional[Sequence[_databasetools.DatabaseToolsConnectionLockArgs]] = None,
private_endpoint_id: Optional[str] = None,
proxy_client: Optional[_databasetools.DatabaseToolsConnectionProxyClientArgs] = None,
related_resource: Optional[_databasetools.DatabaseToolsConnectionRelatedResourceArgs] = None,
runtime_support: Optional[str] = None,
advanced_properties: Optional[Mapping[str, str]] = None,
url: Optional[str] = None,
defined_tags: Optional[Mapping[str, str]] = None,
connection_string: Optional[str] = None)
func NewDatabaseToolsConnection(ctx *Context, name string, args DatabaseToolsConnectionArgs, opts ...ResourceOption) (*DatabaseToolsConnection, error)
public DatabaseToolsConnection(string name, DatabaseToolsConnectionArgs args, CustomResourceOptions? opts = null)
public DatabaseToolsConnection(String name, DatabaseToolsConnectionArgs args)
public DatabaseToolsConnection(String name, DatabaseToolsConnectionArgs args, CustomResourceOptions options)
type: oci:DatabaseTools:DatabaseToolsConnection
properties: # The arguments to resource properties.
options: # Bag of options to control resource's behavior.
Parameters
- name string
- The unique name of the resource.
- args DatabaseToolsConnectionArgs
- The arguments to resource properties.
- opts CustomResourceOptions
- Bag of options to control resource's behavior.
- resource_name str
- The unique name of the resource.
- args DatabaseToolsConnectionArgs
- The arguments to resource properties.
- opts ResourceOptions
- Bag of options to control resource's behavior.
- ctx Context
- Context object for the current deployment.
- name string
- The unique name of the resource.
- args DatabaseToolsConnectionArgs
- The arguments to resource properties.
- opts ResourceOption
- Bag of options to control resource's behavior.
- name string
- The unique name of the resource.
- args DatabaseToolsConnectionArgs
- The arguments to resource properties.
- opts CustomResourceOptions
- Bag of options to control resource's behavior.
- name String
- The unique name of the resource.
- args DatabaseToolsConnectionArgs
- 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 databaseToolsConnectionResource = new Oci.DatabaseTools.DatabaseToolsConnection("databaseToolsConnectionResource", new()
{
Type = "string",
CompartmentId = "string",
UserPassword = new Oci.DatabaseTools.Inputs.DatabaseToolsConnectionUserPasswordArgs
{
SecretId = "string",
ValueType = "string",
},
UserName = "string",
DisplayName = "string",
KeyStores = new[]
{
new Oci.DatabaseTools.Inputs.DatabaseToolsConnectionKeyStoreArgs
{
KeyStoreContent = new Oci.DatabaseTools.Inputs.DatabaseToolsConnectionKeyStoreKeyStoreContentArgs
{
ValueType = "string",
SecretId = "string",
},
KeyStorePassword = new Oci.DatabaseTools.Inputs.DatabaseToolsConnectionKeyStoreKeyStorePasswordArgs
{
ValueType = "string",
SecretId = "string",
},
KeyStoreType = "string",
},
},
FreeformTags =
{
{ "string", "string" },
},
Locks = new[]
{
new Oci.DatabaseTools.Inputs.DatabaseToolsConnectionLockArgs
{
Type = "string",
Message = "string",
RelatedResourceId = "string",
TimeCreated = "string",
},
},
PrivateEndpointId = "string",
ProxyClient = new Oci.DatabaseTools.Inputs.DatabaseToolsConnectionProxyClientArgs
{
ProxyAuthenticationType = "string",
Roles = new[]
{
"string",
},
UserName = "string",
UserPassword = new Oci.DatabaseTools.Inputs.DatabaseToolsConnectionProxyClientUserPasswordArgs
{
SecretId = "string",
ValueType = "string",
},
},
RelatedResource = new Oci.DatabaseTools.Inputs.DatabaseToolsConnectionRelatedResourceArgs
{
EntityType = "string",
Identifier = "string",
},
RuntimeSupport = "string",
AdvancedProperties =
{
{ "string", "string" },
},
Url = "string",
DefinedTags =
{
{ "string", "string" },
},
ConnectionString = "string",
});
example, err := DatabaseTools.NewDatabaseToolsConnection(ctx, "databaseToolsConnectionResource", &DatabaseTools.DatabaseToolsConnectionArgs{
Type: pulumi.String("string"),
CompartmentId: pulumi.String("string"),
UserPassword: &databasetools.DatabaseToolsConnectionUserPasswordArgs{
SecretId: pulumi.String("string"),
ValueType: pulumi.String("string"),
},
UserName: pulumi.String("string"),
DisplayName: pulumi.String("string"),
KeyStores: databasetools.DatabaseToolsConnectionKeyStoreArray{
&databasetools.DatabaseToolsConnectionKeyStoreArgs{
KeyStoreContent: &databasetools.DatabaseToolsConnectionKeyStoreKeyStoreContentArgs{
ValueType: pulumi.String("string"),
SecretId: pulumi.String("string"),
},
KeyStorePassword: &databasetools.DatabaseToolsConnectionKeyStoreKeyStorePasswordArgs{
ValueType: pulumi.String("string"),
SecretId: pulumi.String("string"),
},
KeyStoreType: pulumi.String("string"),
},
},
FreeformTags: pulumi.StringMap{
"string": pulumi.String("string"),
},
Locks: databasetools.DatabaseToolsConnectionLockArray{
&databasetools.DatabaseToolsConnectionLockArgs{
Type: pulumi.String("string"),
Message: pulumi.String("string"),
RelatedResourceId: pulumi.String("string"),
TimeCreated: pulumi.String("string"),
},
},
PrivateEndpointId: pulumi.String("string"),
ProxyClient: &databasetools.DatabaseToolsConnectionProxyClientArgs{
ProxyAuthenticationType: pulumi.String("string"),
Roles: pulumi.StringArray{
pulumi.String("string"),
},
UserName: pulumi.String("string"),
UserPassword: &databasetools.DatabaseToolsConnectionProxyClientUserPasswordArgs{
SecretId: pulumi.String("string"),
ValueType: pulumi.String("string"),
},
},
RelatedResource: &databasetools.DatabaseToolsConnectionRelatedResourceArgs{
EntityType: pulumi.String("string"),
Identifier: pulumi.String("string"),
},
RuntimeSupport: pulumi.String("string"),
AdvancedProperties: pulumi.StringMap{
"string": pulumi.String("string"),
},
Url: pulumi.String("string"),
DefinedTags: pulumi.StringMap{
"string": pulumi.String("string"),
},
ConnectionString: pulumi.String("string"),
})
var databaseToolsConnectionResource = new DatabaseToolsConnection("databaseToolsConnectionResource", DatabaseToolsConnectionArgs.builder()
.type("string")
.compartmentId("string")
.userPassword(DatabaseToolsConnectionUserPasswordArgs.builder()
.secretId("string")
.valueType("string")
.build())
.userName("string")
.displayName("string")
.keyStores(DatabaseToolsConnectionKeyStoreArgs.builder()
.keyStoreContent(DatabaseToolsConnectionKeyStoreKeyStoreContentArgs.builder()
.valueType("string")
.secretId("string")
.build())
.keyStorePassword(DatabaseToolsConnectionKeyStoreKeyStorePasswordArgs.builder()
.valueType("string")
.secretId("string")
.build())
.keyStoreType("string")
.build())
.freeformTags(Map.of("string", "string"))
.locks(DatabaseToolsConnectionLockArgs.builder()
.type("string")
.message("string")
.relatedResourceId("string")
.timeCreated("string")
.build())
.privateEndpointId("string")
.proxyClient(DatabaseToolsConnectionProxyClientArgs.builder()
.proxyAuthenticationType("string")
.roles("string")
.userName("string")
.userPassword(DatabaseToolsConnectionProxyClientUserPasswordArgs.builder()
.secretId("string")
.valueType("string")
.build())
.build())
.relatedResource(DatabaseToolsConnectionRelatedResourceArgs.builder()
.entityType("string")
.identifier("string")
.build())
.runtimeSupport("string")
.advancedProperties(Map.of("string", "string"))
.url("string")
.definedTags(Map.of("string", "string"))
.connectionString("string")
.build());
database_tools_connection_resource = oci.database_tools.DatabaseToolsConnection("databaseToolsConnectionResource",
type="string",
compartment_id="string",
user_password={
"secret_id": "string",
"value_type": "string",
},
user_name="string",
display_name="string",
key_stores=[{
"key_store_content": {
"value_type": "string",
"secret_id": "string",
},
"key_store_password": {
"value_type": "string",
"secret_id": "string",
},
"key_store_type": "string",
}],
freeform_tags={
"string": "string",
},
locks=[{
"type": "string",
"message": "string",
"related_resource_id": "string",
"time_created": "string",
}],
private_endpoint_id="string",
proxy_client={
"proxy_authentication_type": "string",
"roles": ["string"],
"user_name": "string",
"user_password": {
"secret_id": "string",
"value_type": "string",
},
},
related_resource={
"entity_type": "string",
"identifier": "string",
},
runtime_support="string",
advanced_properties={
"string": "string",
},
url="string",
defined_tags={
"string": "string",
},
connection_string="string")
const databaseToolsConnectionResource = new oci.databasetools.DatabaseToolsConnection("databaseToolsConnectionResource", {
type: "string",
compartmentId: "string",
userPassword: {
secretId: "string",
valueType: "string",
},
userName: "string",
displayName: "string",
keyStores: [{
keyStoreContent: {
valueType: "string",
secretId: "string",
},
keyStorePassword: {
valueType: "string",
secretId: "string",
},
keyStoreType: "string",
}],
freeformTags: {
string: "string",
},
locks: [{
type: "string",
message: "string",
relatedResourceId: "string",
timeCreated: "string",
}],
privateEndpointId: "string",
proxyClient: {
proxyAuthenticationType: "string",
roles: ["string"],
userName: "string",
userPassword: {
secretId: "string",
valueType: "string",
},
},
relatedResource: {
entityType: "string",
identifier: "string",
},
runtimeSupport: "string",
advancedProperties: {
string: "string",
},
url: "string",
definedTags: {
string: "string",
},
connectionString: "string",
});
type: oci:DatabaseTools:DatabaseToolsConnection
properties:
advancedProperties:
string: string
compartmentId: string
connectionString: string
definedTags:
string: string
displayName: string
freeformTags:
string: string
keyStores:
- keyStoreContent:
secretId: string
valueType: string
keyStorePassword:
secretId: string
valueType: string
keyStoreType: string
locks:
- message: string
relatedResourceId: string
timeCreated: string
type: string
privateEndpointId: string
proxyClient:
proxyAuthenticationType: string
roles:
- string
userName: string
userPassword:
secretId: string
valueType: string
relatedResource:
entityType: string
identifier: string
runtimeSupport: string
type: string
url: string
userName: string
userPassword:
secretId: string
valueType: string
DatabaseToolsConnection 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 DatabaseToolsConnection resource accepts the following input properties:
- Compartment
Id string - (Updatable) The OCID of the compartment containing the Database Tools connection.
- Display
Name string - (Updatable) A user-friendly name. Does not have to be unique, and it's changeable. Avoid entering confidential information.
- Type string
- (Updatable) The DatabaseToolsConnection type.
- User
Name string - (Updatable) The database user name.
- User
Password DatabaseTools Connection User Password - (Updatable) The user password.
- Advanced
Properties Dictionary<string, string> - (Updatable) The advanced connection properties key-value pair (e.g.,
oracle.net.ssl_server_dn_match
). - Connection
String string - (Updatable) The connect descriptor or Easy Connect Naming method use to connect to the database.
- Dictionary<string, string>
- (Updatable) Defined tags for this resource. Each key is predefined and scoped to a namespace. Example:
{"foo-namespace.bar-key": "value"}
- Dictionary<string, string>
- (Updatable) Simple key-value pair that is applied without any predefined name, type or scope. Exists for cross-compatibility only. Example:
{"bar-key": "value"}
- Key
Stores List<DatabaseTools Connection Key Store> - (Updatable) Oracle wallet or Java Keystores containing trusted certificates for authenticating the server's public certificate and the client private key and associated certificates required for client authentication.
- Locks
List<Database
Tools Connection Lock> - Locks associated with this resource.
- Private
Endpoint stringId - (Updatable) The OCID of the Database Tools private endpoint used to access the database in the customer VCN.
- Proxy
Client DatabaseTools Connection Proxy Client - (Updatable) The proxy client information.
- Database
Tools Connection Related Resource - (Updatable) The related resource
- Runtime
Support string - Specifies whether this connection is supported by the Database Tools Runtime.
- Url string
- (Updatable) The JDBC URL used to connect to the Generic JDBC database system.
- Compartment
Id string - (Updatable) The OCID of the compartment containing the Database Tools connection.
- Display
Name string - (Updatable) A user-friendly name. Does not have to be unique, and it's changeable. Avoid entering confidential information.
- Type string
- (Updatable) The DatabaseToolsConnection type.
- User
Name string - (Updatable) The database user name.
- User
Password DatabaseTools Connection User Password Args - (Updatable) The user password.
- Advanced
Properties map[string]string - (Updatable) The advanced connection properties key-value pair (e.g.,
oracle.net.ssl_server_dn_match
). - Connection
String string - (Updatable) The connect descriptor or Easy Connect Naming method use to connect to the database.
- map[string]string
- (Updatable) Defined tags for this resource. Each key is predefined and scoped to a namespace. Example:
{"foo-namespace.bar-key": "value"}
- map[string]string
- (Updatable) Simple key-value pair that is applied without any predefined name, type or scope. Exists for cross-compatibility only. Example:
{"bar-key": "value"}
- Key
Stores []DatabaseTools Connection Key Store Args - (Updatable) Oracle wallet or Java Keystores containing trusted certificates for authenticating the server's public certificate and the client private key and associated certificates required for client authentication.
- Locks
[]Database
Tools Connection Lock Args - Locks associated with this resource.
- Private
Endpoint stringId - (Updatable) The OCID of the Database Tools private endpoint used to access the database in the customer VCN.
- Proxy
Client DatabaseTools Connection Proxy Client Args - (Updatable) The proxy client information.
- Database
Tools Connection Related Resource Args - (Updatable) The related resource
- Runtime
Support string - Specifies whether this connection is supported by the Database Tools Runtime.
- Url string
- (Updatable) The JDBC URL used to connect to the Generic JDBC database system.
- compartment
Id String - (Updatable) The OCID of the compartment containing the Database Tools connection.
- display
Name String - (Updatable) A user-friendly name. Does not have to be unique, and it's changeable. Avoid entering confidential information.
- type String
- (Updatable) The DatabaseToolsConnection type.
- user
Name String - (Updatable) The database user name.
- user
Password ConnectionUser Password - (Updatable) The user password.
- advanced
Properties Map<String,String> - (Updatable) The advanced connection properties key-value pair (e.g.,
oracle.net.ssl_server_dn_match
). - connection
String String - (Updatable) The connect descriptor or Easy Connect Naming method use to connect to the database.
- Map<String,String>
- (Updatable) Defined tags for this resource. Each key is predefined and scoped to a namespace. Example:
{"foo-namespace.bar-key": "value"}
- Map<String,String>
- (Updatable) Simple key-value pair that is applied without any predefined name, type or scope. Exists for cross-compatibility only. Example:
{"bar-key": "value"}
- key
Stores List<ConnectionKey Store> - (Updatable) Oracle wallet or Java Keystores containing trusted certificates for authenticating the server's public certificate and the client private key and associated certificates required for client authentication.
- locks
List<Connection
Lock> - Locks associated with this resource.
- private
Endpoint StringId - (Updatable) The OCID of the Database Tools private endpoint used to access the database in the customer VCN.
- proxy
Client ConnectionProxy Client - (Updatable) The proxy client information.
- Connection
Related Resource - (Updatable) The related resource
- runtime
Support String - Specifies whether this connection is supported by the Database Tools Runtime.
- url String
- (Updatable) The JDBC URL used to connect to the Generic JDBC database system.
- compartment
Id string - (Updatable) The OCID of the compartment containing the Database Tools connection.
- display
Name string - (Updatable) A user-friendly name. Does not have to be unique, and it's changeable. Avoid entering confidential information.
- type string
- (Updatable) The DatabaseToolsConnection type.
- user
Name string - (Updatable) The database user name.
- user
Password DatabaseTools Connection User Password - (Updatable) The user password.
- advanced
Properties {[key: string]: string} - (Updatable) The advanced connection properties key-value pair (e.g.,
oracle.net.ssl_server_dn_match
). - connection
String string - (Updatable) The connect descriptor or Easy Connect Naming method use to connect to the database.
- {[key: string]: string}
- (Updatable) Defined tags for this resource. Each key is predefined and scoped to a namespace. Example:
{"foo-namespace.bar-key": "value"}
- {[key: string]: string}
- (Updatable) Simple key-value pair that is applied without any predefined name, type or scope. Exists for cross-compatibility only. Example:
{"bar-key": "value"}
- key
Stores DatabaseTools Connection Key Store[] - (Updatable) Oracle wallet or Java Keystores containing trusted certificates for authenticating the server's public certificate and the client private key and associated certificates required for client authentication.
- locks
Database
Tools Connection Lock[] - Locks associated with this resource.
- private
Endpoint stringId - (Updatable) The OCID of the Database Tools private endpoint used to access the database in the customer VCN.
- proxy
Client DatabaseTools Connection Proxy Client - (Updatable) The proxy client information.
- Database
Tools Connection Related Resource - (Updatable) The related resource
- runtime
Support string - Specifies whether this connection is supported by the Database Tools Runtime.
- url string
- (Updatable) The JDBC URL used to connect to the Generic JDBC database system.
- compartment_
id str - (Updatable) The OCID of the compartment containing the Database Tools connection.
- display_
name str - (Updatable) A user-friendly name. Does not have to be unique, and it's changeable. Avoid entering confidential information.
- type str
- (Updatable) The DatabaseToolsConnection type.
- user_
name str - (Updatable) The database user name.
- user_
password databasetools.Database Tools Connection User Password Args - (Updatable) The user password.
- advanced_
properties Mapping[str, str] - (Updatable) The advanced connection properties key-value pair (e.g.,
oracle.net.ssl_server_dn_match
). - connection_
string str - (Updatable) The connect descriptor or Easy Connect Naming method use to connect to the database.
- Mapping[str, str]
- (Updatable) Defined tags for this resource. Each key is predefined and scoped to a namespace. Example:
{"foo-namespace.bar-key": "value"}
- Mapping[str, str]
- (Updatable) Simple key-value pair that is applied without any predefined name, type or scope. Exists for cross-compatibility only. Example:
{"bar-key": "value"}
- key_
stores Sequence[databasetools.Database Tools Connection Key Store Args] - (Updatable) Oracle wallet or Java Keystores containing trusted certificates for authenticating the server's public certificate and the client private key and associated certificates required for client authentication.
- locks
Sequence[databasetools.
Database Tools Connection Lock Args] - Locks associated with this resource.
- private_
endpoint_ strid - (Updatable) The OCID of the Database Tools private endpoint used to access the database in the customer VCN.
- proxy_
client databasetools.Database Tools Connection Proxy Client Args - (Updatable) The proxy client information.
- databasetools.
Database Tools Connection Related Resource Args - (Updatable) The related resource
- runtime_
support str - Specifies whether this connection is supported by the Database Tools Runtime.
- url str
- (Updatable) The JDBC URL used to connect to the Generic JDBC database system.
- compartment
Id String - (Updatable) The OCID of the compartment containing the Database Tools connection.
- display
Name String - (Updatable) A user-friendly name. Does not have to be unique, and it's changeable. Avoid entering confidential information.
- type String
- (Updatable) The DatabaseToolsConnection type.
- user
Name String - (Updatable) The database user name.
- user
Password Property Map - (Updatable) The user password.
- advanced
Properties Map<String> - (Updatable) The advanced connection properties key-value pair (e.g.,
oracle.net.ssl_server_dn_match
). - connection
String String - (Updatable) The connect descriptor or Easy Connect Naming method use to connect to the database.
- Map<String>
- (Updatable) Defined tags for this resource. Each key is predefined and scoped to a namespace. Example:
{"foo-namespace.bar-key": "value"}
- Map<String>
- (Updatable) Simple key-value pair that is applied without any predefined name, type or scope. Exists for cross-compatibility only. Example:
{"bar-key": "value"}
- key
Stores List<Property Map> - (Updatable) Oracle wallet or Java Keystores containing trusted certificates for authenticating the server's public certificate and the client private key and associated certificates required for client authentication.
- locks List<Property Map>
- Locks associated with this resource.
- private
Endpoint StringId - (Updatable) The OCID of the Database Tools private endpoint used to access the database in the customer VCN.
- proxy
Client Property Map - (Updatable) The proxy client information.
- Property Map
- (Updatable) The related resource
- runtime
Support String - Specifies whether this connection is supported by the Database Tools Runtime.
- url String
- (Updatable) The JDBC URL used to connect to the Generic JDBC database system.
Outputs
All input properties are implicitly available as output properties. Additionally, the DatabaseToolsConnection resource produces the following output properties:
- Id string
- The provider-assigned unique ID for this managed resource.
- Lifecycle
Details string - A message describing the current state in more detail. For example, this message can be used to provide actionable information for a resource in the Failed state.
- State string
- The current state of the Database Tools connection.
- Dictionary<string, string>
- Usage of system tag keys. These predefined keys are scoped to namespaces. Example:
{"orcl-cloud.free-tier-retained": "true"}
- Time
Created string - The time the Database Tools connection was created. An RFC3339 formatted datetime string.
- Time
Updated string - The time the DatabaseToolsConnection was updated. An RFC3339 formatted datetime string.
- Id string
- The provider-assigned unique ID for this managed resource.
- Lifecycle
Details string - A message describing the current state in more detail. For example, this message can be used to provide actionable information for a resource in the Failed state.
- State string
- The current state of the Database Tools connection.
- map[string]string
- Usage of system tag keys. These predefined keys are scoped to namespaces. Example:
{"orcl-cloud.free-tier-retained": "true"}
- Time
Created string - The time the Database Tools connection was created. An RFC3339 formatted datetime string.
- Time
Updated string - The time the DatabaseToolsConnection was updated. An RFC3339 formatted datetime string.
- id String
- The provider-assigned unique ID for this managed resource.
- lifecycle
Details String - A message describing the current state in more detail. For example, this message can be used to provide actionable information for a resource in the Failed state.
- state String
- The current state of the Database Tools connection.
- Map<String,String>
- Usage of system tag keys. These predefined keys are scoped to namespaces. Example:
{"orcl-cloud.free-tier-retained": "true"}
- time
Created String - The time the Database Tools connection was created. An RFC3339 formatted datetime string.
- time
Updated String - The time the DatabaseToolsConnection was updated. An RFC3339 formatted datetime string.
- id string
- The provider-assigned unique ID for this managed resource.
- lifecycle
Details string - A message describing the current state in more detail. For example, this message can be used to provide actionable information for a resource in the Failed state.
- state string
- The current state of the Database Tools connection.
- {[key: string]: string}
- Usage of system tag keys. These predefined keys are scoped to namespaces. Example:
{"orcl-cloud.free-tier-retained": "true"}
- time
Created string - The time the Database Tools connection was created. An RFC3339 formatted datetime string.
- time
Updated string - The time the DatabaseToolsConnection was updated. An RFC3339 formatted datetime string.
- id str
- The provider-assigned unique ID for this managed resource.
- lifecycle_
details str - A message describing the current state in more detail. For example, this message can be used to provide actionable information for a resource in the Failed state.
- state str
- The current state of the Database Tools connection.
- Mapping[str, str]
- Usage of system tag keys. These predefined keys are scoped to namespaces. Example:
{"orcl-cloud.free-tier-retained": "true"}
- time_
created str - The time the Database Tools connection was created. An RFC3339 formatted datetime string.
- time_
updated str - The time the DatabaseToolsConnection was updated. An RFC3339 formatted datetime string.
- id String
- The provider-assigned unique ID for this managed resource.
- lifecycle
Details String - A message describing the current state in more detail. For example, this message can be used to provide actionable information for a resource in the Failed state.
- state String
- The current state of the Database Tools connection.
- Map<String>
- Usage of system tag keys. These predefined keys are scoped to namespaces. Example:
{"orcl-cloud.free-tier-retained": "true"}
- time
Created String - The time the Database Tools connection was created. An RFC3339 formatted datetime string.
- time
Updated String - The time the DatabaseToolsConnection was updated. An RFC3339 formatted datetime string.
Look up Existing DatabaseToolsConnection Resource
Get an existing DatabaseToolsConnection 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?: DatabaseToolsConnectionState, opts?: CustomResourceOptions): DatabaseToolsConnection
@staticmethod
def get(resource_name: str,
id: str,
opts: Optional[ResourceOptions] = None,
advanced_properties: Optional[Mapping[str, str]] = None,
compartment_id: Optional[str] = None,
connection_string: Optional[str] = None,
defined_tags: Optional[Mapping[str, str]] = None,
display_name: Optional[str] = None,
freeform_tags: Optional[Mapping[str, str]] = None,
key_stores: Optional[Sequence[_databasetools.DatabaseToolsConnectionKeyStoreArgs]] = None,
lifecycle_details: Optional[str] = None,
locks: Optional[Sequence[_databasetools.DatabaseToolsConnectionLockArgs]] = None,
private_endpoint_id: Optional[str] = None,
proxy_client: Optional[_databasetools.DatabaseToolsConnectionProxyClientArgs] = None,
related_resource: Optional[_databasetools.DatabaseToolsConnectionRelatedResourceArgs] = None,
runtime_support: Optional[str] = None,
state: Optional[str] = None,
system_tags: Optional[Mapping[str, str]] = None,
time_created: Optional[str] = None,
time_updated: Optional[str] = None,
type: Optional[str] = None,
url: Optional[str] = None,
user_name: Optional[str] = None,
user_password: Optional[_databasetools.DatabaseToolsConnectionUserPasswordArgs] = None) -> DatabaseToolsConnection
func GetDatabaseToolsConnection(ctx *Context, name string, id IDInput, state *DatabaseToolsConnectionState, opts ...ResourceOption) (*DatabaseToolsConnection, error)
public static DatabaseToolsConnection Get(string name, Input<string> id, DatabaseToolsConnectionState? state, CustomResourceOptions? opts = null)
public static DatabaseToolsConnection get(String name, Output<String> id, DatabaseToolsConnectionState state, CustomResourceOptions options)
Resource lookup is not supported in YAML
- name
- The unique name of the resulting resource.
- id
- 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
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- name
- The unique name of the resulting resource.
- id
- 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
- The unique name of the resulting resource.
- id
- 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
- The unique name of the resulting resource.
- id
- 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.
- Advanced
Properties Dictionary<string, string> - (Updatable) The advanced connection properties key-value pair (e.g.,
oracle.net.ssl_server_dn_match
). - Compartment
Id string - (Updatable) The OCID of the compartment containing the Database Tools connection.
- Connection
String string - (Updatable) The connect descriptor or Easy Connect Naming method use to connect to the database.
- Dictionary<string, string>
- (Updatable) Defined tags for this resource. Each key is predefined and scoped to a namespace. Example:
{"foo-namespace.bar-key": "value"}
- Display
Name string - (Updatable) A user-friendly name. Does not have to be unique, and it's changeable. Avoid entering confidential information.
- Dictionary<string, string>
- (Updatable) Simple key-value pair that is applied without any predefined name, type or scope. Exists for cross-compatibility only. Example:
{"bar-key": "value"}
- Key
Stores List<DatabaseTools Connection Key Store> - (Updatable) Oracle wallet or Java Keystores containing trusted certificates for authenticating the server's public certificate and the client private key and associated certificates required for client authentication.
- Lifecycle
Details string - A message describing the current state in more detail. For example, this message can be used to provide actionable information for a resource in the Failed state.
- Locks
List<Database
Tools Connection Lock> - Locks associated with this resource.
- Private
Endpoint stringId - (Updatable) The OCID of the Database Tools private endpoint used to access the database in the customer VCN.
- Proxy
Client DatabaseTools Connection Proxy Client - (Updatable) The proxy client information.
- Database
Tools Connection Related Resource - (Updatable) The related resource
- Runtime
Support string - Specifies whether this connection is supported by the Database Tools Runtime.
- State string
- The current state of the Database Tools connection.
- Dictionary<string, string>
- Usage of system tag keys. These predefined keys are scoped to namespaces. Example:
{"orcl-cloud.free-tier-retained": "true"}
- Time
Created string - The time the Database Tools connection was created. An RFC3339 formatted datetime string.
- Time
Updated string - The time the DatabaseToolsConnection was updated. An RFC3339 formatted datetime string.
- Type string
- (Updatable) The DatabaseToolsConnection type.
- Url string
- (Updatable) The JDBC URL used to connect to the Generic JDBC database system.
- User
Name string - (Updatable) The database user name.
- User
Password DatabaseTools Connection User Password - (Updatable) The user password.
- Advanced
Properties map[string]string - (Updatable) The advanced connection properties key-value pair (e.g.,
oracle.net.ssl_server_dn_match
). - Compartment
Id string - (Updatable) The OCID of the compartment containing the Database Tools connection.
- Connection
String string - (Updatable) The connect descriptor or Easy Connect Naming method use to connect to the database.
- map[string]string
- (Updatable) Defined tags for this resource. Each key is predefined and scoped to a namespace. Example:
{"foo-namespace.bar-key": "value"}
- Display
Name string - (Updatable) A user-friendly name. Does not have to be unique, and it's changeable. Avoid entering confidential information.
- map[string]string
- (Updatable) Simple key-value pair that is applied without any predefined name, type or scope. Exists for cross-compatibility only. Example:
{"bar-key": "value"}
- Key
Stores []DatabaseTools Connection Key Store Args - (Updatable) Oracle wallet or Java Keystores containing trusted certificates for authenticating the server's public certificate and the client private key and associated certificates required for client authentication.
- Lifecycle
Details string - A message describing the current state in more detail. For example, this message can be used to provide actionable information for a resource in the Failed state.
- Locks
[]Database
Tools Connection Lock Args - Locks associated with this resource.
- Private
Endpoint stringId - (Updatable) The OCID of the Database Tools private endpoint used to access the database in the customer VCN.
- Proxy
Client DatabaseTools Connection Proxy Client Args - (Updatable) The proxy client information.
- Database
Tools Connection Related Resource Args - (Updatable) The related resource
- Runtime
Support string - Specifies whether this connection is supported by the Database Tools Runtime.
- State string
- The current state of the Database Tools connection.
- map[string]string
- Usage of system tag keys. These predefined keys are scoped to namespaces. Example:
{"orcl-cloud.free-tier-retained": "true"}
- Time
Created string - The time the Database Tools connection was created. An RFC3339 formatted datetime string.
- Time
Updated string - The time the DatabaseToolsConnection was updated. An RFC3339 formatted datetime string.
- Type string
- (Updatable) The DatabaseToolsConnection type.
- Url string
- (Updatable) The JDBC URL used to connect to the Generic JDBC database system.
- User
Name string - (Updatable) The database user name.
- User
Password DatabaseTools Connection User Password Args - (Updatable) The user password.
- advanced
Properties Map<String,String> - (Updatable) The advanced connection properties key-value pair (e.g.,
oracle.net.ssl_server_dn_match
). - compartment
Id String - (Updatable) The OCID of the compartment containing the Database Tools connection.
- connection
String String - (Updatable) The connect descriptor or Easy Connect Naming method use to connect to the database.
- Map<String,String>
- (Updatable) Defined tags for this resource. Each key is predefined and scoped to a namespace. Example:
{"foo-namespace.bar-key": "value"}
- display
Name String - (Updatable) A user-friendly name. Does not have to be unique, and it's changeable. Avoid entering confidential information.
- Map<String,String>
- (Updatable) Simple key-value pair that is applied without any predefined name, type or scope. Exists for cross-compatibility only. Example:
{"bar-key": "value"}
- key
Stores List<ConnectionKey Store> - (Updatable) Oracle wallet or Java Keystores containing trusted certificates for authenticating the server's public certificate and the client private key and associated certificates required for client authentication.
- lifecycle
Details String - A message describing the current state in more detail. For example, this message can be used to provide actionable information for a resource in the Failed state.
- locks
List<Connection
Lock> - Locks associated with this resource.
- private
Endpoint StringId - (Updatable) The OCID of the Database Tools private endpoint used to access the database in the customer VCN.
- proxy
Client ConnectionProxy Client - (Updatable) The proxy client information.
- Connection
Related Resource - (Updatable) The related resource
- runtime
Support String - Specifies whether this connection is supported by the Database Tools Runtime.
- state String
- The current state of the Database Tools connection.
- Map<String,String>
- Usage of system tag keys. These predefined keys are scoped to namespaces. Example:
{"orcl-cloud.free-tier-retained": "true"}
- time
Created String - The time the Database Tools connection was created. An RFC3339 formatted datetime string.
- time
Updated String - The time the DatabaseToolsConnection was updated. An RFC3339 formatted datetime string.
- type String
- (Updatable) The DatabaseToolsConnection type.
- url String
- (Updatable) The JDBC URL used to connect to the Generic JDBC database system.
- user
Name String - (Updatable) The database user name.
- user
Password ConnectionUser Password - (Updatable) The user password.
- advanced
Properties {[key: string]: string} - (Updatable) The advanced connection properties key-value pair (e.g.,
oracle.net.ssl_server_dn_match
). - compartment
Id string - (Updatable) The OCID of the compartment containing the Database Tools connection.
- connection
String string - (Updatable) The connect descriptor or Easy Connect Naming method use to connect to the database.
- {[key: string]: string}
- (Updatable) Defined tags for this resource. Each key is predefined and scoped to a namespace. Example:
{"foo-namespace.bar-key": "value"}
- display
Name string - (Updatable) A user-friendly name. Does not have to be unique, and it's changeable. Avoid entering confidential information.
- {[key: string]: string}
- (Updatable) Simple key-value pair that is applied without any predefined name, type or scope. Exists for cross-compatibility only. Example:
{"bar-key": "value"}
- key
Stores DatabaseTools Connection Key Store[] - (Updatable) Oracle wallet or Java Keystores containing trusted certificates for authenticating the server's public certificate and the client private key and associated certificates required for client authentication.
- lifecycle
Details string - A message describing the current state in more detail. For example, this message can be used to provide actionable information for a resource in the Failed state.
- locks
Database
Tools Connection Lock[] - Locks associated with this resource.
- private
Endpoint stringId - (Updatable) The OCID of the Database Tools private endpoint used to access the database in the customer VCN.
- proxy
Client DatabaseTools Connection Proxy Client - (Updatable) The proxy client information.
- Database
Tools Connection Related Resource - (Updatable) The related resource
- runtime
Support string - Specifies whether this connection is supported by the Database Tools Runtime.
- state string
- The current state of the Database Tools connection.
- {[key: string]: string}
- Usage of system tag keys. These predefined keys are scoped to namespaces. Example:
{"orcl-cloud.free-tier-retained": "true"}
- time
Created string - The time the Database Tools connection was created. An RFC3339 formatted datetime string.
- time
Updated string - The time the DatabaseToolsConnection was updated. An RFC3339 formatted datetime string.
- type string
- (Updatable) The DatabaseToolsConnection type.
- url string
- (Updatable) The JDBC URL used to connect to the Generic JDBC database system.
- user
Name string - (Updatable) The database user name.
- user
Password DatabaseTools Connection User Password - (Updatable) The user password.
- advanced_
properties Mapping[str, str] - (Updatable) The advanced connection properties key-value pair (e.g.,
oracle.net.ssl_server_dn_match
). - compartment_
id str - (Updatable) The OCID of the compartment containing the Database Tools connection.
- connection_
string str - (Updatable) The connect descriptor or Easy Connect Naming method use to connect to the database.
- Mapping[str, str]
- (Updatable) Defined tags for this resource. Each key is predefined and scoped to a namespace. Example:
{"foo-namespace.bar-key": "value"}
- display_
name str - (Updatable) A user-friendly name. Does not have to be unique, and it's changeable. Avoid entering confidential information.
- Mapping[str, str]
- (Updatable) Simple key-value pair that is applied without any predefined name, type or scope. Exists for cross-compatibility only. Example:
{"bar-key": "value"}
- key_
stores Sequence[databasetools.Database Tools Connection Key Store Args] - (Updatable) Oracle wallet or Java Keystores containing trusted certificates for authenticating the server's public certificate and the client private key and associated certificates required for client authentication.
- lifecycle_
details str - A message describing the current state in more detail. For example, this message can be used to provide actionable information for a resource in the Failed state.
- locks
Sequence[databasetools.
Database Tools Connection Lock Args] - Locks associated with this resource.
- private_
endpoint_ strid - (Updatable) The OCID of the Database Tools private endpoint used to access the database in the customer VCN.
- proxy_
client databasetools.Database Tools Connection Proxy Client Args - (Updatable) The proxy client information.
- databasetools.
Database Tools Connection Related Resource Args - (Updatable) The related resource
- runtime_
support str - Specifies whether this connection is supported by the Database Tools Runtime.
- state str
- The current state of the Database Tools connection.
- Mapping[str, str]
- Usage of system tag keys. These predefined keys are scoped to namespaces. Example:
{"orcl-cloud.free-tier-retained": "true"}
- time_
created str - The time the Database Tools connection was created. An RFC3339 formatted datetime string.
- time_
updated str - The time the DatabaseToolsConnection was updated. An RFC3339 formatted datetime string.
- type str
- (Updatable) The DatabaseToolsConnection type.
- url str
- (Updatable) The JDBC URL used to connect to the Generic JDBC database system.
- user_
name str - (Updatable) The database user name.
- user_
password databasetools.Database Tools Connection User Password Args - (Updatable) The user password.
- advanced
Properties Map<String> - (Updatable) The advanced connection properties key-value pair (e.g.,
oracle.net.ssl_server_dn_match
). - compartment
Id String - (Updatable) The OCID of the compartment containing the Database Tools connection.
- connection
String String - (Updatable) The connect descriptor or Easy Connect Naming method use to connect to the database.
- Map<String>
- (Updatable) Defined tags for this resource. Each key is predefined and scoped to a namespace. Example:
{"foo-namespace.bar-key": "value"}
- display
Name String - (Updatable) A user-friendly name. Does not have to be unique, and it's changeable. Avoid entering confidential information.
- Map<String>
- (Updatable) Simple key-value pair that is applied without any predefined name, type or scope. Exists for cross-compatibility only. Example:
{"bar-key": "value"}
- key
Stores List<Property Map> - (Updatable) Oracle wallet or Java Keystores containing trusted certificates for authenticating the server's public certificate and the client private key and associated certificates required for client authentication.
- lifecycle
Details String - A message describing the current state in more detail. For example, this message can be used to provide actionable information for a resource in the Failed state.
- locks List<Property Map>
- Locks associated with this resource.
- private
Endpoint StringId - (Updatable) The OCID of the Database Tools private endpoint used to access the database in the customer VCN.
- proxy
Client Property Map - (Updatable) The proxy client information.
- Property Map
- (Updatable) The related resource
- runtime
Support String - Specifies whether this connection is supported by the Database Tools Runtime.
- state String
- The current state of the Database Tools connection.
- Map<String>
- Usage of system tag keys. These predefined keys are scoped to namespaces. Example:
{"orcl-cloud.free-tier-retained": "true"}
- time
Created String - The time the Database Tools connection was created. An RFC3339 formatted datetime string.
- time
Updated String - The time the DatabaseToolsConnection was updated. An RFC3339 formatted datetime string.
- type String
- (Updatable) The DatabaseToolsConnection type.
- url String
- (Updatable) The JDBC URL used to connect to the Generic JDBC database system.
- user
Name String - (Updatable) The database user name.
- user
Password Property Map - (Updatable) The user password.
Supporting Types
DatabaseToolsConnectionKeyStore, DatabaseToolsConnectionKeyStoreArgs
- Key
Store DatabaseContent Tools Connection Key Store Key Store Content - (Updatable) The key store content.
- Key
Store DatabasePassword Tools Connection Key Store Key Store Password - (Updatable) The key store password.
- Key
Store stringType - (Updatable) The key store type.
- Key
Store DatabaseContent Tools Connection Key Store Key Store Content - (Updatable) The key store content.
- Key
Store DatabasePassword Tools Connection Key Store Key Store Password - (Updatable) The key store password.
- Key
Store stringType - (Updatable) The key store type.
- key
Store ConnectionContent Key Store Key Store Content - (Updatable) The key store content.
- key
Store ConnectionPassword Key Store Key Store Password - (Updatable) The key store password.
- key
Store StringType - (Updatable) The key store type.
- key
Store DatabaseContent Tools Connection Key Store Key Store Content - (Updatable) The key store content.
- key
Store DatabasePassword Tools Connection Key Store Key Store Password - (Updatable) The key store password.
- key
Store stringType - (Updatable) The key store type.
- key_
store_ databasetools.content Database Tools Connection Key Store Key Store Content - (Updatable) The key store content.
- key_
store_ databasetools.password Database Tools Connection Key Store Key Store Password - (Updatable) The key store password.
- key_
store_ strtype - (Updatable) The key store type.
- key
Store Property MapContent - (Updatable) The key store content.
- key
Store Property MapPassword - (Updatable) The key store password.
- key
Store StringType - (Updatable) The key store type.
DatabaseToolsConnectionKeyStoreKeyStoreContent, DatabaseToolsConnectionKeyStoreKeyStoreContentArgs
- value_
type str - (Updatable) The value type of the key store content.
- secret_
id str - (Updatable) The OCID of the secret containing the key store.
DatabaseToolsConnectionKeyStoreKeyStorePassword, DatabaseToolsConnectionKeyStoreKeyStorePasswordArgs
- value_
type str - (Updatable) The value type of the key store password.
- secret_
id str - (Updatable) The OCID of the secret containing the key store password.
DatabaseToolsConnectionLock, DatabaseToolsConnectionLockArgs
- Type string
- Type of the lock.
- Message string
- A message added by the creator of the lock. This is typically used to give an indication of why the resource is locked.
- string
- The id of the resource that is locking this resource. Indicates that deleting this resource will remove the lock.
- Time
Created string - When the lock was created.
- Type string
- Type of the lock.
- Message string
- A message added by the creator of the lock. This is typically used to give an indication of why the resource is locked.
- string
- The id of the resource that is locking this resource. Indicates that deleting this resource will remove the lock.
- Time
Created string - When the lock was created.
- type String
- Type of the lock.
- message String
- A message added by the creator of the lock. This is typically used to give an indication of why the resource is locked.
- String
- The id of the resource that is locking this resource. Indicates that deleting this resource will remove the lock.
- time
Created String - When the lock was created.
- type string
- Type of the lock.
- message string
- A message added by the creator of the lock. This is typically used to give an indication of why the resource is locked.
- string
- The id of the resource that is locking this resource. Indicates that deleting this resource will remove the lock.
- time
Created string - When the lock was created.
- type str
- Type of the lock.
- message str
- A message added by the creator of the lock. This is typically used to give an indication of why the resource is locked.
- str
- The id of the resource that is locking this resource. Indicates that deleting this resource will remove the lock.
- time_
created str - When the lock was created.
- type String
- Type of the lock.
- message String
- A message added by the creator of the lock. This is typically used to give an indication of why the resource is locked.
- String
- The id of the resource that is locking this resource. Indicates that deleting this resource will remove the lock.
- time
Created String - When the lock was created.
DatabaseToolsConnectionProxyClient, DatabaseToolsConnectionProxyClientArgs
- Proxy
Authentication stringType - (Updatable) The proxy authentication type.
- Roles List<string>
- (Updatable) A list of database roles for the client. These roles are enabled if the proxy is authorized to use the roles on behalf of the client.
- User
Name string - (Updatable) The user name.
- User
Password DatabaseTools Connection Proxy Client User Password - (Updatable) The user password.
- Proxy
Authentication stringType - (Updatable) The proxy authentication type.
- Roles []string
- (Updatable) A list of database roles for the client. These roles are enabled if the proxy is authorized to use the roles on behalf of the client.
- User
Name string - (Updatable) The user name.
- User
Password DatabaseTools Connection Proxy Client User Password - (Updatable) The user password.
- proxy
Authentication StringType - (Updatable) The proxy authentication type.
- roles List<String>
- (Updatable) A list of database roles for the client. These roles are enabled if the proxy is authorized to use the roles on behalf of the client.
- user
Name String - (Updatable) The user name.
- user
Password ConnectionProxy Client User Password - (Updatable) The user password.
- proxy
Authentication stringType - (Updatable) The proxy authentication type.
- roles string[]
- (Updatable) A list of database roles for the client. These roles are enabled if the proxy is authorized to use the roles on behalf of the client.
- user
Name string - (Updatable) The user name.
- user
Password DatabaseTools Connection Proxy Client User Password - (Updatable) The user password.
- proxy_
authentication_ strtype - (Updatable) The proxy authentication type.
- roles Sequence[str]
- (Updatable) A list of database roles for the client. These roles are enabled if the proxy is authorized to use the roles on behalf of the client.
- user_
name str - (Updatable) The user name.
- user_
password databasetools.Database Tools Connection Proxy Client User Password - (Updatable) The user password.
- proxy
Authentication StringType - (Updatable) The proxy authentication type.
- roles List<String>
- (Updatable) A list of database roles for the client. These roles are enabled if the proxy is authorized to use the roles on behalf of the client.
- user
Name String - (Updatable) The user name.
- user
Password Property Map - (Updatable) The user password.
DatabaseToolsConnectionProxyClientUserPassword, DatabaseToolsConnectionProxyClientUserPasswordArgs
- secret_
id str - (Updatable) The OCID of the secret containing the user password.
- value_
type str - (Updatable) The value type of the user password.
DatabaseToolsConnectionRelatedResource, DatabaseToolsConnectionRelatedResourceArgs
- Entity
Type string - (Updatable) The resource entity type.
- Identifier string
- (Updatable) The OCID of the related resource.
- Entity
Type string - (Updatable) The resource entity type.
- Identifier string
- (Updatable) The OCID of the related resource.
- entity
Type String - (Updatable) The resource entity type.
- identifier String
- (Updatable) The OCID of the related resource.
- entity
Type string - (Updatable) The resource entity type.
- identifier string
- (Updatable) The OCID of the related resource.
- entity_
type str - (Updatable) The resource entity type.
- identifier str
- (Updatable) The OCID of the related resource.
- entity
Type String - (Updatable) The resource entity type.
- identifier String
- (Updatable) The OCID of the related resource.
DatabaseToolsConnectionUserPassword, DatabaseToolsConnectionUserPasswordArgs
- secret_
id str - (Updatable) The OCID of the secret containing the user password.
- value_
type str (Updatable) The value type of the user password.
** 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
Import
DatabaseToolsConnections can be imported using the id
, e.g.
$ pulumi import oci:DatabaseTools/databaseToolsConnection:DatabaseToolsConnection test_database_tools_connection "id"
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.