Amazon S3 Vectors 的動作、資源和條件索引鍵

Amazon S3 Vectors （服務字首：s3vectors) 提供下列服務特定的資源、動作和條件內容索引鍵，可用於 IAM 許可政策。

參考資料：

• 了解如何設定此服務。

• 檢視可供此服務使用的 API 操作清單。

• 了解如何使用 IAM 許可政策來保護此服務及其資源。

Amazon S3 Vectors 定義的動作

您可在 IAM 政策陳述式的 Action 元素中指定以下動作。使用政策來授予在 AWS中執行操作的許可。在政策中使用動作時，通常會允許或拒絕存取相同名稱的 API 操作或 CLI 命令。不過，在某些情況下，單一動作可控制對多個操作的存取。或者，某些操作需要多種不同的動作。

動作資料表的存取層級欄說明動作的分類方式 （列出、讀取、許可管理或標記）。此分類可協助您了解在政策中使用某動作時，該動作授予您的存取層級。如需存取層級的詳細資訊，請參閱政策摘要中的存取層級。

「動作」資料表的資源類型欄會指出每個動作是否支援資源層級的許可。如果此欄沒有值，您必須在政策陳述式的 Resource 元素中指定政策適用的所有資源 ("*")。如果資料欄包含資源類型，則您可以在具有該動作的陳述式中指定該類型的 ARN。如果動作具有一或多個必要資源，呼叫者必須具有對這些資源使用動作的許可。表格中的必要資源會以星號 (*) 表示。如果您使用 IAM 政策中的 Resource 元素限制資源存取，則每種必要的資源類型必須要有 ARN 或模式。某些動作支援多種資源類型。如果資源類型是選用 (未顯示為必要)，則您可以選擇使用其中一種選用資源類型。

「動作」資料表的條件索引鍵欄包含您可以在政策陳述式的 Condition 元素中指定的索引鍵。如需有關與服務資源相關聯之條件索引鍵的詳細資訊，請參閱「資源類型」資料表的條件索引鍵欄。

動作資料表的相依動作欄會顯示成功呼叫動作所需的其他許可。除了 動作本身的許可之外，還需要這些許可。當動作指定相依動作時，這些相依性可能適用於針對該動作定義的其他資源，而不只是資料表中列出的第一個資源。

注意

資源條件索引鍵會列在資源類型資料表中。您可以在「動作」資料表的資源類型 (*必填) 欄中找到適用於動作的資源類型連結。「資源類型」資料表中的資源類型包括條件索引鍵欄，其中包含套用至「動作」資料表中動作的資源條件索引鍵。

如需下表各欄的詳細資訊，請參閱動作資料表。

動作	描述	存取層級	資源類型 (*必填項目)	條件索引鍵	相依動作
CreateIndex	准許在指定的向量儲存貯體內建立新的向量索引	寫入	Index*
CreateVectorBucket	准許建立新的向量儲存貯體	寫入	VectorBucket*
				s3vectors:sseType s3vectors:kmsKeyArn
DeleteIndex	准許刪除指定的向量索引	寫入	Index*
DeleteVectorBucket	准許刪除指定的向量儲存貯體	寫入	VectorBucket*
DeleteVectorBucketPolicy	准許從指定的向量儲存貯體刪除 IAM 資源政策	許可管理	VectorBucket*
DeleteVectors	准許從指定的向量索引刪除一批向量	寫入	Index*
GetIndex	准許取得指定向量索引的屬性	讀取	Index*
GetVectorBucket	准許取得指定向量儲存貯體的屬性	讀取	VectorBucket*
GetVectorBucketPolicy	准許取得特定向量儲存貯體的 IAM 資源政策	讀取	VectorBucket*
GetVectors	准許透過向量索引鍵取得一批向量	讀取	Index*
ListIndexes	准許取得指定向量儲存貯體中所有索引的分頁清單	清單	VectorBucket*
ListVectorBuckets	准許取得帳戶中所有向量儲存貯體的分頁清單	清單
ListVectors	准許取得指定向量索引中所有向量的分頁清單	清單	Index*		s3vectors:GetVectors
PutVectorBucketPolicy	准許將 IAM 資源政策新增至指定的向量儲存貯體	許可管理	VectorBucket*
PutVectors	准許將一批向量新增至指定的向量索引	寫入	Index*
QueryVectors	准許在指定查詢向量的指定搜尋向量索引內尋找最接近的鄰	讀取	Index*		s3vectors:GetVectors

Amazon S3 Vectors 定義的資源類型

此服務會定義下列資源類型，並可用在 IAM 許可政策陳述式的 Resource 元素中。動作表格中的每個動作都代表可使用該動作指定的資源類型。資源類型也能定義您可以在政策中包含哪些條件索引鍵。這些索引鍵都會顯示在「資源類型」資料表的最後一欄。如需下表各欄的詳細資訊，請參閱資源類型資料表。

資源類型	ARN	條件索引鍵
Index	arn:${Partition}:s3vectors:${Region}:${Account}:bucket/${BucketName}/index/${IndexName}
VectorBucket	arn:${Partition}:s3vectors:${Region}:${Account}:bucket/${BucketName}

Amazon S3 Vectors 的條件索引鍵

Amazon S3 Vectors 定義下列條件索引鍵，可用於 IAM 政策的 Condition元素。您可以使用這些索引鍵來縮小套用政策陳述式的條件。如需下表各欄的詳細資訊，請參閱條件索引鍵表。

若要檢視所有 服務可用的全域條件索引鍵，請參閱AWS 全域條件內容索引鍵。

條件索引鍵	描述	Type
s3vectors:kmsKeyArn	針對用於加密向量儲存貯體的金鑰，依 AWS KMS 金鑰 ARN 篩選存取權	ARN
s3vectors:sseType	依伺服器端加密類型篩選存取權	字串