本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
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
在该命令中,YourGroupName用你的 Active Directory 组的名称替换。
用于验证此参数的正则表达式为包含大小写字母数字的字符串(不包含空格)。此外,还可以包含下划线或以下任何字符:=, . @: /-
类型:字符串
长度限制:最小长度为 1。长度上限为 256。
模式:
^S-1-[\d-]+$
必需:是
- ServerId
-
服务器的系统分配的唯一标识符(分配了该访问权限)。
类型:字符串
长度限制:固定长度为 19。
模式:
^s-([0-9a-f]{17})$
必需:是
响应语法
{
"Access": {
"ExternalId": "string",
"HomeDirectory": "string",
"HomeDirectoryMappings": [
{
"Entry": "string",
"Target": "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
-
当 Transfer Family 服务中发生错误时,会Amazon引发此异常。
HTTP 状态代码:500
- InvalidRequestException
-
当客户端提交格式错误的请求时,会引发此异常。
HTTP 状态代码:400
- ResourceNotFoundException
-
当 Transfer Family 服务找不到资源时,会Amazon引发此异常。
HTTP 状态代码:400
- ServiceUnavailableException
-
由于 Transfer FamAmazon ily 服务不可用,请求失败。
HTTP 状态代码:500
另请参阅
有关在特定语言的 Amazon 软件开发工具包中使用此 API 的更多信息,请参阅以下内容: