TagResource - Amazon Elastic File System
Sintaxe da SolicitaçãoParâmetros da Solicitação de URICorpo da SolicitaçãoSintaxe da RespostaElementos de RespostaErrosExemplosConsulte também

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

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

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 solicitação usa os seguintes parâmetros de URI:

ResourceId

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})$

Exigido: Sim

Corpo da Solicitação

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

Tags

Uma matriz de objetos de Tag para adicionar. Cada objeto de Tag é um par de chave-valor.

Tipo: matriz de objetos Tag

Exigido: Sim

Sintaxe da Resposta

HTTP/1.1 200

Elementos de Resposta

Se a ação tiver êxito, o serviço enviará de volta uma resposta HTTP 200 com um corpo HTTP vazio.

Erros

AccessPointNotFound

Retornado se o AccessPointId valor especificado não existir no valor do Conta da AWS solicitante.

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.

Código de Status HTTP: 400

FileSystemNotFound

Retornado se o FileSystemId valor especificado não existir no valor do Conta da AWS solicitante.

Código de Status HTTP: 404

InternalServerError

Retornado se ocorreu um erro no lado do servidor.

Código de Status HTTP: 500

Exemplos

Criar tags em um sistema de arquivos

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

Exemplo de solicitação

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

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

Consulte também

Para obter mais informações sobre como usar essa API em um dos AWS SDKs específicos da linguagem, consulte o seguinte: