

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

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

Atribui uma ou mais tags (pares de chave-valor) para a Amazon QuickSight recurso. 

As tags podem ajudar a organizar e categorizar seus recursos. Você também pode usá-las para definir o escopo de permissões de usuários, concedendo a um usuário permissão para acessar ou alterar apenas recursos com determinados valores de tag. Você pode usar o`TagResource`operação com um recurso que já tem tags. Se você especificar uma nova chave de tag para o recurso, essa tag será anexada à lista de tags associadas ao recurso. Se você especificar uma chave de tag que já esteja associada ao recurso, o novo valor de tag especificado substituirá o valor anterior dessa tag.

Você pode associar até 50 tags a um recurso. Amazônia QuickSight oferece suporte à marcação no conjunto de dados, na fonte de dados, no painel e no modelo. 

Marcação para a Amazon QuickSight funciona da mesma forma que marcar para outrosAWSserviços, exceto pelo seguinte:
+ Você não pode usar tags para rastrear custos da Amazon QuickSight. Isso não é possível porque você não pode marcar os recursos que a Amazon QuickSight os custos são baseados, por exemplo, na Amazon QuickSight capacidade de armazenamento (SPICE), número de usuários, tipo de usuários e métricas de uso.
+ Amazônia QuickSight No momento, o não oferece suporte ao editor de tags paraAWS Resource Groups.

## Sintaxe da solicitação
<a name="API_TagResource_RequestSyntax"></a>

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

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

## Parâmetros da solicitação de URI
<a name="API_TagResource_RequestParameters"></a>

A solicitação usa os parâmetros de URI a seguir.

 ** [ResourceArn](#API_TagResource_RequestSyntax) **   <a name="QS-TagResource-request-ResourceArn"></a>
O nome de recurso da Amazon (ARN) do recurso que você deseja marcar.  
Obrigatório: Sim

## Corpo da solicitação
<a name="API_TagResource_RequestBody"></a>

A solicitação aceita os dados a seguir no formato JSON.

 ** [Tags](#API_TagResource_RequestSyntax) **   <a name="QS-TagResource-request-Tags"></a>
Contém um mapa dos pares de chave-valor para a tag de recurso ou tags atribuídas ao recurso.  
Type: String of[Tag](API_Tag.md)objetos  
Membros da matriz: Número mínimo de 1 item. Número máximo de 200 itens.  
Obrigatório: Sim

## Sintaxe da resposta
<a name="API_TagResource_ResponseSyntax"></a>

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

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

## Elementos de resposta
<a name="API_TagResource_ResponseElements"></a>

Se a ação for bem-sucedida, o serviço retornará a resposta HTTP a seguir.

 ** [Status](#API_TagResource_ResponseSyntax) **   <a name="QS-TagResource-response-Status"></a>
O status HTTP da solicitação.

Os seguintes dados são retornados no formato JSON pelo serviço.

 ** [RequestId](#API_TagResource_ResponseSyntax) **   <a name="QS-TagResource-response-RequestId"></a>
OAWSID da solicitação para essa operação.  
Type: String

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

Para obter informações sobre os erros que são comuns a todas as ações, consulte[Erros comuns](CommonErrors.md).

 ** AccessDeniedException **   
Você não tem acesso a esse item. Não foi possível validar as credenciais fornecidas. Talvez você não tenha permissão para executar a solicitação. Verifique se sua conta está autorizada a usar a Amazon QuickSight , se as suas políticas têm as permissões corretas e se você está usando as chaves de acesso corretas.  
Código de status HTTP: 401

 ** InternalFailureException **   
Ocorreu um erro interno.  
Código de status HTTP: 500

 ** InvalidParameterValueException **   
Um ou mais parâmetros têm um valor que não é válido.  
Código de status HTTP: 400

 ** LimitExceededException **   
Um limite foi excedido.  
Código de status HTTP: 409

 ** ResourceNotFoundException **   
Não foi possível encontrar um ou mais recursos.  
Código de status HTTP: 404

 ** ThrottlingException **   
O acesso é limitado.  
Código de status HTTP: 429

## Consulte também
<a name="API_TagResource_SeeAlso"></a>

Para obter mais informações sobre como usar essa API em um dos AWS SDKs específicos de linguagem, consulte o seguinte:
+  [AWS Command Line Interface](https://docs.aws.amazon.com/goto/aws-cli/quicksight-2018-04-01/TagResource) 
+  [AWS SDK for .NET](https://docs.aws.amazon.com/goto/DotNetSDKV3/quicksight-2018-04-01/TagResource) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/quicksight-2018-04-01/TagResource) 
+  [AWS SDK for Go](https://docs.aws.amazon.com/goto/SdkForGoV1/quicksight-2018-04-01/TagResource) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/quicksight-2018-04-01/TagResource) 
+  [AWSSDK para o JavaScript](https://docs.aws.amazon.com/goto/AWSJavaScriptSDK/quicksight-2018-04-01/TagResource) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/quicksight-2018-04-01/TagResource) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/quicksight-2018-04-01/TagResource) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/quicksight-2018-04-01/TagResource) 