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à.

# TagResource
<a name="API_TagResource"></a>

Crea un tag per una risorsa EFS. È possibile creare tag per i file system e i punti di accesso EFS utilizzando questa operazione API.

Questa operazione richiede le autorizzazioni per l'operazione `elasticfilesystem:TagResource`.

## Sintassi della richiesta
<a name="API_TagResource_RequestSyntax"></a>

```
POST /2015-02-01/resource-tags/ResourceId HTTP/1.1
Content-type: application/json

{
   "Tags": [ 
      { 
         "Key": "string",
         "Value": "string"
      }
   ]
}
```

## Parametri della richiesta URI
<a name="API_TagResource_RequestParameters"></a>

La richiesta utilizza i seguenti parametri URI.

 ** [ResourceId](#API_TagResource_RequestSyntax) **   <a name="efs-TagResource-request-uri-ResourceId"></a>
L'ID che specifica la risorsa EFS per la quale desideri creare un tag.  
Limitazioni di lunghezza: lunghezza massima di 128.  
Modello: `^(arn:aws[-a-z]*:elasticfilesystem:[0-9a-z-:]+:(access-point/fsap|file-system/fs)-[0-9a-f]{8,40}|fs(ap)?-[0-9a-f]{8,40})$`   
Obbligatorio: sì

## Corpo della richiesta
<a name="API_TagResource_RequestBody"></a>

La richiesta accetta i seguenti dati in formato JSON.

 ** [Tags](#API_TagResource_RequestSyntax) **   <a name="efs-TagResource-request-Tags"></a>
Una matrice di oggetti `Tag` da aggiungere. Ogni oggetto `Tag` è una coppia chiave-valore.  
Tipo: matrice di oggetti [Tag](API_Tag.md)  
Obbligatorio: sì

## Sintassi della risposta
<a name="API_TagResource_ResponseSyntax"></a>

```
HTTP/1.1 200
```

## Elementi di risposta
<a name="API_TagResource_ResponseElements"></a>

Se l'operazione riesce, il servizio invia una risposta HTTP 200 con un corpo HTTP vuoto.

## Errori
<a name="API_TagResource_Errors"></a>

 ** AccessPointNotFound **   
Restituito se il `AccessPointId` valore specificato non esiste nel richiedente Account AWS.    
 ** ErrorCode **   
Il codice di errore è una stringa che identifica in modo univoco una condizione di errore. Ha lo scopo di essere letta e compresa dai programmi che rilevano e gestiscono gli errori in base al loro tipo.   
 ** Message **   
Il messaggio di errore contiene una descrizione generica della condizione di errore in inglese. È destinato a interlocutori umani. I programmi semplici visualizzano il messaggio direttamente all'utente finale se si verifica una condizione di errore che non conoscono o che non sono interessati a gestire. I programmi sofisticati, con una gestione degli errori più completa e una vera e propria internazionalizzazione, più probabilmente ignoreranno il messaggio di errore.
Codice di stato HTTP: 404

 ** BadRequest **   
Restituito se la richiesta non è valida o contiene un errore, ad esempio un valore di parametro non valido o un parametro obbligatorio mancante.    
 ** ErrorCode **   
Il codice di errore è una stringa che identifica in modo univoco una condizione di errore. Ha lo scopo di essere letta e compresa dai programmi che rilevano e gestiscono gli errori in base al loro tipo.   
 ** Message **   
Il messaggio di errore contiene una descrizione generica della condizione di errore in inglese. È destinato a interlocutori umani. I programmi semplici visualizzano il messaggio direttamente all'utente finale se si verifica una condizione di errore che non conoscono o che non sono interessati a gestire. I programmi sofisticati, con una gestione degli errori più completa e una vera e propria internazionalizzazione, più probabilmente ignoreranno il messaggio di errore.
Codice di stato HTTP: 400

 ** FileSystemNotFound **   
Restituito se il `FileSystemId` valore specificato non esiste in quello del richiedente. Account AWS    
 ** ErrorCode **   
Il codice di errore è una stringa che identifica in modo univoco una condizione di errore. Ha lo scopo di essere letta e compresa dai programmi che rilevano e gestiscono gli errori in base al loro tipo.   
 ** Message **   
Il messaggio di errore contiene una descrizione generica della condizione di errore in inglese. È destinato a interlocutori umani. I programmi semplici visualizzano il messaggio direttamente all'utente finale se si verifica una condizione di errore che non conoscono o che non sono interessati a gestire. I programmi sofisticati, con una gestione degli errori più completa e una vera e propria internazionalizzazione, più probabilmente ignoreranno il messaggio di errore.
Codice di stato HTTP: 404

 ** InternalServerError **   
Restituito se si è verificato un errore lato server.    
 ** ErrorCode **   
Il codice di errore è una stringa che identifica in modo univoco una condizione di errore. Ha lo scopo di essere letta e compresa dai programmi che rilevano e gestiscono gli errori in base al loro tipo.   
 ** Message **   
Il messaggio di errore contiene una descrizione generica della condizione di errore in inglese. È destinato a interlocutori umani. I programmi semplici visualizzano il messaggio direttamente all'utente finale se si verifica una condizione di errore che non conoscono o che non sono interessati a gestire. I programmi sofisticati, con una gestione degli errori più completa e una vera e propria internazionalizzazione, più probabilmente ignoreranno il messaggio di errore.
Codice di stato HTTP: 500

## Esempi
<a name="API_TagResource_Examples"></a>

### Creazione di tag su un file system
<a name="API_TagResource_Example_1"></a>

La richiesta seguente crea tre tag (`"key1"`, `"key2"` e `"key3"`) nel file system specificato.

#### Richiesta di esempio
<a name="API_TagResource_Example_1_Request"></a>

```
POST /2015-02-01/tag-resource/fs-01234567 HTTP/1.1 
Host: elasticfilesystem.us-west-2.amazonaws.com
x-amz-date: 20140620T221118Z
Authorization: <...>
Content-Type: application/json
Content-Length: 160

{
    "Tags": [
        {
            "Key": "key1",
            "Value": "value1"            
        },
        {
            "Key": "key2",
            "Value": "value2"            
        },
        {
            "Key": "key3",
            "Value": "value3"            
        }
    ]
}
```

#### Risposta di esempio
<a name="API_TagResource_Example_1_Response"></a>

```
HTTP/1.1 204 no content
x-amzn-RequestId: 01234567-89ab-cdef-0123-456789abcdef
```

## Vedi anche
<a name="API_TagResource_SeeAlso"></a>

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/elasticfilesystem-2015-02-01/TagResource) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/TagResource) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/TagResource) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/TagResource) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/TagResource) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/TagResource) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/TagResource) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/TagResource) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/TagResource) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/TagResource)