ListedServer - 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.

ListedServer

Devuelve las propiedades de un servidor habilitado para el protocolo de File Transfer que se especificó.

Contenido

Arn

Especifica el nombre exclusivo de recurso de Amazon (ARN) para que se publique un servidor.

Tipo: cadena

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

Patrón: arn:\S+

Obligatorio: sí

Domain

Especifica el dominio del sistema de almacenamiento que se utiliza para las transferencias de archivos.

Tipo: cadena

Valores válidos: S3 | EFS

Obligatorio: no

EndpointType

Especifica el tipo de VPC punto final al que está conectado el servidor. Si el servidor está conectado a un VPC punto final, no se puede acceder a él a través de la Internet pública.

Tipo: cadena

Valores válidos: PUBLIC | VPC | VPC_ENDPOINT

Obligatorio: no

IdentityProviderType

El modo de autenticación de un servidor. El valor predeterminado esSERVICE_MANAGED, que te permite almacenar las credenciales de usuario y acceder a ellas dentro del AWS Transfer Family servicio.

Úselo AWS_DIRECTORY_SERVICE para proporcionar acceso a los grupos de Active Directory AWS Directory Service for Microsoft Active Directory o a Microsoft Active Directory en su entorno local o AWS mediante AD Connector. Esta opción también requiere que se especifique el ID del directorio mediante el parámetro IdentityProviderDetails.

Utilice el valor API_GATEWAY para la integración con un proveedor de identidades de su elección. La API_GATEWAY configuración requiere que proporciones un punto de enlace de Amazon API Gateway URL para solicitar la autenticación mediante el IdentityProviderDetails parámetro.

Utilice el AWS_LAMBDA valor para utilizar directamente una AWS Lambda función como su proveedor de identidad. Si elige este valor, debe especificar el valor ARN para la función Lambda en el Function parámetro del tipo de IdentityProviderDetails datos.

Tipo: cadena

Valores válidos: SERVICE_MANAGED | API_GATEWAY | AWS_DIRECTORY_SERVICE | AWS_LAMBDA

Obligatorio: no

LoggingRole

El nombre del recurso de Amazon (ARN) de la función AWS Identity and Access Management (IAM) que permite a un servidor activar el CloudWatch registro de Amazon para Amazon S3 o AmazonEFSevents. Cuando esté configurado, podrá ver la actividad de los usuarios en sus CloudWatch registros.

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

ServerId

Especifica el identificador único asignado por el sistema para los servidores que figuraban en la lista.

Tipo: cadena

Limitaciones de longitud: longitud fija de 19.

Patrón: s-([0-9a-f]{17})

Obligatorio: no

State

Estado del servidor que se describió. Un valor de ONLINE indica que el servidor puede aceptar trabajos y transferir archivos. Un valor State de OFFLINE significa que el servidor no puede realizar operaciones de File Transfer.

Los estados de STARTING y STOPPING indican que el servidor se encuentra en un estado intermedio; es decir, que no puede responder por completo o que no está completamente desconectado. Los valores de START_FAILED o STOP_FAILED pueden indicar una condición de error.

Tipo: cadena

Valores válidos: OFFLINE | ONLINE | STARTING | STOPPING | START_FAILED | STOP_FAILED

Obligatorio: no

UserCount

Especifica el número de usuarios que están asignados a un servidor que especificó con el ServerId.

Tipo: entero

Obligatorio: no

Véase también

Para obtener más información sobre cómo usarlo API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente: