文件層級 ACLs - Amazon Quick
全域 ACL 檔案結構

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

文件層級 ACLs

您可以使用兩種組態方法之一，在 Amazon S3 知識庫層級啟用存取控制清單 (ACLs)，每種方法都針對不同的使用案例進行最佳化。

重要

文件層級 ACL 組態是永久的。您無法在無 ACLs 支援的情況下建立的知識庫上啟用 ACL，而且一旦啟用，就無法停用 ACLs。若要變更 ACL 組態，請從頭開始建立具有所需設定的新知識庫。

注意

對於啟用 ACL 的知識庫，不會擷取沒有相關聯 ACL 項目的文件。確保每個文件都有透過全域 ACL 檔案或其中繼資料檔案中定義的 ACL。

全域 ACL 組態檔案

建立單一集中式檔案，在資料夾層級定義存取許可。這提供了簡化方法來管理大型文件階層的許可。此方法非常適合具有穩定許可結構的組織。全域檔案的任何變更都需要重新索引整個受影響的字首，這可能需要數小時的知識庫，其中包含數百萬份文件。如需檔案格式，請參閱 全域 ACL 檔案結構。

文件層級中繼資料檔案

每個文件都有自己的中繼資料檔案，其中包含特定的存取控制資訊。此方法需要您為每個文件建立和維護個別中繼資料檔案。當許可變更時，它可大幅加快索引更新速度，因為只有受影響的文件需要重新編製索引，而不是整個資料夾結構。如需在中繼資料檔案中設定 ACLs 的詳細資訊，請參閱 文件中繼資料。

選擇最符合您營運需求的方法：使用全域 ACL 檔案進行集中式管理，以便更輕鬆地管理，或選擇文件層級中繼資料檔案，以便更快速地進行許可更新和更精細的控制。

定期更新 Amazon S3 ACLs 組態，以符合組織的存取需求，讓您的文件層級 ACL 保持最新狀態。如需常見最佳實務的詳細資訊，請參閱 在知識庫中管理 ACLs最佳實務。

全域 ACL 檔案結構

全域檔案可在資料夾層級提供集中式存取控制管理。檔案中的每個項目都會將 Amazon S3 金鑰字首映射到一組 ACL 項目，這些項目會套用至該字首下的所有文件。

全域 ACL json 檔案使用以下結構：

[
    {
        "keyPrefix": "s3://BUCKETNAME/prefix1/",
        "aclEntries": [
            {
                "Name": "user1@example.com",
                "Type": "USER",
                "Access": "ALLOW"
            },
            {
                "Name": "group1",
                "Type": "GROUP",
                "Access": "DENY"
            }
        ]
    },
    {
        "keyPrefix": "s3://BUCKETNAME/prefix1/document_1.txt",
        "aclEntries": [
            {
                "Name": "user1@example.com",
                "Type": "USER",
                "Access": "ALLOW"
            },
            {
                "Name": "group1",
                "Type": "GROUP",
                "Access": "DENY"
            }
        ]
    },
    {
        "keyPrefix": "s3://BUCKETNAME/prefix2/",
        "aclEntries": [
            {
                "Name": "user2@example.com",
                "Type": "USER",
                "Access": "ALLOW"
            },
            {
                "Name": "user1@example.com",
                "Type": "USER",
                "Access": "DENY"
            },
            {
                "Name": "group1",
                "Type": "GROUP",
                "Access": "DENY"
            }
        ]
    }
]

陣列中的每個項目都包含下列欄位：

keyPrefix

ACL 項目套用的 Amazon S3 路徑字首。此字首下的所有文件都會繼承指定的許可。

aclEntries

存取控制項目的陣列，每個項目都包含下列欄位：

  • Name – USER類型為 Quick 中使用者的電子郵件地址。GROUP 類型為 Quick 中的群組名稱。

  • Type – USER 或 GROUP。

  • Access – ALLOW 或 DENY。