Resource Access Management:Alibaba Cloud CLI を使用した STS API オペレーションの呼び出し

Alibaba Cloud CLI を使用する前に、Alibaba Cloud CLI をインストールする必要があります。Alibaba Cloud CLI は、Windows、Linux、macOS をサポートしています。Alibaba Cloud CLI をインストールする際は、ご利用のデバイスのオペレーティングシステムに基づいてインストールパッケージを選択してください。

• Windows への Alibaba Cloud CLI のインストール

• Linux への Alibaba Cloud CLI のインストール

• macOS への Alibaba Cloud CLI のインストール

また、Alibaba Cloud Cloud Shell を使用して、Alibaba Cloud CLI で実行するコマンドをデバッグすることもできます。Cloud Shell の詳細については、「Cloud Shell とは」をご参照ください。

Alibaba Cloud CLI を使用する前に、Alibaba Cloud CLI で認証情報とリージョン ID を指定する必要があります。Alibaba Cloud CLI は、さまざまな種類の認証情報をサポートしています。詳細については、「プロファイルの構成」トピックの「認証情報の種類」セクションをご参照ください。この例では、AccessKey ペアを認証情報として使用します。

1. RAM ユーザーを作成し、その RAM ユーザーの AccessKey ペアを作成します。詳細については、「RAM ユーザーの作成」と「AccessKey ペアの作成」をご参照ください。

2. 必要な権限を RAM ユーザーに付与します。この例では、AliyunSTSAssumeRoleAccess ポリシーが RAM ユーザーにアタッチされます。このポリシーは、STS の AssumeRole オペレーションを呼び出す権限を付与します。詳細については、「RAM ユーザーへの権限付与」をご参照ください。

3. ご利用のリージョン ID を取得します。Alibaba Cloud CLI は、指定したリージョン ID を使用して API 呼び出しを開始します。詳細については、「エンドポイント」をご参照ください。

   説明

   Alibaba Cloud CLI を使用する際、--region オプションを使用して、特定のリージョンでコマンドを実行できます。このオプションを使用すると、Alibaba Cloud CLI は、デフォルトの認証情報設定と環境変数内のリージョン情報を無視します。詳細については、「コマンドラインオプション」をご参照ください。

4. RAM ユーザーの AccessKey ペアを使用して、AkProfile 構成ファイルに認証情報を構成します。詳細については、「プロファイルの構成」トピックの「構成例」セクションをご参照ください。

例 1: Alibaba Cloud CLI を使用して呼び出し可能な STS API オペレーションのクエリ

次のコードは、--help オプションを使用して、Alibaba Cloud CLI で呼び出し可能な STS API オペレーションをクエリする方法の例を示しています。サポートされている API オペレーションは、「機能別オペレーションリスト」でも確認できます。

1. 次のコマンドを実行します。

   aliyun sts --help

2. コマンド出力を表示します。

   

例 2: 偽装する RAM ロールの一時的な認証情報の取得

次のコードは、Alibaba Cloud CLI を使用して STS の AssumeRole オペレーションを呼び出す方法の例を示しています。このオペレーションは、偽装する RAM ロールの一時的な認証情報を取得するために呼び出されます。

1. 次のコマンドを実行します。

   説明

   コマンドパラメーターに関するヘルプ情報を取得するには、次のいずれかの方法を使用できます。

   • aliyun sts AssumeRole --help コマンドを実行して、コマンドパラメーターに関する提案を取得します。

   • AssumeRole トピックを読んで、パラメーターの詳細を表示します。

   aliyun sts AssumeRole \
     --DurationSeconds 3600 \
     --Policy '{"Statement": [{"Action": ["*"],"Effect": "Allow","Resource": ["*"]}],"Version":"1"}' \
     --RoleSessionName alice \
     --RoleArn 'acs:ram::123456789012****:role/adminrole' \
     --ExternalId abcd1234

2. 期待されるコマンド出力を表示します。出力の SecurityToken パラメーターは、クエリする一時的な認証情報を示します。

   {
     "RequestId": "6894B13B-6D71-4EF5-88FA-F32781734A7F",
     "AssumedRoleUser": {
       "AssumedRoleId": "34458433936495****:alice",
       "Arn": "acs:ram::123456789012****:role/adminrole/alice"
     },
     "Credentials": {
       "SecurityToken": "********",
       "Expiration": "2015-04-09T11:52:19Z",
       "AccessKeySecret": "wyLTSmsyPGP1ohvvw8xYgB29dlGI8KMiH2pK****",
       "AccessKeyId": "STS.L4aBSCSJVMuKg5U1****"
     }
   }

   説明

   STS の API 呼び出し後にエラーメッセージが返された場合は、返されたエラーコードに基づいて、リクエストパラメーターとリクエストパラメーターの値が有効であるかどうかを確認する必要があります。

   また、返されたリクエスト ID または SDK エラー情報に基づいて、OpenAPI Troubleshoot ページで診断を実行することもできます。