Request Syntax URI Request Parameters Request Body Response Syntax Response Elements Errors Examples See Also

UpdateDatasourcePackages

Starts a data source package for the Detective behavior graph.

Request Syntax


POST /graph/datasources/update HTTP/1.1
Content-type: application/json

{
   "DatasourcePackages": [ "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.

DatasourcePackages

The data source package to start for the behavior graph.

Type: Array of strings

Array Members: Minimum number of 1 item. Maximum number of 25 items.

Valid Values: DETECTIVE_CORE | EKS_AUDIT | ASFF_SECURITYHUB_FINDING

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

Response Elements

If the action is successful, the service sends back an HTTP 200 response with an empty HTTP body.

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

ServiceQuotaExceededException

This request cannot be completed for one of the following reasons.

This request cannot be completed if it would cause the number of member accounts in the behavior graph to exceed the maximum allowed. A behavior graph cannot have more than 1,200 member accounts.
This request cannot be completed if the current volume ingested is above the limit of 10 TB per day. Detective will not allow you to add additional member accounts.

HTTP Status Code: 402

ValidationException

The request parameters are invalid.

HTTP Status Code: 400

Examples

Example

This example illustrates one usage of UpdateDatasourcePackages.

Sample Request


POST /graph/datasources/set HTTP/1.1
Host: api.detective.us-west-2.amazonaws.com
Accept-Encoding: gzip, deflate, br
Content-Length: 167
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",
   "DatasourcePackages":[
      "DETECTIVE_CORE",
      "EKS_AUDIT",
      "ASFF_SECURITYHUB_FINDING"
   ]
}

Example

This example illustrates one usage of UpdateDatasourcePackages.

Sample Response


Sample Response
HTTP/1.1 200 OK
Content-Length: 0
Date: Wed, 11 May 2022 17:17:41 GMT
x-amzn-RequestId: ddce670a-02cf-4993-9bb7-72e05c2d08f1
Connection: Keep-alive