Hämta primära, sekundära nycklar, läs- eller skrivnycklar i Azure Cosmos DB

Använd Azure Portal för att hämta någon av de fyra inbyggda nycklarna:

• Primär skrivskyddad
• Primär skrivskyddad
• Sekundär läs- och skrivbehörighet
• Sekundär skrivskyddad

1. Logga in på Azure Portal (https://portal.azure.com).

2. Gå till ditt befintliga Azure Cosmos DB-konto.

3. I fönstret Kontoresurs väljer du Nycklar i avsnittet Inställningar på tjänstmenyn.

4. Leta upp och registrera värdet för fälten Primärnyckel eller Sekundär nyckel i antingen skrivskyddade nycklar eller skrivskyddade .

   Dricks

   Du kan behöva visa nycklarna innan du registrerar deras värden. Som standard är nycklarna dolda.

Använd det här Azure CLI-skriptet för att hämta nycklar eller anslutningssträng från ditt Azure Cosmos DB-konto.

az cosmosdb keys list \
    --resource-group "<name-of-existing-resource-group>" \
    --name "<name-of-existing-account>" \
    --type "keys"

--type argumentalternativ är:

• connection-strings
• keys
• read-only-keys

Mer information finns i az cosmosdb keys list.

Använd det här Azure PowerShell-skriptet för att hämta nycklar eller anslutningssträng från ditt Azure Cosmos DB-konto.

$parameters = @{
    ResourceGroupName = "<name-of-existing-resource-group>"
    Name = "<name-of-existing-account>"
    Type = "Keys"
}
Get-AzCosmosDBAccountKey @parameters

Type parameteralternativ är:

• ConnectionStrings
• Keys
• ReadOnlyKeys

Mer information finns i Get-AzCosmosDBAccountKey.

I det här exemplet matar Bicep-mallen ut alla autentiseringsuppgifter för ett befintligt Azure Cosmos DB-konto.

metadata description = 'Gets all keys and connection strings for an Azure Cosmos DB account.'

@description('The name of the Azure Cosmos DB account.')
param accountName string

resource account 'Microsoft.DocumentDB/databaseAccounts@2024-05-15' existing = {
  name: accountName
}

output endpoint string = account.properties.documentEndpoint

var keys = account.listKeys()

output keys object = {
  primary: {
    readWrite: keys.primaryMasterKey
    readOnly: keys.primaryReadonlyMasterKey
  }
  secondary: {
    readWrite: keys.secondaryMasterKey
    readOnly: keys.secondaryReadonlyMasterKey
  }
}

var connectionStrings = account.listConnectionStrings()

output connectionStrings object = {
  primary: {
    readWrite: connectionStrings.connectionStrings[0].connectionString
    readOnly: connectionStrings.connectionStrings[1].connectionString
  }
  secondary: {
    readWrite: connectionStrings.connectionStrings[2].connectionString
    readOnly: connectionStrings.connectionStrings[3].connectionString
  }
}