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

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

重要

如果您使用 API 金鑰，請將其安全地儲存在別處，例如 Azure Key Vault。 請勿在程式碼中直接包含 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 服務 (部分機器翻譯)，然後選擇要開始使用的服務。