本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
DescribeAccess
描述分配给启用文件传输协议的特定服务器的访问权限，该访问权限由其 ServerId 属性和其 ExternalId 标识。
此调用的响应返回与指定的 ServerId 值关联的访问权限的属性。
请求语法
{
"ExternalId": "string",
"ServerId": "string"
}请求参数
有关所有操作的通用参数的信息，请参阅通用参数。
该请求接受以下JSON格式的数据。
- ExternalId
-
识别目录中特定组所需的唯一标识符。您关联的群组中的用户可以通过启用的协议访问您的 Amazon S3 或 Amazon EFS 资源 Amazon Transfer Family。如果您知道组名，则可以使用 Windows 运行以下命令来查看这些SID值 PowerShell。
Get-ADGroup -Filter {samAccountName -like "YourGroupName*"} -Properties * | Select SamAccountName,ObjectSid在该命令中，替换为您的 YourGroupNameActive Directory 组的名称。
用于验证此参数的正则表达式是由不带空格的大写和小写字母数字字符组成的字符串。此外，还可以包括下划线或以下任何字符：=、.@：/-
类型：字符串
长度限制：最小长度为 1。最大长度为 256。
模式：
S-1-[\d-]+必需：是
- ServerId
-
分配了该访问权限的服务器的系统分配的唯一标识符。
类型：字符串
长度限制：固定长度为 19。
模式：
s-([0-9a-f]{17})必需：是
响应语法
{
"Access": {
"ExternalId": "string",
"HomeDirectory": "string",
"HomeDirectoryMappings": [
{
"Entry": "string",
"Target": "string",
"Type": "string"
}
],
"HomeDirectoryType": "string",
"Policy": "string",
"PosixProfile": {
"Gid": number,
"SecondaryGids": [ number ],
"Uid": number
},
"Role": "string"
},
"ServerId": "string"
}响应元素
如果操作成功，服务将发回 HTTP 200 响应。
以下数据由服务以JSON格式返回。
- Access
-
访问权限连接到的服务器的外部标识符。
类型：DescribedAccess 对象
- ServerId
-
分配了该访问权限的服务器的系统分配的唯一标识符。
类型：字符串
长度限制：固定长度为 19。
模式：
s-([0-9a-f]{17})
错误
有关所有操作的常见错误的信息，请参阅常见错误。
- InternalServiceError
-
当 Amazon Transfer Family 服务中发生错误时，会引发此异常。
HTTP状态码：500
- InvalidRequestException
-
当客户端提交格式错误的请求时，会引发此异常。
HTTP状态码：400
- ResourceNotFoundException
-
当 Transfer Family 服务找不到资源时，就会 Amazon引发此异常。
HTTP状态码：400
- ServiceUnavailableException
-
请求失败，因为 Trans Amazon fer Family 服务不可用。
HTTP状态码：500
另请参阅
有关API在一种特定语言中使用此功能的更多信息 Amazon SDKs，请参阅以下内容：