本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
DescribeAccess
描述指派給特定檔案傳輸協定啟用伺服器的存取權，如其ServerId屬性及其 所識別ExternalId。
此呼叫的回應會傳回與指定ServerId值相關聯的存取屬性。
請求語法
{
"ExternalId": "string",
"ServerId": "string"
}請求參數
如需所有動作的一般參數資訊，請參閱《Common Parameters》。
請求接受下列JSON格式的資料。
- ExternalId
-
識別目錄中特定群組所需的唯一識別碼。您關聯的群組使用者可透過使用 的已啟用通訊協定存取您的 Amazon S3 或 Amazon EFS 資源 AWS 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",
"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
-
當 AWS Transfer Family 服務發生錯誤時，就會擲回此例外狀況。
HTTP 狀態碼：500
- InvalidRequestException
-
當用戶端提交格式不正確的請求時，就會擲回此例外狀況。
HTTP 狀態碼：400
- ResourceNotFoundException
-
當 AWS Transfer Family 服務找不到資源時，就會擲回此例外狀況。
HTTP 狀態碼：400
- ServiceUnavailableException
-
請求失敗，因為 AWS Transfer Family 服務無法使用。
HTTP 狀態碼：500
另請參閱
如需在其中一種語言特定的 API中使用此功能的詳細資訊 AWS SDKs，請參閱下列內容：
