すべてのプロダクト
Search

このプロダクト

    Alibaba Cloud CLI:Alibaba Cloud CLI 資格情報管理ガイド

    ドキュメントセンター

    Alibaba Cloud CLI:Alibaba Cloud CLI 資格情報管理ガイド

    最終更新日:Nov 09, 2025

    Alibaba Cloud CLI では、複数の資格情報設定を保存できます。これらの設定を管理するには、configure コマンドとそのサブコマンドを使用します。このトピックでは、コマンドの構文と使用例について説明します。

    インタラクティブモードでプロファイルを作成する

    aliyun configure コマンドを実行して、インタラクティブモードでプロファイルを作成します。

    構文

    aliyun configure [--mode <AUTHENTICATE_MODE>] [--profile <PROFILE_NAME>]

    • AUTHENTICATE_MODE: 設定する資格情報の種類を指定します。このパラメーターを指定しない場合、デフォルトで AccessKey (AK) プロファイルが作成されます。

    • PROFILE_NAME: プロファイル名を指定します。このパラメーターを指定しない場合、現在のプロファイルが変更されます。指定したプロファイルが存在しない場合は、新しいプロファイルが作成されます。

    例

    1. 次のコマンドを実行して、インタラクティブモードで AK クレデンシャルタイプの AkProfile プロファイルを構成します。

      aliyun configure --mode AK --profile AkProfile

    2. インタラクティブプロセス:

      Configuring profile 'AkProfile' in 'AK' authenticate mode...
Access Key Id []: "0wNEpMMlzy7s****"
Access Key Secret []: <YOUR_ACCESS_KEY_SECRET>
Default Region Id []: cn-hangzhou
Default Output Format [json]: json (Only support json)
Default Language [zh|en] en: en
Saving profile[profile] ...Done.

    非インタラクティブモードでプロファイルを作成または変更する

    aliyun configure set コマンドを実行して、非インタラクティブモードでプロファイルを作成または変更します。

    説明

    プロファイルが変更されると、Alibaba Cloud CLI は変更されたプロファイルに切り替わります。

    構文

    aliyun configure set [--mode <AUTHENTICATE_MODE>] [--profile <PROFILE_NAME>] [--settingName <settingValue>...]

    • AUTHENTICATE_MODE: 資格情報の種類を指定します。このパラメーターを指定しない場合、デフォルトで AK プロファイルが作成されます。

    • PROFILE_NAME: プロファイル名を指定します。このパラメーターが指定されておらず、ALIBABA_CLOUD_PROFILE 環境変数も設定されていない場合、現在のプロファイルが変更されます。指定されたプロファイルが存在しない場合、新しいプロファイルが作成されます。

    • settingName: 構成するプロファイルオプション。プロファイルに必要なオプションを構成します。そうしないと、プロファイルの作成に失敗します。詳細については、「クレデンシャルを構成する」をご参照ください。

      変更可能な設定のリスト

      オプション

      説明

      例

      --region

      デフォルトリージョンの ID。

      cn-hangzhou

      --language

      ヘルプ情報の言語。

      • 中国語: zh

      • 英語: en

      zh

      --read-timeout

      I/O タイムアウト期間。単位: 秒。

      10

      --connect-timeout

      接続タイムアウト (秒)。

      10

      --retry-count

      最大リトライ回数。

      5

      --expired-seconds

      クレデンシャルの有効期間。

      900

      --access-key-id

      現在の Alibaba Cloud アカウントまたは RAM (Resource Access Management) ユーザーの AccessKey ID。

      yourAccessKeyID

      --access-key-secret

      Alibaba Cloud アカウントまたは RAM ユーザーの AccessKey シークレット。

      yourAccessKeySecret

      --sts-token

      セキュリティトークン。

      yourSecurityToken

      --sts-region

      セキュリティトークンサービス (STS) トークンを取得するために呼び出しが開始されるリージョン。

      cn-hangzhou

      --ram-role-name

      RAM ロールの名前。

      ECSAdmin

      --ram-role-arn

      RAM ロールの ARN (Alibaba Cloud Resource Name)。

      acs:ram::012345678910****:role/Alice

      --role-session-name

      ロールセッションの名前。

      alice

      --source-profile

      ソースプロファイルの名前。

      RamRoleArnProfile

      --process-command

      外部プログラムを実行するためのコマンド。

      acs-sso login --profile sso

      --oidc-provider-arn

      OIDC (OpenID Connect) プロバイダーの ARN。

      acs:ram::012345678910****:oidc-provider/TestOidcIdp

      --oidc-token-file

      OIDC トークンのファイルパス。

      /path/to/oidctoken

      --cloud-sso-sign-in-url

      CloudSSO ユーザーのログインアドレス。

      https://signin-******.alibabacloudsso.com/device/login

      --cloud-sso-access-config

      CloudSSO のプロファイル ID です。

      ac-012345678910abcde****

      --cloud-sso-account-id

      CloudSSO にログインするために使用される Alibaba Cloud アカウントの UID です。

      012345678910****

      --oauth-site-type

      OAuth ログオンのサイトタイプ。

      • 中国サイト (aliyun.com): CN

      • 国際サイト (alibabacloud.com): INTL

      CN

    例 1: 非インタラクティブモードでファイルを作成する

    1. 次のコマンドを実行して、非インタラクティブモードで AK クレデンシャルタイプの AkProfile プロファイルを構成します。

      aliyun configure set \
  --access-key-id <yourAccessKeyID> \
  --access-key-secret <yourAccessKeySecret> \
  --region cn-hangzhou \
  --profile AkProfile \
  --mode AK \
  --language en

    2. aliyun configure list コマンドを実行します。次の出力が表示された場合、AkProfile プロファイルが作成されています。

      Profile           | Credential            | Valid   | Region           | Language
---------         | ------------------    | ------- | ---------------- | --------
default           | AK:******             | Valid   | cn-beijing       | zh
AkProfile *       | AK:******             | Valid   | cn-hangzhou      | en

    例 2: プロファイルを変更する

    1. aliyun configure get region コマンドを実行します。現在のプロファイルのリージョン ID が返されます。

      image

    2. 次のコマンドを実行して、プロファイルのリージョン ID を cn-shanghai に置き換えます。

      aliyun configure set --region cn-shanghai

    3. aliyun configure get region を再度実行して、リージョン ID が更新されているかどうかを確認します。

      image

    プロファイルのリストを照会する

    aliyun configure list コマンドを実行して、プロファイルのリストを照会します。リスト上のすべてのプロファイルの概要を表示できます。

    例

    1. 次のコマンドを実行して、プロファイルのリストを照会します。

      aliyun configure list

    2. 次のプロファイルのリストが返されます。

      プロファイルリストには、プロファイル名、プロファイル識別子、一部のクレデンシャル情報、クレデンシャルの有効期間、デフォルトリージョン ID、ヘルプ情報の言語など、各プロファイルの概要が含まれています。Alibaba Cloud CLI は、プロファイル名の右側にアスタリスク (*) を使用してプロファイルを識別します。

      Profile           | Credential            | Valid   | Region           | Language
---------         | ------------------    | ------- | ---------------- | --------
AkProfile *       | AK:******             | Valid   | cn-beijing       | en
StsTokenProfile   | StsToken:******       | Valid   | cn-hangzhou      | en
RamRoleArnProfile | RamRoleArn:******     | Valid   | cn-shanghai      | en
EcsRamRoleProfile | EcsRamRole:ECSAdmin   | Valid   | cn-qingdao       | zh

    プロファイルの詳細を照会する

    aliyun configure get コマンドを実行して、指定されたプロファイルの詳細を照会します。

    構文

    aliyun configure get [--profile <PROFILE_NAME>] [<SETTING_NAME>...]

    • PROFILE_NAME: プロファイル名を指定します。このパラメーターを指定せず、ALIBABA_CLOUD_PROFILE 環境変数が設定されていない場合、現在のプロファイルに関する情報が表示されます。指定したプロファイルが存在しない場合、メッセージ profile <PROFILE_NAME> not found! が返されます。

    • SETTING_NAME: 表示する設定を指定します。複数の設定を指定できます。このパラメーターを指定しない場合、すべての設定が表示されます。指定した設定が存在しない場合、コマンドは情報を返しません。

      表示可能な設定のリスト

      オプション

      説明

      関連する設定フィールド

      profile

      プロファイル名。

      name

      mode

      クレデンシャルタイプ。

      mode

      region

      デフォルトリージョンの ID。

      region_id

      language

      ヘルプ情報の言語。

      language

      access-key-id

      現在の Alibaba Cloud アカウントまたは RAM ユーザーの AccessKey ID。

      access_key_id

      access-key-secret

      Alibaba Cloud アカウントまたは RAM ユーザーの AccessKey シークレット。

      access_key_secret

      sts-token

      RAM ユーザーまたはロールの STS (Security Token Service) トークン。

      sts_token

      sts-region

      RAM ユーザーまたはロールが STS トークンを取得するリージョンの ID。

      sts_region

      ram-role-name

      RAM ロールの名前。

      ram_role_name

      ram-role-arn

      RAM ロールの ARN。

      ram_role_arn

      external-id

      RAM ロールの外部 ID。

      external_id

      role-session-name

      ロールセッションの名前。

      ram_session_name

      cloud-sso-sign-in-url

      CloudSSO ユーザーのログインアドレス。

      cloud-sso-sign-in-url

      cloud-sso-access-config

      CloudSSO のプロファイル ID。

      cloud-sso-access-config

      cloud-sso-account-id

      CloudSSO にログインするために使用される Alibaba Cloud アカウントの UID。

      cloud-sso-account-id

      oauth-site-type

      OAuth ログオンのサイトタイプ。

      oauth-site-type

    例 1: プロファイルのすべての構成オプションを表示する

    1. 次のコマンドを実行して、AK タイプの AkProfile プロファイルのすべての構成オプションを照会します。

      aliyun configure get --profile AkProfile

    2. 応答例:

      {
  "name": "AkProfile",
  "mode": "AK",
  "access_key_id": "<yourAccessKeyID>",
  "access_key_secret": "<yourAccessKeySecret>",
  "region_id": "cn-hangzhou",
  "output_format": "json",
  "language": "en"
}

    例 2: プロファイルの指定された構成オプションを照会する

    1. 次のコマンドを実行して、クレデンシャルタイプが External である ExternalProfile のプロファイル名、クレデンシャルタイプ、およびデフォルト言語を照会します。

      aliyun configure get profile mode language --profile ExternalProfile

    2. 詳細は key=value 形式で返されます。

      profile=ExternalProfile
mode=External
language=en

    特定のプロファイルに切り替える

    v3.0.214 以降、aliyun configure switch コマンドを実行して、現在のアクティブなプロファイルを変更できます。プロファイルを切り替えると、別の資格情報を指定しない限り、Alibaba Cloud CLI はすべてのリクエストに対して自動的に新しいプロファイルを使用します。

    構文

    aliyun configure switch --profile <PROFILE_NAME>

    PROFILE_NAME: プロファイル名を指定します。このパラメーターは必須です。このパラメーターが空の場合、または指定されたプロファイルが存在しない場合、コマンドは失敗します。

    例

    1. aliyun configure list コマンドを実行して、プロファイルのリストを照会します。リストは、現在のプロファイルが default であることを示しています。Alibaba Cloud CLI は、プロファイル名の右側にアスタリスク (*) を使用してプロファイルを識別します。

      Profile           | Credential            | Valid   | Region           | Language
---------         | ------------------    | ------- | ---------------- | --------
default *         | AK:******             | Valid   | cn-hangzhou      | en
ExampleProfile    | AK:******             | Valid   | cn-beijing| zh

    2. 次のコマンドを実行して、ExampleProfile プロファイルに切り替えます。The default profile is `ExampleProfile` now メッセージが表示された場合、コマンドは成功です。

      aliyun configure switch --profile exampleProfile

    3. aliyun configure list コマンドを再度実行して、指定したプロファイルに切り替えられているかどうかを確認します。

      Profile           | Credential            | Valid   | Region           | Language
---------         | ------------------    | ------- | ---------------- | --------
default           | AK:******             | Valid   | cn-hangzhou      | en
ExampleProfile *  | AK:******             | Valid   | cn-beijing       | zh

    プロファイルを削除する

    aliyun configure delete コマンドを実行して、特定のプロファイルを削除します。

    構文

    aliyun configure delete --profile <PROFILE_NAME>

    • PROFILE_NAME: 削除するプロファイルの名前を指定します。このパラメーターは必須です。このパラメーターが空の場合、または指定されたプロファイルが存在しない場合、コマンドは失敗します。

    • 現在のプロファイルを削除すると、リストの先頭にあるプロファイルに自動的に切り替わります。詳細については、次の例を参照してください。

    • 少なくとも 1 つのプロファイルを保持することをお勧めします。誤ってすべてのプロファイルを削除すると、Alibaba Cloud CLI は期待どおりに動作しません。この問題を解決するには、config.json ファイルを手動で削除する必要があります。このファイルは、ユーザーのホームディレクトリにある .aliyun フォルダにあります。ユーザーのホームディレクトリの場所は、オペレーティングシステムによって異なります。

      • Windows: C:\Users\<USER_NAME>\.aliyun

      • Linux および macOS: /home/<USER_NAME>/.aliyun

    例

    1. aliyun configure list コマンドを実行して、プロファイルのリストを照会します。

      Profile           | Credential            | Valid   | Region           | Language
---------         | ------------------    | ------- | ---------------- | --------
default           | AK:******             | Valid   | cn-hangzhou      | en
AkProfile         | AK:******             | Valid   | cn-hangzhou      | en
ExampleProfile *  | AK:******             | Valid   | cn-hangzhou      | en

    2. 次のコマンドを実行して、ExampleProfile ファイルを削除します。

      aliyun configure delete --profile ExampleProfile

    3. aliyun configure list コマンドを再度実行して、ExampleProfile プロファイルが削除されているかどうかを確認します。削除されている場合、default プロファイルに切り替えられます。

      Profile           | Credential            | Valid   | Region           | Language
---------         | ------------------    | ------- | ---------------- | --------
default *         | AK:******             | Valid   | cn-hangzhou      | en
AkProfile         | AK:******             | Valid   | cn-hangzhou      | en