Database Accounts - List Keys

Lists the access keys for the specified Azure Cosmos DB database account.

POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DocumentDB/databaseAccounts/{accountName}/listKeys?api-version=2015-04-08

URI Parameters

Name In Required Type Description
subscriptionId
path True
  • string

Azure subscription ID.

resourceGroupName
path True
  • string

Name of an Azure resource group.

Regex pattern: ^[-\w\._\(\)]+$

accountName
path True
  • string

Cosmos DB database account name.

Regex pattern: ^[a-z0-9]+(-[a-z0-9]+)*

api-version
query True
  • string

Version of the API to be used with the client request. The current version is 2015-04-08.

Responses

Name Type Description
200 OK

The operation completed successfully.

Security

azure_auth

Azure Active Directory OAuth2 Flow

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Name Description
user_impersonation Impersonate your user account

Examples

CosmosDBDatabaseAccountListKeys

Sample Request

POST https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.DocumentDB/databaseAccounts/ddb1/listKeys?api-version=2015-04-08

Sample Response

{
  "primaryMasterKey": "primaryMasterKey",
  "secondaryMasterKey": "secondaryMasterKey",
  "primaryReadonlyMasterKey": "primaryReadonlyMasterKey",
  "secondaryReadonlyMasterKey": "secondaryReadonlyMasterKey"
}

Definitions

DatabaseAccountListKeysResult

The access keys for the given database account.

Name Type Description
primaryMasterKey
  • string

Base 64 encoded value of the primary read-write key.

primaryReadonlyMasterKey
  • string

Base 64 encoded value of the primary read-only key.

secondaryMasterKey
  • string

Base 64 encoded value of the secondary read-write key.

secondaryReadonlyMasterKey
  • string

Base 64 encoded value of the secondary read-only key.