搭配 Azure AI 服務使用環境變數

本指南顯示在測試應用程式時，如何為您的 Azure AI 服務訂用帳戶認證設定和擷取環境變數。

重要

我們建議使用適用於 Azure 資源的受控識別搭配 Microsoft Entra ID 驗證，以避免使用在雲端執行的應用程式儲存認證。

請謹慎使用 API 金鑰。 請勿在程式碼中直接包含 API 金鑰，且切勿公開張貼金鑰。 如果使用 API 金鑰，請將密鑰安全地儲存在 Azure 金鑰保存庫、定期輪替密鑰，並使用角色型存取控制和網路存取限制來限制對 Azure 金鑰保存庫 的存取。 如需在應用程式中安全地使用 API 金鑰的詳細資訊，請參閱搭配 Azure 金鑰保存庫 的 API 金鑰。

如需 AI 服務安全性的詳細資訊，請參閱驗證對 Azure AI 服務的要求。

設定環境變數

若要設定環境變數，請使用下列其中一個命令，其中 ENVIRONMENT_VARIABLE_KEY 是具名索引鍵，而 value 是儲存在環境變數中的值。

命令列

使用下列命令來建立並指派已保存的環境變數，並指定輸入值。

:: Assigns the env var to the value
setx ENVIRONMENT_VARIABLE_KEY "value"

在新的命令提示字元執行個體中，使用下列命令來讀取環境變數。

:: Prints the env var value
echo %ENVIRONMENT_VARIABLE_KEY%

PowerShell

使用下列命令來建立並指派已保存的環境變數，並指定輸入值。

# Assigns the env var to the value
[System.Environment]::SetEnvironmentVariable('ENVIRONMENT_VARIABLE_KEY', 'value', 'User')

在新的 Windows PowerShell 執行個體中，使用下列命令來讀取環境變數。

# Prints the env var value
[System.Environment]::GetEnvironmentVariable('ENVIRONMENT_VARIABLE_KEY')

Bash

使用下列命令來建立並指派已保存的環境變數，並指定輸入值。

# Assigns the env var to the value
echo export ENVIRONMENT_VARIABLE_KEY="value" >> /etc/environment && source /etc/environment

在新的 Bash 執行個體中，使用下列命令來讀取環境變數。

# Prints the env var value
echo "${ENVIRONMENT_VARIABLE_KEY}"

# Or use printenv:
# printenv ENVIRONMENT_VARIABLE_KEY

提示

在您設定環境變數之後，請重新啟動您的整合式開發環境 (IDE)，以確保可使用新增的環境變數。

擷取環境變數

若要在程式碼中使用環境變數，必須將其讀入記憶體中。 根據您使用的語言，使用下列其中一個程式碼片段。 這些程式碼片段示範如何取得環境變數 (假設為 ENVIRONMENT_VARIABLE_KEY)，並將值指派給名為 value 的程式變數。

C#

如需詳細資訊，請參閱Environment.GetEnvironmentVariable 。

using static System.Environment;

class Program
{
    static void Main()
    {
        // Get the named env var, and assign it to the value variable
        var value =
            GetEnvironmentVariable(
                "ENVIRONMENT_VARIABLE_KEY");
    }
}

C++

如需詳細資訊，請參閱 getenv_s 和 getenv。

#include <iostream> 
#include <stdlib.h>

std::string GetEnvironmentVariable(const char* name);

int main()
{
    // Get the named env var, and assign it to the value variable
    auto value = GetEnvironmentVariable("ENVIRONMENT_VARIABLE_KEY");
}

std::string GetEnvironmentVariable(const char* name)
{
#if defined(_MSC_VER)
    size_t requiredSize = 0;
    (void)getenv_s(&requiredSize, nullptr, 0, name);
    if (requiredSize == 0)
    {
        return "";
    }
    auto buffer = std::make_unique<char[]>(requiredSize);
    (void)getenv_s(&requiredSize, buffer.get(), requiredSize, name);
    return buffer.get();
#else
    auto value = getenv(name);
    return value ? value : "";
#endif
}

Java

如需詳細資訊，請參閱System.getenv 。

import java.lang.*;

public class Program {
   public static void main(String[] args) throws Exception {
    // Get the named env var, and assign it to the value variable
    String value =
        System.getenv(
            "ENVIRONMENT_VARIABLE_KEY")
   }
}

Node.js

如需詳細資訊，請參閱process.env 。

// Get the named env var, and assign it to the value variable
const value =
    process.env.ENVIRONMENT_VARIABLE_KEY;

Python

如需詳細資訊，請參閱os.environ 。

import os

# Get the named env var, and assign it to the value variable
value = os.environ['ENVIRONMENT_VARIABLE_KEY']

Objective-C

如需詳細資訊，請參閱environment 。

// Get the named env var, and assign it to the value variable
NSString* value =
    [[[NSProcessInfo processInfo]environment]objectForKey:@"ENVIRONMENT_VARIABLE_KEY"];

下一步

• 探索 Azure AI 服務 (部分機器翻譯)，然後選擇要開始使用的服務。