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. # 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)