若要以程式設計方式啟用自動化敏感資料探索,您有幾個選項:
其他選項和詳細資訊取決於您擁有的帳戶類型。
如果您是 Macie 管理員,請使用 UpdateAutomatedDiscoveryConfiguration操作或執行 update-automated-discovery-configuration命令來啟用您帳戶或組織的自動敏感資料探索。在您的請求中,ENABLED
為 status
參數指定 。針對 autoEnableOrganizationMembers
參數,指定要為其啟用的帳戶。如果您使用的是 AWS CLI,請使用 auto-enable-organization-members
參數指定帳戶。有效的 值如下:
-
ALL
(預設) – 為您組織中的所有帳戶啟用它。這包括您的管理員帳戶、現有的成員帳戶,以及後續加入您組織的帳戶。
-
NEW
– 為您的管理員帳戶啟用它。同時為後續加入您組織的帳戶自動啟用此功能。如果您先前為組織啟用了自動探索功能,並指定了此值,則目前為其啟用的現有成員帳戶將繼續啟用自動探索功能。
-
NONE
– 僅啟用您的管理員帳戶。請勿針對後續加入您組織的帳戶自動啟用它。如果您先前為組織啟用了自動探索功能,並指定了此值,則目前為其啟用的現有成員帳戶將繼續啟用自動探索功能。
如果您想要僅針對特定成員帳戶選擇性地啟用自動敏感資料探索,請指定 NEW
或 NONE
。然後,您可以使用 BatchUpdateAutomatedDiscoveryAccounts操作或執行 batch-update-automated-discovery-accounts命令來啟用帳戶的自動探索。
如果您有獨立的 Macie 帳戶,請使用 UpdateAutomatedDiscoveryConfiguration操作或執行 update-automated-discovery-configuration命令來啟用您帳戶的自動敏感資料探索。在您的請求中,ENABLED
為 status
參數指定 。針對 autoEnableOrganizationMembers
參數,請考慮您是否計劃成為其他帳戶的 Macie 管理員,並指定適當的值。如果您指定 NONE
,當您成為帳戶的 Macie 管理員時,系統不會自動為帳戶啟用自動探索。如果您指定 ALL
或 NEW
,會自動為帳戶啟用自動探索。如果您使用的是 AWS CLI,請使用 auto-enable-organization-members
參數來指定此設定的適當值。
下列範例示範如何使用 AWS CLI 為組織中的一或多個帳戶啟用自動敏感資料探索。第一個範例會第一次為組織中的所有帳戶啟用自動探索。它可自動探索 Macie 管理員帳戶、所有現有的成員帳戶,以及後續加入組織的任何帳戶。
$
aws macie2 update-automated-discovery-configuration --status ENABLED --auto-enable-organization-members ALL --region us-east-1
其中 us-east-1
是為帳戶啟用自動敏感資料探索的區域,即美國東部 (維吉尼亞北部) 區域。如果請求成功,Macie 會啟用帳戶的自動探索,並傳回空的回應。
下一個範例會將組織的成員啟用設定變更為 NONE
。透過此變更,不會針對後續加入組織的帳戶自動啟用自動敏感資料探索。反之,它只會針對 Macie 管理員帳戶及其目前啟用的任何現有成員帳戶啟用。
$
aws macie2 update-automated-discovery-configuration --status ENABLED --auto-enable-organization-members NONE --region us-east-1
其中 us-east-1
是要變更設定的 區域,即美國東部 (維吉尼亞北部) 區域。如果請求成功,Macie 會更新設定並傳回空白回應。
下列範例可為組織中的兩個成員帳戶啟用自動敏感資料探索。Macie 管理員已為組織啟用自動探索。此範例已針對 Linux、macOS 或 Unix 格式化,並使用反斜線 (\) 行接續字元來改善可讀性。
$
aws macie2 batch-update-automated-discovery-accounts \
--region us-east-1
\
--accounts '[{"accountId":"123456789012
","status":"ENABLED"},{"accountId":"111122223333
","status":"ENABLED"}]'
此範例已針對 Microsoft Windows 進行格式化,並使用 caret (^) line-contination 字元來改善可讀性。
C:\>
aws macie2 batch-update-automated-discovery-accounts ^
--region us-east-1
^
--accounts=[{\"accountId\":\"123456789012
\",\"status\":\"ENABLED\"},{\"accountId\":\"111122223333
\",\"status\":\"ENABLED\"}]
其中:
如果所有指定帳戶的請求成功,Macie 會傳回空errors
陣列。如果某些帳戶的請求失敗,陣列會指定每個受影響帳戶發生的錯誤。例如:
"errors": [
{
"accountId": "123456789012",
"errorCode": "ACCOUNT_PAUSED"
}
]
在上述回應中,指定帳戶 (123456789012
) 的請求失敗,因為該帳戶的 Macie 目前已暫停。若要解決此錯誤,Macie 管理員必須先為帳戶啟用 Macie。
如果所有帳戶的請求失敗,您會收到一則訊息,說明發生的錯誤。