本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
ListAccesses
列出您在伺服器上擁有的所有存取權的詳細資訊。
請求語法
{
"MaxResults": number,
"NextToken": "string",
"ServerId": "string"
}請求參數
如需所有動作的一般參數資訊，請參閱《Common Parameters》。
請求接受下列JSON格式的資料。
- MaxResults
-
指定SIDs要傳回的存取數目上限。
類型：整數
有效範圍：最小值為 1。最大值為 1000。
必要：否
- NextToken
-
當您可以從
ListAccesses呼叫取得其他結果時，輸出中會傳回NextToken參數。然後，您可以在後續命令中傳遞至NextToken參數，以繼續列出其他存取權。類型：字串
長度限制：長度下限為 1。長度上限為 6144。
必要：否
- ServerId
-
系統指派的唯一識別碼，適用於已指派使用者給伺服器的伺服器。
類型：字串
長度限制條件：固定長度為 19。
模式：
s-([0-9a-f]{17})必要：是
回應語法
{
"Accesses": [
{
"ExternalId": "string",
"HomeDirectory": "string",
"HomeDirectoryType": "string",
"Role": "string"
}
],
"NextToken": "string",
"ServerId": "string"
}回應元素
如果動作成功，服務會傳回 HTTP 200 個回應。
服務會以 JSON 格式傳回下列資料。
- Accesses
-
傳回您指定
ServerId值的存取權及其屬性。類型：ListedAccess 物件陣列
- NextToken
-
當您可以從
ListAccesses呼叫取得其他結果時，輸出中會傳回NextToken參數。然後，您可以在後續命令中傳遞至NextToken參數，以繼續列出其他存取權。類型：字串
長度限制：長度下限為 1。長度上限為 6144。
- ServerId
-
系統指派的唯一識別碼，適用於已指派使用者給伺服器的伺服器。
類型：字串
長度限制條件：固定長度為 19。
模式：
s-([0-9a-f]{17})
錯誤
如需所有動作常見錯誤的資訊，請參閱常見錯誤。
- InternalServiceError
-
當 AWS Transfer Family 服務發生錯誤時，就會擲回此例外狀況。
HTTP 狀態碼：500
- InvalidNextTokenException
-
傳遞的
NextToken參數無效。HTTP 狀態碼：400
- InvalidRequestException
-
當用戶端提交格式錯誤的請求時，就會擲回此例外狀況。
HTTP 狀態碼：400
- ResourceNotFoundException
-
當 AWS Transfer Family 服務找不到資源時，就會擲回此例外狀況。
HTTP 狀態碼：400
- ServiceUnavailableException
-
請求失敗，因為 AWS Transfer Family 服務無法使用。
HTTP 狀態碼：500
另請參閱
如需在其中一種語言特定 API中使用此功能的詳細資訊 AWS SDKs，請參閱下列內容：
