

La AWS SDK per JavaScript v2 è arrivata. end-of-support [Ti consigliamo di migrare alla AWS SDK per JavaScript v3.](https://docs.aws.amazon.com//sdk-for-javascript/v3/developer-guide/) [Per ulteriori dettagli e informazioni su come effettuare la migrazione, consulta questo annuncio.](https://aws.amazon.com/blogs//developer/announcing-end-of-support-for-aws-sdk-for-javascript-v2/)

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# Creazione di un' EC2 istanza Amazon
<a name="ec2-example-creating-an-instance"></a>

![JavaScript code example that applies to Node.js execution](http://docs.aws.amazon.com/it_it/sdk-for-javascript/v2/developer-guide/images/nodeicon.png)

**Questo esempio di codice di Node.js illustra:**
+ Come creare un' EC2 istanza Amazon da un'Amazon Machine Image (AMI) pubblica.
+ Come creare e assegnare tag alla nuova EC2 istanza Amazon.

## Informazioni sull'esempio
<a name="ec2-example-creating-an-instance-scenario"></a>

In questo esempio, utilizzi un modulo Node.js per creare un' EC2 istanza Amazon e assegnarle sia una coppia di key pair che dei tag. Il codice utilizza l'SDK per JavaScript creare e contrassegnare un'istanza utilizzando questi metodi della classe EC2 client Amazon:
+ [`runInstances`](https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/EC2.html#runInstances-property)
+ [`createTags`](https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/EC2.html#createTags-property)

## Attività prerequisite
<a name="ec2-example-creating-an-instance-prerequisites"></a>

Per configurare ed eseguire questo esempio, è necessario completare queste attività.
+ Installa Node.js. Per ulteriori informazioni, consultare il sito Web di [Node.js](https://nodejs.org).
+ Creazione di un file di configurazione condiviso con le credenziali utente. Per ulteriori informazioni sulla fornitura di un file delle credenziali condiviso, consulta [Caricamento delle credenziali su Node.js dal file delle credenziali condiviso](loading-node-credentials-shared.md).
+ Crea una coppia di chiavi. Per informazioni dettagliate, consultare [Lavorare con Amazon EC2 Key Pairs](ec2-example-key-pairs.md). Puoi utilizzare il nome della coppia di chiavi di questo esempio.

## Creazione e tagging di un'istanza
<a name="ec2-example-creating-an-instance-and-tags"></a>

Crea un modulo Node.js con il nome del file `ec2_createinstances.js`. Assicurati di configurare il kit SDK come mostrato in precedenza.

Crea un oggetto per passare i parametri per il `runInstances` metodo di AWS. EC2 classe client, incluso il nome della coppia di chiavi da assegnare e l'ID dell'AMI da eseguire. Per chiamare il `runInstances` metodo, crea una promessa per richiamare un oggetto di EC2 servizio Amazon, passando i parametri. Quindi gestisci la risposta nel callback della promessa. 

Il codice aggiunge quindi un `Name` tag a una nuova istanza, che la EC2 console Amazon riconosce e visualizza nel campo **Nome** dell'elenco delle istanze. È possibile aggiungere fino a un massimo di 50 tag per un'istanza, che possono essere aggiunti in una singola chiamata al metodo `createTags`.

```
// Load the AWS SDK for Node.js
var AWS = require("aws-sdk");
// Load credentials and set region from JSON file
AWS.config.update({ region: "REGION" });

// Create EC2 service object
var ec2 = new AWS.EC2({ apiVersion: "2016-11-15" });

// AMI is amzn-ami-2011.09.1.x86_64-ebs
var instanceParams = {
  ImageId: "AMI_ID",
  InstanceType: "t2.micro",
  KeyName: "KEY_PAIR_NAME",
  MinCount: 1,
  MaxCount: 1,
};

// Create a promise on an EC2 service object
var instancePromise = new AWS.EC2({ apiVersion: "2016-11-15" })
  .runInstances(instanceParams)
  .promise();

// Handle promise's fulfilled/rejected states
instancePromise
  .then(function (data) {
    console.log(data);
    var instanceId = data.Instances[0].InstanceId;
    console.log("Created instance", instanceId);
    // Add tags to the instance
    tagParams = {
      Resources: [instanceId],
      Tags: [
        {
          Key: "Name",
          Value: "SDK Sample",
        },
      ],
    };
    // Create a promise on an EC2 service object
    var tagPromise = new AWS.EC2({ apiVersion: "2016-11-15" })
      .createTags(tagParams)
      .promise();
    // Handle promise's fulfilled/rejected states
    tagPromise
      .then(function (data) {
        console.log("Instance tagged");
      })
      .catch(function (err) {
        console.error(err, err.stack);
      });
  })
  .catch(function (err) {
    console.error(err, err.stack);
  });
```

Digita la seguente riga di comando per eseguire l'esempio.

```
node ec2_createinstances.js
```

Questo codice di esempio può essere trovato [qui su GitHub](https://github.com/awsdocs/aws-doc-sdk-examples/tree/master/javascript/example_code/ec2/ec2_createinstances.js).