# AzureCosmosDBResource.AddCosmosDatabase

- Module: [Aspire.Hosting.Azure.CosmosDB](/reference/api/go/aspire.hosting.azure.cosmosdb.md)
- Defined on: [AzureCosmosDBResource](/reference/api/go/aspire.hosting.azure.cosmosdb/azurecosmosdbresource.md)
- Version: `17.0.0`
- Kind: `method`

Adds a database to the associated Cosmos DB account resource.

## Definition

```go
type AzureCosmosDBResource interface {
    // ... omitted for brevity
    AddCosmosDatabase(
        name string,
        options ...*AddCosmosDatabaseOptions,
    ) AzureCosmosDBDatabaseResource
}
```

## Signature

```go
AddCosmosDatabase(
    name string,
    options ...*AddCosmosDatabaseOptions,
) AzureCosmosDBDatabaseResource
```

## Parameters

- `name` (`string`) -- The name of the database resource.
- `options` (`...*AddCosmosDatabaseOptions`) -- optional settings, see [Options](#options)

## Options

Optional parameters are passed in a trailing `options ...*AddCosmosDatabaseOptions` argument.

- `DatabaseName` (`*string`) -- The name of the database. If not provided, this defaults to the same value as `name`.

## Returns

[`AzureCosmosDBDatabaseResource`](/reference/api/go/aspire.hosting.azure.cosmosdb/azurecosmosdbdatabaseresource.md) -- The resource builder.

Returns a handle; failures surface later via `Err()`.

## Defined on

- [AzureCosmosDBResource](/reference/api/go/aspire.hosting.azure.cosmosdb/azurecosmosdbresource.md) -- `handle`
