Amazon을 사용하여 애플리케이션 개발 QuickSight API

환경에 를 설치합니다 AWS SDK. 이 작업을 수행하는 방법에 대한 지침은 AWS 명령줄 인터페이스 에서 확인할 수 있습니다.

다음 명령 및 후속 지침을 사용하여 자격 증명과 리전을 설정합니다 AWS CLI. 적절한 권한이 있는 IAM 자격 증명 또는 역할에 자격 증명을 사용합니다.

aws configure

다음 명령을 실행하여 Amazon QuickSight SDK 도움말을 확인합니다.

aws quicksight help

를 사용하는 방법에 대한 자세한 지침을 보려면 다음과 같이 이름을 입력한 다음 도움말을 API입력합니다.

aws quicksight list-users help

이제 Amazon QuickSight API 작업을 호출할 수 있습니다. 이 예제에서는 계정의 Amazon QuickSight 사용자 목록을 반환합니다.

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

시작하려면 에서 Java 프로젝트를 생성합니다IDE.

Amazon QuickSight SDK을 새 프로젝트로 가져옵니다. 예: AWSQuickSightJavaClient-1.11.x.jar

가 Amazon 를 인IDE덱싱하면 다음과 같이 가져오기 라인을 추가할 수 QuickSight SDK있습니다.

import com.amazonaws.services.quicksight.AmazonQuickSight;

이를 유효한 것으로 인식하지 IDE 못하면 를 가져왔는지 확인합니다SDK.

다른 와 마찬가지로 AWS SDKsAmazon QuickSight SDK은 많은 함수를 수행하기 위해 외부 종속성이 필요합니다. 외부 종속 프로그램은 다운로드를 하여 같은 프로젝트에 가져와야 합니다. 다음과 같은 종속 프로그램이 필요합니다.

이제 Amazon QuickSight 클라이언트를 생성할 준비가 되었습니다. 클라이언트가 통신할 수 있는 기본 퍼블릭 엔드포인트를 사용하거나 엔드포인트를 명시적으로 참조할 수 있습니다. 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 QuickSight 계정의 모든 사용자를 나열할 수 있습니다.

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

가능한 모든 API 작업 목록과 해당 작업에서 사용하는 요청 객체를 보려면 에서 클라이언트 객체를 CTRL클릭하여 Amazon QuickSight 인터페이스를 IDE 볼 수 있습니다. 또는 Amazon QuickSight JavaClient JAR 파일의 com.amazonaws.services.quicksight 패키지 내에서 찾을 수 있습니다.

다음 명령을 사용하여 노드 환경을 설정합니다.

를 사용하여 AWS SDK Node.js를 구성하고 자격 증명을 설정하는 방법에 대한 자세한 내용은 vAWS SDK for JavaScript SDK2용 개발자 안내서-->를 참조하세요.

다음 코드 예제를 사용하여 설정을 테스트합니다. HTTPS 는 필수입니다. 샘플에는 URL 요청 파라미터와 함께 Amazon QuickSight 작업의 전체 목록이 표시된 다음 계정의 Amazon QuickSight 사용자 목록이 표시됩니다.

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-based environment, that file is called ~/.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에 디렉터리를 변경하고 Python 3 인터프리터 환경에 들어갑니다.

응답은 딕셔너리 객체 형태로 반환됩니다. 각 항목에는 요청 IDs 및 응답 상태가 포함된 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에 콘솔 앱 프로젝트를 새로 생성합니다.

솔루션 아래에서 앱 종속성을 찾아서, 컨텍스트 메뉴를 열고(마우스 오른쪽 버튼 클릭) 패키지 추가를 선택합니다.

소스 목록에서 소스 구성을 선택합니다.

추가를 선택하고 QuickSightSDK라고 소스 이름을 명명합니다. nuget 폴더를 검색하고 소스 추가를 선택합니다.

확인을 선택합니다. 그런 다음 를 QuickSightSDK 선택한 상태에서 세 개의 Amazon QuickSight 패키지를 모두 선택합니다.

패키지 추가를 클릭합니다.

다음 샘플 앱을 콘솔 앱 편집기에 복사하여 붙여 넣습니다.

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)
            );
        }
    }
}