TagResource - Amazon Elastic File System
Sintaxe da SolicitaçãoURIParâmetros de solicitaçãoCorpo 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

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

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"
      }
   ]
}

URIParâmetros de solicitação

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

ResourceId

O ID que especifica o EFS recurso 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 seguintes dados no JSON formato.

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 for bem-sucedida, o serviço retornará uma resposta de HTTP 200 com o HTTP corpo vazio.

Erros

AccessPointNotFound

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

HTTPCódigo de status: 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.

HTTPCódigo de status: 400

FileSystemNotFound

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

HTTPCódigo de status: 404

InternalServerError

Retornado se ocorreu um erro no lado do servidor.

HTTPCódigo de status: 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 isso API em um idioma específico AWS SDKs, consulte o seguinte: