ListTagsForResource - Amazon Elastic File System
Sintaxis de la solicitudParámetros de solicitud del URICuerpo de la solicitudSintaxis de la respuestaElementos de respuestaErroresVéase también

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.

ListTagsForResource

Muestra una lista de todas las etiquetas de un recurso de EFS de nivel superior. Debe proporcionar el ID del recurso para el que quiera recuperar las etiquetas.

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

Sintaxis de la solicitud

GET /2015-02-01/resource-tags/ResourceId?MaxResults=MaxResults&NextToken=NextToken HTTP/1.1

Parámetros de solicitud del URI

La solicitud utiliza los siguientes parámetros URI.

MaxResults

(Opcional) Especifica la cantidad máxima de objetos de etiqueta que se devuelven en la respuesta. El valor predeterminado es 100.

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

NextToken

(Opcional) Puede usar NextToken en una solicitud posterior para buscar la siguiente página de descripciones de puntos de acceso si la carga útil de la respuesta estaba paginada.

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

Patrón: .+

ResourceId

Especifica el recurso de EFS para el que desea recuperar las etiquetas. Puede recuperar etiquetas para los puntos de acceso y los sistemas de archivos de EFS mediante este punto de conexión de API.

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 no tiene un cuerpo de la solicitud.

Sintaxis de la respuesta

HTTP/1.1 200
Content-type: application/json

{
   "NextToken": "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.

NextToken

NextToken está presente si la carga útil de la respuesta está paginada. Puede utilizar NextToken en la solicitud subsiguiente para obtener la siguiente página de descripciones del punto de acceso.

Tipo: string

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

Patrón: .+

Tags

Un conjunto de las etiquetas del recurso de EFS especificado.

Tipo: matriz de objetos Tag

Errores

AccessPointNotFound

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

Código de estado HTTP: 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.

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

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: