Configure o SDK para JavaScript - AWS SDK for JavaScript

O Guia de API referência da AWS SDK for JavaScript V3 descreve detalhadamente todas as API operações da AWS SDK for JavaScript versão 3 (V3).

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Configure o SDK para JavaScript

Os tópicos desta seção explicam como instalar e carregar o SDK para JavaScript que você possa acessar os serviços web compatíveis com o SDK.

nota

Os desenvolvedores do React Native devem usar AWS Amplify para criar novos projetos no AWS. Consulte o aws-sdk-react-nativearquivo para obter detalhes.

Pré-requisitos

Instale o Node.js nos seus servidores, se ele ainda não estiver instalado.

Configurar um ambiente AWS Node.js

Para configurar um ambiente AWS Node.js no qual você possa executar seu aplicativo, use qualquer um dos seguintes métodos:

  • Escolha uma imagem de máquina da Amazon (AMI) com o Node.js pré-instalado. Em seguida, crie uma instância do Amazon EC2 usando essa AMI. Ao criar sua instância do Amazon EC2, selecione sua AMI no AWS Marketplace. Pesquise AWS Marketplace por Node.js e escolha uma opção de AMI que inclua uma versão pré-instalada do Node.js (32 bits ou 64 bits).

  • Crie uma instância do Amazon EC2 e instale o Node.js. Para obter mais informações sobre como instalar o Node.js em uma instância do Amazon Linux, consulte Configurando o Node.js em uma EC2 instância da Amazon.

  • Crie um ambiente sem servidor usando AWS Lambda para executar o Node.js como uma função Lambda. Para obter mais informações sobre como usar o Node.js em uma função do Lambda, consulte Modelo de programação (Node.js) no Guia do desenvolvedor do AWS Lambda .

  • Implante seu aplicativo Node.js em AWS Elastic Beanstalk. Para obter mais informações sobre como usar o Node.js com Elastic Beanstalk, consulte Implantar aplicativos do Node.js no AWS Elastic Beanstalk no Guia do Desenvolvedor do AWS Elastic Beanstalk .

  • Crie um servidor de aplicativos Node.js usando AWS OpsWorks o. Para obter mais informações sobre como usar o Node.js com AWS OpsWorks, consulte Como criar sua primeira pilha de Node.js no Guia do AWS OpsWorks usuário.

Navegadores da Web compatíveis

O AWS SDK for JavaScript suporta todos os navegadores da web modernos.

Na versão 3.183.0 ou posterior, o SDK JavaScript usa artefatos ES2020, que oferecem suporte às seguintes versões mínimas.

Navegador Version (Versão)
Google Chrome 80,0 ou mais
Mozilla Firefox 80,0 ou mais
Opera Mais de 63,0
Microsoft Edge 80,0 ou mais
Apple Safari 14,1+
Internet da Samsung 12.0+

Na versão 3.182.0 ou anterior, o SDK JavaScript usa artefatos ES5, que oferecem suporte às seguintes versões mínimas.

Navegador Version (Versão)
Google Chrome Mais de 49,0
Mozilla Firefox 45,0+
Opera Mais de 36,0
Microsoft Edge 12.0+
Windows Internet Explorer N/D
Apple Safari 9.0+
Navegador do Android Mais de 76,0
UC Browser 12,12 ou mais
Internet da Samsung 5.0+
nota

Estruturas como essa AWS Amplify podem não oferecer o mesmo suporte de navegador que o SDK para. JavaScript Consulte a Documentação do AWS Amplify para obter detalhes.

Instale o SDK para JavaScript

Nem todos os serviços estão imediatamente disponíveis no SDK ou em todas as AWS regiões.

Para instalar um serviço AWS SDK for JavaScript usando o npm, o gerenciador de pacotes Node.js, digite o seguinte comando no prompt de comando, em que SERVICE é o nome de um serviço, comos3.

npm install @aws-sdk/client-SERVICE

Para obter uma lista completa dos pacotes do cliente de AWS SDK for JavaScript serviço, consulte o guia de referência AWS SDK for JavaScript da API.

Carregue o SDK para JavaScript

Depois de instalar o SDK, você pode carregar um pacote de cliente no aplicativo do seu nó usando import. Por exemplo, para carregar o cliente Amazon S3 e o comando Amazon ListBucketsS3, use o seguinte.

import { S3Client, ListBucketsCommand } from "@aws-sdk/client-s3";