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ámetroMarker
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: