PutFileSystemPolicy - Amazon Elastic File System
Sintaxis de la solicitudURIParámetros de solicitudCuerpo de la solicitudSintaxis de la respuestaElementos de respuestaErroresEjemplosVéase también

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

PutFileSystemPolicy

Aplica un Amazon EFS FileSystemPolicy a un sistema de EFS archivos de Amazon. Una política del sistema de archivos es una política IAM basada en recursos y puede contener varias declaraciones de políticas. 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 API operación. EFSLas políticas del sistema de archivos 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 sobre la política de sistema de archivos predeterminada, consulte Política de sistema de EFS archivos predeterminada.

nota

EFSlas políticas del sistema de archivos 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"
}

URIParámetros de solicitud

La solicitud utiliza los siguientes URI parámetros.

FileSystemId

El ID del sistema de EFS archivos para el que 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 JSON formato.

BypassPolicyLockoutSafetyCheck

(Opcional) Un valor booleano que especifica si se omite o no el control de seguridad de bloqueo de FileSystemPolicy. La comprobación de seguridad del bloqueo determina si la política de la solicitud bloqueará o impedirá que el IAM director que realiza la solicitud realice futuras PutFileSystemPolicy solicitudes en este sistema de archivos. BypassPolicyLockoutSafetyCheckTrueConfigúrelo solo cuando desee impedir que el IAM director que realiza la solicitud realice PutFileSystemPolicy solicitudes posteriores en este sistema de archivos. El valor predeterminado es False.

Tipo: Booleano

Obligatorio: no

Policy

La FileSystemPolicy que está creando. Acepta una definición de política JSON formateada. EFSlas políticas del sistema de archivos 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, consulta Políticas basadas en recursos en Amazon. EFS

Tipo: string

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 envía una respuesta de HTTP 200.

El servicio devuelve los siguientes datos en JSON formato.

FileSystemId

Especifica el sistema de EFS archivos al que FileSystemPolicy se aplica.

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

El JSON formato del sistema FileSystemPolicy de EFS archivos.

Tipo: string

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.

HTTPCódigo de estado: 400

FileSystemNotFound

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

HTTPCódigo de estado: 404

IncorrectFileSystemLifeCycleState

Se devuelve si el estado del ciclo de vida del sistema de archivos es no “disponible”.

HTTPCódigo de estado: 409

InternalServerError

Se devuelve si se ha producido un error en el servidor.

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

HTTPCódigo de estado: 400

Ejemplos

Crea un EFS FileSystemPolicy

La siguiente solicitud crea una FileSystemPolicy que permite a todos AWS los principales montar el sistema de EFS archivos 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 cómo usarlo API en uno de los idiomas específicos AWS SDKs, consulte lo siguiente: