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

DescribeTags

nota

OBSOLETO: la acción DescribeTags está en desuso y no recibe mantenimiento. Para ver las etiquetas asociadas a los recursos de EFS, utilice la acción ListTagsForResource de la API.

Devuelve las etiquetas asociadas a un sistema de archivos. El orden de las etiquetas devueltas en la respuesta a una llamada a DescribeTags y el orden de las etiquetas devueltas en las respuestas de una iteración de varias llamadas (cuando se utiliza la paginación) no están especificados.

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

Sintaxis de la solicitud

GET /2015-02-01/tags/FileSystemId/?Marker=Marker&MaxItems=MaxItems HTTP/1.1

Parámetros de solicitud del URI

La solicitud utiliza los siguientes parámetros URI.

FileSystemId

El ID del sistema de archivos cuya conjunto de etiquetas desea recuperar.

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

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

Obligatorio: sí

Marker

(Opcional) Un token de paginación opaco devuelto por una operación DescribeTags anterior (cadena). Si está presente, especifica continuar la lista desde donde terminó la llamada anterior.

Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 128.

Patrón: .+

MaxItems

(Opcional) El número máximo de etiquetas del sistema de archivos que se devuelven en una respuesta. Actualmente, este número se establece automáticamente en 100 y el resto de valores se ignoran. La respuesta se pagina a 100 por página si tiene más de 100 etiquetas.

Rango válido: valor mínimo de 1.

Cuerpo de la solicitud

La solicitud no tiene un cuerpo de la solicitud.

Sintaxis de la respuesta

HTTP/1.1 200 Content-type: application/json { "Marker": "string", "NextMarker": "string", "Tags": [ { "Key": "string", "Value": "string" } ] }

Elementos de respuesta

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200.

El servicio devuelve los datos siguientes en formato JSON.

Marker

Si la solicitud incluía un Marker, la respuesta devuelve ese valor en este campo.

Tipo: string

Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 128.

Patrón: .+

NextMarker

Si hay un valor, hay más etiquetas que devolver. En una solicitud posterior, puede proporcionar el valor de NextMarker como valor del parámetro Marker en la siguiente solicitud para recuperar el siguiente conjunto de etiquetas.

Tipo: string

Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 128.

Patrón: .+

Tags

Devuelve las etiquetas asociadas al sistema de archivos como un conjunto de objetos Tag.

Tipo: matriz de objetos Tag

Errores

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.

Código de estado HTTP: 400

FileSystemNotFound

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

Código de estado HTTP: 404

InternalServerError

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

Código de estado HTTP: 500

Ejemplos

Recuperar etiquetas asociadas a un sistema de archivos

La siguiente solicitud recupera etiquetas (pares de clave-valor) asociadas al sistema de archivos especificado.

Solicitud de muestra

GET /2015-02-01/tags/fs-01234567/ HTTP/1.1 Host: elasticfilesystem.us-west-2.amazonaws.com x-amz-date: 20140620T215404Z Authorization: <...>

Respuesta de ejemplo

HTTP/1.1 200 OK x-amzn-RequestId: 01234567-89ab-cdef-0123-456789abcdef Content-Type: application/json Content-Length: 288 { "Tags":[ { "Key":"Name", "Value":"my first file system" }, { "Key":"Fleet", "Value":"Development" }, { "Key":"Developer", "Value":"Alice" } ] }

Véase también

Para obtener más información sobre el uso de esta API en un SDK de AWS de un lenguaje específico, consulte: