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](#API_DescribeAccessPoints_RequestSyntax) ** (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](#API_DescribeAccessPoints_RequestSyntax) ** (Opcional) Si proporciona un `FileSystemId`, EFS devuelve todos los puntos de acceso de ese sistema de archivos; se excluyen mutuamente con `AccessPointId`. 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](#API_DescribeAccessPoints_RequestSyntax) ** (Opcional) Al recuperar los puntos de acceso de un sistema de archivos, si lo desea, puede especificar el parámetro `MaxItems` para limitar el número de objetos devueltos en una respuesta. El valor predeterminado es 100. Rango válido: valor mínimo de 1. ** [NextToken](#API_DescribeAccessPoints_RequestSyntax) ** `NextToken` está presente si la respuesta está paginada. Puede utilizar `NextMarker` en 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](#API_DescribeAccessPoints_ResponseSyntax) ** Un conjunto de descripciones de puntos de acceso. Tipo: matriz de objetos [AccessPointDescription](API_AccessPointDescription.md) ** [NextToken](#API_DescribeAccessPoints_ResponseSyntax) ** 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 `AccessPointId` valor 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 `FileSystemId` valor 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: + [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/elasticfilesystem-2015-02-01/DescribeAccessPoints) + [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/DescribeAccessPoints) + [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/DescribeAccessPoints) + [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/DescribeAccessPoints) + [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/DescribeAccessPoints) + [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/DescribeAccessPoints) + [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/DescribeAccessPoints) + [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/DescribeAccessPoints) + [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/DescribeAccessPoints) + [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/DescribeAccessPoints)