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.
DescribeAccessPoints
Devuelve la descripción de un punto de acceso de Amazon EFS específico, si se proporciona AccessPointId. Si proporciona un FileSystemId de EFS, devuelve descripciones de todos los puntos de acceso de ese sistema de archivos. Puede proporcionar un AccessPointId o un FileSystemId en la solicitud, pero no ambos.
Esta operación necesita permisos para la acción elasticfilesystem:DescribeAccessPoints.
Sintaxis de la solicitud
GET /2015-02-01/access-points?AccessPointId=AccessPointId&FileSystemId=FileSystemId&MaxResults=MaxResults&NextToken=NextToken HTTP/1.1
Parámetros de solicitud del URI
La solicitud utiliza los siguientes parámetros URI.
- AccessPointId
-
(Opcional) Especifica un punto de acceso de EFS para describirlo en la respuesta; se excluye mutuamente con
FileSystemId.Limitaciones de longitud: longitud máxima de 128 caracteres.
Patrón:
^(arn:aws[-a-z]*:elasticfilesystem:[0-9a-z-:]+:access-point/fsap-[0-9a-f]{8,40}|fsap-[0-9a-f]{8,40})$ - FileSystemId
-
(Opcional) Si proporciona un
FileSystemId, EFS devuelve todos los puntos de acceso de ese sistema de archivos; se excluyen mutuamente conAccessPointId.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})$ - MaxResults
-
(Opcional) Al recuperar los puntos de acceso de un sistema de archivos, si lo desea, puede especificar el parámetro
MaxItemspara limitar el número de objetos devueltos en una respuesta. El valor predeterminado es 100.Rango válido: valor mínimo de 1.
- NextToken
-
NextTokenestá presente si la respuesta está paginada. Puede utilizarNextMarkeren la solicitud subsiguiente para obtener la siguiente página de descripciones del punto de acceso.Limitaciones de longitud: longitud mínima de 1. Longitud máxima de 128.
Patrón:
.+
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
{
"AccessPoints": [
{
"AccessPointArn": "string",
"AccessPointId": "string",
"ClientToken": "string",
"FileSystemId": "string",
"LifeCycleState": "string",
"Name": "string",
"OwnerId": "string",
"PosixUser": {
"Gid": number,
"SecondaryGids": [ number ],
"Uid": number
},
"RootDirectory": {
"CreationInfo": {
"OwnerGid": number,
"OwnerUid": number,
"Permissions": "string"
},
"Path": "string"
},
"Tags": [
{
"Key": "string",
"Value": "string"
}
]
}
],
"NextToken": "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.
- AccessPoints
-
Un conjunto de descripciones de puntos de acceso.
Tipo: matriz de objetos AccessPointDescription
- NextToken
-
Está presente si hay más puntos de acceso de los que se devuelven en la respuesta. Puede utilizar el NextMarker en la solicitud posterior para obtener las descripciones adicionales.
Tipo: cadena
Limitaciones de longitud: longitud mínima de 1. Longitud máxima de 128.
Patrón:
.+
Errores
- AccessPointNotFound
-
Se devuelve si el
AccessPointIdvalor especificado no existe en el del solicitante. Cuenta de AWS- ErrorCode
-
El código de error es una cadena que identifica de forma exclusiva una condición de error. Está diseñado para que los programas que detectan y administran errores por tipo puedan leerlo y comprenderlo.
- Message
-
El mensaje de error contiene una descripción genérica de la condición de error en inglés. Está destinado a un público humano. Los programas simples muestran el mensaje directamente al usuario final si se detecta una condición de error que no sabe cómo controlar o no le interesa hacerlo. Los programas sofisticados con un control de errores más exhaustivo y una internacionalización adecuada tienen más probabilidades de ignorar el mensaje de error.
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.
- ErrorCode
-
El código de error es una cadena que identifica de forma exclusiva una condición de error. Está diseñado para que los programas que detectan y administran errores por tipo puedan leerlo y comprenderlo.
- Message
-
El mensaje de error contiene una descripción genérica de la condición de error en inglés. Está destinado a un público humano. Los programas simples muestran el mensaje directamente al usuario final si se detecta una condición de error que no sabe cómo controlar o no le interesa hacerlo. Los programas sofisticados con un control de errores más exhaustivo y una internacionalización adecuada tienen más probabilidades de ignorar el mensaje de error.
Código de estado HTTP: 400
- FileSystemNotFound
-
Se devuelve si el
FileSystemIdvalor especificado no existe en el del solicitante. Cuenta de AWS- ErrorCode
-
El código de error es una cadena que identifica de forma exclusiva una condición de error. Está diseñado para que los programas que detectan y administran errores por tipo puedan leerlo y comprenderlo.
- Message
-
El mensaje de error contiene una descripción genérica de la condición de error en inglés. Está destinado a un público humano. Los programas simples muestran el mensaje directamente al usuario final si se detecta una condición de error que no sabe cómo controlar o no le interesa hacerlo. Los programas sofisticados con un control de errores más exhaustivo y una internacionalización adecuada tienen más probabilidades de ignorar el mensaje de error.
Código de estado HTTP: 404
- InternalServerError
-
Se devuelve si se ha producido un error en el servidor.
- ErrorCode
-
El código de error es una cadena que identifica de forma exclusiva una condición de error. Está diseñado para que los programas que detectan y administran errores por tipo puedan leerlo y comprenderlo.
- Message
-
El mensaje de error contiene una descripción genérica de la condición de error en inglés. Está destinado a un público humano. Los programas simples muestran el mensaje directamente al usuario final si se detecta una condición de error que no sabe cómo controlar o no le interesa hacerlo. Los programas sofisticados con un control de errores más exhaustivo y una internacionalización adecuada tienen más probabilidades de ignorar el mensaje de error.
Código de estado HTTP: 500
Véase también
Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
