Alibaba Cloud CLI の環境変数 - Alibaba Cloud CLI - Alibaba Cloud ドキュメントセンター

Alibaba Cloud CLI では、認証情報、リージョン、動作オプション、その他の実行時パラメーターを環境変数を使用して構成できます。CI/CD パイプライン、コンテナ環境、または自動化スクリプトでは、認証情報や実行時構成を渡す方法として環境変数が推奨されます。本トピックでは、サポートされているすべての環境変数を一覧表示し、優先度順に説明することで、必要な設定項目を迅速に特定できるようにします。

優先度順

Alibaba Cloud CLI は、構成を読み取る際に以下の優先度順（上から下へ）で設定を適用します。

コマンドラインパラメーター（例：--profile や --region）
設定ファイル（~/.aliyun/config.json）
環境変数

詳細については、「コマンドラインパラメーターの理解」をご参照ください。

認証情報と ID

環境変数を使用して、AccessKey、Security Token Service (STS) トークン、OpenID Connect (OIDC)、RAM ロールなどの認証情報を構成できます。これにより、シークレットをプレーンテキストで設定ファイルに保存する必要がなくなります。

環境変数	説明
`ALIBABA_CLOUD_ACCESS_KEY_ID`	AccessKey ID。
`ALIBABA_CLOUD_ACCESS_KEY_SECRET`	AccessKey Secret。
`ALIBABA_CLOUD_SECURITY_TOKEN`	STS 一時セキュリティトークン。AccessKey ID および AccessKey Secret と併用します。
`ALIBABA_CLOUD_CREDENTIALS_URI`	CredentialsURI モード用の認証情報サービスエンドポイント。エイリアスは使用できません。
`ALIBABA_CLOUD_OIDC_PROVIDER_ARN`	OIDC ID プロバイダーの ARN（Alibaba Cloud リソースネーム）。
`ALIBABA_CLOUD_OIDC_TOKEN_FILE`	OIDC トークンファイルのパス。
`ALIBABA_CLOUD_ROLE_ARN`	RAM ロール ARN。RamRoleArn および ChainableRamRoleArn 認証モードで使用します。
`ALIBABA_CLOUD_EXTERNAL_ID`	外部 ID。クロスアカウントでのロールの引き受けシナリオで使用します。
`ALIBABA_CLOUD_SSO_CLIENT_ID`	Cloud SSO OIDC クライアント ID。設定すると、CLI に組み込まれているデフォルトのクライアント ID をオーバーライドします。

各認証情報タイプの構成方法と適用可能なシナリオについては、「認証情報を構成する」をご参照ください。

プロファイルの選択

CLI が使用するプロファイルを制御します。

環境変数	説明
`ALIBABA_CLOUD_PROFILE`	使用するプロファイル名を指定します。`--profile` パラメーターと同等です。
`ALIBABA_CLOUD_IGNORE_PROFILE`	`TRUE`（大文字で、大文字・小文字を区別します）に設定すると、CLI は設定ファイル内のプロファイルを無視し、環境変数で提供された認証情報のみを使用します。

リージョンとエンドポイント

環境変数	説明
`ALIBABA_CLOUD_REGION_ID`	デフォルトリージョン ID（例：`cn-hangzhou`）。
`ALIBABA_CLOUD_ENDPOINT`	カスタム API エンドポイントアドレス。設定すると、CLI はリクエストをこのアドレスに直接送信し、自動エンドポイント解決をスキップします。
`ALIBABA_CLOUD_ENDPOINT_TYPE`	エンドポイントタイプ。たとえば、VPC プライベートネットワークエンドポイントを使用するには `vpc` に設定します。空のままにするか未設定の場合は、パブリックネットワークエンドポイントを使用します。

プラグイン管理

プラグインの自動インストール動作、保存場所、ダウンロードソースを制御します。

環境変数	説明
`ALIBABA_CLOUD_CLI_PLUGIN_AUTO_INSTALL`	`true` に設定すると、プラグインコマンド呼び出し時に不足しているプラグインを CLI が自動的にインストールします。
`ALIBABA_CLOUD_CLI_PLUGIN_AUTO_INSTALL_ENABLE_PRE`	`true` に設定すると、プレリリース版プラグインの自動インストールが許可されます。
`ALIBABA_CLOUD_CLI_PLUGINS_DIR`	カスタムプラグインインストールディレクトリ。デフォルトは `~/.aliyun/plugins/` です。
`ALIBABA_CLOUD_CLI_PLUGIN_NO_CACHE`	`true` または `1` に設定すると、プラグインインデックスキャッシュをバイパスし、毎回リモートソースから最新のインデックスをフェッチします。
`ALIBABA_CLOUD_CLI_PLUGIN_SOURCE_BASE`	カスタムプラグインダウンロードソースのベース URL。プライベートネットワーク環境やプライベートイメージシナリオで役立ちます。

ネットワーク、タイムアウト、言語

CLI は、現在のプロファイルの以下の設定をプラグインの子プロセスに自動的に引き継ぎます。タイムアウトおよびリトライポリシーを調整するには、aliyun configure コマンドを使用するか、設定ファイルを直接編集してください。

環境変数	説明
`ALIBABA_CLOUD_READ_TIMEOUT`	I/O 読み取りタイムアウト（秒単位）。
`ALIBABA_CLOUD_CONNECT_TIMEOUT`	接続タイムアウト（秒単位）。
`ALIBABA_CLOUD_RETRY_COUNT`	リクエスト失敗時のリトライ回数。
`ALIBABA_CLOUD_LANGUAGE`	CLI の言語設定。有効な値は `en`（英語）または `zh`（中国語）です。