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.
# Acciones
Se admiten las siguientes acciones:
+ [CreateAccessPoint](API_CreateAccessPoint.md)
+ [CreateFileSystem](API_CreateFileSystem.md)
+ [CreateMountTarget](API_CreateMountTarget.md)
+ [CreateReplicationConfiguration](API_CreateReplicationConfiguration.md)
+ [CreateTags](API_CreateTags.md)
+ [DeleteAccessPoint](API_DeleteAccessPoint.md)
+ [DeleteFileSystem](API_DeleteFileSystem.md)
+ [DeleteFileSystemPolicy](API_DeleteFileSystemPolicy.md)
+ [DeleteMountTarget](API_DeleteMountTarget.md)
+ [DeleteReplicationConfiguration](API_DeleteReplicationConfiguration.md)
+ [DeleteTags](API_DeleteTags.md)
+ [DescribeAccessPoints](API_DescribeAccessPoints.md)
+ [DescribeAccountPreferences](API_DescribeAccountPreferences.md)
+ [DescribeBackupPolicy](API_DescribeBackupPolicy.md)
+ [DescribeFileSystemPolicy](API_DescribeFileSystemPolicy.md)
+ [DescribeFileSystems](API_DescribeFileSystems.md)
+ [DescribeLifecycleConfiguration](API_DescribeLifecycleConfiguration.md)
+ [DescribeMountTargets](API_DescribeMountTargets.md)
+ [DescribeMountTargetSecurityGroups](API_DescribeMountTargetSecurityGroups.md)
+ [DescribeReplicationConfigurations](API_DescribeReplicationConfigurations.md)
+ [DescribeTags](API_DescribeTags.md)
+ [ListTagsForResource](API_ListTagsForResource.md)
+ [ModifyMountTargetSecurityGroups](API_ModifyMountTargetSecurityGroups.md)
+ [PutAccountPreferences](API_PutAccountPreferences.md)
+ [PutBackupPolicy](API_PutBackupPolicy.md)
+ [PutFileSystemPolicy](API_PutFileSystemPolicy.md)
+ [PutLifecycleConfiguration](API_PutLifecycleConfiguration.md)
+ [TagResource](API_TagResource.md)
+ [UntagResource](API_UntagResource.md)
+ [UpdateFileSystem](API_UpdateFileSystem.md)
+ [UpdateFileSystemProtection](API_UpdateFileSystemProtection.md)
# CreateAccessPoint
Crea un punto de acceso de EFS Un punto de acceso es una vista específica de la aplicación en un sistema de archivos de EFS que aplica un usuario y un grupo del sistema operativo, así como una ruta del sistema de archivos, a cualquier solicitud del sistema de archivos realizada a través del punto de acceso. El usuario y el grupo del sistema operativo invalidan cualquier información de identidad proporcionada por el cliente de NFS. La ruta del sistema de archivos se expone como directorio raíz del punto de acceso. Las aplicaciones que utilizan el punto de acceso solo pueden acceder a los datos en el directorio y subdirectorios de la propia aplicación. Un sistema de archivos puede tener un máximo de 10 000 puntos de acceso, a menos que solicite un aumento. Para obtener más información, consulte [Mounting a file system using EFS access points](https://docs.aws.amazon.com/efs/latest/ug/efs-access-points.html) (Montaje de un sistema de archivos mediante puntos de acceso de EFS).
**nota**
Si se envían varias solicitudes para crear puntos de acceso en el mismo sistema de archivos en rápida sucesión y el sistema de archivos se acerca al límite de puntos de acceso, es posible que estas solicitudes reciban una limitación como respuesta. Esto es para garantizar que el sistema de archivos no supere el límite de puntos de acceso indicada.
Esta operación necesita permisos para la acción `elasticfilesystem:CreateAccessPoint`.
Los puntos de acceso se pueden etiquetar al crearlos. Si se especifican etiquetas en la acción de creación, IAM realiza una autorización adicional en la acción `elasticfilesystem:TagResource` para verificar que los usuarios tengan permisos para crear etiquetas. Por lo tanto, usted debe conceder permisos explícitos para utilizar la acción `elasticfilesystem:TagResource`. Para obtener más información, consulte [Conceder permisos para etiquetar recursos durante la creación](https://docs.aws.amazon.com/efs/latest/ug/using-tags-efs.html#supported-iam-actions-tagging.html).
## Sintaxis de la solicitud
```
POST /2015-02-01/access-points HTTP/1.1
Content-type: application/json
{
"ClientToken": "string",
"FileSystemId": "string",
"PosixUser": {
"Gid": number,
"SecondaryGids": [ number ],
"Uid": number
},
"RootDirectory": {
"CreationInfo": {
"OwnerGid": number,
"OwnerUid": number,
"Permissions": "string"
},
"Path": "string"
},
"Tags": [
{
"Key": "string",
"Value": "string"
}
]
}
```
## Parámetros de solicitud del URI
La solicitud no utiliza ningún parámetro de URI.
## Cuerpo de la solicitud
La solicitud acepta los siguientes datos en formato JSON.
** [ClientToken](#API_CreateAccessPoint_RequestSyntax) **
Cadena de hasta 64 caracteres ASCII que Amazon EFS utiliza para garantizar la creación idempotente.
Tipo: cadena
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 64.
Patrón: `.+`
Obligatorio: sí
** [FileSystemId](#API_CreateAccessPoint_RequestSyntax) **
El ID del sistema de archivos de EFS al que el punto de acceso proporciona acceso.
Tipo: cadena
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í
** [PosixUser](#API_CreateAccessPoint_RequestSyntax) **
El usuario y el grupo del sistema operativo aplicados a todas las solicitudes del sistema de archivos realizadas mediante el punto de acceso.
Tipo: objeto [PosixUser](API_PosixUser.md)
Obligatorio: no
** [RootDirectory](#API_CreateAccessPoint_RequestSyntax) **
Especifica el directorio del sistema de archivos de EFS que el punto de acceso expone como directorio raíz del sistema de archivos a los clientes de NFS que utilizan el punto de acceso. Los clientes que utilizan el punto de acceso solo pueden acceder al directorio raíz e inferiores. Si `RootDirectory` > `Path` especificado no existe, Amazon EFS crea el directorio raíz utilizando la configuración de `CreationInfo` cuando un cliente se conecta a un punto de acceso. Al especificar un `RootDirectory`, debe proporcionar la `Path` y la `CreationInfo`.
Amazon EFS crea un directorio raíz solo si ha proporcionado CreationInfo: OwnUid, OwnGID y los permisos para el directorio. Si no proporciona dicha información, Amazon EFS no creará el directorio raíz. Si el directorio raíz no existe, los intentos de montaje utilizando el punto de acceso fallarán.
Tipo: objeto [RootDirectory](API_RootDirectory.md)
Obligatorio: no
** [Tags](#API_CreateAccessPoint_RequestSyntax) **
Crea las etiquetas asociadas al punto de acceso. Cada etiqueta es un par clave-valor, cada clave debe ser única. Para obtener más información, consulte los [AWS recursos de etiquetado](https://docs.aws.amazon.com/general/latest/gr/aws_tagging.html) en la Guía de referencia * AWS general*.
Tipo: matriz de objetos [Tag](API_Tag.md)
Obligatorio: no
## Sintaxis de la respuesta
```
HTTP/1.1 200
Content-type: application/json
{
"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"
}
]
}
```
## 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.
** [AccessPointArn](#API_CreateAccessPoint_ResponseSyntax) **
El nombre de recurso de Amazon (ARN) único asociado al punto de acceso.
Tipo: cadena
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}$`
** [AccessPointId](#API_CreateAccessPoint_ResponseSyntax) **
El ID del punto de acceso, asignado por Amazon EFS.
Tipo: cadena
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})$`
** [ClientToken](#API_CreateAccessPoint_ResponseSyntax) **
La cadena opaca especificada en la solicitud para garantizar la creación de idempotentes.
Tipo: cadena
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 64.
Patrón: `.+`
** [FileSystemId](#API_CreateAccessPoint_ResponseSyntax) **
El ID del sistema de archivos de EFS al que se aplica el punto de acceso.
Tipo: cadena
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})$`
** [LifeCycleState](#API_CreateAccessPoint_ResponseSyntax) **
Identifica la fase del ciclo de vida del punto de acceso.
Tipo: cadena
Valores válidos: `creating | available | updating | deleting | deleted | error`
** [Name](#API_CreateAccessPoint_ResponseSyntax) **
El nombre del punto de acceso. Este es el valor de la etiqueta `Name`.
Tipo: cadena
** [OwnerId](#API_CreateAccessPoint_ResponseSyntax) **
Identifica al Cuenta de AWS propietario del recurso del punto de acceso.
Tipo: cadena
Limitaciones de longitud: longitud máxima de 255 caracteres.
Patrón: `^(\d{12})|(\d{4}-\d{4}-\d{4})$`
** [PosixUser](#API_CreateAccessPoint_ResponseSyntax) **
La identidad POSIX completa, incluidos el ID de usuario, el ID de grupo y el grupo IDs secundario del punto de acceso que utilizan los clientes de NFS para todas las operaciones de archivos que utilizan el punto de acceso.
Tipo: objeto [PosixUser](API_PosixUser.md)
** [RootDirectory](#API_CreateAccessPoint_ResponseSyntax) **
El directorio del sistema de archivos de EFS que el punto de acceso expone como directorio raíz a los clientes de NFS que utilizan el punto de acceso.
Tipo: objeto [RootDirectory](API_RootDirectory.md)
** [Tags](#API_CreateAccessPoint_ResponseSyntax) **
Las etiquetas asociadas al punto de acceso, presentadas como una matriz de objetos Tag.
Tipo: matriz de objetos [Tag](API_Tag.md)
## Errores
** AccessPointAlreadyExists **
Se devuelve si el punto de acceso que está intentando crear ya existe, con el token de creación que proporcionó en la solicitud.
** 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: 409
** AccessPointLimitExceeded **
Se devuelve si ya Cuenta de AWS se ha creado el número máximo de puntos de acceso permitidos por sistema de archivos. Para obtener más información, consulte [https://docs.aws.amazon.com/efs/latest/ug/limits.html#limits-efs-resources-per-account-per-region](https://docs.aws.amazon.com/efs/latest/ug/limits.html#limits-efs-resources-per-account-per-region).
** 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: 403
** 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 Cuenta de AWS solicitante.
** 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
** IncorrectFileSystemLifeCycleState **
Se devuelve si el estado del ciclo de vida del sistema de archivos es no “disponible”.
** 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: 409
** 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
** ThrottlingException **
Se devuelve cuando la acción de la API `CreateAccessPoint` se ejecuta demasiado rápido y el número de puntos de acceso en el sistema de archivos se acerca al [límite de 120](https://docs.aws.amazon.com/efs/latest/ug/limits.html#limits-efs-resources-per-account-per-region).
** 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: 429
## 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/CreateAccessPoint)
+ [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/CreateAccessPoint)
+ [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/CreateAccessPoint)
+ [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/CreateAccessPoint)
+ [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/CreateAccessPoint)
+ [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/CreateAccessPoint)
+ [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/CreateAccessPoint)
+ [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/CreateAccessPoint)
+ [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/CreateAccessPoint)
+ [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/CreateAccessPoint)
# CreateFileSystem
Crea un nuevo sistema de archivos vacío. La operación requiere un token de creación en la solicitud que Amazon EFS usa para garantizar la creación idempotent (llamar a la operación con el mismo token de creación no tiene ningún efecto). Si actualmente no existe un sistema de archivos que sea propiedad de la persona que llama Cuenta de AWS con el token de creación especificado, esta operación hace lo siguiente:
+ Crea un nuevo sistema de archivos vacío. El sistema de archivos tendrá un ID de Amazon EFS asignado y un estado de ciclo de vida inicial de `creating`.
+ Se devuelve con la descripción del sistema de archivos creado.
De lo contrario, esta operación devuelve un error `FileSystemAlreadyExists` con el ID del sistema de archivos existente.
**nota**
Para casos de uso básicos, puede utilizar un UUID generado de forma aleatoria para el token de creación.
La operación idempotent le permite volver a intentar una llamada `CreateFileSystem` sin riesgo de crear un sistema de archivos adicional. Esto puede ocurrir cuando una llamada inicial produce un error de forma que queda la incertidumbre de si se creó o no un sistema de archivos. Por ejemplo, se agotó el tiempo de espera de nivel de transporte o se restableció la conexión. Siempre que utilice el mismo token de creación, si la llamada inicial hubiera realizado con éxito la creación de un sistema de archivos, el cliente puede deducir su existencia a partir del error `FileSystemAlreadyExists`.
Para obtener más información, consulte [Creación de recursos para Amazon EFS](https://docs.aws.amazon.com/efs/latest/ug/creating-using-create-fs.html#creating-using-create-fs-part1) en la *Guía del usuario de Amazon EFS*.
**nota**
La llamada `CreateFileSystem` realiza devuelve información mientras el estado de ciclo de vida del sistema de archivos siga siendo `creating`. Puede comprobar el estado de creación del sistema de archivos llamando a la operación [DescribeFileSystems](API_DescribeFileSystems.md), que entre otras cosas devuelve el estado del sistema de archivos.
Esta operación también tiene un parámetro `PerformanceMode` opcional que elige para su sistema de archivos. Se recomienda `generalPurpose` `PerformanceMode` para todos los sistemas de archivos. El modo `maxIO` es un tipo de rendimiento de la generación anterior que está diseñado para cargas de trabajo altamente paralelizadas que pueden tolerar latencias más altas que el modo `generalPurpose`. El modo `MaxIO` no es compatible con los sistemas de archivos One Zone o sistemas de archivos que utilicen rendimiento elástico.
El `PerformanceMode` no se puede cambiar después de haber creado el sistema de archivos. Para obtener más información, consulte [Amazon EFS: Modos de rendimiento](https://docs.aws.amazon.com/efs/latest/ug/performance.html#performancemodes.html).
El modo de rendimiento del sistema de archivos se puede configurar mediante el parámetro `ThroughputMode`.
Una vez que se ha creado totalmente el sistema de archivos, Amazon EFS establece su estado de ciclo de vida en `available`. A partir de ese momento puede crear uno o varios destinos de montaje para el sistema de archivos en la VPC. Para obtener más información, consulte [CreateMountTarget](API_CreateMountTarget.md). El sistema de archivos Amazon EFS se monta en una EC2 instancia de la VPC mediante el destino de montaje. Para obtener más información, consulte [Amazon EFS: cómo funciona](https://docs.aws.amazon.com/efs/latest/ug/how-it-works.html).
Esta operación necesita permisos para la acción `elasticfilesystem:CreateFileSystem`.
Los sistemas de archivos se pueden etiquetar al crearlos. Si se especifican etiquetas en la acción de creación, IAM realiza una autorización adicional en la acción `elasticfilesystem:TagResource` para verificar que los usuarios tengan permisos para crear etiquetas. Por lo tanto, usted debe conceder permisos explícitos para utilizar la acción `elasticfilesystem:TagResource`. Para obtener más información, consulte [Conceder permisos para etiquetar recursos durante la creación](https://docs.aws.amazon.com/efs/latest/ug/using-tags-efs.html#supported-iam-actions-tagging.html).
## Sintaxis de la solicitud
```
POST /2015-02-01/file-systems HTTP/1.1
Content-type: application/json
{
"AvailabilityZoneName": "string",
"Backup": boolean,
"CreationToken": "string",
"Encrypted": boolean,
"KmsKeyId": "string",
"PerformanceMode": "string",
"ProvisionedThroughputInMibps": number,
"Tags": [
{
"Key": "string",
"Value": "string"
}
],
"ThroughputMode": "string"
}
```
## Parámetros de solicitud del URI
La solicitud no utiliza ningún parámetro de URI.
## Cuerpo de la solicitud
La solicitud acepta los siguientes datos en formato JSON.
** [AvailabilityZoneName](#API_CreateFileSystem_RequestSyntax) **
Para los sistemas de archivos One Zone, especifique la zona de disponibilidad AWS en la que se creará el sistema de archivos. Utilice el formato `us-east-1a` para especificar la zona de disponibilidad. Para obtener más información acerca de los sistemas de archivos One Zone, consulte [Tipos de sistemas de archivos EFS](https://docs.aws.amazon.com/efs/latest/ug/availability-durability.html#file-system-type) en la *Guía del usuario de Amazon EFS*.
Los sistemas de archivos One Zone no están disponibles en todas las zonas de disponibilidad en las Regiones de AWS que Amazon EFS está disponible.
Tipo: cadena
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 64.
Patrón: `.+`
Obligatorio: no
** [Backup](#API_CreateFileSystem_RequestSyntax) **
Especifica si las copias de seguridad automáticas están habilitadas en el sistema de archivos que está creando. Establezca el valor en `true` para habilitar copias de seguridad automáticas. Si va a crear un sistema de archivos One Zone, las copias de seguridad automáticas están habilitadas de forma predeterminada. Para obtener más información, consulte [Copias de seguridad automáticas](https://docs.aws.amazon.com/efs/latest/ug/awsbackup.html#automatic-backups) en la *Guía del usuario de Amazon EFS*.
El valor predeterminado es `false`. Sin embargo, si especifica una `AvailabilityZoneName`, el valor predeterminado es `true`.
AWS Backup no está disponible en todos los Regiones de AWS lugares donde Amazon EFS está disponible.
Tipo: Booleano
Obligatorio: no
** [CreationToken](#API_CreateFileSystem_RequestSyntax) **
Una cadena de hasta 64 caracteres ASCII. Amazon EFS la utiliza para garantizar la creación de idempotentes.
Tipo: cadena
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 64.
Patrón: `.+`
Obligatorio: sí
** [Encrypted](#API_CreateFileSystem_RequestSyntax) **
Un valor booleano que, si es verdadero, crea un sistema de archivos cifrado. Al crear un sistema de archivos cifrados, tiene la opción de especificar una AWS Key Management Service clave existente (clave KMS). Si no especifica una clave KMS, se utilizará la clave KMS por defecto para Amazon EFS, `/aws/elasticfilesystem`, se utiliza para proteger el sistema de archivos cifrado.
Tipo: Booleano
Obligatorio: no
** [KmsKeyId](#API_CreateFileSystem_RequestSyntax) **
El ID de la clave KMS que se va a utilizar para proteger el sistema de archivos cifrado. Este parámetro solo es necesario si quiere utilizar una clave KMS que no sea la predeterminada. Si no se especifica este parámetro, se utiliza la clave KMS de forma predeterminada para Amazon EFS. Puede usar los siguientes formatos para especificar este ID de clave KMS.
+ ID de clave: un identificador único de la clave, por ejemplo `1234abcd-12ab-34cd-56ef-1234567890ab`.
+ ARN: un nombre de recurso de Amazon (ARN) para la clave, por ejemplo `arn:aws:kms:us-west-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab`.
+ Alias de clave: un nombre de visualización creado con anterioridad para una clave, por ejemplo `alias/projectKey1`.
+ ARN de alias de clave: un ARN para un alias de clave, por ejemplo `arn:aws:kms:us-west-2:444455556666:alias/projectKey1`.
Si la usa`KmsKeyId`, debe establecer el [CreateFileSystemparámetro:Encrypted](#efs-CreateFileSystem-request-Encrypted) en true.
EFS solo acepta claves KMS simétricas. No puede utilizar claves KMS asimétricas con sistemas de archivos de Amazon EFS.
Tipo: cadena
Limitaciones de longitud: longitud máxima de 2048 caracteres.
Patrón: `^([0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}|mrk-[0-9a-f]{32}|alias/[a-zA-Z0-9/_-]+|(arn:aws[-a-z]*:kms:[a-z0-9-]+:\d{12}:((key/[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12})|(key/mrk-[0-9a-f]{32})|(alias/[a-zA-Z0-9/_-]+))))$`
Obligatorio: no
** [PerformanceMode](#API_CreateFileSystem_RequestSyntax) **
El modo de desempeño del sistema de archivos. Recomendamos el modo de rendimiento `generalPurpose` para todos los sistemas de archivos. Los sistemas de archivos que utilizan el modo de rendimiento `maxIO` pueden escalar a niveles superiores de rendimiento total y operaciones por segundo, con la contrapartida de que la latencia es un poco mayor en la mayoría de las operaciones con archivos. El modo de rendimiento no se puede cambiar después de haber creado el sistema de archivos. El modo `maxIO` no es compatible con los sistemas de archivos One Zone.
Debido a las latencias por operación más altas con una E/S máx., recomendamos utilizar el modo de rendimiento de uso general para todos los sistemas de archivos.
El valor predeterminado es `generalPurpose`.
Tipo: cadena
Valores válidos: `generalPurpose | maxIO`
Obligatorio: no
** [ProvisionedThroughputInMibps](#API_CreateFileSystem_RequestSyntax) **
El rendimiento, medido en mebibytes por segundo (MiBps), que desea aprovisionar para el sistema de archivos que está creando. Obligatorio si `ThroughputMode` se establece en `provisioned`. Los valores válidos son de 1 a 3414 MiBps, y el límite superior depende de la región. Para aumentar este límite, póngase en contacto con. Soporte Para obtener más información, consulte [Cuotas de Amazon EFS que puede incrementar](https://docs.aws.amazon.com/efs/latest/ug/limits.html#soft-limits) en la *Guía del usuario de Amazon EFS.*
Tipo: Doble
Rango válido: valor mínimo de 1.0.
Obligatorio: no
** [Tags](#API_CreateFileSystem_RequestSyntax) **
Se utiliza para crear una o varias etiquetas asociadas al sistema de archivos. Las etiquetas son pares clave-valor que define el usuario. Asigne un nombre al sistema de archivos en el momento de su creación mediante la inclusión de un par clave-valor `"Key":"Name","Value":"{value}"`. Cada clave debe ser única. Para obtener más información, consulte [AWS los recursos de etiquetado](https://docs.aws.amazon.com/general/latest/gr/aws_tagging.html) en la *Guía de referencia AWS general*.
Tipo: matriz de objetos [Tag](API_Tag.md)
Obligatorio: no
** [ThroughputMode](#API_CreateFileSystem_RequestSyntax) **
Especifica el modo de rendimiento del sistema de archivos. El modo puede ser `bursting`, `provisioned` o `elastic`. Si establece `ThroughputMode` en `provisioned`, también debe establecer un valor para `ProvisionedThroughputInMibps`. Después de crear el sistema de archivos, puede disminuir el rendimiento aprovisionado del sistema de archivos o alternar los modos de rendimiento, con ciertas restricciones de tiempo. Para obtener más información, consulte [Especificación del rendimiento con el modo aprovisionado](https://docs.aws.amazon.com/efs/latest/ug/performance.html#provisioned-throughput) en la *Guía del usuario de Amazon EFS*.
El valor predeterminado es `bursting`.
Tipo: cadena
Valores válidos: `bursting | provisioned | elastic`
Obligatorio: no
## Sintaxis de la respuesta
```
HTTP/1.1 201
Content-type: application/json
{
"AvailabilityZoneId": "string",
"AvailabilityZoneName": "string",
"CreationTime": number,
"CreationToken": "string",
"Encrypted": boolean,
"FileSystemArn": "string",
"FileSystemId": "string",
"FileSystemProtection": {
"ReplicationOverwriteProtection": "string"
},
"KmsKeyId": "string",
"LifeCycleState": "string",
"Name": "string",
"NumberOfMountTargets": number,
"OwnerId": "string",
"PerformanceMode": "string",
"ProvisionedThroughputInMibps": number,
"SizeInBytes": {
"Timestamp": number,
"Value": number,
"ValueInArchive": number,
"ValueInIA": number,
"ValueInStandard": number
},
"Tags": [
{
"Key": "string",
"Value": "string"
}
],
"ThroughputMode": "string"
}
```
## Elementos de respuesta
Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 201.
El servicio devuelve los datos siguientes en formato JSON.
** [AvailabilityZoneId](#API_CreateFileSystem_ResponseSyntax) **
El identificador único y coherente de la zona de disponibilidad en la que se encuentra el sistema de archivos y solo es válido para los sistemas de archivos One Zone. Por ejemplo, `use1-az1` es un identificador de zona de disponibilidad para el Región de AWS us-east-1 y tiene la misma ubicación en todas. Cuenta de AWS
Tipo: cadena
** [AvailabilityZoneName](#API_CreateFileSystem_ResponseSyntax) **
Describe la zona de AWS disponibilidad en la que se encuentra el sistema de archivos y solo es válido para los sistemas de archivos de una zona. Para obtener más información, consulte [Uso de clases de almacenamiento de EFS](https://docs.aws.amazon.com/efs/latest/ug/storage-classes.html) en la *Guía del usuario de Amazon EFS.*
Tipo: cadena
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 64.
Patrón: `.+`
** [CreationTime](#API_CreateFileSystem_ResponseSyntax) **
Hora en que se creó el sistema de archivos, en segundos (desde 1970-01-01T 00:00:00 Z).
Tipo: marca temporal
** [CreationToken](#API_CreateFileSystem_ResponseSyntax) **
La cadena opaca especificada en la solicitud.
Tipo: cadena
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 64.
Patrón: `.+`
** [Encrypted](#API_CreateFileSystem_ResponseSyntax) **
Un valor booleano que, si es verdadero, indica que el sistema de archivos está cifrado.
Tipo: Booleano
** [FileSystemArn](#API_CreateFileSystem_ResponseSyntax) **
Nombre de recurso de Amazon (ARN) para el sistema de archivos de EFS en el formato `arn:aws:elasticfilesystem:region:account-id:file-system/file-system-id `. Ejemplo con datos de muestra: `arn:aws:elasticfilesystem:us-west-2:1111333322228888:file-system/fs-01234567`
Tipo: cadena
** [FileSystemId](#API_CreateFileSystem_ResponseSyntax) **
El ID del sistema de archivos, asignado por Amazon EFS.
Tipo: cadena
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})$`
** [FileSystemProtection](#API_CreateFileSystem_ResponseSyntax) **
Describe la protección del sistema de archivos.
Tipo: objeto [FileSystemProtectionDescription](API_FileSystemProtectionDescription.md)
** [KmsKeyId](#API_CreateFileSystem_ResponseSyntax) **
El identificador de un sistema de archivos cifrado que AWS KMS key se utiliza para proteger el sistema de archivos cifrados.
Tipo: cadena
Limitaciones de longitud: longitud máxima de 2048 caracteres.
Patrón: `^([0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}|mrk-[0-9a-f]{32}|alias/[a-zA-Z0-9/_-]+|(arn:aws[-a-z]*:kms:[a-z0-9-]+:\d{12}:((key/[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12})|(key/mrk-[0-9a-f]{32})|(alias/[a-zA-Z0-9/_-]+))))$`
** [LifeCycleState](#API_CreateFileSystem_ResponseSyntax) **
La fase del ciclo de vida del sistema de archivos.
Tipo: cadena
Valores válidos: `creating | available | updating | deleting | deleted | error`
** [Name](#API_CreateFileSystem_ResponseSyntax) **
Puede añadir etiquetas a un sistema de archivos, incluida una etiqueta `Name`. Para obtener más información, consulte [CreateFileSystem](#API_CreateFileSystem). Si el sistema de archivos tiene una etiqueta `Name`, Amazon EFS devuelve el valor de este campo.
Tipo: cadena
Limitaciones de longitud: longitud máxima de 256.
Patrón: `^([\p{L}\p{Z}\p{N}_.:/=+\-@]*)$`
** [NumberOfMountTargets](#API_CreateFileSystem_ResponseSyntax) **
El número actual de destinos de montaje que tiene el sistema de archivos. Para obtener más información, consulte [CreateMountTarget](API_CreateMountTarget.md).
Tipo: entero
Rango válido: valor mínimo de 0.
** [OwnerId](#API_CreateFileSystem_ResponseSyntax) **
El Cuenta de AWS que creó el sistema de archivos.
Tipo: cadena
Limitaciones de longitud: longitud máxima de 255 caracteres.
Patrón: `^(\d{12})|(\d{4}-\d{4}-\d{4})$`
** [PerformanceMode](#API_CreateFileSystem_ResponseSyntax) **
El modo de desempeño del sistema de archivos.
Tipo: cadena
Valores válidos: `generalPurpose | maxIO`
** [ProvisionedThroughputInMibps](#API_CreateFileSystem_ResponseSyntax) **
La cantidad de rendimiento aprovisionada, medida en MiBps, para el sistema de archivos. Válido para los sistemas de archivos que utilizan `ThroughputMode` establecido en `provisioned`.
Tipo: Doble
Rango válido: valor mínimo de 0.0.
** [SizeInBytes](#API_CreateFileSystem_ResponseSyntax) **
El último tamaño medido conocido (en bytes) de los datos almacenados en el sistema de archivos, en su campo `Value`, y el momento en que se determinó ese tamaño en su campo `Timestamp`. El valor de `Timestamp` es el número entero de segundos transcurridos desde 1970-01-01T 00:00:00 Z. El valor de `SizeInBytes` no representa el tamaño de una instantánea coherente del sistema de archivos, pero en última instancia es coherente cuando no hay escrituras en el sistema de archivos. Es decir, `SizeInBytes` representa el tamaño real solo si el sistema de archivos no se modifica durante un período superior a un par de horas. De lo contrario, el valor no es el tamaño exacto que tenía el sistema de archivos en ningún momento.
Tipo: objeto [FileSystemSize](API_FileSystemSize.md)
** [Tags](#API_CreateFileSystem_ResponseSyntax) **
Las etiquetas asociadas al sistema de archivos, presentadas como un conjunto de objetos `Tag`.
Tipo: matriz de objetos [Tag](API_Tag.md)
** [ThroughputMode](#API_CreateFileSystem_ResponseSyntax) **
Muestra el modo de rendimiento de un sistema de archivos. Para obtener más información, consulte [Modos de rendimiento](https://docs.aws.amazon.com/efs/latest/ug/performance.html#throughput-modes) en la *Guía del usuario de Amazon EFS*.
Tipo: cadena
Valores válidos: `bursting | provisioned | elastic`
## 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.
** 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
** FileSystemAlreadyExists **
Se devuelve si el sistema de archivos que está intentando crear ya existe, con el token de creación que proporcionó.
** 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: 409
** FileSystemLimitExceeded **
Se devuelve si ya Cuenta de AWS se ha creado el número máximo de sistemas de archivos permitido por cuenta.
** 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: 403
** InsufficientThroughputCapacity **
Se devuelve si no hay suficiente capacidad para aprovisionar un rendimiento adicional. Este valor puede devolverse al intentar crear un sistema de archivos en el modo de rendimiento aprovisionado, al intentar aumentar el rendimiento aprovisionado de un sistema de archivos existente o al intentar cambiar un sistema de archivos existente del modo de rendimiento de ráfaga al de rendimiento aprovisionado. Inténtelo de nuevo más tarde.
** 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: 503
** 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
** ThroughputLimitExceeded **
Se devuelve si el modo de rendimiento o la cantidad de rendimiento aprovisionada no se pueden cambiar porque se ha alcanzado el límite de rendimiento de 1024 MiB/s .
** 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
** UnsupportedAvailabilityZone **
Se devuelve si la funcionalidad de Amazon EFS solicitada no está disponible en la zona de disponibilidad especificada.
** 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
## Ejemplos
### Crear un sistema de archivos de EFS cifrado
El siguiente ejemplo envía una solicitud POST para crear un sistema de archivos en la región `us-west-2` con las copias de seguridad automáticas habilitadas. La solicitud especifica `myFileSystem1` como token de creación de la idempotencia.
#### Solicitud de muestra
```
POST /2015-02-01/file-systems HTTP/1.1
Host: elasticfilesystem.us-west-2.amazonaws.com
x-amz-date: 20140620T215117Z
Authorization: <...>
Content-Type: application/json
Content-Length: 42
{
"CreationToken" : "myFileSystem1",
"PerformanceMode" : "generalPurpose",
"Backup": true,
"Encrypted": true,
"Tags":[
{
"Key": "Name",
"Value": "Test Group1"
}
]
}
```
#### Respuesta de ejemplo
```
HTTP/1.1 201 Created
x-amzn-RequestId: 01234567-89ab-cdef-0123-456789abcdef
Content-Type: application/json
Content-Length: 319
{
"ownerId":"251839141158",
"CreationToken":"myFileSystem1",
"Encrypted": true,
"PerformanceMode" : "generalPurpose",
"fileSystemId":"fs-01234567",
"CreationTime":"1403301078",
"LifeCycleState":"creating",
"numberOfMountTargets":0,
"SizeInBytes":{
"Timestamp": 1403301078,
"Value": 29313618372,
"ValueInArchive": 201156,
"ValueInIA": 675432,
"ValueInStandard": 29312741784
},
"Tags":[
{
"Key": "Name",
"Value": "Test Group1"
}
],
"ThroughputMode": "elastic"
}
```
### Crear un sistema de archivos EFS cifrado con disponibilidad One Zone
El siguiente ejemplo envía una solicitud POST para crear un sistema de archivos en la región `us-west-2` con las copias de seguridad automáticas habilitadas. El sistema de archivos tendrá almacenamiento One Zone en la zona de disponibilidad `us-west-2b`.
#### Solicitud de muestra
```
POST /2015-02-01/file-systems HTTP/1.1
Host: elasticfilesystem.us-west-2.amazonaws.com
x-amz-date: 20140620T215117Z
Authorization: <...>
Content-Type: application/json
Content-Length: 42
{
"CreationToken" : "myFileSystem2",
"PerformanceMode" : "generalPurpose",
"Backup": true,
"AvailabilityZoneName": "us-west-2b",
"Encrypted": true,
"ThroughputMode": "elastic",
"Tags":[
{
"Key": "Name",
"Value": "Test Group1"
}
]
}
```
#### Respuesta de ejemplo
```
HTTP/1.1 201 Created
x-amzn-RequestId: 01234567-89ab-cdef-0123-456789abcdef
Content-Type: application/json
Content-Length: 319
{
"ownerId":"251839141158",
"CreationToken":"myFileSystem1",
"Encrypted": true,
"AvailabilityZoneId": "usew2-az2",
"AvailabilityZoneName": "us-west-2b",
"PerformanceMode" : "generalPurpose",
"fileSystemId":"fs-01234567",
"CreationTime":"1403301078",
"LifeCycleState":"creating",
"numberOfMountTargets":0,
"SizeInBytes":{
"Timestamp": 1403301078,
"Value": 29313618372,
"ValueInArchive": 201156,
"ValueInIA": 675432,
"ValueInStandard": 29312741784
},
"Tags":[
{
"Key": "Name",
"Value": "Test Group1"
}
],
"ThroughputMode": "elastic"
}
```
## Véase también
Para obtener más información sobre el uso de esta API en uno de los idiomas AWS SDKs específicos, consulta lo siguiente:
+ [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/elasticfilesystem-2015-02-01/CreateFileSystem)
+ [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/CreateFileSystem)
+ [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/CreateFileSystem)
+ [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/CreateFileSystem)
+ [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/CreateFileSystem)
+ [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/CreateFileSystem)
+ [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/CreateFileSystem)
+ [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/CreateFileSystem)
+ [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/CreateFileSystem)
+ [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/CreateFileSystem)
# CreateMountTarget
Crea un destino de montaje para un sistema de archivos. A continuación, puede montar el sistema de archivos en EC2 las instancias mediante el destino de montaje. Para obtener más información sobre los destinos de montaje, consulte [Administración de destinos de montaje](https://docs.aws.amazon.com/efs/latest/ug/accessing-fs.html).
Para crear un destino de montaje para un sistema de archivos de EFS, el estado del ciclo de vida del sistema de archivos debe ser `available`. Para obtener más información, consulte [DescribeFileSystems](API_DescribeFileSystems.md).
Después de crear el destino de montaje, Amazon EFS devuelve una respuesta que incluye `MountTargetId` y una dirección IP (`IpAddress` o `Ipv6Address`). Esta dirección IP se utiliza al montar el sistema de archivos en una EC2 instancia. También puede utilizar el nombre DNS del destino de montaje al montar el sistema de archivos. La EC2 instancia en la que se monta el sistema de archivos mediante el destino de montaje puede convertir el nombre DNS del objetivo de montaje en su dirección IP. Para obtener más información, consulte [Cómo funciona Amazon EFS](https://docs.aws.amazon.com/efs/latest/ug/how-it-works.html).
Tenga en cuenta que puede crear destinos de montaje para un sistema de archivos en una sola VPC y que solo puede haber un destino de montaje por zona de disponibilidad. Para obtener más información, consulte [Creación de destinos de montaje](https://docs.aws.amazon.com/efs/latest/ug/manage-fs-access-create-delete-mount-targets.html).
Si la solicitud cumple los requisitos, Amazon EFS hace lo siguiente:
+ Crea un nuevo destino de montaje en la subred especificada.
+ Crea también una nueva interfaz de red en la subred como sigue:
+ La descripción `Mount target fsmt-id for file system fs-id `, donde ` fsmt-id ` es el ID del destino de montaje y ` fs-id ` es `FileSystemId`.
+ La propiedad `requesterManaged` de la interfaz de red establecida en `true` y el valor `requesterId` en `EFS`.
Cada destino de montaje tiene una interfaz de red correspondiente administrada por el solicitante EC2 . Después de crear la interfaz de red, Amazon EFS establece el campo `NetworkInterfaceId` de la descripción del destino de montaje en el ID de interfaz de red y la dirección IP en su dirección. Si la creación de interfaz de red produce un error, toda la operación `CreateMountTarget` fracasa.
**nota**
La llamada a `CreateMountTarget` realiza una devolución solo después de crear la interfaz de red pero, mientras el estado del destino sigue siendo `creating`, usted puede comprobar el estado de creación del destino de montaje llamando a la operación [DescribeMountTargets](API_DescribeMountTargets.md), que entre otras cosas devuelve el estado del destino de montaje.
Esta operación requiere permisos para las siguientes acciones en el sistema de archivos:
+ `elasticfilesystem:CreateMountTarget`
Esta operación también requiere permisos para las siguientes EC2 acciones de Amazon:
+ `ec2:DescribeSubnets`
+ `ec2:DescribeNetworkInterfaces`
+ `ec2:CreateNetworkInterface`
## Sintaxis de la solicitud
```
POST /2015-02-01/mount-targets HTTP/1.1
Content-type: application/json
{
"FileSystemId": "string",
"IpAddress": "string",
"IpAddressType": "string",
"Ipv6Address": "string",
"SecurityGroups": [ "string" ],
"SubnetId": "string"
}
```
## Parámetros de solicitud del URI
La solicitud no utiliza ningún parámetro de URI.
## Cuerpo de la solicitud
La solicitud acepta los siguientes datos en formato JSON.
** [FileSystemId](#API_CreateMountTarget_RequestSyntax) **
El ID del sistema de archivos para el que se crea el destino de montaje.
Tipo: cadena
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í
** [IpAddress](#API_CreateMountTarget_RequestSyntax) **
Si el `IpAddressType` objetivo del montaje es IPv4 (`IPV4_ONLY`o`DUAL_STACK`), especifique la IPv4 dirección que se va a utilizar. Si omite un valor `IpAddress`, Amazon EFS selecciona una dirección IP no utilizada en la subred especificada para `SubnetId`.
Tipo: cadena
Limitaciones de longitud: longitud mínima de 7. Longitud máxima de 15.
Patrón: `^[0-9]{1,3}\.[0-9]{1,3}\.[0-9]{1,3}\.[0-9]{1,3}$`
Obligatorio: no
** [IpAddressType](#API_CreateMountTarget_RequestSyntax) **
El tipo de dirección IP del destino de montaje. Los valores posibles son `IPV4_ONLY` (solo IPv4 direcciones), `IPV6_ONLY` (solo IPv6 direcciones) y `DUAL_STACK` (pila doble, ambas IPv4 IPv6 direcciones). Si no especifica `IpAddressType`, entonces se usa `IPV4_ONLY`.
El valor de `IPAddressType` debe coincidir con el tipo de IP de la subred. Además, el parámetro `IPAddressType` anula el valor establecido como dirección IP predeterminada para la subred en la VPC. Por ejemplo, si `IPAddressType` es `IPV4_ONLY` y `AssignIpv6AddressOnCreation` es`true`, entonces IPv4 se usa para el objetivo de montaje. Para obtener más información, consulte [Modificación de los atributos de las direcciones IP de sus subredes](https://docs.aws.amazon.com/vpc/latest/userguide/subnet-public-ip.html).
Tipo: cadena
Valores válidos: `IPV4_ONLY | IPV6_ONLY | DUAL_STACK`
Obligatorio: no
** [Ipv6Address](#API_CreateMountTarget_RequestSyntax) **
Si el `IPAddressType` objetivo del montaje es IPv6 (`IPV6_ONLY`o`DUAL_STACK`), especifique la IPv6 dirección que se va a utilizar. Si omite un valor `Ipv6Address`, Amazon EFS selecciona una dirección IP no utilizada en la subred especificada para `SubnetId`.
Tipo: cadena
Limitaciones de longitud: longitud mínima de 3. Longitud máxima de 39.
Obligatorio: no
** [SecurityGroups](#API_CreateMountTarget_RequestSyntax) **
Grupo de seguridad de VPC IDs, del formulario. `sg-xxxxxxxx` Estos deben ser para la misma VPC que la subred especificada. El número máximo de grupos de seguridad depende de la cuota de la cuenta. Para obtener más información, consulte [Cuotas de Amazon VPC](https://docs.aws.amazon.com/vpc/latest/userguide/amazon-vpc-limits.html) en la *Guía del usuario de Amazon VPC* (consulte la tabla **Grupos de seguridad**). Si no especifica un grupo de seguridad, Amazon EFS utiliza el grupo de seguridad predeterminado para la VPC de la subred.
Tipo: matriz de cadenas
Miembros de la matriz: número máximo de 100 elementos.
Limitaciones de longitud: longitud mínima de 11. Longitud máxima de 43.
Patrón: `^sg-[0-9a-f]{8,40}`
Obligatorio: no
** [SubnetId](#API_CreateMountTarget_RequestSyntax) **
El ID de la subred a la que se añade el destino de montaje. Para los sistemas de archivos One Zone, utilice la subred asociada a la zona de disponibilidad del sistema de archivos. El tipo de subred debe ser igual a `IpAddressType`.
Tipo: cadena
Limitaciones de longitud: longitud mínima de 50. Longitud máxima de 80.
Patrón: `^subnet-[0-9a-f]{8,40}$`
Obligatorio: sí
## Sintaxis de la respuesta
```
HTTP/1.1 200
Content-type: application/json
{
"AvailabilityZoneId": "string",
"AvailabilityZoneName": "string",
"FileSystemId": "string",
"IpAddress": "string",
"Ipv6Address": "string",
"LifeCycleState": "string",
"MountTargetId": "string",
"NetworkInterfaceId": "string",
"OwnerId": "string",
"SubnetId": "string",
"VpcId": "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.
** [AvailabilityZoneId](#API_CreateMountTarget_ResponseSyntax) **
El identificador único y coherente de la zona de disponibilidad en la que reside el destino de montaje. Por ejemplo, `use1-az1` es un ID AZ para la región us-east-1 y tiene la misma ubicación en todas. Cuenta de AWS
Tipo: cadena
** [AvailabilityZoneName](#API_CreateMountTarget_ResponseSyntax) **
El nombre de la zona de disponibilidad en la que se encuentra el destino de montaje. Las zonas de disponibilidad se asignan de forma independiente a los nombres de cada una de ellas. Cuenta de AWS Por ejemplo, es Cuenta de AWS posible que la zona `us-east-1a` de disponibilidad de su ubicación no sea la misma que la `us-east-1a` de otra Cuenta de AWS.
Tipo: cadena
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 64.
Patrón: `.+`
** [FileSystemId](#API_CreateMountTarget_ResponseSyntax) **
El ID del sistema de archivos para el que se crea el destino de montaje.
Tipo: cadena
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})$`
** [IpAddress](#API_CreateMountTarget_ResponseSyntax) **
La IPv4 dirección del objetivo de montaje.
Tipo: cadena
Limitaciones de longitud: longitud mínima de 7. Longitud máxima de 15.
Patrón: `^[0-9]{1,3}\.[0-9]{1,3}\.[0-9]{1,3}\.[0-9]{1,3}$`
** [Ipv6Address](#API_CreateMountTarget_ResponseSyntax) **
La IPv6 dirección del objetivo de montaje.
Tipo: cadena
Limitaciones de longitud: longitud mínima de 3. Longitud máxima de 39.
** [LifeCycleState](#API_CreateMountTarget_ResponseSyntax) **
Estado del ciclo de vida del destino de montaje.
Tipo: cadena
Valores válidos: `creating | available | updating | deleting | deleted | error`
** [MountTargetId](#API_CreateMountTarget_ResponseSyntax) **
ID de destino de montaje asignado por el sistema.
Tipo: cadena
Limitaciones de longitud: longitud mínima de 13. Longitud máxima de 45.
Patrón: `^fsmt-[0-9a-f]{8,40}$`
** [NetworkInterfaceId](#API_CreateMountTarget_ResponseSyntax) **
El ID de la interfaz de red que creó Amazon EFS cuando creó el destino de montaje.
Tipo: cadena
** [OwnerId](#API_CreateMountTarget_ResponseSyntax) **
Cuenta de AWS ID propietario del recurso.
Tipo: cadena
Limitaciones de longitud: longitud máxima de 255 caracteres.
Patrón: `^(\d{12})|(\d{4}-\d{4}-\d{4})$`
** [SubnetId](#API_CreateMountTarget_ResponseSyntax) **
El ID de la subred del destino de montaje.
Tipo: cadena
Limitaciones de longitud: longitud mínima de 50. Longitud máxima de 80.
Patrón: `^subnet-[0-9a-f]{8,40}$`
** [VpcId](#API_CreateMountTarget_ResponseSyntax) **
El ID de la nube privada virtual (VPC) en la que está configurado el destino de montaje.
Tipo: cadena
## Errores
** AvailabilityZonesMismatch **
Se devuelve si la zona de disponibilidad que se especificó para el destino de montaje es diferente de la zona de disponibilidad del sistema de archivos. Para obtener más información, consulte [Redundancia de almacenamiento regional y One Zone](https://docs.aws.amazon.com/efs/latest/ug/accessing-fs).
** 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
** 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 Cuenta de AWS solicitante.
** 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
** IncorrectFileSystemLifeCycleState **
Se devuelve si el estado del ciclo de vida del sistema de archivos es no “disponible”.
** 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: 409
** 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
** IpAddressInUse **
Se devuelve si en la solicitud se especificó una dirección IP (`IpAddress` o `Ipv6Address`) que ya está en uso en la subred.
** 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: 409
** MountTargetConflict **
Se devuelve si el destino de montaje infringe una de las restricciones especificadas en función de los destinos de montaje existentes en el sistema de archivos.
** 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: 409
** NetworkInterfaceLimitExceeded **
La cuenta que realiza la llamada ha alcanzado el límite de interfaces de red elásticas para la Región de AWS específica. Elimine algunas interfaces de red o solicite que se aumente la cuota de la cuenta. Para obtener más información, consulte [Cuotas de Amazon VPC](https://docs.aws.amazon.com/vpc/latest/userguide/amazon-vpc-limits.html) en la *Guía del usuario de Amazon VPC* (consulte la entrada **Interfaces de red por región** en la tabla **Interfaces de red**).
** 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: 409
** NoFreeAddressesInSubnet **
Se devuelve si no se especificó `IpAddress` o `Ipv6Address` en la solicitud y no hay direcciones IP libres en la subred.
** 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: 409
** SecurityGroupLimitExceeded **
Se devuelve si el número de `SecurityGroups` especificado en la solicitud supera el límite, que se basa en la cuota de la cuenta. Elimine algunos grupos de seguridad o solicite que se aumente la cuota de la cuenta. Para obtener más información, consulte [Cuotas de Amazon VPC](https://docs.aws.amazon.com/vpc/latest/userguide/amazon-vpc-limits.html) en la *Guía del usuario de Amazon VPC* (consulte la tabla **Grupos de seguridad**).
** 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
** SecurityGroupNotFound **
Se devuelve si uno de los grupos de seguridad especificados no existe en la nube privada virtual (VPC) de la subred.
** 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
** SubnetNotFound **
Se devuelve si no hay ninguna subred con el ID `SubnetId` proporcionado en la solicitud.
** 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
** UnsupportedAvailabilityZone **
Se devuelve si la funcionalidad de Amazon EFS solicitada no está disponible en la zona de disponibilidad especificada.
** 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
## Ejemplos
### Cree un objetivo de montaje en una IPv4 dirección disponible en una subred
La siguiente solicitud especifica solo el sistema de archivos y la subred del destino de montaje. El destino se crea en una IPv4 dirección disponible en la subred especificada, con el grupo de seguridad predeterminado asociado a la VPC.
#### Solicitud de muestra
```
POST /2015-02-01/mount-targets HTTP/1.1
Host: elasticfilesystem.us-west-2.amazonaws.com
x-amz-date: 20140620T221118Z
Authorization: <...>
Content-Type: application/json
Content-Length: 160
{"SubnetId": "subnet-748c5d03", "FileSystemId": "fs-01234567"}
```
#### Respuesta de ejemplo
```
HTTP/1.1 200 OK
x-amzn-RequestId: 01234567-89ab-cdef-0123-456789abcdef
Content-Type: application/json
Content-Length: 252
{
"OwnerId": "231243201240",
"MountTargetId": "fsmt-55a4413c",
"FileSystemId": "fs-01234567",
"SubnetId": "subnet-01234567",
"LifeCycleState": "available",
"IpAddress": "172.31.22.183"
"NetworkInterfaceId":"eni-1bcb7772"
"AvailabilityZoneId": "eus1-az2",
"AvailabilityZoneName": "eu-south-1b",
"VpcId": "vpc-08d45b31fa009a15e"
}
```
### Cree un destino de montaje en una dirección específica IPv4
La siguiente solicitud especifica el sistema de archivos, la subred, el grupo de seguridad y la IPv4 dirección que se van a utilizar para el destino de montaje.
#### Solicitud de muestra
```
POST /2015-02-01/mount-targets HTTP/1.1
Host: elasticfilesystem.us-west-2.amazonaws.com
x-amz-date: 20140620T221118Z
Authorization: <...>
Content-Type: application/json
Content-Length: 160
{
"FileSystemId":"fs-01234567",
"SubnetId":"subnet-01234567",
"IpAddress":"10.0.2.42",
"SecurityGroups":[
"sg-01234567"
]
}
```
#### Respuesta de ejemplo
```
HTTP/1.1 200 OK
x-amzn-RequestId: 01234567-89ab-cdef-0123-456789abcdef
Content-Type: application/json
Content-Length: 252
{
"OwnerId":"251839141158",
"MountTargetId":"fsmt-9a13661e",
"FileSystemId":"fs-01234567",
"SubnetId":"subnet-fd04ff94",
"LifeCycleState":"available",
"IpAddress":"10.0.2.42",
"NetworkInterfaceId":"eni-1bcb7772"
"AvailabilityZoneId": "eus1-az2",
"AvailabilityZoneName": "eu-south-1b",
"VpcId": "vpc-08d45b31fa009a15e"
}
```
### Cree un destino de montaje en una dirección específica IPv6
La siguiente solicitud especifica el sistema de archivos, la subred, el grupo de seguridad y la IPv6 dirección que se van a utilizar para el destino de montaje.
#### Solicitud de muestra
```
POST /2015-02-01/mount-targets HTTP/1.1
Host: elasticfilesystem.us-west-2.amazonaws.com
x-amz-date: 20140620T221118Z
Authorization: <...>
Content-Type: application/json
Content-Length: 160
{
"FileSystemId":"fs-01234567",
"SubnetId":"subnet-01234567",
"Ipv6Address":"2001:0db8:85a3:0000:0000:8a2e:0370:7334",
"IpAddressType": "IPV6_ONLY",
"SecurityGroups":[
"sg-01234567"
]
}
```
#### Respuesta de ejemplo
```
HTTP/1.1 200 OK
x-amzn-RequestId: 01234567-89ab-cdef-0123-456789abcdef
Content-Type: application/json
Content-Length: 252
{
"OwnerId":"251839141158",
"MountTargetId":"fsmt-9a13661e",
"FileSystemId":"fs-01234567",
"SubnetId":"subnet-fd04ff94",
"LifeCycleState":"available",
"Ipv6Address":"2001:0db8:85a3:0000:0000:8a2e:0370:7334",
"NetworkInterfaceId":"eni-1bcb7772"
"AvailabilityZoneId": "eus1-az2",
"AvailabilityZoneName": "eu-south-1b",
"VpcId": "vpc-08d45b31fa009a15e"
}
```
### Cree un destino de montaje en una IPv4 dirección disponible en una subred de doble pila
La siguiente solicitud especifica solo el sistema de archivos, la subred y el tipo de dirección del destino de montaje. El destino se crea en una IPv4 dirección disponible en la subred de doble pila especificada, con el grupo de seguridad predeterminado asociado a la VPC.
#### Solicitud de muestra
```
POST /2015-02-01/mount-targets HTTP/1.1
Host: elasticfilesystem.us-west-2.amazonaws.com
x-amz-date: 20140620T221118Z
Authorization: <...>
Content-Type: application/json
Content-Length: 160
{"SubnetId": "subnet-748c5d03", "FileSystemId": "fs-01234567"}
```
#### Respuesta de ejemplo
```
HTTP/1.1 200 OK
x-amzn-RequestId: 01234567-89ab-cdef-0123-456789abcdef
Content-Type: application/json
Content-Length: 252
{
"OwnerId": "251839141158",
"MountTargetId": "fsmt-55a4413c",
"FileSystemId": "fs-01234567",
"SubnetId":"subnet-fd04ff94",
"LifeCycleState": "available",
"IpAddress": "172.31.22.183"
"Ipv6Address": "2a05:d01a:419:8611:3e57:75ab:5719:b238",
"NetworkInterfaceId": "eni-01234567",
"AvailabilityZoneId": "eus1-az2",
"AvailabilityZoneName": "eu-south-1b",
"VpcId": "vpc-08d45b31fa009a15e"
}
```
### Cree un objetivo de montaje en direcciones IPv4 específicas y IPv6 en una subred de doble pila
La siguiente solicitud especifica el sistema de archivos, la subred, el grupo de seguridad, la dirección y la IPv4 dirección del destino de IPv6 montaje. El destino se crea en las IPv6 direcciones IPv4 E especificadas en una subred de doble pila.
#### Solicitud de muestra
```
POST /2015-02-01/mount-targets HTTP/1.1
Host: elasticfilesystem.us-west-2.amazonaws.com
x-amz-date: 20140620T221118Z
Authorization: <...>
Content-Type: application/json
Content-Length: 160
{
"FileSystemId":"fs-01234567",
"SubnetId":"subnet-01234567",
"IpAddressType": "DUAL_STACK",
"IpAddress": "10.0.1.25",
"Ipv6Address":"2001:0db8:85a3:0000:0000:8a2e:0370:7334",
"SecurityGroups":[
"sg-01234567"
]
}
```
#### Respuesta de ejemplo
```
HTTP/1.1 200 OK
x-amzn-RequestId: 01234567-89ab-cdef-0123-456789abcdef
Content-Type: application/json
Content-Length: 252
{
"OwnerId": "231243201240",
"MountTargetId": "fsmt-55a4413c",
"FileSystemId": "fs-01234567",
"SubnetId": "subnet-01234567",
"LifeCycleState": "available",
"IpAddress": "10.0.1.25",
"Ipv6Address":"2001:0db8:85a3:0000:0000:8a2e:0370:7334",
"NetworkInterfaceId": "eni-01234567",
"AvailabilityZoneId": "eus1-az2",
"AvailabilityZoneName": "eu-south-1b",
"VpcId": "vpc-08d45b31fa009a15e"
}
```
## 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/CreateMountTarget)
+ [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/CreateMountTarget)
+ [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/CreateMountTarget)
+ [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/CreateMountTarget)
+ [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/CreateMountTarget)
+ [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/CreateMountTarget)
+ [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/CreateMountTarget)
+ [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/CreateMountTarget)
+ [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/CreateMountTarget)
+ [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/CreateMountTarget)
# CreateReplicationConfiguration
Crea una configuración de replicación en un sistema de archivos de EFS nuevo o existente. Para obtener más información, consulte [Replicación de Amazon EFS](https://docs.aws.amazon.com/efs/latest/ug/efs-replication.html) en la *Guía del usuario de Amazon EFS*. La siguiente configuración de replicación básica especifica lo siguiente:
+ **Sistema de archivos de origen**: el sistema de archivos de EFS que desea replicar.
+ **Sistema de archivos de destino**: el sistema de archivos de destino en el que se replica el sistema de archivos de origen. Solo puede haber un sistema de archivos de destino en una configuración de replicación.
**nota**
Un sistema de archivos solo puede formar parte de una configuración de replicación.
Los parámetros de destino de la configuración de replicación dependen de si la replicación se realiza en un sistema de archivos nuevo o en uno existente, y de si la replicación se produce entre Cuentas de AWS. Para obtener más información, consulte [DestinationToCreate](API_DestinationToCreate.md).
Esta operación necesita permisos para la acción `elasticfilesystem:CreateReplicationConfiguration`. Además, se requieren otros permisos según la forma en que se repliquen los sistemas de archivos. Para obtener más información, consulte [Permisos necesarios para la replicación](https://docs.aws.amazon.com/efs/latest/ug/efs-replication.html#efs-replication-permissions) en la *Guía del usuario de Amazon EFS*.
## Sintaxis de la solicitud
```
POST /2015-02-01/file-systems/SourceFileSystemId/replication-configuration HTTP/1.1
Content-type: application/json
{
"Destinations": [
{
"AvailabilityZoneName": "string",
"FileSystemId": "string",
"KmsKeyId": "string",
"Region": "string",
"RoleArn": "string"
}
]
}
```
## Parámetros de solicitud del URI
La solicitud utiliza los siguientes parámetros URI.
** [SourceFileSystemId](#API_CreateReplicationConfiguration_RequestSyntax) **
Especifica el sistema de archivos de Amazon EFS que desea replicar. Este sistema de archivos no puede ser un sistema de archivos de origen o de destino en otra configuración de replicación.
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í
## Cuerpo de la solicitud
La solicitud acepta los siguientes datos en formato JSON.
** [Destinations](#API_CreateReplicationConfiguration_RequestSyntax) **
Una gama de objetos de configuración de destino. Solo se admite un objeto de configuración de destino.
Tipo: matriz de objetos [DestinationToCreate](API_DestinationToCreate.md)
Obligatorio: sí
## Sintaxis de la respuesta
```
HTTP/1.1 200
Content-type: application/json
{
"CreationTime": number,
"Destinations": [
{
"FileSystemId": "string",
"LastReplicatedTimestamp": number,
"OwnerId": "string",
"Region": "string",
"RoleArn": "string",
"Status": "string",
"StatusMessage": "string"
}
],
"OriginalSourceFileSystemArn": "string",
"SourceFileSystemArn": "string",
"SourceFileSystemId": "string",
"SourceFileSystemOwnerId": "string",
"SourceFileSystemRegion": "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.
** [CreationTime](#API_CreateReplicationConfiguration_ResponseSyntax) **
Describe cuándo se creó la configuración de replicación.
Tipo: marca temporal
** [Destinations](#API_CreateReplicationConfiguration_ResponseSyntax) **
Una gama de objetos de destino. Solo se admite un objeto de destino.
Tipo: matriz de objetos [Destination](API_Destination.md)
** [OriginalSourceFileSystemArn](#API_CreateReplicationConfiguration_ResponseSyntax) **
Nombre de recurso de Amazon (ARN) del sistema de archivos de EFS de origen original en la configuración de replicación.
Tipo: cadena
** [SourceFileSystemArn](#API_CreateReplicationConfiguration_ResponseSyntax) **
Nombre de recurso de Amazon (ARN) del sistema de archivos de origen actual en la configuración de replicación.
Tipo: cadena
** [SourceFileSystemId](#API_CreateReplicationConfiguration_ResponseSyntax) **
El ID del sistema de archivos de Amazon EFS de origen que se está replicando.
Tipo: cadena
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})$`
** [SourceFileSystemOwnerId](#API_CreateReplicationConfiguration_ResponseSyntax) **
ID del sistema de archivos fuente Cuenta de AWS en el que reside.
Tipo: cadena
Limitaciones de longitud: longitud máxima de 255 caracteres.
Patrón: `^(\d{12})|(\d{4}-\d{4}-\d{4})$`
** [SourceFileSystemRegion](#API_CreateReplicationConfiguration_ResponseSyntax) **
El Región de AWS en el que se encuentra el sistema de archivos EFS de origen.
Tipo: cadena
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 64.
Patrón: `^[a-z]{2}-((iso[a-z]{0,1}-)|(gov-)){0,1}[a-z]+-{0,1}[0-9]{0,1}$`
## 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.
** 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
** ConflictException **
Se devuelve si el sistema de archivos de origen de una replicación está cifrado pero el sistema de archivos de destino no está cifrado.
** 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: 409
** FileSystemLimitExceeded **
Se devuelve si ya Cuenta de AWS se ha creado el número máximo de sistemas de archivos permitidos por cuenta.
** 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: 403
** FileSystemNotFound **
Se devuelve si el `FileSystemId` valor especificado no existe en el del Cuenta de AWS solicitante.
** 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
** IncorrectFileSystemLifeCycleState **
Se devuelve si el estado del ciclo de vida del sistema de archivos es no “disponible”.
** 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: 409
** InsufficientThroughputCapacity **
Se devuelve si no hay suficiente capacidad para aprovisionar un rendimiento adicional. Este valor puede devolverse al intentar crear un sistema de archivos en el modo de rendimiento aprovisionado, al intentar aumentar el rendimiento aprovisionado de un sistema de archivos existente o al intentar cambiar un sistema de archivos existente del modo de rendimiento de ráfaga al de rendimiento aprovisionado. Inténtelo de nuevo más tarde.
** 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: 503
** 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
** ReplicationNotFound **
Se devuelve si el sistema de archivos especificado no tiene una configuración de replicación.
** ErrorCode **
ReplicationNotFound
** 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
** ThroughputLimitExceeded **
Se devuelve si el modo de rendimiento o la cantidad de rendimiento aprovisionada no se pueden cambiar porque se ha alcanzado el límite de rendimiento de 1024. MiB/s
** 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
** UnsupportedAvailabilityZone **
Se devuelve si la funcionalidad de Amazon EFS solicitada no está disponible en la zona de disponibilidad especificada.
** 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
** ValidationException **
Se devuelve si el AWS Backup servicio no está disponible en el lugar Región de AWS en el que se realizó la solicitud.
** 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
## 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/CreateReplicationConfiguration)
+ [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/CreateReplicationConfiguration)
+ [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/CreateReplicationConfiguration)
+ [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/CreateReplicationConfiguration)
+ [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/CreateReplicationConfiguration)
+ [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/CreateReplicationConfiguration)
+ [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/CreateReplicationConfiguration)
+ [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/CreateReplicationConfiguration)
+ [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/CreateReplicationConfiguration)
+ [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/CreateReplicationConfiguration)
# CreateTags
**nota**
OBSOLETO: `CreateTags` está en desuso y no recibe mantenimiento. Para crear etiquetas para los recursos de EFS, utilice la acción [TagResource](API_TagResource.md) de la API.
Crea o sobrescribe etiquetas asociadas a un sistema de archivos. Cada etiqueta es un par clave-valor. Si una clave de etiqueta especificada en la solicitud ya existe en el sistema de archivos, esta operación sobrescribe su valor con el valor proporcionado en la solicitud. Si añade la etiqueta `Name` al sistema de archivos, Amazon EFS la devuelve como respuesta a la operación [DescribeFileSystems](API_DescribeFileSystems.md).
Esta operación necesita permiso para la acción `elasticfilesystem:CreateTags`.
## Sintaxis de la solicitud
```
POST /2015-02-01/create-tags/FileSystemId HTTP/1.1
Content-type: application/json
{
"Tags": [
{
"Key": "string",
"Value": "string"
}
]
}
```
## Parámetros de solicitud del URI
La solicitud utiliza los siguientes parámetros URI.
** [FileSystemId](#API_CreateTags_RequestSyntax) **
El ID del sistema de archivos cuyas etiquetas desea modificar (cadena). Esta operación modifica únicamente las etiquetas, no el sistema de archivos.
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í
## Cuerpo de la solicitud
La solicitud acepta los siguientes datos en formato JSON.
** [Tags](#API_CreateTags_RequestSyntax) **
Una matriz de objetos `Tag` que añadir. Cada objeto `Tag` es un par clave-valor.
Tipo: matriz de objetos [Tag](API_Tag.md)
Obligatorio: sí
## Sintaxis de la respuesta
```
HTTP/1.1 204
```
## Elementos de respuesta
Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 204 con un cuerpo HTTP vacío.
## 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.
** 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 Cuenta de AWS solicitante.
** 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/CreateTags)
+ [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/CreateTags)
+ [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/CreateTags)
+ [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/CreateTags)
+ [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/CreateTags)
+ [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/CreateTags)
+ [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/CreateTags)
+ [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/CreateTags)
+ [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/CreateTags)
+ [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/CreateTags)
# DeleteAccessPoint
Elimina el punto de acceso especificado. Una vez completada la eliminación, los nuevos clientes ya no podrán conectarse a los puntos de acceso. Los clientes conectados al punto de acceso en el momento de la eliminación seguirán funcionando hasta que finalicen su conexión.
Esta operación necesita permisos para la acción `elasticfilesystem:DeleteAccessPoint`.
## Sintaxis de la solicitud
```
DELETE /2015-02-01/access-points/AccessPointId HTTP/1.1
```
## Parámetros de solicitud del URI
La solicitud utiliza los siguientes parámetros URI.
** [AccessPointId](#API_DeleteAccessPoint_RequestSyntax) **
El ID del punto de acceso que desea eliminar.
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})$`
Obligatorio: sí
## Cuerpo de la solicitud
La solicitud no tiene un cuerpo de la solicitud.
## Sintaxis de la respuesta
```
HTTP/1.1 204
```
## Elementos de respuesta
Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 204 con un cuerpo HTTP vacío.
## Errores
** AccessPointNotFound **
Se devuelve si el `AccessPointId` valor especificado no existe en el del Cuenta de AWS solicitante.
** 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
** 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/DeleteAccessPoint)
+ [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/DeleteAccessPoint)
+ [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/DeleteAccessPoint)
+ [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/DeleteAccessPoint)
+ [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/DeleteAccessPoint)
+ [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/DeleteAccessPoint)
+ [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/DeleteAccessPoint)
+ [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/DeleteAccessPoint)
+ [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/DeleteAccessPoint)
+ [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/DeleteAccessPoint)
# DeleteFileSystem
Elimina un sistema de archivos, lo que corta de forma permanente el acceso a su contenido. Cuando regrese, el sistema de archivos ya no existe y no podrá acceder a ningún contenido del sistema de archivos eliminado.
Debe eliminar manualmente los destinos de montaje adjuntos a un sistema de archivos antes de poder eliminar un sistema de archivos de EFS. Este paso se realiza automáticamente cuando se utiliza la AWS consola para eliminar un sistema de archivos.
**nota**
No se puede eliminar un sistema de archivos que forme parte de una configuración de replicación de EFS. Debe eliminarse primero la configuración de replicación.
No se puede eliminar un sistema de archivos que esté en uso. Es decir, si el sistema de archivos tiene ningún destino de montaje, primero debe eliminarlo. Para obtener más información, consulte [DescribeMountTargets](API_DescribeMountTargets.md) y [DeleteMountTarget](API_DeleteMountTarget.md).
**nota**
La llamada `DeleteFileSystem` realiza vuelve mientras el estado del sistema de archivos siga siendo `deleting`. Puede comprobar el estado de eliminación del sistema de archivos llamando a la operación [DescribeFileSystems](API_DescribeFileSystems.md), que devuelve una lista de los sistemas de archivos de su cuenta. Si pasa el identificador del sistema de archivos o el token de creación del sistema de archivos eliminado, [DescribeFileSystems](API_DescribeFileSystems.md) devuelve un error `404 FileSystemNotFound`.
Esta operación necesita permisos para la acción `elasticfilesystem:DeleteFileSystem`.
## Sintaxis de la solicitud
```
DELETE /2015-02-01/file-systems/FileSystemId HTTP/1.1
```
## Parámetros de solicitud del URI
La solicitud utiliza los siguientes parámetros URI.
** [FileSystemId](#API_DeleteFileSystem_RequestSyntax) **
El ID del sistema de archivos que desea eliminar.
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í
## Cuerpo de la solicitud
La solicitud no tiene un cuerpo de la solicitud.
## Sintaxis de la respuesta
```
HTTP/1.1 204
```
## Elementos de respuesta
Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 204 con un cuerpo HTTP vacío.
## 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.
** 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
** FileSystemInUse **
Se devuelve si un sistema de archivos tiene objetivos de montaje.
** 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: 409
** FileSystemNotFound **
Se devuelve si el `FileSystemId` valor especificado no existe en el del Cuenta de AWS solicitante.
** 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
## Ejemplos
### Eliminar un sistema de archivos
El siguiente ejemplo envía una solicitud DELETE al punto de conexión `file-systems` (`elasticfilesystem.us-west-2.amazonaws.com/2015-02-01/file-systems/fs-01234567`) para eliminar un sistema de archivos cuyo ID es `fs-01234567`.
#### Solicitud de muestra
```
DELETE /2015-02-01/file-systems/fs-01234567 HTTP/1.1
Host: elasticfilesystem.us-west-2.amazonaws.com
x-amz-date: 20140622T233021Z
Authorization: <...>
```
#### Respuesta de ejemplo
```
HTTP/1.1 204 No Content
x-amzn-RequestId: a2d125b3-7ebd-4d6a-ab3d-5548630bff33
Content-Length: 0
```
## 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/DeleteFileSystem)
+ [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/DeleteFileSystem)
+ [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/DeleteFileSystem)
+ [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/DeleteFileSystem)
+ [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/DeleteFileSystem)
+ [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/DeleteFileSystem)
+ [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/DeleteFileSystem)
+ [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/DeleteFileSystem)
+ [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/DeleteFileSystem)
+ [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/DeleteFileSystem)
# DeleteFileSystemPolicy
Elimina el `FileSystemPolicy` del sistema de archivos especificado. `FileSystemPolicy` predeterminado entra en vigor una vez que se elimina la política existente. Para obtener más información acerca de la política del sistema de archivos predeterminada, consulte [Uso de políticas basadas en recursos con EFS](https://docs.aws.amazon.com/efs/latest/ug/res-based-policies-efs.html).
Esta operación necesita permisos para la acción `elasticfilesystem:DeleteFileSystemPolicy`.
## Sintaxis de la solicitud
```
DELETE /2015-02-01/file-systems/FileSystemId/policy HTTP/1.1
```
## Parámetros de solicitud del URI
La solicitud utiliza los siguientes parámetros URI.
** [FileSystemId](#API_DeleteFileSystemPolicy_RequestSyntax) **
Especifica el sistema de archivos EFS del que se va a eliminar el `FileSystemPolicy`.
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í
## Cuerpo de la solicitud
La solicitud no tiene un cuerpo de la solicitud.
## Sintaxis de la respuesta
```
HTTP/1.1 200
```
## Elementos de respuesta
Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200 con un cuerpo HTTP vacío.
## 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.
** 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 Cuenta de AWS solicitante.
** 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
** IncorrectFileSystemLifeCycleState **
Se devuelve si el estado del ciclo de vida del sistema de archivos es no “disponible”.
** 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: 409
** 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/DeleteFileSystemPolicy)
+ [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/DeleteFileSystemPolicy)
+ [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/DeleteFileSystemPolicy)
+ [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/DeleteFileSystemPolicy)
+ [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/DeleteFileSystemPolicy)
+ [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/DeleteFileSystemPolicy)
+ [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/DeleteFileSystemPolicy)
+ [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/DeleteFileSystemPolicy)
+ [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/DeleteFileSystemPolicy)
+ [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/DeleteFileSystemPolicy)
# DeleteMountTarget
Elimina el destino de montaje especificado.
Esta operación rompe de manera forzada los montajes del sistema de archivos utilizando el destino de montaje que se está eliminando, lo que podría afectar a las instancias o a las aplicaciones que utilizan dichos montajes. Para evitar que las aplicaciones se interrumpan abruptamente, puede considerar la posibilidad de desmontar cualquier soporte del objetivo de montaje, si es posible. La operación también elimina la interfaz de red asociada. Es posible que se pierdan las escrituras no confirmadas, pero romper un objetivo de montaje mediante esta operación no daña el sistema de archivos en sí. El sistema de archivos que creó se mantiene. Puede montar una EC2 instancia en su VPC mediante otro destino de montaje.
Esta operación requiere permisos para las siguientes acciones en el sistema de archivos:
+ `elasticfilesystem:DeleteMountTarget`
**nota**
La llamada a `DeleteMountTarget` se devuelve mientras el estado del objetivo de montaje sigue siendo `deleting`. Puede comprobar la eliminación del objetivo de montaje llamando a la operación [DescribeMountTargets](API_DescribeMountTargets.md), que devuelve una lista de descripciones de los objetivos de montaje para el sistema de archivos en cuestión.
La operación también requiere permisos para la siguiente EC2 acción de Amazon en la interfaz de red del objetivo de montaje:
+ `ec2:DeleteNetworkInterface`
## Sintaxis de la solicitud
```
DELETE /2015-02-01/mount-targets/MountTargetId HTTP/1.1
```
## Parámetros de solicitud del URI
La solicitud utiliza los siguientes parámetros URI.
** [MountTargetId](#API_DeleteMountTarget_RequestSyntax) **
El ID del destino de montaje que se elimina (cadena).
Limitaciones de longitud: longitud mínima de 13. Longitud máxima de 45.
Patrón: `^fsmt-[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 204
```
## Elementos de respuesta
Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 204 con un cuerpo HTTP vacío.
## 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.
** 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
** DependencyTimeout **
Se agotó el tiempo de espera del servicio al intentar tramitar la solicitud y el cliente debería volver a intentar realizar la llamada.
** 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: 504
** 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
** MountTargetNotFound **
Se devuelve si no hay un objetivo de montaje con el ID especificado que se encoentró en la Cuenta de AWS de la persona que llama.
** 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
## Ejemplos
### Eliminar el objetivo de montaje de un sistema de archivos
El siguiente ejemplo envía una solicitud DELETE para eliminar un destino de montaje específico.
#### Solicitud de muestra
```
DELETE /2015-02-01/mount-targets/fsmt-9a13661e HTTP/1.1
Host: elasticfilesystem.us-west-2.amazonaws.com
x-amz-date: 20140622T232908Z
Authorization: <...>
```
#### Respuesta de ejemplo
```
HTTP/1.1 204 No Content
x-amzn-RequestId: 01234567-89ab-cdef-0123-456789abcdef
```
## 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/DeleteMountTarget)
+ [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/DeleteMountTarget)
+ [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/DeleteMountTarget)
+ [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/DeleteMountTarget)
+ [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/DeleteMountTarget)
+ [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/DeleteMountTarget)
+ [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/DeleteMountTarget)
+ [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/DeleteMountTarget)
+ [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/DeleteMountTarget)
+ [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/DeleteMountTarget)
# DeleteReplicationConfiguration
Elimina una configuración de replicación. La eliminación de una configuración de replicación finaliza el proceso de replicación. Tras eliminar una configuración de replicación, se puede escribir en el sistema de archivos de destino y se vuelve a habilitar su protección contra sobrescritura de la replicación. Para obtener más información, consulte [Eliminación de una configuración de replicación](https://docs.aws.amazon.com/efs/latest/ug/delete-replications.html).
Esta operación necesita permisos para la acción `elasticfilesystem:DeleteReplicationConfiguration`.
## Sintaxis de la solicitud
```
DELETE /2015-02-01/file-systems/SourceFileSystemId/replication-configuration?deletionMode=DeletionMode HTTP/1.1
```
## Parámetros de solicitud del URI
La solicitud utiliza los siguientes parámetros URI.
** [DeletionMode](#API_DeleteReplicationConfiguration_RequestSyntax) **
Al replicar de forma transversal Cuentas de AWS o transversal Regiones de AWS, Amazon EFS elimina la configuración de replicación de la cuenta o región (`ALL_CONFIGURATIONS`) de origen y de destino de forma predeterminada. Si hay un problema de configuración o de permisos que impide que Amazon EFS elimine la configuración de replicación de ambos lados, puede utilizar el modo `LOCAL_CONFIGURATION_ONLY` para eliminar la configuración únicamente en su lado (la cuenta o región desde la que se realiza la eliminación).
Utilice el modo `LOCAL_CONFIGURATION_ONLY` únicamente si Amazon EFS no puede eliminar la configuración de replicación en las cuentas o regiones de origen y destino. Al eliminar la configuración local, no se podrá recuperar la configuración de la otra cuenta o región.
Además, no utilice este modo para la replicación entre la misma cuenta y la misma región, ya que si lo hace, se produce un error de excepción. BadRequest
Valores válidos: `ALL_CONFIGURATIONS | LOCAL_CONFIGURATION_ONLY`
** [SourceFileSystemId](#API_DeleteReplicationConfiguration_RequestSyntax) **
El ID del sistema de archivos de origen en la configuración de replicación.
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í
## Cuerpo de la solicitud
La solicitud no tiene un cuerpo de la solicitud.
## Sintaxis de la respuesta
```
HTTP/1.1 204
```
## Elementos de respuesta
Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 204 con un cuerpo HTTP vacío.
## 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.
** 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
** ReplicationNotFound **
Se devuelve si el sistema de archivos especificado no tiene una configuración de replicación.
** ErrorCode **
ReplicationNotFound
** 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
## 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/DeleteReplicationConfiguration)
+ [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/DeleteReplicationConfiguration)
+ [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/DeleteReplicationConfiguration)
+ [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/DeleteReplicationConfiguration)
+ [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/DeleteReplicationConfiguration)
+ [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/DeleteReplicationConfiguration)
+ [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/DeleteReplicationConfiguration)
+ [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/DeleteReplicationConfiguration)
+ [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/DeleteReplicationConfiguration)
+ [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/DeleteReplicationConfiguration)
# DeleteTags
**nota**
OBSOLETO: `DeleteTags` está en desuso y no recibe mantenimiento. Para quitar etiquetas de recursos de EFS, utilice la acción de la API [UntagResource](API_UntagResource.md).
Elimina las etiquetas especificadas de un sistema de archivos. Si la solicitud `DeleteTags` incluye una clave de etiqueta que no existe, Amazon EFS la ignora y no provoca ningún error. Para obtener más información sobre las etiquetas y las restricciones relacionadas, consulte [Restricciones de etiquetas](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/cost-alloc-tags.html) en la *Guía del Administración de facturación y costos de AWS usuario*.
Esta operación necesita permisos para la acción `elasticfilesystem:DeleteTags`.
## Sintaxis de la solicitud
```
POST /2015-02-01/delete-tags/FileSystemId HTTP/1.1
Content-type: application/json
{
"TagKeys": [ "string" ]
}
```
## Parámetros de solicitud del URI
La solicitud utiliza los siguientes parámetros URI.
** [FileSystemId](#API_DeleteTags_RequestSyntax) **
El ID del sistema de archivos cuyas etiquetas desea eliminar(cadena).
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í
## Cuerpo de la solicitud
La solicitud acepta los siguientes datos en formato JSON.
** [TagKeys](#API_DeleteTags_RequestSyntax) **
Una lista de las claves de etiqueta que se eliminarán.
Tipo: matriz de cadenas
Miembros de la matriz: número mínimo de 1 artículo. Número máximo de 50 artículos.
Limitaciones de longitud: longitud mínima de 1. Longitud máxima de 128.
Patrón: `^(?![aA]{1}[wW]{1}[sS]{1}:)([\p{L}\p{Z}\p{N}_.:/=+\-@]+)$`
Obligatorio: sí
## Sintaxis de la respuesta
```
HTTP/1.1 204
```
## Elementos de respuesta
Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 204 con un cuerpo HTTP vacío.
## 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.
** 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 Cuenta de AWS solicitante.
** 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/DeleteTags)
+ [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/DeleteTags)
+ [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/DeleteTags)
+ [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/DeleteTags)
+ [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/DeleteTags)
+ [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/DeleteTags)
+ [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/DeleteTags)
+ [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/DeleteTags)
+ [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/DeleteTags)
+ [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/DeleteTags)
# 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)
# DescribeAccountPreferences
Devuelve la configuración de preferencias de la cuenta Cuenta de AWS asociada al usuario que realiza la solicitud, en la versión actual Región de AWS.
## Sintaxis de la solicitud
```
GET /2015-02-01/account-preferences HTTP/1.1
Content-type: application/json
{
"MaxResults": number,
"NextToken": "string"
}
```
## Parámetros de solicitud del URI
La solicitud no utiliza ningún parámetro de URI.
## Cuerpo de la solicitud
La solicitud acepta los siguientes datos en formato JSON.
** [MaxResults](#API_DescribeAccountPreferences_RequestSyntax) **
(Opcional) Al recuperar las preferencias de la cuenta, 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.
Tipo: entero
Rango válido: valor mínimo de 1.
Obligatorio: no
** [NextToken](#API_DescribeAccountPreferences_RequestSyntax) **
(Opcional) Puedes usar `NextToken` en una solicitud posterior para buscar la siguiente página de preferencias de la Cuenta de AWS si la carga útil de la respuesta estaba paginada.
Tipo: cadena
Limitaciones de longitud: longitud mínima de 1. Longitud máxima de 128.
Patrón: `.+`
Obligatorio: no
## Sintaxis de la respuesta
```
HTTP/1.1 200
Content-type: application/json
{
"NextToken": "string",
"ResourceIdPreference": {
"ResourceIdType": "string",
"Resources": [ "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](#API_DescribeAccountPreferences_ResponseSyntax) **
Está presente si hay más registros de los que se devuelven en la respuesta. Se puede utilizar `NextToken` en la solicitud subsiguiente para obtener las descripciones adicionales.
Tipo: cadena
Limitaciones de longitud: longitud mínima de 1. Longitud máxima de 128.
Patrón: `.+`
** [ResourceIdPreference](#API_DescribeAccountPreferences_ResponseSyntax) **
Describe la configuración de preferencias del identificador de recurso Cuenta de AWS asociado al usuario que realiza la solicitud, en el estado actual Región de AWS.
Tipo: objeto [ResourceIdPreference](API_ResourceIdPreference.md)
## Errores
** 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, consulte lo siguiente:
+ [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/elasticfilesystem-2015-02-01/DescribeAccountPreferences)
+ [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/DescribeAccountPreferences)
+ [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/DescribeAccountPreferences)
+ [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/DescribeAccountPreferences)
+ [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/DescribeAccountPreferences)
+ [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/DescribeAccountPreferences)
+ [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/DescribeAccountPreferences)
+ [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/DescribeAccountPreferences)
+ [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/DescribeAccountPreferences)
+ [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/DescribeAccountPreferences)
# DescribeBackupPolicy
Devuelve la política de copias de seguridad del sistema de archivos de EFS especificado.
## Sintaxis de la solicitud
```
GET /2015-02-01/file-systems/FileSystemId/backup-policy HTTP/1.1
```
## Parámetros de solicitud del URI
La solicitud utiliza los siguientes parámetros URI.
** [FileSystemId](#API_DescribeBackupPolicy_RequestSyntax) **
Especifica el sistema de archivos de EFS para el que se va a recuperar la `BackupPolicy`.
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í
## 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
{
"BackupPolicy": {
"Status": "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.
** [BackupPolicy](#API_DescribeBackupPolicy_ResponseSyntax) **
Describe la política de copias de seguridad del sistema de archivos e indica si las copias de seguridad automáticas están activadas o desactivadas.
Tipo: objeto [BackupPolicy](API_BackupPolicy.md)
## 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.
** 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 Cuenta de AWS solicitante.
** 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
** PolicyNotFound **
Se devuelve si no se pueden localizar la política de IAM o la política de recursos especificadas o si no se puede acceder a ellas. Según la acción que se realice, el error también se puede devolver si la política del sistema de archivos predeterminada está vigente para el sistema de archivos de EFS o si no se especifica ninguna política de copia de seguridad.
** 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
** ValidationException **
Se devuelve si el AWS Backup servicio no está disponible en el lugar Región de AWS en el que se realizó la solicitud.
** 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
## 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/DescribeBackupPolicy)
+ [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/DescribeBackupPolicy)
+ [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/DescribeBackupPolicy)
+ [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/DescribeBackupPolicy)
+ [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/DescribeBackupPolicy)
+ [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/DescribeBackupPolicy)
+ [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/DescribeBackupPolicy)
+ [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/DescribeBackupPolicy)
+ [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/DescribeBackupPolicy)
+ [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/DescribeBackupPolicy)
# DescribeFileSystemPolicy
Devuelve la `FileSystemPolicy` del sistema de archivos de EFS especificado.
Esta operación necesita permisos para la acción `elasticfilesystem:DescribeFileSystemPolicy`.
## Sintaxis de la solicitud
```
GET /2015-02-01/file-systems/FileSystemId/policy HTTP/1.1
```
## Parámetros de solicitud del URI
La solicitud utiliza los siguientes parámetros URI.
** [FileSystemId](#API_DescribeFileSystemPolicy_RequestSyntax) **
Especifica el sistema de archivos EFS del que se va a recuperar el `FileSystemPolicy`.
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í
## 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
{
"FileSystemId": "string",
"Policy": "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.
** [FileSystemId](#API_DescribeFileSystemPolicy_ResponseSyntax) **
Especifica el sistema de archivos de EFS al que se aplica la `FileSystemPolicy`.
Tipo: cadena
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})$`
** [Policy](#API_DescribeFileSystemPolicy_ResponseSyntax) **
`FileSystemPolicy` con formato JSON para el sistema de archivos de EFS.
Tipo: cadena
Limitaciones de longitud: longitud mínima de 1. Longitud máxima de 20 000.
Patrón: `[\s\S]+`
## 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.
** 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 Cuenta de AWS solicitante.
** 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
** PolicyNotFound **
Se devuelve si no se pueden localizar la política de IAM o la política de recursos especificadas o si no se puede acceder a ellas. Según la acción que se realice, el error también se puede devolver si la política del sistema de archivos predeterminada está vigente para el sistema de archivos de EFS o si no se especifica ninguna política de copia de seguridad.
** 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
## Ejemplos
### Ejemplo
Este ejemplo ilustra un uso de DescribeFileSystemPolicy.
#### Solicitud de muestra
```
GET /2015-02-01/file-systems/fs-01234567/policy HTTP/1.1
```
#### Respuesta de ejemplo
```
{
"FileSystemId": "fs-01234567",
"Policy": "{
"Version": "2012-10-17",
"Id": "efs-policy-wizard-cdef0123-aaaa-6666-5555-444455556666",
"Statement": [
{
"Sid": "efs-statement-abcdef01-1111-bbbb-2222-111122224444",
"Effect" : "Deny",
"Principal": {
"AWS": "*"
},
"Action": "*",
"Resource": "arn:aws:elasticfilesystem:us-east-2:111122223333:file-system/fs-01234567",
"Condition": {
"Bool": {
"aws:SecureTransport": "false"
}
}
},
{
"Sid": "efs-statement-01234567-aaaa-3333-4444-111122223333",
"Effect": "Allow",
"Principal": {
"AWS": "*"
},
"Action": [
"elasticfilesystem:ClientMount",
"elasticfilesystem:ClientWrite"
],
"Resource" : "arn:aws:elasticfilesystem:us-east-2:111122223333:file-system/fs-01234567"
}
]
}
}
```
## 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, consulte lo siguiente:
+ [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/elasticfilesystem-2015-02-01/DescribeFileSystemPolicy)
+ [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/DescribeFileSystemPolicy)
+ [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/DescribeFileSystemPolicy)
+ [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/DescribeFileSystemPolicy)
+ [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/DescribeFileSystemPolicy)
+ [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/DescribeFileSystemPolicy)
+ [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/DescribeFileSystemPolicy)
+ [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/DescribeFileSystemPolicy)
+ [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/DescribeFileSystemPolicy)
+ [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/DescribeFileSystemPolicy)
# DescribeFileSystems
Devuelve la descripción de un sistema de archivos de Amazon EFS específico si se proporciona `CreationToken` o `FileSystemId` del sistema de archivos. De lo contrario, devuelve descripciones de todos los sistemas de archivos propiedad Región de AWS de la persona que llama Cuenta de AWS en el punto final al que está llamando.
Al recuperar todas las descripciones de los sistemas de archivos, si lo desea, puede especificar el parámetro `MaxItems` para limitar el número de descripciones en una respuesta. Este número se establece automáticamente en 100. Si quedan más descripciones de sistemas de archivos, Amazon EFS devuelve un `NextMarker`, un token opaco, en la respuesta. En este caso, debe enviar una solicitud posterior con el parámetro de solicitud `Marker` establecido en el valor de `NextMarker`.
Para recuperar una lista de las descripciones del sistema de archivos, esta operación se utiliza en un proceso iterativo, en el que `DescribeFileSystems` se llama primero sin el `Marker` y, a continuación, la operación continúa llamándola con el parámetro `Marker` establecido en el valor de `NextMarker` de la respuesta anterior hasta que la respuesta no tenga ningún `NextMarker`.
El orden de los sistemas de archivos devueltos en la respuesta a una llamada a `DescribeFileSystems` y el orden de los sistemas de archivos devueltos en las respuestas de una iteración de varias llamadas no están especificados.
Esta operación necesita permisos para la acción `elasticfilesystem:DescribeFileSystems`.
## Sintaxis de la solicitud
```
GET /2015-02-01/file-systems?CreationToken=CreationToken&FileSystemId=FileSystemId&Marker=Marker&MaxItems=MaxItems HTTP/1.1
```
## Parámetros de solicitud del URI
La solicitud utiliza los siguientes parámetros URI.
** [CreationToken](#API_DescribeFileSystems_RequestSyntax) **
(Opcional) Restringe la lista al sistema de archivos con este identificador de creación (cadena). Al crear un sistema de archivos de Amazon EFS, se especifica un token de creación.
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 64.
Patrón: `.+`
** [FileSystemId](#API_DescribeFileSystems_RequestSyntax) **
(Opcional) ID del sistema de archivos cuya descripción desea recuperar (cadena).
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})$`
** [Marker](#API_DescribeFileSystems_RequestSyntax) **
(Opcional) Un token de paginación opaco devuelto por una operación `DescribeFileSystems` anterior (cadena). Si está presente, especifica continuar la lista desde donde terminó la llamada de devolución.
Limitaciones de longitud: longitud mínima de 1. Longitud máxima de 128.
Patrón: `.+`
** [MaxItems](#API_DescribeFileSystems_RequestSyntax) **
(Opcional) Especifica el número máximo de sistemas de archivos que se devuelven en una respuesta (integer). Este número se establece automáticamente en 100. La respuesta se pagina a 100 por página si tiene más de 100 sistemas de archivos.
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
{
"FileSystems": [
{
"AvailabilityZoneId": "string",
"AvailabilityZoneName": "string",
"CreationTime": number,
"CreationToken": "string",
"Encrypted": boolean,
"FileSystemArn": "string",
"FileSystemId": "string",
"FileSystemProtection": {
"ReplicationOverwriteProtection": "string"
},
"KmsKeyId": "string",
"LifeCycleState": "string",
"Name": "string",
"NumberOfMountTargets": number,
"OwnerId": "string",
"PerformanceMode": "string",
"ProvisionedThroughputInMibps": number,
"SizeInBytes": {
"Timestamp": number,
"Value": number,
"ValueInArchive": number,
"ValueInIA": number,
"ValueInStandard": number
},
"Tags": [
{
"Key": "string",
"Value": "string"
}
],
"ThroughputMode": "string"
}
],
"Marker": "string",
"NextMarker": "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.
** [FileSystems](#API_DescribeFileSystems_ResponseSyntax) **
Conjunto de descripciones de sistemas de archivos.
Tipo: matriz de objetos [FileSystemDescription](API_FileSystemDescription.md)
** [Marker](#API_DescribeFileSystems_ResponseSyntax) **
Está presente si el intermediario lo proporciona en la solicitud (cadena).
Tipo: cadena
Limitaciones de longitud: longitud mínima de 1. Longitud máxima de 128.
Patrón: `.+`
** [NextMarker](#API_DescribeFileSystems_ResponseSyntax) **
Está presente si hay más sistemas de archivos de los devueltos en la respuesta (cadena). Se puede utilizar `NextMarker` en la solicitud subsiguiente para obtener las descripciones.
Tipo: cadena
Limitaciones de longitud: longitud mínima de 1. Longitud máxima de 128.
Patrón: `.+`
## 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.
** 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
## Ejemplos
### Recupere una lista de 10 sistemas de archivos
El siguiente ejemplo envía una solicitud GET al punto de conexión `file-systems` (`elasticfilesystem.us-west-2.amazonaws.com/2015-02-01/file-systems`). La solicitud especifica un parámetro de consulta `MaxItems` para limitar el número de descripciones del sistema de archivos a 10.
#### Solicitud de muestra
```
GET /2015-02-01/file-systems?MaxItems=10 HTTP/1.1
Host: elasticfilesystem.us-west-2.amazonaws.com
x-amz-date: 20140622T191208Z
Authorization: <...>
```
#### Respuesta de ejemplo
```
HTTP/1.1 200 OK
x-amzn-RequestId: 01234567-89ab-cdef-0123-456789abcdef
Content-Type: application/json
Content-Length: 499
{
"FileSystems":[
{
"OwnerId":"251839141158",
"CreationToken":"MyFileSystem1",
"FileSystemId":"fs-01234567",
"PerformanceMode" : "generalPurpose",
"CreationTime":"1403301078",
"LifeCycleState":"created",
"Name":"my first file system",
"NumberOfMountTargets":1,
"SizeInBytes":{
"Timestamp": 1403301078,
"Value": 29313618372,
"ValueInArchive": 201156,
"ValueInIA": 675432,
"ValueInStandard": 29312741784
}
}
]
}
```
## 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/DescribeFileSystems)
+ [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/DescribeFileSystems)
+ [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/DescribeFileSystems)
+ [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/DescribeFileSystems)
+ [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/DescribeFileSystems)
+ [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/DescribeFileSystems)
+ [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/DescribeFileSystems)
+ [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/DescribeFileSystems)
+ [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/DescribeFileSystems)
+ [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/DescribeFileSystems)
# DescribeLifecycleConfiguration
Devuelve el objeto `LifecycleConfiguration` actual para el sistema de archivos de EFS especificado. La administración del ciclo de vida usa el objeto `LifecycleConfiguration` para identificar cuándo se deben mover los archivos entre clases de almacenamiento. En el caso de un sistema de archivos sin un objeto `LifecycleConfiguration`, la llamada devuelve una matriz vacía en la respuesta.
Esta operación necesita permisos para la operación `elasticfilesystem:DescribeLifecycleConfiguration`.
## Sintaxis de la solicitud
```
GET /2015-02-01/file-systems/FileSystemId/lifecycle-configuration HTTP/1.1
```
## Parámetros de solicitud del URI
La solicitud utiliza los siguientes parámetros URI.
** [FileSystemId](#API_DescribeLifecycleConfiguration_RequestSyntax) **
El ID del sistema de archivos cuyo objeto `LifecycleConfiguration` desea recuperar (String).
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í
## 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
{
"LifecyclePolicies": [
{
"TransitionToArchive": "string",
"TransitionToIA": "string",
"TransitionToPrimaryStorageClass": "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.
** [LifecyclePolicies](#API_DescribeLifecycleConfiguration_ResponseSyntax) **
Un conjunto de políticas de administración del ciclo de vida. EFS admite un máximo de una política por sistema de archivos.
Tipo: matriz de objetos [LifecyclePolicy](API_LifecyclePolicy.md)
Miembros de la matriz: número máximo de 3 elementos.
## 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.
** 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 Cuenta de AWS solicitante.
** 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
## Ejemplos
### Recupera la configuración del ciclo de vida de un sistema de archivos
La siguiente solicitud recupera el objeto `LifecycleConfiguration` del sistema de archivos especificado.
#### Solicitud de muestra
```
GET /2015-02-01/file-systems/fs-01234567/lifecycle-configuration HTTP/1.1
Host: elasticfilesystem.us-west-2.amazonaws.com
x-amz-date: 20181120T221118Z
Authorization: <...>
```
#### Respuesta de ejemplo
```
HTTP/1.1 200 OK
x-amzn-RequestId: 01234567-89ab-cdef-0123-456789abcdef
Content-Type: application/json
Content-Length: 86
{
"LifecyclePolicies": [
{
"TransitionToArchive": "AFTER_270_DAYS"
},
{
"TransitionToIA": "AFTER_14_DAYS"
},
{
"TransitionToPrimaryStorageClass": "AFTER_1_ACCESS"
}
]
}
```
## 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/DescribeLifecycleConfiguration)
+ [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/DescribeLifecycleConfiguration)
+ [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/DescribeLifecycleConfiguration)
+ [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/DescribeLifecycleConfiguration)
+ [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/DescribeLifecycleConfiguration)
+ [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/DescribeLifecycleConfiguration)
+ [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/DescribeLifecycleConfiguration)
+ [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/DescribeLifecycleConfiguration)
+ [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/DescribeLifecycleConfiguration)
+ [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/DescribeLifecycleConfiguration)
# DescribeMountTargets
Devuelve las descripciones de todos los destinos de montaje actuales o un destino de montaje específico, de un sistema de archivos. Al solicitar todos los objetivos de montaje actuales, no se especifica el orden de los objetivos de montaje devueltos en la respuesta.
Esta operación requiere permisos para la acción `elasticfilesystem:DescribeMountTargets`, ya sea en el ID del sistema de archivos que especifique en `FileSystemId` o en el sistema de archivos del destino de montaje que especifique en `MountTargetId`.
El comando de la CLI correspondiente es `describe-mount-targets`.
## Sintaxis de la solicitud
```
GET /2015-02-01/mount-targets?AccessPointId=AccessPointId&FileSystemId=FileSystemId&Marker=Marker&MaxItems=MaxItems&MountTargetId=MountTargetId HTTP/1.1
```
## Parámetros de solicitud del URI
La solicitud utiliza los siguientes parámetros URI.
** [AccessPointId](#API_DescribeMountTargets_RequestSyntax) **
(Opcional) El ID del punto de acceso cuyos objetivos de montaje desea enumerar. Debe incluirse en la solicitud si un `FileSystemId` o `MountTargetId` no se han incluido en la solicitud. Acepta un ID de punto de acceso o un ARN como entrada.
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_DescribeMountTargets_RequestSyntax) **
(Opcional) ID del sistema de archivos cuyos objetivos de montaje desea enumerar (cadena). Debe incluirse en la solicitud si un `AccessPointId` o `MountTargetId` no se han incluido. Acepta un ID de sistema de archivos o un ARN como entrada.
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})$`
** [Marker](#API_DescribeMountTargets_RequestSyntax) **
(Opcional) Un token de paginación opaco devuelto por una operación `DescribeMountTargets` anterior (cadena). Si está presente, especifica continuar la lista desde donde terminó la llamada de devolución anterior.
Limitaciones de longitud: longitud mínima de 1. Longitud máxima de 128.
Patrón: `.+`
** [MaxItems](#API_DescribeMountTargets_RequestSyntax) **
(Opcional) El número máximo de destinos de montaje que se devuelven en una respuesta. Actualmente, este número se establece automáticamente en 10 y el resto de valores se ignoran. La respuesta se pagina a 100 por página si tiene más de 100 destinos de montaje.
Rango válido: valor mínimo de 1.
** [MountTargetId](#API_DescribeMountTargets_RequestSyntax) **
(Opcional) ID del objetivo de montaje que quiere describir (cadena). Debe incluirse en la solicitud si un `FileSystemId` no se ha incluido. Acepta un ID de destino de montaje o un ARN como entrada.
Limitaciones de longitud: longitud mínima de 13. Longitud máxima de 45.
Patrón: `^fsmt-[0-9a-f]{8,40}$`
## 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",
"MountTargets": [
{
"AvailabilityZoneId": "string",
"AvailabilityZoneName": "string",
"FileSystemId": "string",
"IpAddress": "string",
"Ipv6Address": "string",
"LifeCycleState": "string",
"MountTargetId": "string",
"NetworkInterfaceId": "string",
"OwnerId": "string",
"SubnetId": "string",
"VpcId": "string"
}
],
"NextMarker": "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](#API_DescribeMountTargets_ResponseSyntax) **
Si la solicitud incluía un `Marker`, la respuesta devuelve ese valor en este campo.
Tipo: cadena
Limitaciones de longitud: longitud mínima de 1. Longitud máxima de 128.
Patrón: `.+`
** [MountTargets](#API_DescribeMountTargets_ResponseSyntax) **
Devuelve los objetivos de montaje del sistema de archivos como un conjunto de objetos `MountTargetDescription`.
Tipo: matriz de objetos [MountTargetDescription](API_MountTargetDescription.md)
** [NextMarker](#API_DescribeMountTargets_ResponseSyntax) **
Si hay un valor, hay más objetivos de montaje que devolver. En una solicitud posterior, puede proporcionar `Marker` en su solicitud para recuperar el siguiente conjunto de objetivos de montaje.
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 Cuenta de AWS solicitante.
** 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
** MountTargetNotFound **
Se devuelve si no hay un objetivo de montaje con el ID especificado que se encoentró en la Cuenta de AWS de la persona que llama.
** 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
## Ejemplos
### Recupera las descripciones de los objetivos de montaje creados para un sistema de archivos
La siguiente solicitud recupera las descripciones de los objetivos de montaje creados para el sistema de archivos especificado.
#### Solicitud de muestra
```
GET /2015-02-01/mount-targets?FileSystemId=fs-01234567 HTTP/1.1
Host: elasticfilesystem.us-west-2.amazonaws.com
x-amz-date: 20140622T191252Z
Authorization: <...>
```
#### Respuesta de ejemplo
```
HTTP/1.1 200 OK
x-amzn-RequestId: 01234567-89ab-cdef-0123-456789abcdef
Content-Type: application/json
Content-Length: 357
{
"MountTargets":[
{
"OwnerId":"251839141158",
"MountTargetId":"fsmt-01234567",
"FileSystemId":"fs-01234567",
"SubnetId":"subnet-01234567",
"LifeCycleState":"added",
"IpAddress":"10.0.2.42",
"NetworkInterfaceId":"eni-1bcb7772"
}
]
}
```
## 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/DescribeMountTargets)
+ [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/DescribeMountTargets)
+ [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/DescribeMountTargets)
+ [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/DescribeMountTargets)
+ [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/DescribeMountTargets)
+ [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/DescribeMountTargets)
+ [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/DescribeMountTargets)
+ [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/DescribeMountTargets)
+ [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/DescribeMountTargets)
+ [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/DescribeMountTargets)
# DescribeMountTargetSecurityGroups
Devuelve los grupos de seguridad actualmente en vigor de un destino de montaje. Esta operación requiere que se haya creado la interfaz de red del objetivo de montaje y que no el estado del ciclo de vida del destino de montaje no sea `deleted`.
Esta operación necesita permisos para las siguientes acciones:
+ Acción de `elasticfilesystem:DescribeMountTargetSecurityGroups` en el sistema de archivos del objetivo de montaje.
+ Acción de `ec2:DescribeNetworkInterfaceAttribute` en la interfaz de red del objetivo de montaje.
## Sintaxis de la solicitud
```
GET /2015-02-01/mount-targets/MountTargetId/security-groups HTTP/1.1
```
## Parámetros de solicitud del URI
La solicitud utiliza los siguientes parámetros URI.
** [MountTargetId](#API_DescribeMountTargetSecurityGroups_RequestSyntax) **
El ID del objetivo de montaje cuyos grupos de seguridad desea recuperar.
Limitaciones de longitud: longitud mínima de 13. Longitud máxima de 45.
Patrón: `^fsmt-[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
{
"SecurityGroups": [ "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.
** [SecurityGroups](#API_DescribeMountTargetSecurityGroups_ResponseSyntax) **
Un conjunto de grupos de seguridad
Tipo: matriz de cadenas
Miembros de la matriz: número máximo de 100 elementos.
Limitaciones de longitud: longitud mínima de 11. Longitud máxima de 43.
Patrón: `^sg-[0-9a-f]{8,40}`
## 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.
** 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
** IncorrectMountTargetState **
Se devuelve si el objetivo de montaje no tiene el estado correcto para la operación.
** 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: 409
** 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
** MountTargetNotFound **
Se devuelve si no hay un objetivo de montaje con el ID especificado que se encoentró en la Cuenta de AWS de la persona que llama.
** 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
## Ejemplos
### Recuperar grupos de seguridad en vigor de un sistema de archivos
El siguiente ejemplo recupera los grupos de seguridad vigentes para la interfaz de red asociada a un objetivo de montaje.
#### Solicitud de muestra
```
GET /2015-02-01/mount-targets/fsmt-9a13661e/security-groups HTTP/1.1
Host: elasticfilesystem.us-west-2.amazonaws.com
x-amz-date: 20140620T223513Z
Authorization: <...>
```
#### Respuesta de ejemplo
```
HTTP/1.1 200 OK
x-amzn-RequestId: 01234567-89ab-cdef-0123-456789abcdef
Content-Length: 57
{
"SecurityGroups" : [
"sg-188d9f74"
]
}
```
## 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/DescribeMountTargetSecurityGroups)
+ [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/DescribeMountTargetSecurityGroups)
+ [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/DescribeMountTargetSecurityGroups)
+ [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/DescribeMountTargetSecurityGroups)
+ [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/DescribeMountTargetSecurityGroups)
+ [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/DescribeMountTargetSecurityGroups)
+ [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/DescribeMountTargetSecurityGroups)
+ [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/DescribeMountTargetSecurityGroups)
+ [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/DescribeMountTargetSecurityGroups)
+ [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/DescribeMountTargetSecurityGroups)
# DescribeReplicationConfigurations
Recupera la configuración de replicación de un sistema de archivos específico. Si no se especifica un sistema de archivos, se recuperan todas las configuraciones de replicación del Cuenta de AWS in Región de AWS an.
## Sintaxis de la solicitud
```
GET /2015-02-01/file-systems/replication-configurations?FileSystemId=FileSystemId&MaxResults=MaxResults&NextToken=NextToken HTTP/1.1
```
## Parámetros de solicitud del URI
La solicitud utiliza los siguientes parámetros URI.
** [FileSystemId](#API_DescribeReplicationConfigurations_RequestSyntax) **
Puede recuperar la configuración de replicación de un sistema de archivos específico proporcionando su ID de sistema de archivos. Para la replicación entre cuentas y regiones, una cuenta solo puede describir la configuración de replicación de un sistema de archivos en su propia región.
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_DescribeReplicationConfigurations_RequestSyntax) **
(Opcional) 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_DescribeReplicationConfigurations_RequestSyntax) **
`NextToken` está presente si la respuesta está paginada. Se puede utilizar `NextToken` en una solicitud posterior para buscar la siguiente página de resultados.
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
{
"NextToken": "string",
"Replications": [
{
"CreationTime": number,
"Destinations": [
{
"FileSystemId": "string",
"LastReplicatedTimestamp": number,
"OwnerId": "string",
"Region": "string",
"RoleArn": "string",
"Status": "string",
"StatusMessage": "string"
}
],
"OriginalSourceFileSystemArn": "string",
"SourceFileSystemArn": "string",
"SourceFileSystemId": "string",
"SourceFileSystemOwnerId": "string",
"SourceFileSystemRegion": "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](#API_DescribeReplicationConfigurations_ResponseSyntax) **
Se puede utilizar `NextToken` de la respuesta anterior en la solicitud subsiguiente para obtener las descripciones adicionales.
Tipo: cadena
Limitaciones de longitud: longitud mínima de 1. Longitud máxima de 128.
Patrón: `.+`
** [Replications](#API_DescribeReplicationConfigurations_ResponseSyntax) **
El conjunto de configuraciones de replicación que se devuelve.
Tipo: matriz de objetos [ReplicationConfigurationDescription](API_ReplicationConfigurationDescription.md)
## 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.
** 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 Cuenta de AWS solicitante.
** 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
** ReplicationNotFound **
Se devuelve si el sistema de archivos especificado no tiene una configuración de replicación.
** ErrorCode **
ReplicationNotFound
** 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
** ValidationException **
Se devuelve si el AWS Backup servicio no está disponible en el lugar Región de AWS en el que se realizó la solicitud.
** 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
## 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/DescribeReplicationConfigurations)
+ [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/DescribeReplicationConfigurations)
+ [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/DescribeReplicationConfigurations)
+ [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/DescribeReplicationConfigurations)
+ [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/DescribeReplicationConfigurations)
+ [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/DescribeReplicationConfigurations)
+ [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/DescribeReplicationConfigurations)
+ [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/DescribeReplicationConfigurations)
+ [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/DescribeReplicationConfigurations)
+ [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/DescribeReplicationConfigurations)
# 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](#API_DescribeTags_RequestSyntax) **
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](#API_DescribeTags_RequestSyntax) **
(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. Longitud máxima de 128.
Patrón: `.+`
** [MaxItems](#API_DescribeTags_RequestSyntax) **
(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](#API_DescribeTags_ResponseSyntax) **
Si la solicitud incluía un `Marker`, la respuesta devuelve ese valor en este campo.
Tipo: cadena
Limitaciones de longitud: longitud mínima de 1. Longitud máxima de 128.
Patrón: `.+`
** [NextMarker](#API_DescribeTags_ResponseSyntax) **
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: cadena
Limitaciones de longitud: longitud mínima de 1. Longitud máxima de 128.
Patrón: `.+`
** [Tags](#API_DescribeTags_ResponseSyntax) **
Devuelve las etiquetas asociadas al sistema de archivos como un conjunto de objetos `Tag`.
Tipo: matriz de objetos [Tag](API_Tag.md)
## 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.
** 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 Cuenta de AWS solicitante.
** 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
## 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 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/DescribeTags)
+ [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/DescribeTags)
+ [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/DescribeTags)
+ [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/DescribeTags)
+ [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/DescribeTags)
+ [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/DescribeTags)
+ [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/DescribeTags)
+ [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/DescribeTags)
+ [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/DescribeTags)
+ [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/DescribeTags)
# 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](#API_ListTagsForResource_RequestSyntax) **
(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](#API_ListTagsForResource_RequestSyntax) **
(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. Longitud máxima de 128.
Patrón: `.+`
** [ResourceId](#API_ListTagsForResource_RequestSyntax) **
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](#API_ListTagsForResource_ResponseSyntax) **
`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: cadena
Limitaciones de longitud: longitud mínima de 1. Longitud máxima de 128.
Patrón: `.+`
** [Tags](#API_ListTagsForResource_ResponseSyntax) **
Un conjunto de las etiquetas del recurso de EFS especificado.
Tipo: matriz de objetos [Tag](API_Tag.md)
## Errores
** AccessPointNotFound **
Se devuelve si el `AccessPointId` valor especificado no existe en el del Cuenta de AWS solicitante.
** 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/ListTagsForResource)
+ [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/ListTagsForResource)
+ [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/ListTagsForResource)
+ [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/ListTagsForResource)
+ [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/ListTagsForResource)
+ [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/ListTagsForResource)
+ [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/ListTagsForResource)
+ [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/ListTagsForResource)
+ [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/ListTagsForResource)
+ [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/ListTagsForResource)
# ModifyMountTargetSecurityGroups
Modifica el conjunto de grupos de seguridad en vigor de un destino de montaje.
Al crear un destino de montaje, Amazon EFS también crea una nueva interfaz de red. Para obtener más información, consulte [CreateMountTarget](API_CreateMountTarget.md). Esta operación reemplaza los grupos de seguridad vigentes para la interfaz de red asociada a un destino de montaje, por los `SecurityGroups` proporcionados en la solicitud. Esta operación requiere que se haya creado la interfaz de red del destino de montaje y que no el estado del ciclo de vida del destino de montaje no sea `deleted`.
La operación necesita permisos para las siguientes acciones:
+ Acción de `elasticfilesystem:ModifyMountTargetSecurityGroups` en el sistema de archivos del objetivo de montaje.
+ Acción de `ec2:ModifyNetworkInterfaceAttribute` en la interfaz de red del objetivo de montaje.
## Sintaxis de la solicitud
```
PUT /2015-02-01/mount-targets/MountTargetId/security-groups HTTP/1.1
Content-type: application/json
{
"SecurityGroups": [ "string" ]
}
```
## Parámetros de solicitud del URI
La solicitud utiliza los siguientes parámetros URI.
** [MountTargetId](#API_ModifyMountTargetSecurityGroups_RequestSyntax) **
El ID del objetivo de montaje cuyos grupos de seguridad desea modificar.
Limitaciones de longitud: longitud mínima de 13. Longitud máxima de 45.
Patrón: `^fsmt-[0-9a-f]{8,40}$`
Obligatorio: sí
## Cuerpo de la solicitud
La solicitud acepta los siguientes datos en formato JSON.
** [SecurityGroups](#API_ModifyMountTargetSecurityGroups_RequestSyntax) **
Un conjunto de grupos de seguridad de VPC. IDs
Tipo: matriz de cadenas
Miembros de la matriz: número máximo de 100 elementos.
Limitaciones de longitud: longitud mínima de 11. Longitud máxima de 43.
Patrón: `^sg-[0-9a-f]{8,40}`
Obligatorio: no
## Sintaxis de la respuesta
```
HTTP/1.1 204
```
## Elementos de respuesta
Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 204 con un cuerpo HTTP vacío.
## 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.
** 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
** IncorrectMountTargetState **
Se devuelve si el objetivo de montaje no tiene el estado correcto para la operación.
** 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: 409
** 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
** MountTargetNotFound **
Se devuelve si no hay un objetivo de montaje con el ID especificado que se encoentró en la Cuenta de AWS de la persona que llama.
** 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
** SecurityGroupLimitExceeded **
Se devuelve si el número de `SecurityGroups` especificado en la solicitud supera el límite, que se basa en la cuota de la cuenta. Elimine algunos grupos de seguridad o solicite que se aumente la cuota de la cuenta. Para obtener más información, consulte [Cuotas de Amazon VPC](https://docs.aws.amazon.com/vpc/latest/userguide/amazon-vpc-limits.html) en la *Guía del usuario de Amazon VPC* (consulte la tabla **Grupos de seguridad**).
** 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
** SecurityGroupNotFound **
Se devuelve si uno de los grupos de seguridad especificados no existe en la nube privada virtual (VPC) de la subred.
** 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
## Ejemplos
### Sustituya los grupos de seguridad de un objetivo de montaje
El siguiente ejemplo sustituye los grupos de seguridad vigentes para la interfaz de red asociada a un destino de montaje.
#### Solicitud de muestra
```
PUT /2015-02-01/mount-targets/fsmt-9a13661e/security-groups HTTP/1.1
Host: elasticfilesystem.us-west-2.amazonaws.com
x-amz-date: 20140620T223446Z
Authorization: <...>
Content-Type: application/json
Content-Length: 57
{
"SecurityGroups" : [
"sg-188d9f74"
]
}
```
#### Respuesta de ejemplo
```
HTTP/1.1 204 No Content
x-amzn-RequestId: 01234567-89ab-cdef-0123-456789abcdef
```
## 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, consulte lo siguiente:
+ [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/elasticfilesystem-2015-02-01/ModifyMountTargetSecurityGroups)
+ [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/ModifyMountTargetSecurityGroups)
+ [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/ModifyMountTargetSecurityGroups)
+ [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/ModifyMountTargetSecurityGroups)
+ [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/ModifyMountTargetSecurityGroups)
+ [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/ModifyMountTargetSecurityGroups)
+ [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/ModifyMountTargetSecurityGroups)
+ [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/ModifyMountTargetSecurityGroups)
+ [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/ModifyMountTargetSecurityGroups)
+ [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/ModifyMountTargetSecurityGroups)
# PutAccountPreferences
Utilice esta operación para establecer la preferencia de la cuenta en la cuenta actual Región de AWS para utilizar un recurso largo de 17 caracteres (63 bits) o corto de 8 caracteres (32 bits) IDs para el nuevo sistema de archivos EFS y montar los recursos de destino. IDs Los cambios que realice no afectarán a todos los recursos existentes. Puede establecer la preferencia de ID durante el período de suscripción a medida que EFS pasa a ser un recurso IDs largo. Para obtener más información, consulte [Administración de recursos de Amazon EFS IDs](https://docs.aws.amazon.com/efs/latest/ug/manage-efs-resource-ids.html).
**nota**
A partir de octubre de 2021, recibirá un mensaje de error si intenta configurar la preferencia de la cuenta para utilizar el ID de recurso corto en formato de 8 caracteres. Póngase en contacto con el servicio de AWS asistencia si recibe un error y debe utilizar la IDs abreviatura de sistema de archivos y montar los recursos de destino.
## Sintaxis de la solicitud
```
PUT /2015-02-01/account-preferences HTTP/1.1
Content-type: application/json
{
"ResourceIdType": "string"
}
```
## Parámetros de solicitud del URI
La solicitud no utiliza ningún parámetro de URI.
## Cuerpo de la solicitud
La solicitud acepta los siguientes datos en formato JSON.
** [ResourceIdType](#API_PutAccountPreferences_RequestSyntax) **
Especifica la preferencia de ID de recurso de EFS que se debe establecer para el usuario Cuenta de AWS Región de AWS, en la versión actual `LONG_ID` (17 caracteres) u `SHORT_ID` (8 caracteres).
A partir de octubre de 2021, recibirá un error al establecer la preferencia de cuenta en `SHORT_ID`. Póngase en contacto con el servicio de AWS asistencia si recibe un error y debe utilizar la abreviatura IDs para sistema de archivos y montar los recursos de destino.
Tipo: cadena
Valores válidos: `LONG_ID | SHORT_ID`
Obligatorio: sí
## Sintaxis de la respuesta
```
HTTP/1.1 200
Content-type: application/json
{
"ResourceIdPreference": {
"ResourceIdType": "string",
"Resources": [ "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.
** [ResourceIdPreference](#API_PutAccountPreferences_ResponseSyntax) **
Describe el tipo de recurso y su preferencia de ID para el usuario Cuenta de AWS, en el estado actual Región de AWS.
Tipo: objeto [ResourceIdPreference](API_ResourceIdPreference.md)
## 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.
** 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
** 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, consulte lo siguiente:
+ [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/elasticfilesystem-2015-02-01/PutAccountPreferences)
+ [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/PutAccountPreferences)
+ [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/PutAccountPreferences)
+ [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/PutAccountPreferences)
+ [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/PutAccountPreferences)
+ [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/PutAccountPreferences)
+ [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/PutAccountPreferences)
+ [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/PutAccountPreferences)
+ [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/PutAccountPreferences)
+ [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/PutAccountPreferences)
# PutBackupPolicy
Actualiza la política de copias de seguridad del sistema de archivos. Utilice esta acción para iniciar o detener las copias de seguridad automáticas del sistema de archivos.
## Sintaxis de la solicitud
```
PUT /2015-02-01/file-systems/FileSystemId/backup-policy HTTP/1.1
Content-type: application/json
{
"BackupPolicy": {
"Status": "string"
}
}
```
## Parámetros de solicitud del URI
La solicitud utiliza los siguientes parámetros URI.
** [FileSystemId](#API_PutBackupPolicy_RequestSyntax) **
Especifica el sistema de archivos de EFS para el que se debe actualizar la política de copias de seguridad.
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í
## Cuerpo de la solicitud
La solicitud acepta los siguientes datos en formato JSON.
** [BackupPolicy](#API_PutBackupPolicy_RequestSyntax) **
La política de copias de seguridad incluida en la solicitud de `PutBackupPolicy`.
Tipo: objeto [BackupPolicy](API_BackupPolicy.md)
Obligatorio: sí
## Sintaxis de la respuesta
```
HTTP/1.1 200
Content-type: application/json
{
"BackupPolicy": {
"Status": "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.
** [BackupPolicy](#API_PutBackupPolicy_ResponseSyntax) **
Describe la política de copias de seguridad del sistema de archivos e indica si las copias de seguridad automáticas están activadas o desactivadas.
Tipo: objeto [BackupPolicy](API_BackupPolicy.md)
## 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.
** 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 Cuenta de AWS solicitante.
** 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
** IncorrectFileSystemLifeCycleState **
Se devuelve si el estado del ciclo de vida del sistema de archivos es no “disponible”.
** 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: 409
** 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
** ValidationException **
Se devuelve si el AWS Backup servicio no está disponible en el lugar Región de AWS en el que se realizó la solicitud.
** 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
## 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/PutBackupPolicy)
+ [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/PutBackupPolicy)
+ [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/PutBackupPolicy)
+ [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/PutBackupPolicy)
+ [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/PutBackupPolicy)
+ [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/PutBackupPolicy)
+ [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/PutBackupPolicy)
+ [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/PutBackupPolicy)
+ [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/PutBackupPolicy)
+ [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/PutBackupPolicy)
# PutFileSystemPolicy
Aplica un `FileSystemPolicy` de Amazon EFS a un sistema de archivos de Amazon EFS. Una política de sistema de archivos es una política de IAM basada en recursos y puede contener varias declaraciones de política. Un sistema de archivos siempre tiene exactamente una política de sistema de archivos, que puede ser la política predeterminada o una política explícita establecida o actualizada mediante esta operación de API. Las políticas del sistema de archivos de EFS tienen un límite de 20 000 caracteres. Cuando se establece una política explícita, se anula la política predeterminada. Para obtener más información acerca de la política de sistema de archivos predeterminada, consulte [ Política de sistema de archivos de EFS predeterminada](https://docs.aws.amazon.com/efs/latest/ug/iam-access-control-nfs-efs.html#default-filesystempolicy).
**nota**
Las políticas del sistema de archivos de EFS tienen un límite de 20 000 caracteres.
Esta operación necesita permisos para la acción `elasticfilesystem:PutFileSystemPolicy`.
## Sintaxis de la solicitud
```
PUT /2015-02-01/file-systems/FileSystemId/policy HTTP/1.1
Content-type: application/json
{
"BypassPolicyLockoutSafetyCheck": boolean,
"Policy": "string"
}
```
## Parámetros de solicitud del URI
La solicitud utiliza los siguientes parámetros URI.
** [FileSystemId](#API_PutFileSystemPolicy_RequestSyntax) **
El ID del sistema de archivos de EFS para el que se desea crear o actualizar `FileSystemPolicy`.
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í
## Cuerpo de la solicitud
La solicitud acepta los siguientes datos en formato JSON.
** [BypassPolicyLockoutSafetyCheck](#API_PutFileSystemPolicy_RequestSyntax) **
(Opcional) Un valor booleano que especifica si se omite o no el control de seguridad de bloqueo de `FileSystemPolicy`. La comprobación de seguridad de bloqueo determina si la política de la solicitud bloqueará, o impedirá, que la entidad principal de seguridad de IAM que realiza la solicitud haga futuras solicitudes de `PutFileSystemPolicy` en este sistema de archivos. Establezca `BypassPolicyLockoutSafetyCheck` en `True` solo cuando pretenda evitar que la entidad principal de IAM que realiza la solicitud haga solicitudes posteriores de `PutFileSystemPolicy` en este sistema de archivos. El valor predeterminado es `False`.
Tipo: Booleano
Obligatorio: no
** [Policy](#API_PutFileSystemPolicy_RequestSyntax) **
La `FileSystemPolicy` que está creando. Acepta una definición de política con formato JSON. Las políticas del sistema de archivos de EFS tienen un límite de 20 000 caracteres. Para obtener más información sobre los elementos que componen una política de sistema de archivos, consulte [Políticas basadas en recursos de Amazon EFS](https://docs.aws.amazon.com/efs/latest/ug/security_iam_service-with-iam.html#security_iam_service-with-iam-resource-based-policies).
Tipo: cadena
Limitaciones de longitud: longitud mínima de 1. Longitud máxima de 20 000.
Patrón: `[\s\S]+`
Obligatorio: sí
## Sintaxis de la respuesta
```
HTTP/1.1 200
Content-type: application/json
{
"FileSystemId": "string",
"Policy": "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.
** [FileSystemId](#API_PutFileSystemPolicy_ResponseSyntax) **
Especifica el sistema de archivos de EFS al que se aplica la `FileSystemPolicy`.
Tipo: cadena
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})$`
** [Policy](#API_PutFileSystemPolicy_ResponseSyntax) **
`FileSystemPolicy` con formato JSON para el sistema de archivos de EFS.
Tipo: cadena
Limitaciones de longitud: longitud mínima de 1. Longitud máxima de 20 000.
Patrón: `[\s\S]+`
## 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.
** 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 Cuenta de AWS solicitante.
** 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
** IncorrectFileSystemLifeCycleState **
Se devuelve si el estado del ciclo de vida del sistema de archivos es no “disponible”.
** 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: 409
** 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
** InvalidPolicyException **
Se devuelve si `FileSystemPolicy` tiene un formato incorrecto o contiene un error, como un valor de parámetro no válido, o falta un parámetro obligatorio. Se devuelve en el caso de un error en la comprobación de seguridad relacionada con el bloqueo de la política.
** 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
## Ejemplos
### Crear un EFS FileSystemPolicy
La siguiente solicitud crea una `FileSystemPolicy` que permite a todos los AWS principales montar el sistema de archivos EFS especificado con permisos de lectura y escritura.
#### Solicitud de muestra
```
PUT /2015-02-01/file-systems/fs-01234567/file-system-policy HTTP/1.1
{
"Version": "2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"elasticfilesystem:ClientMount",
"elasticfilesystem:ClientWrite"
],
"Principal": {
"AWS": ["*"]
},
}
]
}
```
#### Respuesta de ejemplo
```
{
"Version": "2012-10-17",
"Id": "1",
"Statement": [
{
"Sid": "efs-statement-abcdef01-1111-bbbb-2222-111122224444",
"Effect": "Allow",
"Action": [
"elasticfilesystem:ClientMount",
"elasticfilesystem:ClientWrite"
],
"Principal": {
"AWS": ["*"]
},
"Resource":"arn:aws:elasticfilesystem:us-east-1:1111222233334444:file-system/fs-01234567"
}
]
}
```
## 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, consulte lo siguiente:
+ [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/elasticfilesystem-2015-02-01/PutFileSystemPolicy)
+ [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/PutFileSystemPolicy)
+ [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/PutFileSystemPolicy)
+ [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/PutFileSystemPolicy)
+ [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/PutFileSystemPolicy)
+ [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/PutFileSystemPolicy)
+ [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/PutFileSystemPolicy)
+ [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/PutFileSystemPolicy)
+ [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/PutFileSystemPolicy)
+ [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/PutFileSystemPolicy)
# PutLifecycleConfiguration
Utilice esta acción para gestionar el almacenamiento de su sistema de archivos. A `LifecycleConfiguration` consta de uno o más objetos `LifecyclePolicy` que definen lo siguiente:
+ **`TransitionToIA`**: Cuándo mover los archivos del sistema de archivos del almacenamiento principal (clase de almacenamiento Estándar) al almacenamiento de Acceso poco frecuente (IA).
+ **`TransitionToArchive`**: Cuándo mover los archivos del sistema de archivos de su clase de almacenamiento actual (clase de almacenamiento IA o Estándar) al almacenamiento Archivado.
Los sistemas de archivos no pueden realizar la transición al almacenamiento Archivado antes de pasar al almacenamiento IA. Por lo tanto, no TransitionToArchive debe configurarse o debe ser posterior a TransitionTo IA.
**nota**
La clase de almacenamiento Archivo solo está disponible para sistemas de archivos que utilicen el modo de rendimiento elástico y el modo de rendimiento de uso general.
+ **`TransitionToPrimaryStorageClass`**: si se deben volver a mover los archivos del sistema de archivos al almacenamiento principal (clase de almacenamiento Estándar) una vez que se haya accedido a ellos en almacenamiento IA o Archivado.
Para obtener más información, consulte [ Administración del almacenamiento del sistema de archivos](https://docs.aws.amazon.com/efs/latest/ug/lifecycle-management-efs.html).
Cada sistema de archivos de Amazon EFS admite una configuración de ciclo de vida, que se aplica a todos los archivos del sistema de archivos. Si ya existe un objeto `LifecycleConfiguration` para el sistema de archivos especificado, una llamada a `PutLifecycleConfiguration` modifica la configuración existente. Una llamada `PutLifecycleConfiguration` con una matriz `LifecyclePolicies` vacía en el cuerpo de la solicitud elimina cualquier otra `LifecycleConfiguration` existente. En la solicitud, especifique lo siguiente:
+ El ID del sistema de archivos para el que va a habilitar, deshabilitar o modificar la administración del ciclo de vida.
+ Una matriz `LifecyclePolicies` de objetos `LifecyclePolicy` que definen cuándo mover los archivos al almacenamiento de IA, al almacenamiento Archivado y de vuelta al almacenamiento principal.
**nota**
Amazon EFS requiere que cada objeto `LifecyclePolicy` tenga una sola transición, por lo que la matriz `LifecyclePolicies` debe estar estructurada con objetos `LifecyclePolicy` independientes. Para más información, consulte los ejemplos de solicitudes en la siguiente sección.
Esta operación necesita permisos para la operación `elasticfilesystem:PutLifecycleConfiguration`.
Para aplicar un `LifecycleConfiguration` objeto a un sistema de archivos cifrados, necesita los mismos AWS Key Management Service permisos que cuando creó el sistema de archivos cifrados.
## Sintaxis de la solicitud
```
PUT /2015-02-01/file-systems/FileSystemId/lifecycle-configuration HTTP/1.1
Content-type: application/json
{
"LifecyclePolicies": [
{
"TransitionToArchive": "string",
"TransitionToIA": "string",
"TransitionToPrimaryStorageClass": "string"
}
]
}
```
## Parámetros de solicitud del URI
La solicitud utiliza los siguientes parámetros URI.
** [FileSystemId](#API_PutLifecycleConfiguration_RequestSyntax) **
El ID del sistema de archivos para el que crea el objeto `LifecycleConfiguration` (cadena).
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í
## Cuerpo de la solicitud
La solicitud acepta los siguientes datos en formato JSON.
** [LifecyclePolicies](#API_PutLifecycleConfiguration_RequestSyntax) **
Una matriz de objetos de `LifecyclePolicy` que definen el objeto del sistema de archivos de `LifecycleConfiguration`. Un objeto `LifecycleConfiguration` informa a la administración del ciclo de vida de lo siguiente:
+ **`TransitionToIA`**: Cuándo mover los archivos del sistema de archivos del almacenamiento principal (clase de almacenamiento Estándar) al almacenamiento de Acceso poco frecuente (IA).
+ **`TransitionToArchive`**: Cuándo mover los archivos del sistema de archivos de su clase de almacenamiento actual (clase de almacenamiento IA o Estándar) al almacenamiento Archivado.
Los sistemas de archivos no pueden realizar la transición al almacenamiento Archivado antes de pasar al almacenamiento IA. Por lo tanto, no TransitionToArchive debe configurarse o debe ser posterior a TransitionTo IA.
**nota**
La clase de almacenamiento Archivo solo está disponible para sistemas de archivos que utilicen el modo de rendimiento elástico y el modo de rendimiento de uso general.
+ **`TransitionToPrimaryStorageClass`**: si se deben volver a mover los archivos del sistema de archivos al almacenamiento principal (clase de almacenamiento Estándar) una vez que se haya accedido a ellos en almacenamiento IA o Archivado.
Cuando se utiliza el comando `put-lifecycle-configuration` de la CLI o la acción `PutLifecycleConfiguration` de la API, Amazon EFS requiere que cada objeto `LifecyclePolicy` tenga una sola transición. Esto significa que en un órgano de solicitud, `LifecyclePolicies` debe estructurarse como una matriz de objetos `LifecyclePolicy`, un objeto para cada transición de almacenamiento. Para más información, consulte los ejemplos de solicitudes en la siguiente sección.
Tipo: matriz de objetos [LifecyclePolicy](API_LifecyclePolicy.md)
Miembros de la matriz: número máximo de 3 elementos.
Obligatorio: sí
## Sintaxis de la respuesta
```
HTTP/1.1 200
Content-type: application/json
{
"LifecyclePolicies": [
{
"TransitionToArchive": "string",
"TransitionToIA": "string",
"TransitionToPrimaryStorageClass": "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.
** [LifecyclePolicies](#API_PutLifecycleConfiguration_ResponseSyntax) **
Un conjunto de políticas de administración del ciclo de vida. EFS admite un máximo de una política por sistema de archivos.
Tipo: matriz de objetos [LifecyclePolicy](API_LifecyclePolicy.md)
Miembros de la matriz: número máximo de 3 elementos.
## 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.
** 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 Cuenta de AWS solicitante.
** 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
** IncorrectFileSystemLifeCycleState **
Se devuelve si el estado del ciclo de vida del sistema de archivos es no “disponible”.
** 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: 409
** 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
## Ejemplos
### Crear una configuración de ciclo de vida
En el siguiente ejemplo, se crea un objeto `LifecyclePolicy` mediante la acción `PutLifecycleConfiguration`. En este ejemplo se crea una política de ciclo de vida que indica a EFS que haga lo siguiente:
+ Mover todos los archivos del sistema de archivos a los que no se haya accedido en almacenamiento Estándar en los últimos 30 días a la clase de almacenamiento IA.
+ Mover todos los archivos del sistema de archivos a los que no se haya accedido en almacenamiento Estándar en los últimos 90 días a la clase de almacenamiento Archivado.
+ Vuelva a mover los archivos al almacenamiento Estándar una vez que se haya accedido a ellos en almacenamiento IA o Archivado. La clase de almacenamiento Archivo solo está disponible para sistemas de archivos que utilicen el modo de rendimiento elástico y el modo de rendimiento de uso general.
Para obtener más información, consulte [Clases de almacenamiento de EFS](https://docs.aws.amazon.com/efs/latest/ug/storage-classes.html) y [Administración del almacenamiento del sistema de archivos](https://docs.aws.amazon.com/efs/latest/ug/lifecycle-management-efs.html).
#### Solicitud de muestra
```
PUT /2015-02-01/file-systems/fs-0123456789abcdefb/lifecycle-configuration HTTP/1.1
Host: elasticfilesystem.us-west-2.amazonaws.com
x-amz-date: 20181122T232908Z
Authorization: <...>
Content-type: application/json
Content-Length: 86
{
"LifecyclePolicies": [
{
"TransitionToArchive": "AFTER_90_DAYS"
},
{
"TransitionToIA": "AFTER_30_DAYS"
},
{
"TransitionToPrimaryStorage": "AFTER_1_ACCESS"
}
]
}
```
#### Respuesta de ejemplo
```
HTTP/1.1 200 OK
x-amzn-RequestId: 01234567-89ab-cdef-0123-456789abcdef
Content-type: application/json
Content-Length: 86
{
"LifecyclePolicies": [
{
"TransitionToArchive": "AFTER_90_DAYS"
},
{
"TransitionToIA": "AFTER_30_DAYS"
},
{
"TransitionToPrimaryStorage": "AFTER_1_ACCESS"
}
]
}
```
### Ejemplo de solicitud put-lifecycle-configuration CLI
Este ejemplo ilustra un uso de PutLifecycleConfiguration.
#### Solicitud de muestra
```
aws efs put-lifecycle-configuration \
--file-system-id fs-0123456789abcdefb \
--lifecycle-policies "[{"TransitionToArchive":"AFTER_90_DAYS"},
{"TransitionToIA":"AFTER_30_DAYS"},
{"TransitionToPrimaryStorageClass":"AFTER_1_ACCESS"}]
--region us-west-2 \
--profile adminuser
```
#### Respuesta de ejemplo
```
{
"LifecyclePolicies": [
{
"TransitionToArchive": "AFTER_90_DAYS"
},
{
"TransitionToIA": "AFTER_30_DAYS"
},
{
"TransitionToPrimaryStorageClass": "AFTER_1_ACCESS"
}
]
}
```
### Deshabilitar la administración del ciclo de vida
En el siguiente ejemplo, se deshabilita la administración del ciclo de vida del sistema de archivos especificado.
#### Solicitud de muestra
```
PUT /2015-02-01/file-systems/fs-01234567/lifecycle-configuration HTTP/1.1
Host: elasticfilesystem.us-west-2.amazonaws.com
x-amz-date: 20181122T232908Z
Authorization: <...>
Content-type: application/json
Content-Length: 86
{
"LifecyclePolicies": [ ]
}
```
#### Respuesta de ejemplo
```
HTTP/1.1 200 OK
x-amzn-RequestId: 01234567-89ab-cdef-0123-456789abcdef
Content-type: application/json
Content-Length: 86
{
"LifecyclePolicies": [ ]
}
```
## 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, consulte lo siguiente:
+ [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/elasticfilesystem-2015-02-01/PutLifecycleConfiguration)
+ [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/PutLifecycleConfiguration)
+ [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/PutLifecycleConfiguration)
+ [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/PutLifecycleConfiguration)
+ [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/PutLifecycleConfiguration)
+ [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/PutLifecycleConfiguration)
+ [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/PutLifecycleConfiguration)
+ [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/PutLifecycleConfiguration)
+ [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/PutLifecycleConfiguration)
+ [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/PutLifecycleConfiguration)
# TagResource
Crea una etiqueta para un recurso de EFS. Puede crear etiquetas para los puntos de acceso y los sistemas de archivos EFS mediante esta operación de API.
Esta operación necesita permisos para la acción `elasticfilesystem:TagResource`.
## Sintaxis de la solicitud
```
POST /2015-02-01/resource-tags/ResourceId HTTP/1.1
Content-type: application/json
{
"Tags": [
{
"Key": "string",
"Value": "string"
}
]
}
```
## Parámetros de solicitud del URI
La solicitud utiliza los siguientes parámetros URI.
** [ResourceId](#API_TagResource_RequestSyntax) **
El ID que especifica el recurso de EFS para el que desea crear una etiqueta.
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 acepta los siguientes datos en formato JSON.
** [Tags](#API_TagResource_RequestSyntax) **
Una matriz de objetos `Tag` que añadir. Cada objeto `Tag` es un par clave-valor.
Tipo: matriz de objetos [Tag](API_Tag.md)
Obligatorio: sí
## Sintaxis de la respuesta
```
HTTP/1.1 200
```
## Elementos de respuesta
Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200 con un cuerpo HTTP vacío.
## Errores
** AccessPointNotFound **
Se devuelve si el `AccessPointId` valor especificado no existe en el del Cuenta de AWS solicitante.
** 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
## Ejemplos
### Crear etiquetas en un sistema de archivos
La siguiente solicitud crea tres etiquetas (`"key1"`, `"key2"` y `"key3"`) en el sistema de archivos especificado.
#### Solicitud de muestra
```
POST /2015-02-01/tag-resource/fs-01234567 HTTP/1.1
Host: elasticfilesystem.us-west-2.amazonaws.com
x-amz-date: 20140620T221118Z
Authorization: <...>
Content-Type: application/json
Content-Length: 160
{
"Tags": [
{
"Key": "key1",
"Value": "value1"
},
{
"Key": "key2",
"Value": "value2"
},
{
"Key": "key3",
"Value": "value3"
}
]
}
```
#### Respuesta de ejemplo
```
HTTP/1.1 204 no content
x-amzn-RequestId: 01234567-89ab-cdef-0123-456789abcdef
```
## 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/TagResource)
+ [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/TagResource)
+ [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/TagResource)
+ [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/TagResource)
+ [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/TagResource)
+ [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/TagResource)
+ [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/TagResource)
+ [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/TagResource)
+ [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/TagResource)
+ [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/TagResource)
# UntagResource
Elimina etiquetas de un recurso de EFS. Puede eliminar etiquetas para los puntos de acceso y los sistemas de archivos EFS mediante esta operación de API.
Esta operación necesita permisos para la acción `elasticfilesystem:UntagResource`.
## Sintaxis de la solicitud
```
DELETE /2015-02-01/resource-tags/ResourceId?tagKeys=TagKeys HTTP/1.1
```
## Parámetros de solicitud del URI
La solicitud utiliza los siguientes parámetros URI.
** [ResourceId](#API_UntagResource_RequestSyntax) **
Especifica el recurso de EFS para el que desea eliminar las etiquetas.
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í
** [TagKeys](#API_UntagResource_RequestSyntax) **
Las claves de los pares de etiquetas de clave-valor que se van a eliminar del recurso de EFS especificado.
Miembros de la matriz: número mínimo de 1 artículo. Número máximo de 50 artículos.
Limitaciones de longitud: longitud mínima de 1. Longitud máxima de 128.
Patrón: `^(?![aA]{1}[wW]{1}[sS]{1}:)([\p{L}\p{Z}\p{N}_.:/=+\-@]+)$`
Obligatorio: sí
## Cuerpo de la solicitud
La solicitud no tiene un cuerpo de la solicitud.
## Sintaxis de la respuesta
```
HTTP/1.1 200
```
## Elementos de respuesta
Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200 con un cuerpo HTTP vacío.
## Errores
** AccessPointNotFound **
Se devuelve si el `AccessPointId` valor especificado no existe en el del Cuenta de AWS solicitante.
** 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/UntagResource)
+ [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/UntagResource)
+ [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/UntagResource)
+ [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/UntagResource)
+ [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/UntagResource)
+ [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/UntagResource)
+ [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/UntagResource)
+ [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/UntagResource)
+ [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/UntagResource)
+ [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/UntagResource)
# UpdateFileSystem
Actualiza el modo de rendimiento o la cantidad de rendimiento aprovisionado de un sistema de archivos existente.
## Sintaxis de la solicitud
```
PUT /2015-02-01/file-systems/FileSystemId HTTP/1.1
Content-type: application/json
{
"ProvisionedThroughputInMibps": number,
"ThroughputMode": "string"
}
```
## Parámetros de solicitud del URI
La solicitud utiliza los siguientes parámetros URI.
** [FileSystemId](#API_UpdateFileSystem_RequestSyntax) **
El ID del sistema de archivos que desea actualizar.
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í
## Cuerpo de la solicitud
La solicitud acepta los siguientes datos en formato JSON.
** [ProvisionedThroughputInMibps](#API_UpdateFileSystem_RequestSyntax) **
(Opcional) El rendimiento, medido en mebibytes por segundo (MiBps), que desea aprovisionar para el sistema de archivos que está creando. Obligatorio si `ThroughputMode` se establece en `provisioned`. Los valores válidos son del 1 al 3414 MiBps, y el límite superior depende de la región. Para aumentar este límite, póngase en contacto con. Soporte Para obtener más información, consulte [Cuotas de Amazon EFS que puede incrementar](https://docs.aws.amazon.com/efs/latest/ug/limits.html#soft-limits) en la *Guía del usuario de Amazon EFS.*
Tipo: Doble
Rango válido: valor mínimo de 1.0.
Obligatorio: no
** [ThroughputMode](#API_UpdateFileSystem_RequestSyntax) **
(Opcional) Actualiza el modo de rendimiento del sistema de archivos. Si no va a actualizar el modo de rendimiento, no necesita proporcionar este valor en la solicitud. Si cambia `ThroughputMode` a `provisioned`, también debe establecer un valor para `ProvisionedThroughputInMibps`.
Tipo: cadena
Valores válidos: `bursting | provisioned | elastic`
Obligatorio: no
## Sintaxis de la respuesta
```
HTTP/1.1 202
Content-type: application/json
{
"AvailabilityZoneId": "string",
"AvailabilityZoneName": "string",
"CreationTime": number,
"CreationToken": "string",
"Encrypted": boolean,
"FileSystemArn": "string",
"FileSystemId": "string",
"FileSystemProtection": {
"ReplicationOverwriteProtection": "string"
},
"KmsKeyId": "string",
"LifeCycleState": "string",
"Name": "string",
"NumberOfMountTargets": number,
"OwnerId": "string",
"PerformanceMode": "string",
"ProvisionedThroughputInMibps": number,
"SizeInBytes": {
"Timestamp": number,
"Value": number,
"ValueInArchive": number,
"ValueInIA": number,
"ValueInStandard": number
},
"Tags": [
{
"Key": "string",
"Value": "string"
}
],
"ThroughputMode": "string"
}
```
## Elementos de respuesta
Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 202.
El servicio devuelve los datos siguientes en formato JSON.
** [AvailabilityZoneId](#API_UpdateFileSystem_ResponseSyntax) **
El identificador único y coherente de la zona de disponibilidad en la que se encuentra el sistema de archivos y solo es válido para los sistemas de archivos One Zone. Por ejemplo, `use1-az1` es un identificador de zona de disponibilidad para el Región de AWS us-east-1 y tiene la misma ubicación en todas. Cuenta de AWS
Tipo: cadena
** [AvailabilityZoneName](#API_UpdateFileSystem_ResponseSyntax) **
Describe la zona de AWS disponibilidad en la que se encuentra el sistema de archivos y solo es válido para los sistemas de archivos de una zona. Para obtener más información, consulte [Uso de clases de almacenamiento de EFS](https://docs.aws.amazon.com/efs/latest/ug/storage-classes.html) en la *Guía del usuario de Amazon EFS.*
Tipo: cadena
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 64.
Patrón: `.+`
** [CreationTime](#API_UpdateFileSystem_ResponseSyntax) **
Hora en que se creó el sistema de archivos, en segundos (desde 1970-01-01T 00:00:00 Z).
Tipo: marca temporal
** [CreationToken](#API_UpdateFileSystem_ResponseSyntax) **
La cadena opaca especificada en la solicitud.
Tipo: cadena
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 64.
Patrón: `.+`
** [Encrypted](#API_UpdateFileSystem_ResponseSyntax) **
Un valor booleano que, si es verdadero, indica que el sistema de archivos está cifrado.
Tipo: Booleano
** [FileSystemArn](#API_UpdateFileSystem_ResponseSyntax) **
Nombre de recurso de Amazon (ARN) para el sistema de archivos de EFS en el formato `arn:aws:elasticfilesystem:region:account-id:file-system/file-system-id `. Ejemplo con datos de muestra: `arn:aws:elasticfilesystem:us-west-2:1111333322228888:file-system/fs-01234567`
Tipo: cadena
** [FileSystemId](#API_UpdateFileSystem_ResponseSyntax) **
El ID del sistema de archivos, asignado por Amazon EFS.
Tipo: cadena
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})$`
** [FileSystemProtection](#API_UpdateFileSystem_ResponseSyntax) **
Describe la protección del sistema de archivos.
Tipo: objeto [FileSystemProtectionDescription](API_FileSystemProtectionDescription.md)
** [KmsKeyId](#API_UpdateFileSystem_ResponseSyntax) **
El identificador de un sistema de archivos cifrado que AWS KMS key se utiliza para proteger el sistema de archivos cifrados.
Tipo: cadena
Limitaciones de longitud: longitud máxima de 2048 caracteres.
Patrón: `^([0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}|mrk-[0-9a-f]{32}|alias/[a-zA-Z0-9/_-]+|(arn:aws[-a-z]*:kms:[a-z0-9-]+:\d{12}:((key/[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12})|(key/mrk-[0-9a-f]{32})|(alias/[a-zA-Z0-9/_-]+))))$`
** [LifeCycleState](#API_UpdateFileSystem_ResponseSyntax) **
La fase del ciclo de vida del sistema de archivos.
Tipo: cadena
Valores válidos: `creating | available | updating | deleting | deleted | error`
** [Name](#API_UpdateFileSystem_ResponseSyntax) **
Puede añadir etiquetas a un sistema de archivos, incluida una etiqueta `Name`. Para obtener más información, consulte [CreateFileSystem](API_CreateFileSystem.md). Si el sistema de archivos tiene una etiqueta `Name`, Amazon EFS devuelve el valor de este campo.
Tipo: cadena
Limitaciones de longitud: longitud máxima de 256.
Patrón: `^([\p{L}\p{Z}\p{N}_.:/=+\-@]*)$`
** [NumberOfMountTargets](#API_UpdateFileSystem_ResponseSyntax) **
El número actual de destinos de montaje que tiene el sistema de archivos. Para obtener más información, consulte [CreateMountTarget](API_CreateMountTarget.md).
Tipo: entero
Rango válido: valor mínimo de 0.
** [OwnerId](#API_UpdateFileSystem_ResponseSyntax) **
El Cuenta de AWS que creó el sistema de archivos.
Tipo: cadena
Limitaciones de longitud: longitud máxima de 255 caracteres.
Patrón: `^(\d{12})|(\d{4}-\d{4}-\d{4})$`
** [PerformanceMode](#API_UpdateFileSystem_ResponseSyntax) **
El modo de desempeño del sistema de archivos.
Tipo: cadena
Valores válidos: `generalPurpose | maxIO`
** [ProvisionedThroughputInMibps](#API_UpdateFileSystem_ResponseSyntax) **
La cantidad de rendimiento aprovisionada, medida en MiBps, para el sistema de archivos. Válido para los sistemas de archivos que utilizan `ThroughputMode` establecido en `provisioned`.
Tipo: Doble
Rango válido: valor mínimo de 0.0.
** [SizeInBytes](#API_UpdateFileSystem_ResponseSyntax) **
El último tamaño medido conocido (en bytes) de los datos almacenados en el sistema de archivos, en su campo `Value`, y el momento en que se determinó ese tamaño en su campo `Timestamp`. El valor de `Timestamp` es el número entero de segundos transcurridos desde 1970-01-01T 00:00:00 Z. El valor de `SizeInBytes` no representa el tamaño de una instantánea coherente del sistema de archivos, pero en última instancia es coherente cuando no hay escrituras en el sistema de archivos. Es decir, `SizeInBytes` representa el tamaño real solo si el sistema de archivos no se modifica durante un período superior a un par de horas. De lo contrario, el valor no es el tamaño exacto que tenía el sistema de archivos en ningún momento.
Tipo: objeto [FileSystemSize](API_FileSystemSize.md)
** [Tags](#API_UpdateFileSystem_ResponseSyntax) **
Las etiquetas asociadas al sistema de archivos, presentadas como un conjunto de objetos `Tag`.
Tipo: matriz de objetos [Tag](API_Tag.md)
** [ThroughputMode](#API_UpdateFileSystem_ResponseSyntax) **
Muestra el modo de rendimiento de un sistema de archivos. Para obtener más información, consulte [Modos de rendimiento](https://docs.aws.amazon.com/efs/latest/ug/performance.html#throughput-modes) en la *Guía del usuario de Amazon EFS*.
Tipo: cadena
Valores válidos: `bursting | provisioned | elastic`
## 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.
** 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
** IncorrectFileSystemLifeCycleState **
Se devuelve si el estado del ciclo de vida del sistema de archivos es no “disponible”.
** 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: 409
** InsufficientThroughputCapacity **
Se devuelve si no hay suficiente capacidad para aprovisionar un rendimiento adicional. Este valor puede devolverse al intentar crear un sistema de archivos en el modo de rendimiento aprovisionado, al intentar aumentar el rendimiento aprovisionado de un sistema de archivos existente o al intentar cambiar un sistema de archivos existente del modo de rendimiento de ráfaga al de rendimiento aprovisionado. Inténtelo de nuevo más tarde.
** 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: 503
** 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
** ThroughputLimitExceeded **
Se devuelve si el modo de rendimiento o la cantidad de rendimiento aprovisionada no se pueden cambiar porque se ha alcanzado el límite de rendimiento de 1024. MiB/s
** 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
** TooManyRequests **
Se devuelve si no esperas al menos 24 horas antes de cambiar el modo de rendimiento o reducir el valor del rendimiento aprovisionado.
** 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: 429
## Véase también
Para obtener más información sobre el uso de esta API en uno de los idiomas AWS SDKs específicos, consulta lo siguiente:
+ [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/elasticfilesystem-2015-02-01/UpdateFileSystem)
+ [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/UpdateFileSystem)
+ [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/UpdateFileSystem)
+ [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/UpdateFileSystem)
+ [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/UpdateFileSystem)
+ [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/UpdateFileSystem)
+ [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/UpdateFileSystem)
+ [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/UpdateFileSystem)
+ [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/UpdateFileSystem)
+ [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/UpdateFileSystem)
# UpdateFileSystemProtection
Actualiza la protección del sistema de archivos.
Esta operación necesita permisos para la acción `elasticfilesystem:UpdateFileSystemProtection`.
## Sintaxis de la solicitud
```
PUT /2015-02-01/file-systems/FileSystemId/protection HTTP/1.1
Content-type: application/json
{
"ReplicationOverwriteProtection": "string"
}
```
## Parámetros de solicitud del URI
La solicitud utiliza los siguientes parámetros URI.
** [FileSystemId](#API_UpdateFileSystemProtection_RequestSyntax) **
El ID del sistema de archivos que vaya a actualizar.
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í
## Cuerpo de la solicitud
La solicitud acepta los siguientes datos en formato JSON.
** [ReplicationOverwriteProtection](#API_UpdateFileSystemProtection_RequestSyntax) **
El estado de la protección contra sobrescritura de la replicación del sistema de archivos.
+ `ENABLED`: el sistema de archivos no puede utilizarse como el sistema de archivos de destino en una configuración de replicación. El sistema de archivos se puede escribir. La protección contra sobrescritura de la replicación es `ENABLED` de forma predeterminada.
+ `DISABLED`: el sistema de archivos puede utilizarse como el sistema de archivos de destino en una configuración de replicación. El sistema de archivos es de solo lectura y solo puede modificarse mediante replicación de EFS.
+ `REPLICATING`: el sistema de archivos se utiliza como el sistema de archivos de destino en una configuración de replicación. El sistema de archivos es de solo lectura y solo se modifica mediante replicación de EFS.
Si se elimina la configuración de replicación, se vuelve a activar la protección contra sobrescritura de la replicación del sistema de archivos y se puede escribir en este.
Tipo: cadena
Valores válidos: `ENABLED | DISABLED | REPLICATING`
Obligatorio: no
## Sintaxis de la respuesta
```
HTTP/1.1 200
Content-type: application/json
{
"ReplicationOverwriteProtection": "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.
** [ReplicationOverwriteProtection](#API_UpdateFileSystemProtection_ResponseSyntax) **
El estado de la protección contra sobrescritura de la replicación del sistema de archivos.
+ `ENABLED`: el sistema de archivos no puede utilizarse como el sistema de archivos de destino en una configuración de replicación. El sistema de archivos se puede escribir. La protección contra sobrescritura de la replicación es `ENABLED` de forma predeterminada.
+ `DISABLED`: el sistema de archivos puede utilizarse como el sistema de archivos de destino en una configuración de replicación. El sistema de archivos es de solo lectura y solo puede modificarse mediante replicación de EFS.
+ `REPLICATING`: el sistema de archivos se utiliza como el sistema de archivos de destino en una configuración de replicación. El sistema de archivos es de solo lectura y se modifica solo mediante replicación de EFS.
Si se elimina la configuración de replicación, se vuelve a activar la protección contra sobrescritura de la replicación del sistema de archivos y se puede escribir en este.
Tipo: cadena
Valores válidos: `ENABLED | DISABLED | REPLICATING`
## 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.
** 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 Cuenta de AWS solicitante.
** 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
** IncorrectFileSystemLifeCycleState **
Se devuelve si el estado del ciclo de vida del sistema de archivos es no “disponible”.
** 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: 409
** InsufficientThroughputCapacity **
Se devuelve si no hay suficiente capacidad para aprovisionar un rendimiento adicional. Este valor puede devolverse al intentar crear un sistema de archivos en el modo de rendimiento aprovisionado, al intentar aumentar el rendimiento aprovisionado de un sistema de archivos existente o al intentar cambiar un sistema de archivos existente del modo de rendimiento de ráfaga al de rendimiento aprovisionado. Inténtelo de nuevo más tarde.
** 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: 503
** 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
** ReplicationAlreadyExists **
Se devuelve si el sistema de archivos ya está incluido en una configuración de replicación.>
** 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: 409
** ThroughputLimitExceeded **
Se devuelve si el modo de rendimiento o la cantidad de rendimiento aprovisionada no se pueden cambiar porque se ha alcanzado el límite de rendimiento de 1024. MiB/s
** 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
** TooManyRequests **
Se devuelve si no esperas al menos 24 horas antes de cambiar el modo de rendimiento o reducir el valor del rendimiento aprovisionado.
** 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: 429
## Véase también
Para obtener más información sobre el uso de esta API en uno de los idiomas AWS SDKs específicos, consulta lo siguiente:
+ [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/elasticfilesystem-2015-02-01/UpdateFileSystemProtection)
+ [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/UpdateFileSystemProtection)
+ [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/UpdateFileSystemProtection)
+ [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/UpdateFileSystemProtection)
+ [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/UpdateFileSystemProtection)
+ [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/UpdateFileSystemProtection)
+ [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/UpdateFileSystemProtection)
+ [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/UpdateFileSystemProtection)
+ [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/UpdateFileSystemProtection)
+ [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/UpdateFileSystemProtection)