

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

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

Atcorde une ou plusieurs balises (paires clé-valeur) à l'Amazon spécifié QuickSight ressource. 

Les balises vous aident à organiser et à classer vos ressources. Vous pouvez également les utiliser pour définir des autorisations utilisateur, en accordant une autorisation utilisateur pour accéder ou modifier uniquement les ressources avec certaines valeurs de balise. Vous pouvez utiliser le plugin`TagResource`opération avec une ressource qui possède déjà des balises. Si vous spécifiez une nouvelle clé de balise pour la ressource, cette balise est ajoutée à la liste des balises associées à la ressource. Si vous spécifiez une clé de balise déjà associée à la ressource, la nouvelle valeur de balise que vous spécifiez remplace la valeur précédente de cette balise.

Vous pouvez associer jusqu'à 50 balises à une ressource. Amazon QuickSight prend en charge le balisage de l'ensemble de données, de la source de données, du tableau de bord 

Marquage pour Amazon QuickSight fonctionne d'une manière similaire au balisage pour d'autresAWSservices, à l'exception des éléments suivants :
+ Vous ne pouvez pas utiliser de balises pour suivre les coûts d'Amazon QuickSight. Cela n'est pas possible car vous ne pouvez pas étiqueter les ressources qu'Amazon utilise QuickSight les coûts sont basés, par exemple, sur Amazon QuickSight la capacité de stockage (SPICE), le nombre d'utilisateurs, le type d'utilisateurs et les mesures d'utilisation.
+ Amazon QuickSight ne prend pas en charge actuellement l'éditeur de balises pourGroupes de ressources AWS.

## Syntaxe de la demande
<a name="API_TagResource_RequestSyntax"></a>

```
POST /resources/ResourceArn/tags HTTP/1.1
Content-type: application/json

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

## Paramètres de demande URI
<a name="API_TagResource_RequestParameters"></a>

La demande utilise les paramètres URI suivants.

 ** [ResourceArn](#API_TagResource_RequestSyntax) **   <a name="QS-TagResource-request-ResourceArn"></a>
Amazon Rsource Name (ARN) de la ressource que vous souhaitez baliser.  
Obligatoire : Oui

## Corps de la demande
<a name="API_TagResource_RequestBody"></a>

Cette demande accepte les données suivantes au format JSON.

 ** [Tags](#API_TagResource_RequestSyntax) **   <a name="QS-TagResource-request-Tags"></a>
Contient une carte des paires clé-valeur pour la ou les balises de ressource attribuées à la ressource.  
Type : Tableau de[Tag](API_Tag.md)objets  
Membres du tableau : Nombre minimal de 1 élément. Nombre maximal de 200 éléments.  
Obligatoire : Oui

## Syntaxe de la réponse
<a name="API_TagResource_ResponseSyntax"></a>

```
HTTP/1.1 Status
Content-type: application/json

{
   "RequestId": "string"
}
```

## Eléments de réponse
<a name="API_TagResource_ResponseElements"></a>

Si l'action aboutit, le service renvoie la réponse HTTP suivante.

 ** [Status](#API_TagResource_ResponseSyntax) **   <a name="QS-TagResource-response-Status"></a>
Le statut HTTP de la requête.

Les données suivantes sont renvoyées au format JSON par le service.

 ** [RequestId](#API_TagResource_ResponseSyntax) **   <a name="QS-TagResource-response-RequestId"></a>
LeAWSID de demande pour cette opération.  
Type : Chaîne

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

Pour plus d'informations sur les erreurs communes à toutes les actions, consultez[Erreurs courantes](CommonErrors.md).

 ** AccessDeniedException **   
Vous n'avez pas accès à cet élément. Les informations d'identification fournies n'ont pas pu être validées. Il est possible que vous ne soyez pas autorisé à effectuer la demande. Assurez-vous que votre compte est autorisé à utiliser Amazon QuickSight , que vos stratégies ont les autorisations appropriées et que vous utilisez les bonnes clés d'accès.  
HTTP Status Code : 401

 ** InternalFailureException **   
Une défaillance interne s'est produite.  
HTTP Status Code : 500

 ** InvalidParameterValueException **   
La valeur d'un ou de plusieurs paramètres n'est pas valide.  
HTTP Status Code : 400

 ** LimitExceededException **   
Une limite est dépassée.  
HTTP Status Code : 409

 ** ResourceNotFoundException **   
Une ou plusieurs ressources n'ont pas pu être trouvées.  
HTTP Status Code : 404

 ** ThrottlingException **   
L'accès est limité.  
HTTP Status Code : 429

## Voir aussi
<a name="API_TagResource_SeeAlso"></a>

Pour plus d'informations sur l'utilisation de cette API dans l'un des kits SDK AWS spécifiques au langage, consultez les ressources suivantes :
+  [Interface de ligne de commande AWS](https://docs.aws.amazon.com/goto/aws-cli/quicksight-2018-04-01/TagResource) 
+  [AWS SDK pour .NET](https://docs.aws.amazon.com/goto/DotNetSDKV3/quicksight-2018-04-01/TagResource) 
+  [Kit AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/quicksight-2018-04-01/TagResource) 
+  [Kit AWS SDK pour Go](https://docs.aws.amazon.com/goto/SdkForGoV1/quicksight-2018-04-01/TagResource) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/quicksight-2018-04-01/TagResource) 
+  [AWSKits SDK pour JavaScript](https://docs.aws.amazon.com/goto/AWSJavaScriptSDK/quicksight-2018-04-01/TagResource) 
+  [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/quicksight-2018-04-01/TagResource) 
+  [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/quicksight-2018-04-01/TagResource) 
+  [Kit SDK AWS pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/quicksight-2018-04-01/TagResource) 