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>

Criar uma tag para um recurso do EFS. Você pode criar tags para sistemas de arquivos e pontos de acesso do EFS usando essa operação de API.

Essa operação exige permissões para a ação `elasticfilesystem:TagResource`.

## Sintaxe da Solicitação
<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"
      }
   ]
}
```

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

A solicitação usa os seguintes parâmetros de URI:

 ** [ResourceId](#API_TagResource_RequestSyntax) **   <a name="efs-TagResource-request-uri-ResourceId"></a>
O ID que especifica o recurso do EFS para o qual você deseja criar uma tag.  
Restrições de Tamanho: Tamanho máximo de 128.  
Padrão: `^(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})$`   
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="efs-TagResource-request-Tags"></a>
Uma matriz de objetos de `Tag` para adicionar. Cada objeto de `Tag` é um par de chave-valor.  
Tipo: matriz de objetos [Tag](API_Tag.md)  
Obrigatório: sim

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

```
HTTP/1.1 200
```

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

Se a ação for bem-sucedida, o serviço reenviará uma resposta 200 HTTP com um corpo HTTP vazio.

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

 ** AccessPointNotFound **   
Retornado se o `AccessPointId` valor especificado não existir no valor do Conta da AWS solicitante.    
 ** ErrorCode **   
O código de erro é uma sequência que identifica exclusivamente uma condição de erro. O objetivo desse código é ser lido e compreendido pelos programas que detectam e tratam erros por tipo.   
 ** Message **   
A mensagem de erro contém uma descrição genérica da condição do erro em inglês. Ela é destinada ao público humano. Programas simples exibem a mensagem diretamente ao usuário final se encontrarem uma condição de erro que não conhecem ou não tratam. Programas sofisticados com tratamento de erro mais exaustivo e internacionalização própria são mais de prováveis de ignorar a mensagem de erro.
Código de status HTTP: 404

 ** BadRequest **   
Retornado se a solicitação estiver malformada ou contiver um erro, como um valor de parâmetro inválido ou um parâmetro obrigatório ausente.    
 ** ErrorCode **   
O código de erro é uma sequência que identifica exclusivamente uma condição de erro. O objetivo desse código é ser lido e compreendido pelos programas que detectam e tratam erros por tipo.   
 ** Message **   
A mensagem de erro contém uma descrição genérica da condição do erro em inglês. Ela é destinada ao público humano. Programas simples exibem a mensagem diretamente ao usuário final se encontrarem uma condição de erro que não conhecem ou não tratam. Programas sofisticados com tratamento de erro mais exaustivo e internacionalização própria são mais de prováveis de ignorar a mensagem de erro.
Código de status HTTP: 400

 ** FileSystemNotFound **   
Retornado se o `FileSystemId` valor especificado não existir no valor do Conta da AWS solicitante.    
 ** ErrorCode **   
O código de erro é uma sequência que identifica exclusivamente uma condição de erro. O objetivo desse código é ser lido e compreendido pelos programas que detectam e tratam erros por tipo.   
 ** Message **   
A mensagem de erro contém uma descrição genérica da condição do erro em inglês. Ela é destinada ao público humano. Programas simples exibem a mensagem diretamente ao usuário final se encontrarem uma condição de erro que não conhecem ou não tratam. Programas sofisticados com tratamento de erro mais exaustivo e internacionalização própria são mais de prováveis de ignorar a mensagem de erro.
Código de status HTTP: 404

 ** InternalServerError **   
Retornado se ocorreu um erro no lado do servidor.    
 ** ErrorCode **   
O código de erro é uma sequência que identifica exclusivamente uma condição de erro. O objetivo desse código é ser lido e compreendido pelos programas que detectam e tratam erros por tipo.   
 ** Message **   
A mensagem de erro contém uma descrição genérica da condição do erro em inglês. Ela é destinada ao público humano. Programas simples exibem a mensagem diretamente ao usuário final se encontrarem uma condição de erro que não conhecem ou não tratam. Programas sofisticados com tratamento de erro mais exaustivo e internacionalização própria são mais de prováveis de ignorar a mensagem de erro.
Código de status HTTP: 500

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

### Criar tags em um sistema de arquivos
<a name="API_TagResource_Example_1"></a>

A solicitação a seguir cria três tags (`"key1"`, `"key2"`, e `"key3"`) no sistema de arquivos especificado.

#### Exemplo de solicitação
<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"            
        }
    ]
}
```

#### Resposta da amostra
<a name="API_TagResource_Example_1_Response"></a>

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

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

Para obter mais informações sobre como usar essa API em uma das linguagens específicas AWS SDKs, consulte o seguinte:
+  [AWS Interface de linha de comando V2](https://docs.aws.amazon.com/goto/cli2/elasticfilesystem-2015-02-01/TagResource) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/TagResource) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/TagResource) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/TagResource) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/TagResource) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/TagResource) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/TagResource) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/TagResource) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/TagResource) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/TagResource)