本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
ListedServer
返回指定的启用文件传输协议的服务器的属性。
内容
- Arn
-
为要列出的服务器指定唯一的 Amazon 资源名称 (ARN)。
类型:字符串
长度约束:最小长度为 20。长度上限为 1600。
模式:
arn:\S+
必需:是
- Domain
-
指定用于文件传输的存储系统的域。
类型:字符串
有效值:
S3 | EFS
必需:否
- EndpointType
-
指定您的服务器所连接的VPC端点的类型。如果您的服务器已连接到VPC终端节点,则无法通过公共 Internet 访问您的服务器。
类型:字符串
有效值:
PUBLIC | VPC | VPC_ENDPOINT
必需:否
- IdentityProviderType
-
服务器的身份验证模式。默认值为
SERVICE_MANAGED
,允许您在 Amazon Transfer Family 服务中存储和访问用户凭证。用于提供
AWS_DIRECTORY_SERVICE
对本地环境中的活动目录组 Amazon Directory Service for Microsoft Active Directory 或 Microsoft Active Directory 组的访问权限,或者 Amazon 使用 AD Connector 提供访问权限。此选项还要求您使用IdentityProviderDetails
参数提供 Directory ID。使用
API_GATEWAY
值以与您选择的身份提供者集成。该API_GATEWAY
设置要求您使用IdentityProviderDetails
参数提供 Amazon API Gateway 终端节点URL以调用身份验证。使用该
AWS_LAMBDA
值可直接使用 Amazon Lambda 函数作为您的身份提供商。如果您选择此值,则必须在IdentityProviderDetails
数据类型的Function
参数中ARN为 Lambda 函数指定。类型:字符串
有效值:
SERVICE_MANAGED | API_GATEWAY | AWS_DIRECTORY_SERVICE | AWS_LAMBDA
必需:否
- LoggingRole
-
() 角色的亚马逊资源名称 Amazon Identity and Access Management (ARNIAM),允许服务器开启亚马逊 S3 或亚马逊的亚马逊 CloudWatch 日志记录EFSevents。设置后,您可以在 CloudWatch 日志中查看用户活动。
类型:字符串
长度约束:最小长度为 20。最大长度为 2048。
模式:
arn:.*role/\S+
必需:否
- ServerId
-
为列出的服务器指定系统分配的唯一标识符。
类型:字符串
长度限制:固定长度为 19。
模式:
s-([0-9a-f]{17})
必需:否
- State
-
所描述的服务器的状况。值为
ONLINE
表示服务器可以接受作业和传输文件。值State
为OFFLINE
表示服务器无法执行文件传输操作。状态
STARTING
和STOPPING
表示服务器处于中间状态,要么无法完全响应,要么未完全脱机。值START_FAILED
或STOP_FAILED
可以表示错误情况。类型:字符串
有效值:
OFFLINE | ONLINE | STARTING | STOPPING | START_FAILED | STOP_FAILED
必需:否
- UserCount
-
指定分配给您在
ServerId
中指定的服务器的用户数。类型:整数
必需:否
另请参阅
有关API在一种特定语言中使用此功能的更多信息 Amazon SDKs,请参阅以下内容: