DescribedUser - AWS Transfer Family

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.

DescribedUser

Describe las propiedades de un usuario especificado.

Contenido

Arn

Especifica el nombre de recurso de Amazon (ARN) único del usuario del que se solicitó una descripción.

Tipo: cadena

Limitaciones de longitud: longitud mínima de 20. La longitud máxima es de 1600 caracteres.

Patrón: arn:\S+

Obligatorio: sí

HomeDirectory

Directorio de destino (carpeta) de un usuario cuando inicia sesión en el servidor a través del cliente.

Un ejemplo de HomeDirectory es /bucket_name/home/mydirectory.

nota

El parámetro HomeDirectory solo se utiliza si HomeDirectoryType está establecido en PATH.

Tipo: cadena

Limitaciones de longitud: longitud mínima de 0. La longitud máxima es de 1024 caracteres.

Patrón: (|/.*)

Obligatorio: no

HomeDirectoryMappings

Los mapeos de directorio lógico que especifican qué rutas de acceso y claves de Amazon S3 o Amazon EFS deben ser visibles para el usuario y cómo desea hacerlas visibles. Deberá especificar el par Entry y Target, donde Entry muestra cómo se hace visible la ruta y Target es la ruta de Amazon S3 o de Amazon EFS real. Si solo especifica un destino, se muestra tal cual. También debe asegurarse de que su función AWS Identity and Access Management (de IAM) proporcione acceso a las rutas de entrada. Target Este valor solo se puede establecer si HomeDirectoryType está establecido en LOGICAL.

En la mayoría de los casos, puede usar este valor en lugar de la política de sesión para limitar al usuario al directorio de inicio designado (“chroot”). Para ello, puede Entry establecer el valor «/» y el valor del HomeDirectory parámetro. Target

Tipo: Matriz de HomeDirectoryMapEntry objetos

Miembros de la matriz: número mínimo de 1 artículo. Número máximo de 50000 artículos.

Obligatorio: no

HomeDirectoryType

El tipo de directorio de destino (carpeta) que quiere utilizar como directorio de inicio de los usuarios cuando inicien sesión en el servidor. Si lo establece en PATH, el usuario verá la ruta absoluta de bucket de Amazon S3 o de EFS como en sus clientes de protocolo de File Transfer. Si lo configura en LOGICAL, deberá proporcionar asignaciones en las HomeDirectoryMappings que correspondan con la forma en que quiere que las rutas de acceso de Amazon S3 o de Amazon EFS sean visibles para sus usuarios.

nota

Si HomeDirectoryType es LOGICAL, debe proporcionar las asignaciones mediante el parámetro HomeDirectoryMappings. Si, por el contrario, HomeDirectoryType es PATH, se proporciona una ruta absoluta mediante el parámetro HomeDirectory. No puede tener HomeDirectory y HomeDirectoryMappings en su plantilla.

Tipo: cadena

Valores válidos: PATH | LOGICAL

Obligatorio: no

Policy

Una política de sesión para su usuario, de modo que pueda usar el mismo rol AWS Identity and Access Management (IAM) en varios usuarios. Esta política reduce el ámbito de acceso de un usuario a partes de su bucket de Amazon S3. Entre las variables que puede utilizar dentro de esta política se incluyen ${Transfer:UserName}, ${Transfer:HomeDirectory} y ${Transfer:HomeBucket}.

Tipo: cadena

Limitaciones de longitud: longitud mínima de 0 caracteres. La longitud máxima es de 2048 caracteres.

Obligatorio: no

PosixProfile

Especifica la identidad POSIX completa, incluido el ID de usuario (Uid), el ID de grupo (Gid) y cualquier ID de grupo secundario (SecondaryGids), que controla el acceso de los usuarios a los sistemas de archivos de Amazon Elastic File System (Amazon EFS). Los permisos POSIX establecidos en los archivos y directorios del sistema de archivos determinan el nivel de acceso que obtienen los usuarios al transferir archivos dentro y fuera de los sistemas de archivos de Amazon EFS.

Tipo: objeto PosixProfile

Obligatorio: no

Role

El nombre del recurso de Amazon (ARN) del rol AWS Identity and Access Management (IAM) que controla el acceso de los usuarios al bucket de Amazon S3 o al sistema de archivos Amazon EFS. Las políticas asociadas a este rol determinarán el nivel de acceso que quiere ofrecer a los usuarios cuando se transfieran archivos dentro y fuera de su bucket de Amazon S3 o del sistema de archivos de Amazon EFS. El rol de IAM también debe contener una relación de confianza que permita que el servidor pueda obtener acceso a los recursos cuando atienda las solicitudes de transferencia de los usuarios.

Tipo: cadena

Limitaciones de longitud: longitud mínima de 20. La longitud máxima es de 2048 caracteres.

Patrón: arn:.*role/\S+

Obligatorio: no

SshPublicKeys

Especifica la parte de la clave pública de las claves Secure Shell (SSH) almacenadas para el usuario descrito.

Tipo: matriz de objetos SshPublicKey

Miembros de la matriz: número mínimo de 0 artículos. La cantidad máxima es de 5 artículos.

Obligatorio: no

Tags

Especifica los pares clave-valor del usuario solicitado. La etiqueta se puede utilizar para buscar y agrupar usuarios con objetivos diversos.

Tipo: Matriz de Tag objetos

Miembros de la matriz: número mínimo de 1 artículo. Número máximo de 50 artículos.

Obligatorio: no

UserName

Especifica el nombre del usuario del que se solicitó una descripción. Los nombres de usuario se utilizan con fines de autenticación. Esta es la cadena que utilizará el usuario cuando este inicie sesión en el servidor.

Tipo: cadena

Limitaciones de longitud: longitud mínima de 3. La longitud máxima es de 100 caracteres.

Patrón: [\w][\w@.-]{2,99}

Obligatorio: no

Véase también

Para obtener más información sobre el uso de esta API en uno de los AWS SDK específicos del idioma, consulte lo siguiente: