# DatabaseInstanceLookupOptions

Properties for looking up an existing DatabaseInstance.

Used as argument in: [DatabaseInstanceBase.fromLookup](https://docs.aws.amazon.com/cdk/api/v2/docs/aws-cdk-lib.aws_rds.DatabaseInstanceBase.html#fromlookup)

- Source: [`aws-rds/lib/instance.ts`](https://github.com/aws/aws-cdk/blob/v2.278.0/packages/aws-cdk-lib/aws-rds/lib/instance.ts#L1291)
- Type last changed: v2.190.0 · 17 Apr 2025

## Example

TypeScript:

```ts
declare const myUserRole: iam.Role;

const dbFromLookup = rds.DatabaseInstance.fromLookup(this, 'dbFromLookup', {
  instanceIdentifier: 'instanceId',
});

// Grant a connection
dbFromLookup.grantConnect(myUserRole, 'my-user-id');
```

Python:

```python
# my_user_role: iam.Role

db_from_lookup = rds.DatabaseInstance.from_lookup(self, "dbFromLookup",
    instance_identifier="instanceId"
)

# Grant a connection
db_from_lookup.grant_connect(my_user_role, "my-user-id")
```

Java:

```java
Role myUserRole;

IDatabaseInstance dbFromLookup = DatabaseInstance.fromLookup(this, "dbFromLookup", DatabaseInstanceLookupOptions.builder()
        .instanceIdentifier("instanceId")
        .build());

// Grant a connection
dbFromLookup.grantConnect(myUserRole, "my-user-id");
```

C# / .NET:

```csharp
// Install: dotnet add package Amazon.CDK.Lib
Role myUserRole;

var dbFromLookup = DatabaseInstance.FromLookup(this, "dbFromLookup", new DatabaseInstanceLookupOptions {
    InstanceIdentifier = "instanceId"
});

// Grant a connection
dbFromLookup.GrantConnect(myUserRole, "my-user-id");
```

Golang:

```go
// Install: go get github.com/aws/aws-cdk-go/awscdk/v2
var myUserRole Role

dbFromLookup := rds.DatabaseInstance_FromLookup(this, jsii.String("dbFromLookup"), &DatabaseInstanceLookupOptions{
	InstanceIdentifier: jsii.String("instanceId"),
})

// Grant a connection
dbFromLookup.GrantConnect(myUserRole, jsii.String("my-user-id"))
```

## Properties

- `instanceIdentifier`: string (required) — The instance identifier of the DatabaseInstance.
