TagResource - Amazon Elastic File System

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

TagResource

Crea una etiqueta para un EFS recurso. Puede crear etiquetas para sistemas de EFS archivos y puntos de acceso mediante esta API operación.

Esta operación necesita permisos para la acción elasticfilesystem:TagResource.

Sintaxis de la solicitud

POST /2015-02-01/resource-tags/ResourceId HTTP/1.1 Content-type: application/json { "Tags": [ { "Key": "string", "Value": "string" } ] }

URIParámetros de solicitud

La solicitud utiliza los siguientes URI parámetros.

ResourceId

El ID que especifica el EFS recurso para el que desea crear una etiqueta.

Limitaciones de longitud: longitud máxima de 128 caracteres.

Patrón: ^(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})$

Obligatorio: sí

Cuerpo de la solicitud

La solicitud acepta los siguientes datos en JSON formato.

Tags

Una matriz de objetos Tag que añadir. Cada objeto Tag es un par clave-valor.

Tipo: matriz de objetos Tag

Obligatorio: sí

Sintaxis de la respuesta

HTTP/1.1 200

Elementos de respuesta

Si la acción se realiza correctamente, el servicio devuelve una respuesta de HTTP 200 puntos con HTTP el cuerpo vacío.

Errores

AccessPointNotFound

Se devuelve si el AccessPointId valor especificado no existe en el del Cuenta de AWS solicitante.

HTTPCódigo de estado: 404

BadRequest

Se devuelve si la solicitud tiene un formato incorrecto o contiene un error, como un valor de parámetro no válido, o falta un parámetro obligatorio.

HTTPCódigo de estado: 400

FileSystemNotFound

Se devuelve si el FileSystemId valor especificado no existe en el del Cuenta de AWS solicitante.

HTTPCódigo de estado: 404

InternalServerError

Se devuelve si se ha producido un error en el servidor.

HTTPCódigo de estado: 500

Ejemplos

Crear etiquetas en un sistema de archivos

La siguiente solicitud crea tres etiquetas ("key1", "key2" y "key3") en el sistema de archivos especificado.

Solicitud de muestra

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

Respuesta de ejemplo

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

Véase también

Para obtener más información sobre cómo usarlo API en uno de los idiomas específicos AWS SDKs, consulte lo siguiente: