Select your cookie preferences

We use essential cookies and similar tools that are necessary to provide our site and services. We use performance cookies to collect anonymous statistics, so we can understand how customers use our site and make improvements. Essential cookies cannot be deactivated, but you can choose “Customize” or “Decline” to decline performance cookies.

If you agree, AWS and approved third parties will also use cookies to provide useful site features, remember your preferences, and display relevant content, including relevant advertising. To accept or decline all non-essential cookies, choose “Accept” or “Decline.” To make more detailed choices, choose “Customize.”

Describe or Update Discoverer - Amazon EventBridge Schemas

Describe or Update Discoverer

URI

/v1/discoverers/id/discovererId

HTTP methods

GET

Operation ID: DescribeDiscoverer

Describes the discoverer.

Path parameters
NameTypeRequiredDescription
discovererIdStringTrue

The ID of the discoverer.

Responses
Status codeResponse modelDescription
200DiscovererOutput

200 response

400ErrorOutput

400 response

401ErrorOutput

401 response

403ErrorOutput

403 response

404ErrorOutput

404 response

500ErrorOutput

500 response

503ErrorOutput

503 response

PUT

Operation ID: UpdateDiscoverer

Updates the discoverer

Path parameters
NameTypeRequiredDescription
discovererIdStringTrue

The ID of the discoverer.

Responses
Status codeResponse modelDescription
200DiscovererOutput

200 response

400ErrorOutput

400 response

401ErrorOutput

401 response

403ErrorOutput

403 response

404ErrorOutput

404 response

500ErrorOutput

500 response

503ErrorOutput

503 response

DELETE

Operation ID: DeleteDiscoverer

Deletes a discoverer.

Path parameters
NameTypeRequiredDescription
discovererIdStringTrue

The ID of the discoverer.

Responses
Status codeResponse modelDescription
204None

204 response

400ErrorOutput

400 response

401ErrorOutput

401 response

403ErrorOutput

403 response

404ErrorOutput

404 response

500ErrorOutput

500 response

503ErrorOutput

503 response

OPTIONS

Path parameters
NameTypeRequiredDescription
discovererIdStringTrue

The ID of the discoverer.

Responses
Status codeResponse modelDescription
200None

200 response

Schemas

Request bodies

{ "CrossAccount": boolean, "Description": "string" }

PUT schema

{ "CrossAccount": boolean, "Description": "string" }

Response bodies

{ "DiscovererArn": "string", "DiscovererId": "string", "CrossAccount": boolean, "Description": "string", "SourceArn": "string", "State": enum, "tags": { } }

DiscovererOutput schema

{ "DiscovererArn": "string", "DiscovererId": "string", "CrossAccount": boolean, "Description": "string", "SourceArn": "string", "State": enum, "tags": { } }
{ "Message": "string", "Code": "string" }

ErrorOutput schema

{ "Message": "string", "Code": "string" }

Properties

DiscovererOutput

PropertyTypeRequiredDescription
CrossAccount

boolean

False

Whether cross-account events are discovered.

Description

string

False

The description of the discoverer.

DiscovererArn

string

False

The ARN of the discoverer.

DiscovererId

string

False

The ID of the discoverer.

SourceArn

string

False

The ARN of the event bus.

State

DiscovererState

False

The state of the discoverer.

tags

Tags

False

Tags associated with the resource.

DiscovererState

  • STARTED

  • STOPPED

ErrorOutput

PropertyTypeRequiredDescription
Code

string

True

The error code.

Message

string

True

The message string of the error output.

Tags

Key-value pairs associated with a resource.

PropertyTypeRequiredDescription

*

string

False

UpdateDiscovererInput

PropertyTypeRequiredDescription
CrossAccount

boolean

False
Description

string

MinLength: 0

MaxLength: 256

False

The description of the discoverer to update.

PrivacySite termsCookie preferences
© 2025, Amazon Web Services, Inc. or its affiliates. All rights reserved.