Desenvolvendo aplicativos com a Amazon QuickSight API

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

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

aws configure

Veja a QuickSight SDK ajuda da Amazon emitindo o seguinte comando:

aws quicksight help

Para obter instruções detalhadas sobre como usar umAPI, digite seu nome seguido pela ajuda, assim:

aws quicksight list-users help

Agora você pode chamar uma QuickSight API operação da Amazon. Este exemplo retorna uma lista de QuickSight usuários da Amazon 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 no seuIDE.

Importe a Amazon QuickSight SDK para seu novo projeto, por exemplo: AWSQuickSightJavaClient-1.11.x.jar

Depois de IDE indexar a Amazon QuickSight SDK, você poderá adicionar uma linha de importação da seguinte forma:

import com.amazonaws.services.quicksight.AmazonQuickSight;

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

Como outras AWS SDKs, a Amazon QuickSight 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 QuickSight cliente Amazon. 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 método cliente a seguir é usado para fazer todas as API chamadas 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 QuickSight conta Amazon.

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 API operações possíveis e os objetos de solicitação que elas usam, você pode CTRLclicar no objeto cliente IDE em seu para visualizar a QuickSight interface da Amazon. Como alternativa, encontre-o dentro com.amazonaws.services.quicksight do pacote no QuickSight JavaClient JAR arquivo da Amazon.

Configure o ambiente do nó usando os seguintes comandos:

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

Use o exemplo de código a seguir para testar sua configuração. HTTPSé obrigatório. A amostra exibe uma lista completa das QuickSight operações da Amazon junto com seus parâmetros de URL solicitação, seguida por uma lista de QuickSight usuários da Amazon 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 QuickSight pacotes da Amazon:

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