BatchGetGraphMemberDatasources
Gets data source package information for the behavior graph.
Request Syntax
POST /graph/datasources/get HTTP/1.1
Content-type: application/json
{
"AccountIds": [ "string
" ],
"GraphArn": "string
"
}
URI Request Parameters
The request does not use any URI parameters.
Request Body
The request accepts the following data in JSON format.
- AccountIds
-
The list of AWS accounts to get data source package information on.
Type: Array of strings
Array Members: Minimum number of 1 item. Maximum number of 200 items.
Length Constraints: Fixed length of 12.
Pattern:
^[0-9]+$
Required: Yes
- GraphArn
-
The ARN of the behavior graph.
Type: String
Pattern:
^arn:aws[-\w]{0,10}?:detective:[-\w]{2,20}?:\d{12}?:graph:[abcdef\d]{32}?$
Required: Yes
Response Syntax
HTTP/1.1 200
Content-type: application/json
{
"MemberDatasources": [
{
"AccountId": "string",
"DatasourcePackageIngestHistory": {
"string" : {
"string" : {
"Timestamp": "string"
}
}
},
"GraphArn": "string"
}
],
"UnprocessedAccounts": [
{
"AccountId": "string",
"Reason": "string"
}
]
}
Response Elements
If the action is successful, the service sends back an HTTP 200 response.
The following data is returned in JSON format by the service.
- MemberDatasources
-
Details on the status of data source packages for members of the behavior graph.
Type: Array of MembershipDatasources objects
- UnprocessedAccounts
-
Accounts that data source package information could not be retrieved for.
Type: Array of UnprocessedAccount objects
Errors
For information about the errors that are common to all actions, see Common Errors.
- AccessDeniedException
-
The request issuer does not have permission to access this resource or perform this operation.
HTTP Status Code: 403
- InternalServerException
-
The request was valid but failed because of a problem with the service.
HTTP Status Code: 500
- ResourceNotFoundException
-
The request refers to a nonexistent resource.
HTTP Status Code: 404
- ValidationException
-
The request parameters are invalid.
HTTP Status Code: 400
Examples
Example
This example illustrates one usage of BatchGetGraphMemberDatasources.
Sample Request
GET /graph/datasources/get HTTP/1.1
Host: api.detective.us-west-2.amazonaws.com
Accept-Encoding: gzip, deflate, br
Content-Length: 94
Authorization: AUTHPARAMS
X-Amz-Date: 20220511T171741Z
User-Agent: aws-cli/1.14.29 Python/2.7.9 Windows/8 botocore/1.8.33
{
"GraphArn": "arn:aws:detective:us-east-1:111122223333:graph:1a8ef4ba50e74440b4b3c0d4a32ef48b",
"AccountIds": ["379346275224"]
}
Example
This example illustrates one usage of BatchGetGraphMemberDatasources.
Sample Response
HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 596
Date: Wed, 11 May 2022 17:17:41 GMT
x-amzn-RequestId: ddce670a-02cf-4993-9bb7-72e05c2d08f1
Connection: Keep-alive
{
"MemberDatasources": [
{
"AccountId": "379346275224",
"GraphArn": "arn:aws:detective:us-east-1:111122223333:graph:1a8ef4ba50e74440b4b3c0d4a32ef48b",
"DatasourcePackageIngestHistory": {
"DETECTIVE_CORE": {
"STOPPED": null,
"STARTED": {
"Timestamp": "2022-05-05T18:56:33.656Z"
}
},
"EKS_AUDIT": {
"STOPPED": {
"Timestamp": "2022-05-05T19:00:12.621Z"
},
"STARTED": {
"Timestamp": "2022-05-05T18:56:33.656Z"
}
},
"ASFF_SECURITYHUB_FINDING": {
"STOPPED":{
"Timestamp":"2023-05-15T12:47:23.975Z"
},
"STARTED":{
"Timestamp":"2023-05-15T12:46:11.488Z"
}
}
}
}
],
"UnprocessedAccounts": []
}
See Also
For more information about using this API in one of the language-specific AWS SDKs, see the following: