使用的偵測範例 AWS CLI

下列程式碼範例示範如何使用 AWS Command Line Interface 搭配 Detective 的來執行動作和實作常見案例。

Actions 是大型程式的程式碼摘錄，必須在內容中執行。雖然動作會示範如何呼叫個別服務函數，但您可以在其相關案例中查看內容中的動作。

每個範例都包含完整原始程式碼的連結，您可以在其中找到如何在內容中設定和執行程式碼的指示。

主題

動作

動作

下列程式碼範例示範如何使用 accept-invitation。

AWS CLI

接受在行為圖表中成為成員帳戶的邀請

下列accept-invitation範例接受邀請，以在 arn：aws：detective：us-east-1：111122223333：graph：123412341234 行為圖表中成為成員帳戶。


aws detective accept-invitation \
    --graph-arn arn:aws:detective:us-east-1:111122223333:graph:123412341234

此命令不會產生輸出。

如需詳細資訊，請參閱 Amazon Detective 管理指南 中的回應行為圖表邀請。

如需API詳細資訊，請參閱命令參考 AcceptInvitation中的。 AWS CLI

下列程式碼範例示範如何使用 create-graph。

AWS CLI

啟用 Amazon Detective 並建立新的行為圖表

下列create-graph範例為在執行命令的區域中執行命令 AWS 的帳戶啟用 Detective。新的行為圖表會建立，該帳戶將作為其管理員帳戶。命令也會將財務值指派給部門標籤。


aws detective create-graph \
    --tags '{"Department": "Finance"}'

輸出：


{
    "GraphArn": "arn:aws:detective:us-east-1:111122223333:graph:027c7c4610ea4aacaf0b883093cab899"
}

如需詳細資訊，請參閱 Amazon Detective 管理指南中的啟用 Amazon Detective。

如需API詳細資訊，請參閱命令參考 CreateGraph中的。 AWS CLI

下列程式碼範例示範如何使用 create-members。

AWS CLI

邀請成員帳戶加入行為圖表

下列create-members範例會邀請兩個 AWS 帳戶在 arn：aws：detective：us-east-1：111122223333：graph：123412341234 行為圖表中成為成員帳戶。對於每個帳戶，請求會提供 AWS 帳戶 ID 和帳戶根使用者電子郵件地址。請求包含要插入邀請電子郵件的自訂訊息。


aws detective create-members \
    --accounts AccountId=444455556666,EmailAddress=mmajor@example.com AccountId=123456789012,EmailAddress=jstiles@example.com \
    --graph-arn arn:aws:detective:us-east-1:111122223333:graph:123412341234 \
    --message "This is Paul Santos. I need to add your account to the data we use for security investigation in Amazon Detective. If you have any questions, contact me at psantos@example.com."

輸出：


{
    "Members": [
    {
        "AccountId": "444455556666",
        "AdministratorId": "111122223333",
        "EmailAddress": "mmajor@example.com",
        "GraphArn": "arn:aws:detective:us-east-1:111122223333:graph:123412341234",
        "InvitedTime": 1579826107000,
        "MasterId": "111122223333",
        "Status": "INVITED",
        "UpdatedTime": 1579826107000
   },
   {
        "AccountId": "123456789012",
        "AdministratorId": "111122223333",
        "EmailAddress": "jstiles@example.com",
        "GraphArn": "arn:aws:detective:us-east-1:111122223333:graph:123412341234",
        "InvitedTime": 1579826107000,
        "MasterId": "111122223333",
        "Status": "VERIFICATION_IN_PROGRESS",
        "UpdatedTime": 1579826107000
     }
    ],
    "UnprocessedAccounts": [ ]
}

如需詳細資訊，請參閱 Amazon Detective 管理指南 中的將成員帳戶邀請至行為圖表＜https://docs.aws.amazon.com/detective/latest/adminguide/graph-admin-add-member-accounts.html>。

在不傳送邀請電子郵件的情況下邀請成員帳戶

下列create-members範例會邀請兩個 AWS 帳戶在 arn：aws：detective：us-east-1：111122223333：graph：123412341234 行為圖表中成為成員帳戶。對於每個帳戶，請求會提供 AWS 帳戶 ID 和帳戶根使用者電子郵件地址。成員帳戶不會收到邀請電子郵件。


aws detective create-members \
    --accounts AccountId=444455556666,EmailAddress=mmajor@example.com AccountId=123456789012,EmailAddress=jstiles@example.com \
    --graph-arn arn:aws:detective:us-east-1:111122223333:graph:123412341234 \
    --disable-email-notification

輸出：


{
    "Members": [
    {
        "AccountId": "444455556666",
        "AdministratorId": "111122223333",
        "EmailAddress": "mmajor@example.com",
        "GraphArn": "arn:aws:detective:us-east-1:111122223333:graph:123412341234",
        "InvitedTime": 1579826107000,
        "MasterId": "111122223333",
        "Status": "INVITED",
        "UpdatedTime": 1579826107000
   },
   {
        "AccountId": "123456789012",
        "AdministratorId": "111122223333",
        "EmailAddress": "jstiles@example.com",
        "GraphArn": "arn:aws:detective:us-east-1:111122223333:graph:123412341234",
        "InvitedTime": 1579826107000,
        "MasterId": "111122223333",
        "Status": "VERIFICATION_IN_PROGRESS",
        "UpdatedTime": 1579826107000
     }
    ],
    "UnprocessedAccounts": [ ]
}

如需API詳細資訊，請參閱命令參考 CreateMembers中的。 AWS CLI

下列程式碼範例示範如何使用 delete-graph。

AWS CLI

若要停用 Detective 並刪除行為圖表

下列delete-graph範例會停用 Detective 並刪除指定的行為圖表。


aws detective delete-graph \
    --graph-arn arn:aws:detective:us-east-1:111122223333:graph:123412341234

此命令不會產生輸出。

如需詳細資訊，請參閱 Amazon Detective 管理指南中的停用 Amazon Detective。

如需API詳細資訊，請參閱命令參考 DeleteGraph中的。 AWS CLI

下列程式碼範例示範如何使用 delete-members。

AWS CLI

從行為圖表中移除成員帳戶

下列delete-members範例會從 arn：aws：detective：us-east-1：111122223333：graph：123412341234 的行為圖形中移除兩個成員帳戶。若要識別帳戶，請求會提供 AWS 帳戶 IDs。


aws detective delete-members \
    --account-ids 444455556666 123456789012 \
    --graph-arn arn:aws:detective:us-east-1:111122223333:graph:123412341234

輸出：


 {
    "AccountIds": [ "444455556666", "123456789012" ],
    "UnprocessedAccounts": [ ]
}

如需詳細資訊，請參閱 Amazon Detective 管理指南 中的從行為圖表移除成員帳戶＜https://docs.aws.amazon.com/detective/latest/adminguide/graph-admin-remove-member-accounts.html>。

如需API詳細資訊，請參閱命令參考 DeleteMembers中的。 AWS CLI

下列程式碼範例示範如何使用 disassociate-membership。

AWS CLI

從行為圖表中撤銷成員資格

下列 disassociate-membership 範例會從 arn：aws：detective：us-east-1：111122223333：graph：123412341234 的行為圖形中移除執行命令 AWS 的帳戶。


aws detective disassociate-membership \
     --graph-arn arn:aws:detective:us-east-1:111122223333:graph:123412341234

如需詳細資訊，請參閱 Amazon Detective 管理指南 中的從行為圖表＜https://docs.aws.amazon.com/detective/latest/adminguide/member-remove-self-from-graph.html>中移除您的帳戶。

如需API詳細資訊，請參閱命令參考 DisassociateMembership中的。 AWS CLI

下列程式碼範例示範如何使用 get-members。

AWS CLI

擷取所選行為圖形成員帳戶的相關資訊

下列get-members範例會擷取行為圖表 arn：aws：detective：us-east-1：111122223333：graph：123412341234 中兩個成員帳戶的相關資訊。對於這兩個帳戶，請求會提供 AWS 帳戶 IDs。


aws detective get-members \
    --account-ids 444455556666 123456789012 \
    --graph-arn arn:aws:detective:us-east-1:111122223333:graph:123412341234

輸出：


{
    "MemberDetails": [
    {
        "AccountId": "444455556666",
        "AdministratorId": "111122223333",
        "EmailAddress": "mmajor@example.com",
        "GraphArn": "arn:aws:detective:us-east-1:111122223333:graph:123412341234",
        "InvitedTime": 1579826107000,
        "MasterId": "111122223333",
        "Status": "INVITED",
        "UpdatedTime": 1579826107000
    }
    {
        "AccountId": "123456789012",
        "AdministratorId": "111122223333",
        "EmailAddress": "jstiles@example.com",
        "GraphArn": "arn:aws:detective:us-east-1:111122223333:graph:123412341234",
        "InvitedTime": 1579826107000,
        "MasterId": "111122223333",
        "Status": "INVITED",
        "UpdatedTime": 1579826107000
    }
],
    "UnprocessedAccounts": [ ]
}

如需詳細資訊，請參閱 Amazon Detective 管理指南 中的檢視行為圖表中的帳戶清單＜https://docs.aws.amazon.com/detective/latest/adminguide/graph-admin-view-accounts.html>。

如需API詳細資訊，請參閱命令參考 GetMembers中的。 AWS CLI

下列程式碼範例示範如何使用 list-graphs。

AWS CLI

若要檢視您的帳戶是管理員的行為圖表清單

下列list-graphs範例會擷取呼叫帳戶在目前區域中是管理員的行為圖表。


aws detective list-graphs

輸出：


{
    "GraphList": [
        {
            "Arn": "arn:aws:detective:us-east-1:111122223333:graph:123412341234",
            "CreatedTime": 1579736111000
        }
    ]
}

如需API詳細資訊，請參閱命令參考 ListGraphs中的。 AWS CLI

下列程式碼範例示範如何使用 list-invitations。

AWS CLI

檢視帳戶為成員或受邀加入的行為圖表清單

下列list-invitations範例會擷取呼叫帳戶受邀使用的行為圖表。結果僅包含開啟和接受的邀請。它們不包括拒絕的邀請或移除的成員資格。


aws detective list-invitations

輸出：


{
    "Invitations": [
    {
        "AccountId": "444455556666",
        "AdministratorId": "111122223333",
        "EmailAddress": "mmajor@example.com",
        "GraphArn": "arn:aws:detective:us-east-1:111122223333:graph:123412341234",
        "InvitedTime": 1579826107000,
        "MasterId": "111122223333",
        "Status": "INVITED",
        "UpdatedTime": 1579826107000
    }
]
}

如需詳細資訊，請參閱 Amazon Detective 管理指南 中的檢視行為圖表邀請清單＜https://docs.aws.amazon.com/detective/latest/adminguide/member-view-graph-invitations.html>。

如需API詳細資訊，請參閱命令參考 ListInvitations中的。 AWS CLI

下列程式碼範例示範如何使用 list-members。

AWS CLI

在行為圖表中列出成員帳戶

下列list-members範例會擷取行為圖的受邀和啟用成員帳戶arn:aws:detective:us-east-1:111122223333:graph:123412341234。結果不包含已移除的成員帳戶。


aws detective list-members \
    --graph-arn arn:aws:detective:us-east-1:111122223333:graph:123412341234

輸出：


{
    "MemberDetails": [
        {
            "AccountId": "444455556666",
            "AdministratorId": "111122223333",
            "EmailAddress": "mmajor@example.com",
            "GraphArn": "arn:aws:detective:us-east-1:111122223333:graph:123412341234",
            "InvitedTime": 1579826107000,
            "MasterId": "111122223333",
            "Status": "INVITED",
            "UpdatedTime": 1579826107000
        },
        {
            "AccountId": "123456789012",
            "AdministratorId": "111122223333",
            "EmailAddress": "jstiles@example.com",
            "GraphArn": "arn:aws:detective:us-east-1:111122223333:graph:123412341234",
            "InvitedTime": 1579826107000,
            "MasterId": "111122223333",
            "PercentOfGraphUtilization": 2,
            "PercentOfGraphUtilizationUpdatedTime": 1586287843,
            "Status": "ENABLED",
            "UpdatedTime": 1579973711000,
            "VolumeUsageInBytes": 200,
            "VolumeUsageUpdatedTime": 1586287843
        }
    ]
}

如需詳細資訊，請參閱 Amazon Detective 管理指南 中的在行為圖表中檢視帳戶清單。

如需API詳細資訊，請參閱命令參考 ListMembers中的。 AWS CLI

下列程式碼範例示範如何使用 list-tags-for-resource。

AWS CLI

擷取指派給行為圖表的標籤

下列list-tags-for-resource範例會傳回指派給指定行為圖表的標籤。


aws detective list-tags-for-resource \
    --resource-arn arn:aws:detective:us-east-1:111122223333:graph:123412341234

輸出：


{
    "Tags": {
        "Department" : "Finance"
    }
}

如需詳細資訊，請參閱 Amazon Detective 管理指南 中的管理行為圖表的標籤。

如需API詳細資訊，請參閱命令參考 ListTagsForResource中的。 AWS CLI

下列程式碼範例示範如何使用 reject-invitation。

AWS CLI

拒絕在行為圖表中成為成員帳戶的邀請

下列reject-invitation範例拒絕在 arn：aws：detective：us-east-1：111122223333：graph：123412341234 行為圖表中成為成員帳戶的邀請。


aws detective reject-invitation \
    --graph-arn arn:aws:detective:us-east-1:111122223333:graph:123412341234

此命令不會產生輸出。

如需詳細資訊，請參閱 Amazon Detective 管理指南 中的回應行為圖表邀請＜https://docs.aws.amazon.com/detective/latest/adminguide/member-invitation-response.html>。

如需API詳細資訊，請參閱命令參考 RejectInvitation中的。 AWS CLI

下列程式碼範例示範如何使用 tag-resource。

AWS CLI

將標籤指派給資源

下列tag-resource範例會將 Department 標籤的值指派給指定的行為圖表。


aws detective tag-resource \
    --resource-arn arn:aws:detective:us-east-1:111122223333:graph:123412341234 \
    --tags '{"Department":"Finance"}'

此命令不會產生輸出。

如需詳細資訊，請參閱 Amazon Detective 管理指南 中的管理行為圖表的標籤。

如需API詳細資訊，請參閱命令參考 TagResource中的。 AWS CLI

下列程式碼範例示範如何使用 untag-resource。

AWS CLI

從資源中移除標籤值

下列untag-resource範例會從指定的行為圖表中移除 Department 標籤。


aws detective untag-resource \
    --resource-arn arn:aws:detective:us-east-1:111122223333:graph:123412341234 \
    --tag-keys "Department"

此命令不會產生輸出。

如需詳細資訊，請參閱 Amazon Detective 管理指南 中的管理行為圖表的標籤。

如需API詳細資訊，請參閱命令參考 UntagResource中的。 AWS CLI

您的瀏覽器已停用或無法使用 Javascript。

您必須啟用 Javascript，才能使用 AWS 文件。請參閱您的瀏覽器說明頁以取得說明。

文件慣用形式

DAX

Device Farm

使用 的偵測範例 AWS CLI

主題

動作

使用的偵測範例 AWS CLI