Ottenere chiavi primarie, secondarie, di lettura o di lettura/scrittura in Azure Cosmos DB

Usare il portale di Azure per ottenere una delle quattro chiavi predefinite:

• Lettura/scrittura primaria
• Sola lettura primaria
• Lettura/scrittura secondaria
• Sola lettura secondaria

1. Accedere al portale di Azure (https://portal.azure.com).

2. Passare all'account Azure Cosmos DB esistente.

3. Nel riquadro delle risorse dell'account selezionare Chiavi nella sezione Impostazioni del menu del servizio.

4. Individuare e registrare il valore dei campi Chiave primaria o Chiave secondaria nella sezione Chiavi di lettura/scrittura o Sola lettura .

   Suggerimento

   Potrebbe essere necessario visualizzare le chiavi prima di registrare i relativi valori. Per impostazione predefinita, le chiavi sono nascoste.

Usare questo script dell'interfaccia della riga di comando di Azure per ottenere chiavi o stringa di connessione dall'account Azure Cosmos DB.

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

--type Le opzioni dell'argomento includono:

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

Per ulteriori informazioni, vedere az cosmosdb keys list.

Usare questo script di Azure PowerShell per ottenere chiavi o stringa di connessione dall'account Azure Cosmos DB.

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

Type le opzioni dei parametri includono:

• ConnectionStrings
• Keys
• ReadOnlyKeys

Per ulteriori informazioni, vedere Get-AzCosmosDBAccountKey.

Questo esempio di modello Bicep restituisce tutte le credenziali per un account Azure Cosmos DB esistente.

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