DescribedUser - AWS Transfer Family

本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。

DescribedUser

說明指定之使用者的特性。

目錄

Arn

為要求描述的使用者指定唯一的 Amazon 資源名稱 (ARN)。

類型:字串

長度限制︰長度下限為 20。長度上限為 1600。

模式:arn:\S+

必要:是

HomeDirectory

使用者使用其用戶端登入伺服器時的登陸目錄 (資料夾)。

HomeDirectory 範例為 /bucket_name/home/mydirectory

注意

只有在 HomeDirectoryType 設為 PATH 時才會使用 HomeDirectory 參數。

類型:字串

長度限制:長度下限為 0。長度上限為 1024。

模式:(|/.*)

必要:否

HomeDirectoryMappings

邏輯目錄對應,指定您的使用者可以看到哪些 Amazon S3 或 Amazon EFS 路徑和金鑰,以及您希望如何顯示這些路徑和金鑰。您必須指定EntryTarget配對,其中Entry顯示路徑的顯示方式,以及Target實際的 Amazon S3 或 Amazon EFS 路徑。如果您僅指定目標,則會依原樣顯示該目標。您還必須確保您的 AWS Identity and Access Management (IAM) 角色可提供中路徑的存取權Target。只有當設定為邏輯HomeDirectoryType,才能設定此值。

在大多數情況下,您可以使用此值而不是工作階段原則,將使用者鎖定到指定的主目錄 (」chroot「)。要做到這一點,你可Entry以設置為 '/' 並設置Target為 HomeDirectory參數值。

類型:HomeDirectoryMapEntry 物件陣列

陣列成員:項目數下限為 1。5 萬個物品的最大數量。

必要:否

HomeDirectoryType

使用者登入伺服器時,您希望的使用者主目錄之登陸目錄 (資料夾) 類型。如果將其設定為PATH,使用者將在其檔案傳輸協定用戶端中看到絕對的 Amazon S3 儲存貯體或 Amazon EFS 路徑。如果將其設定為LOGICAL,則需要在中提供對應,以便讓使用者看到 Amazon S3 或 Amazon EFS 路徑的方式。HomeDirectoryMappings

注意

如果HomeDirectoryTypeLOGICAL,則必須使用HomeDirectoryMappings參數提供對映。另一方面,HomeDirectoryType如果您使用HomeDirectory參數提供絕對路徑。PATH您的範本HomeDirectoryMappings中不HomeDirectory能同時擁有和。

類型:字串

有效值:PATH | LOGICAL

必要:否

Policy

適用於您的使用者的工作階段政策,以便您可以在多個使用者間使用相同的 AWS Identity and Access Management (IAM) 角色。此政策限制了使用者對 Amazon S3 儲存貯體部分的存取權限。您可以在此政策內使用的變數包括 ${Transfer:UserName}${Transfer:HomeDirectory}${Transfer:HomeBucket}

類型:字串

長度限制:長度下限為 0。長度上限為 2048。

必要:否

PosixProfile

指定完整的 POSIX 身分識別,包括使用者 ID (Uid)、群組 ID (Gid) 和任何次要群組識別碼 (SecondaryGids),以控制使用者對 Amazon Elastic File System (Amazon EFS) 檔案系統的存取權限。對檔案系統中的檔案和目錄設定的 POSIX 許可,會決定使用者在 Amazon EFS 檔案系統中傳入和傳出檔案時所取得的存取等級。

類型:PosixProfile 物件

必要:否

Role

(IAM) 角色的亞馬遜資源名稱 AWS Identity and Access Management (ARN),用於控制使用者對 Amazon S3 儲存貯體或 Amazon EFS 檔案系統的存取。連接到此角色的政策會決定在將檔案傳入和傳出您的 Amazon S3 儲存貯體或 Amazon EFS 檔案系統時,您希望提供給使用者的存取層級。IAM 角色也應包含信任關係,允許伺服器在處理您使用者的傳輸請求時,存取您的資源。

類型:字串

長度限制︰長度下限為 20。長度上限為 2048。

模式:arn:.*role/\S+

必要:否

SshPublicKeys

指定為所描述使用者存放安全通訊殼層 (SSH) 金鑰的公有金鑰部分。

類型:SshPublicKey 物件陣列

陣列成員:項目數下限為 0。項目數上限為 5。

必要:否

Tags

為請求的用戶指定鍵值對。標籤可用於搜尋使用者並將使用者分組,以達到各種目的。

類型:Tag 物件陣列

陣列成員:項目數下限為 1。項目數上限為 50。

必要:否

UserName

指定要求描述的使用者名稱。使用者名稱用於驗證目的。這是您的用戶登錄到服務器時將使用的字符串。

類型:字串

長度限制:長度下限為 3。長度上限為 100。

模式:[\w][\w@.-]{2,99}

必要:否

另請參閱

如需在其中一個特定語言 AWS SDK 中使用此 API 的詳細資訊,請參閱下列內容: