GetDetector - Amazon GuardDuty

GetDetector

Retrieves an Amazon GuardDuty detector specified by the detectorId.

Request Syntax

GET /detector/detectorId HTTP/1.1

URI Request Parameters

The request requires the following URI parameters.

detectorId

The unique ID of the detector that you want to get.

Length Constraints: Minimum length of 1. Maximum length of 300.

Request Body

The request does not have a request body.

Response Syntax

HTTP/1.1 200 Content-type: application/json { "createdAt": "string", "findingPublishingFrequency": "string", "serviceRole": "string", "status": "string", "tags": { "string" : "string" }, "updatedAt": "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.

createdAt

Detector creation timestamp.

Type: String

findingPublishingFrequency

Finding publishing frequency.

Type: String

Valid Values: FIFTEEN_MINUTES | ONE_HOUR | SIX_HOURS

serviceRole

The GuardDuty service role.

Type: String

status

The detector status.

Type: String

Length Constraints: Minimum length of 1. Maximum length of 300.

Valid Values: ENABLED | DISABLED

tags

The tags of the detector resource.

Type: String to string map

Key Length Constraints: Minimum length of 1. Maximum length of 128.

Key Pattern: ^(?!aws:)[a-zA-Z+-=._:/]+$

Value Length Constraints: Maximum length of 256.

updatedAt

Detector last update timestamp.

Type: String

Errors

For information about the errors that are common to all actions, see Common Errors.

BadRequestException

Bad request exception object.

HTTP Status Code: 400

InternalServerErrorException

Internal server error exception object.

HTTP Status Code: 500

See Also

For more information about using this API in one of the language-specific AWS SDKs, see the following: