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 サービスについて調べて、使用を開始するサービスを選択します。