View a markdown version of this page

CreateTags - Amazon Elastic File System

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

CreateTags

nota

OBSOLETO: CreateTags está obsoleto e não será mantido. Para criar tags para recursos do EFS, use a ação TagResource da API.

Cria ou substitui as tags associadas a um sistema de arquivos. Cada tag é um par de chave/valor. Se uma chave de tag especificada na solicitação já existir no sistema de arquivos, essa operação substituirá seu valor pelo valor fornecido na solicitação. Se você adicionar a tag Name ao seu sistema de arquivos, o Amazon EFS a retornará na resposta à operação DescribeFileSystems.

Essa operação exige permissão para a ação elasticfilesystem:CreateTags.

Sintaxe da Solicitação

POST /2015-02-01/create-tags/FileSystemId 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:

FileSystemId

O ID do sistema de arquivos cujas tags você deseja modificar (String). Essa operação modifica somente as tags, não o sistema de arquivos.

Restrições de Tamanho: Tamanho máximo de 128.

Padrão: ^(arn:aws[-a-z]*:elasticfilesystem:[0-9a-z-:]+:file-system/fs-[0-9a-f]{8,40}|fs-[0-9a-f]{8,40})$

Obrigatório: 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

Obrigatório: sim

Sintaxe da resposta

HTTP/1.1 204

Elementos de resposta

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

Erros

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

Consulte também

Para obter mais informações sobre como usar essa API em uma das linguagens específicas AWS SDKs, consulte o seguinte: