若要以程式設計方式調整 S3 儲存貯體的敏感度分數或設定,您有幾個選項。適當的選項取決於您要調整的項目。
- 指派敏感度分數
若要將敏感度分數指派給 S3 儲存貯體,請使用 UpdateResourceProfile 操作。在您的請求中,使用 resourceArn
參數來指定儲存貯體的 Amazon Resource Name (ARN)。針對 sensitivityScoreOverride
參數,執行下列其中一項:
如果您使用的是 AWS Command Line Interface (AWS CLI),請執行 update-resource-profile 命令,將敏感分數指派給 S3 儲存貯體。在您的請求中,使用 resource-arn
參數來指定儲存貯體的 ARN。省略或使用 sensitivity-score-override
參數來指定要指派的分數。
如果您的請求成功,Macie 會指派指定的分數並傳回空的回應。
- 在敏感度分數中排除或包含敏感資料類型
-
若要在 S3 儲存貯體的敏感度分數中排除或包含敏感資料類型,請使用 UpdateResourceProfileDetections 操作。當您使用此操作時,您會覆寫儲存貯體分數目前的包含和排除設定。因此,最好先擷取目前的設定,並決定要保留哪些設定。若要擷取目前的設定,請使用 ListResourceProfileDetections 操作。
當您準備好更新設定時,請使用 resourceArn
參數來指定 S3 儲存貯體的 ARN。針對 suppressDataIdentifiers
參數,執行下列其中一項:
-
若要從儲存貯體的分數中排除敏感資料類型,請使用 type
參數指定偵測到資料的資料識別符類型、受管資料識別符 (MANAGED
) 或自訂資料識別符 ()CUSTOM
。使用 id
參數為偵測到資料的受管或自訂資料識別符指定唯一識別符。
-
若要在儲存貯體的分數中包含敏感資料類型,請勿為偵測到資料的受管或自訂資料識別符指定任何詳細資訊。
-
若要在儲存貯體的分數中包含所有敏感資料類型,請勿指定任何值。如果 suppressDataIdentifiers
參數的值為 null (空白),Macie 會在計算分數時包含所有類型的偵測。
如果您使用的是 AWS CLI,請執行 update-resource-profile-detections 命令,以排除 S3 儲存貯體的敏感分數或包含敏感資料類型。使用 resource-arn
參數來指定儲存貯體的 ARN。使用 suppress-data-identifiers
參數指定要排除或包含在儲存貯體分數中的敏感資料類型。若要先擷取並檢閱儲存貯體的目前設定,請執行 list-resource-profile-detections 命令。
如果您的請求成功,Macie 會更新設定並傳回空的回應。
- 在分析中排除或包含 S3 儲存貯體
-
若要在分析中排除或後續包含 S3 儲存貯體,請使用 UpdateClassificationScope 操作。或者,如果您使用的是 AWS CLI,請執行 update-classification-scope 命令。如需其他詳細資訊和範例,請參閱 在自動化敏感資料探索中排除或包含 S3 儲存貯體。
下列範例示範如何使用 AWS CLI 來調整 S3 儲存貯體的個別設定。第一個範例會手動將敏感度分數上限 (100
) 指派給儲存貯體。它會覆寫儲存貯體的計算分數。
$
aws macie2 update-resource-profile --resource-arn arn:aws:s3:::amzn-s3-demo-bucket
--sensitivity-score-override 100
其中 arn:aws:s3::amzn-s3-demo-bucket
是 S3 儲存貯體的 ARN。
下一個範例會將 S3 儲存貯體的敏感度分數變更為 Macie 自動計算的分數。儲存貯體目前具有手動指派的分數,可覆寫計算的分數。此範例會省略請求中的 sensitivity-score-override
參數,以移除該覆寫。
$
aws macie2 update-resource-profile --resource-arn arn:aws:s3:::amzn-s3-demo-bucket2
其中 arn:aws:s3::amzn-s3-demo-bucket2
是 S3 儲存貯體的 ARN。
下列範例會從 S3 儲存貯體的敏感度分數中排除特定類型的敏感資料。此範例已針對 Linux、macOS 或 Unix 格式化,並使用反斜線 (\) 行接續字元來改善可讀性。
$
aws macie2 update-resource-profile-detections \
--resource-arn arn:aws:s3:::amzn-s3-demo-bucket3
\
--suppress-data-identifiers '[{"type":"MANAGED","id":"ADDRESS
"},{"type":"CUSTOM","id":"3293a69d-4a1e-4a07-8715-208ddexample
"}]'
此範例已針對 Microsoft Windows 進行格式化,並使用 caret (^) line-contination 字元來改善可讀性。
C:\>
aws macie2 update-resource-profile-detections ^
--resource-arn arn:aws:s3:::amzn-s3-demo-bucket3
^
--suppress-data-identifiers=[{\"type\":\"MANAGED\",\"id\":\"ADDRESS
\"},{\"type\":\"CUSTOM\",\"id\":\"3293a69d-4a1e-4a07-8715-208ddexample
\"}]
其中:
-
arn:aws:s3::amzn-s3-demo-bucket3
是 S3 儲存貯體的 ARN。
-
ADDRESS
是受管資料識別符的唯一識別符,可偵測要排除的敏感資料類型 (電子郵件地址)。
-
3293a69d-4a1e-4a07-8715-208ddexample
是自訂資料識別符的唯一識別符,可偵測要排除的敏感資料類型。
下一組範例稍後會在 S3 儲存貯體的敏感度分數中包含所有類型的敏感資料。它會藉由為 suppress-data-identifiers
參數指定空值 (空值) 來覆寫儲存貯體目前的排除設定。若為 Linux、macOS 或 Unix:
$
aws macie2 update-resource-profile-detections --resource-arn arn:aws:s3:::amzn-s3-demo-bucket3
--suppress-data-identifiers '[]'
對於 Microsoft Windows:
C:\>
aws macie2 update-resource-profile-detections --resource-arn arn:aws:s3:::amzn-s3-demo-bucket3
--suppress-data-identifiers=[]
其中 arn:aws:s3::amzn-s3-demo-bucket3
是 S3 儲存貯體的 ARN。