Uzyskiwanie podstawowych, pomocniczych, odczytu lub odczytu kluczy zapisu w usłudze Azure Cosmos DB

Użyj witryny Azure Portal, aby uzyskać jeden z czterech wbudowanych kluczy:

• Podstawowy odczyt-zapis
• Podstawowy tylko do odczytu
• Pomocniczy zapis do odczytu
• Pomocniczy tryb tylko do odczytu

1. Zaloguj się do witryny Azure Portal (https://portal.azure.com).

2. Przejdź do istniejącego konta usługi Azure Cosmos DB.

3. W okienku zasobów konta wybierz pozycję Klucze w sekcji Ustawienia menu usługi.

4. Znajdź i zapisz wartość pól Klucz podstawowy lub Klucz pomocniczy w sekcji Klucze odczytu i zapisu lub Tylko do odczytu.

   Napiwek

   Może być konieczne wyświetlenie kluczy przed zarejestrowaniem ich wartości. Domyślnie klucze są ukryte.

Użyj tego skryptu interfejsu wiersza polecenia platformy Azure, aby uzyskać klucze lub parametry połączenia z konta usługi Azure Cosmos DB.

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

--type Opcje argumentów obejmują:

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

Aby uzyskać więcej informacji, zobacz az cosmosdb keys list.

Użyj tego skryptu programu Azure PowerShell, aby uzyskać klucze lub parametry połączenia z konta usługi Azure Cosmos DB.

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

Type Opcje parametrów obejmują:

• ConnectionStrings
• Keys
• ReadOnlyKeys

Aby uzyskać więcej informacji, zobacz Get-AzCosmosDBAccountKey.

W tym przykładzie szablon Bicep generuje wszystkie poświadczenia dla istniejącego konta usługi Azure Cosmos DB.

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
  }
}