Azure Cosmos DB에서 기본, 보조, 읽기 또는 읽기-쓰기 키 가져오기

Azure Portal을 사용하여 네 가지 기본 제공 키 중 하나를 가져옵니다.

• 기본 읽기-쓰기
• 기본 읽기 전용
• 보조 읽기-쓰기
• 보조 읽기 전용

1. Azure Portal에 로그인합니다(https://portal.azure.com).

2. 기존 Azure Cosmos DB 계정으로 이동합니다.

3. 계정 리소스 창의 서비스 메뉴의 설정 섹션에서 키를 선택합니다.

4. 읽기/쓰기 키 또는 읽기 전용 섹션에서 기본 키 또는 보조 키 필드의 값을 찾아서 기록합니다.

   팁

   값을 기록하기 전에 키를 표시해야 할 수 있습니다. 기본적으로 키는 숨겨집니다.

이 Azure CLI 스크립트를 사용하여 Azure Cosmos DB 계정에서 키 또는 연결 문자열 가져옵니다.

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

--type 인수 옵션은 다음과 같습니다.

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

자세한 내용은 az cosmosdb keys list를 참조하세요.

이 Azure PowerShell 스크립트를 사용하여 Azure Cosmos DB 계정에서 키 또는 연결 문자열 가져옵니다.

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

Type 매개 변수 옵션은 다음과 같습니다.

• ConnectionStrings
• Keys
• ReadOnlyKeys

자세한 내용은 Get-AzCosmosDBAccountKey를 참조하세요.

이 예제 Bicep 템플릿은 기존 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
  }
}