Amazon Quick Sight API を使用したアプリケーションの開発

環境に AWS SDK をインストールします。これを行う方法についての手順は、「AWS コマンドラインインターフェイス」を参照してください。

次のコマンドとフォローアップ手順を使用して AWS 、CLI アイデンティティとリージョンを設定します。適切なアクセス許可を持つ、IAM ID またはロールの認証情報を使用します。

aws configure

次のコマンドを発行して、Amazon Quick Sight SDK のヘルプを確認します。

aws quicksight help

API の使用方法の詳細な手順を取得するには、その名前を入力した後に、以下のようにヘルプを入力します。

aws quicksight list-users help

これで、Amazon Quick Sight API オペレーションを呼び出すことができます。この例では、 アカウントの Amazon Quick Sight ユーザーのリストを返します。

aws quicksight list-users --aws-account-id aws-account-id --namespace default --region us-east-1

開始するには、IDE で Java プロジェクトを作成してください。

Amazon Quick Sight SDK を新しいプロジェクトにインポートします。次に例を示します。 AWSQuickSightJavaClient-1.11.x.jar

IDE が Amazon Quick Sight SDK にインデックスを作成したら、次のようにインポートラインを追加できます。

import com.amazonaws.services.quicksight.AmazonQuickSight;

IDE がこれを有効と認識しない場合は、SDK をインポートしたことを確認してください。

他の AWS SDKs と同様に、Amazon Quick Sight SDK では、多くの関数を実行するために外部依存関係が必要です。同じプロジェクトにこれらをダウンロードしてインポートする必要があります。以下の依存関係は必須です。

これで、Amazon Quick Sight クライアントを作成する準備が整いました。クライアントと通信できるデフォルトのパブリックエンドポイントを使用するか、エンドポイントを明示的に参照することもできます。 AWS 認証情報を指定する方法は複数あります。次の例で、直接的かつシンプルなアプローチを提供します。次のクライアントメソッドは、以下のすべての API コールに使用されます。

private static AmazonQuickSight getClient() {
	final AWSCredentialsProvider credsProvider = new AWSCredentialsProvider() {
	@Override
	public AWSCredentials getCredentials() {
	// provide actual IAM access key and secret key here
	return new BasicAWSCredentials("access-key", "secret-key");
	}
	
	@Override
	public void refresh() {}
	};
	
	return AmazonQuickSightClientBuilder
	.standard()
	.withRegion(Regions.US_EAST_1.getName())
	.withCredentials(credsProvider)
	.build();
	}

これで、上記のクライアントを使用して、Amazon Quick Sight アカウントのすべてのユーザーを一覧表示できます。

getClient().listUsers(new ListUsersRequest()
        .withAwsAccountId("relevant_AWS_account_ID")
        .withNamespace("default"))
        .getUserList().forEach(user -> {
            System.out.println(user.getArn());
        });

使用可能なすべての API オペレーションとそれらが使用するリクエストオブジェクトのリストを表示するには、IDE でクライアントオブジェクトを CTRL クリックすると、Amazon Quick Sight インターフェイスが表示されます。または、Amazon Quick Sight JavaClient JAR ファイルの com.amazonaws.services.quicksightパッケージ内にあります。

次のコマンドを使用して、ノード環境を設定します。

AWS SDK で Node.js を設定し、認証情報を設定する方法については、AWS SDK for JavaScript 「 SDK v2 開発者ガイド」の「-->」を参照してください。

次のコード例を使用して、設定をテストします。HTTPS が必要です。サンプルには、Amazon Quick Sight オペレーションの完全なリストと URL リクエストパラメータが表示され、その後にアカウントの Amazon Quick Sight ユーザーのリストが表示されます。

const AWS = require('aws-sdk');
const https = require('https');

var quicksight = new AWS.Service({
    apiConfig: require('./quicksight-2018-04-01.min.json'),
    region: 'us-east-1',
});

console.log(quicksight.config.apiConfig.operations);

quicksight.listUsers({
    // Enter your actual AWS account ID
    'AwsAccountId': 'relevant_AWS_account_ID', 
    'Namespace': 'default',
}, function(err, data) {
    console.log('---');
    console.log('Errors: ');
    console.log(err);
    console.log('---');
    console.log('Response: ');
    console.log(data);
});

環境の AWS ディレクトリに認証情報ファイルを作成します。Linux/Mac ベースの環境では、そのファイルは ~/.aws/credentials と呼ばれ、次のように表示されます。

[default]
aws_access_key_id = Your_IAM_access_key
aws_secret_access_key = Your_IAM_secret_key

フォルダ botocore-1.12.10 を解凍します。ディレクトリを botocore-1.12.10 に変更し、Python3 インタプリタ環境を入力します。

レスポンスは、ディクショナリオブジェクトとして返されます。レスポンスにはそれぞれ、リクエスト ID とレスポンスステータスを含む ResponseMetadata エントリがあります。その他のエントリは、実行されるオペレーションのタイプに基づいています。

次の例は、最初に作成、削除、グループを一覧表示するサンプルアプリです。次に、Quicksight アカウント内のユーザーが一覧で示されます。

import botocore.session
default_namespace = 'default'
account_id = 'relevant_AWS_Account'

session = botocore.session.get_session()
client = session.create_client("quicksight", region_name='us-east-1')

print('Creating three groups: ')
client.create_group(AwsAccountId = account_id, Namespace=default_namespace, GroupName='MyGroup1')
client.create_group(AwsAccountId = account_id, Namespace=default_namespace, GroupName='MyGroup2')
client.create_group(AwsAccountId = account_id, Namespace=default_namespace, GroupName='MyGroup3')

print('Retrieving the groups and listing them: ')
response = client.list_groups(AwsAccountId = account_id, Namespace=default_namespace)
for group in response['GroupList']:
    print(group)

print('Deleting our groups: ')
client.delete_group(AwsAccountId = account_id, Namespace=default_namespace, GroupName='MyGroup1')
client.delete_group(AwsAccountId = account_id, Namespace=default_namespace, GroupName='MyGroup2')
client.delete_group(AwsAccountId = account_id, Namespace=default_namespace, GroupName='MyGroup3')

response = client.list_users(AwsAccountId = account_id, Namespace=default_namespace)
for user in response['UserList']:
    print(user)

nuget.zip ファイルを nuget と呼ばれるフォルダに解凍します。

Visual Studio で新しい [Console app (コンソールアプリ)] プロジェクトを作成します。

ソリューションの下から、[Dependencies (依存関係)] を見つけます。メニューを右クリックして [Add Packages (パッケージを追加)] を選択し、コンテキストを開きます。

ソースリストで、[Configure Sources (ソースの設定)] を選択します。

[Add (追加)] を選択し、ソースに QuickSightSDK という名前を付けます。nuget フォルダを参照して [Add Source (ソースの追加)] を選択します。

[OK] を選択してください。次に、 QuickSightSDK を選択して、3 つの Amazon Quick Sight パッケージをすべて選択します。

[Add Package (パッケージの追加)] をクリックします。

次のサンプルアプリを、コンソールアプリエディタにコピーして貼り付けます。

using System;
using Amazon.QuickSight.Model;
using Amazon.QuickSight;

namespace DotNetQuickSightSDKTest
{
    class Program
    {
        private static readonly string AccessKey = "insert_your_access_key";
        private static readonly string SecretAccessKey = "insert_your_secret_key";
        private static readonly string AccountID = "AWS_account_ID";
        private static readonly string Namespace = "default";  // leave this as default

        static void Main(string[] args)
        {
            var client = new AmazonQuickSightClient(
                AccessKey,
                SecretAccessKey, 
                Amazon.RegionEndpoint.USEast1);

            var listUsersRequest = new ListUsersRequest
            {
                AwsAccountId = AccountID,
                Namespace = Namespace
            };

            client.ListUsersAsync(listUsersRequest).Result.UserList.ForEach(
                user => Console.WriteLine(user.Arn)
            );

            var listGroupsRequest = new ListGroupsRequest
            {
                AwsAccountId = AccountID,
                Namespace = Namespace
            };

            client.ListGroupsAsync(listGroupsRequest).Result.GroupList.ForEach(
                group => Console.WriteLine(group.Arn)
            );
        }
    }
}