Desenvolvimento de aplicativos com a API Amazon Quick Sight

Instale o AWS SDK em seu ambiente. As instruções sobre como fazer isso estão localizadas aqui: AWS Command Line Interface.

Configure sua identidade e região da AWS CLI usando as instruções de comando e acompanhamento a seguir. Use as credenciais de uma identidade ou função do IAM que tenha as permissões apropriadas.

aws configure

Veja a ajuda do Amazon Quick Sight SDK emitindo o seguinte comando:

aws quicksight help

Para obter instruções detalhadas sobre como usar uma API, insira seu nome seguido por “help” (ajuda), da seguinte forma:

aws quicksight list-users help

Agora você pode chamar uma operação de API do Amazon Quick Sight. Este exemplo retorna uma lista de usuários do Amazon Quick Sight em sua conta.

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

Para começar, crie um projeto Java em seu IDE.

Importe o SDK do Amazon Quick Sight para seu novo projeto, por exemplo: AWSQuickSightJavaClient-1.11.x.jar

Depois que seu IDE indexar o SDK do Amazon Quick Sight, você poderá adicionar uma linha de importação da seguinte forma:

import com.amazonaws.services.quicksight.AmazonQuickSight;

Se o IDE não reconhecer isso como válido, verifique se você importou o SDK.

Como outros AWS SDKs, o Amazon Quick Sight SDK exige dependências externas para realizar muitas de suas funções. Você precisará fazer download e importá-las para o mesmo projeto. As seguintes dependências são obrigatórias:

Agora, você está pronto para criar um cliente Amazon Quick Sight. Você pode usar um endpoint público padrão com o qual o cliente possa se comunicar ou pode fazer referência explícita ao endpoint. Há várias maneiras de fornecer suas AWS credenciais. No exemplo a seguir, fornecemos uma abordagem simples e direta. O seguinte método do cliente é usado para fazer todas as chamadas de API a seguir:

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

Agora, podemos usar o cliente acima para listar todos os usuários em nossa conta Amazon Quick Sight.

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

Para ver uma lista de todas as operações de API possíveis e os objetos de solicitação que elas usam, você pode clicar com a tecla Ctrl pressionada no objeto cliente em seu IDE para visualizar a interface do Amazon Quick Sight. Como alternativa, encontre-o dentro do com.amazonaws.services.quicksight pacote no arquivo JavaClient JAR do Amazon Quick Sight.

Configure o ambiente do nó usando os seguintes comandos:

Para obter informações sobre como configurar o Node.js com o AWS SDK e definir suas credenciais, consulte--> o Guia do AWS SDK para JavaScript desenvolvedor para SDK v2.

Use o exemplo de código a seguir para testar sua configuração. O HTTPS é obrigatório. A amostra exibe uma lista completa das operações do Amazon Quick Sight junto com seus parâmetros de solicitação de URL, seguida por uma lista de usuários do Amazon Quick Sight em sua conta.

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

Crie um arquivo de credenciais no AWS diretório do seu ambiente. Em um Linux/Mac-based environment, that file is called ~/.aws/credentials e tem a seguinte aparência:

[default]
aws_access_key_id = Your_IAM_access_key
aws_secret_access_key = Your_IAM_secret_key

Descompacte a pasta botocore-1.12.10. Altere o diretório em botocore-1.12.10 e entre no ambiente do interpretador Python3.

As respostas voltam como um objeto de dicionário. Cada um deles tem uma ResponseMetadata entrada que contém o status da solicitação IDs e da resposta. As outras entradas dependerão do tipo de operação que você executar.

O exemplo a seguir mostra um exemplo de aplicação que primeiro cria, exclui e lista grupos. Em seguida, ela lista os usuários em uma conta do 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)

Descompacte o arquivo nuget.zip em uma pasta chamada nuget.

Crie um novo projeto chamado Console app no Visual Studio.

Em sua solução, localize as Dependencies (Dependências) da aplicação e, em seguida, abra o contexto (clique com o botão direito no menu) e selecione Add Packages (Adicionar pacotes).

Na lista de fontes, escolha Configure Sources (Configurar fontes).

Escolha Add (Adicionar) e dê o nome QuickSightSDK à fonte. Acesse a pasta nuget e escolha Add Source (Adicionar fonte).

Escolha OK. Em seguida, com a QuickSightSDK opção selecionada, selecione os três pacotes do Amazon Quick Sight:

Clique em Add Package (Adicionar pacote).

Copie e cole o seguinte exemplo de aplicação no editor de aplicação de console.

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