Smaws_Client_EventBridge.Types
type nonrec dead_letter_config = {
arn : resource_arn option;
The ARN of the SQS queue specified as the target for the dead-letter queue.
*)}
Configuration details of the Amazon SQS queue for EventBridge to use as a dead-letter queue (DLQ).
For more information, see Using dead-letter queues to process undelivered events in the EventBridge User Guide.
type nonrec update_event_bus_response = {
dead_letter_config : dead_letter_config option;
description : event_bus_description option;
The event bus description.
*)kms_key_identifier : kms_key_identifier option;
The identifier of the KMS customer managed key for EventBridge to use to encrypt events on this event bus, if one has been specified.
For more information, see Data encryption in EventBridge in the Amazon EventBridge User Guide.
*)name : event_bus_name option;
The event bus name.
*)arn : string_ option;
The event bus Amazon Resource Name (ARN).
*)}
type nonrec update_event_bus_request = {
dead_letter_config : dead_letter_config option;
description : event_bus_description option;
The event bus description.
*)kms_key_identifier : kms_key_identifier option;
The identifier of the KMS customer managed key for EventBridge to use, if you choose to use a customer managed key to encrypt events on this event bus. The identifier can be the key Amazon Resource Name (ARN), KeyId, key alias, or key alias ARN.
If you do not specify a customer managed key identifier, EventBridge uses an Amazon Web Services owned key to encrypt events on the event bus.
For more information, see Identify and view keys in the Key Management Service Developer Guide.
Schema discovery is not supported for event buses encrypted using a customer managed key. EventBridge returns an error if:
You call
{{:https://docs.aws.amazon.com/eventbridge/latest/schema-reference/v1-discoverers.html#CreateDiscoverer}CreateDiscoverer}
on an event bus set to use a customer managed key for encryption.
You call
{{:https://docs.aws.amazon.com/eventbridge/latest/APIReference/API_UpdatedEventBus.html}UpdatedEventBus}
to set a customer managed key on an event bus with schema discovery enabled.
To enable schema discovery on an event bus, choose to use an Amazon Web Services owned key. For more information, see Encrypting events in the Amazon EventBridge User Guide.
If you have specified that EventBridge use a customer managed key for encrypting the source event bus, we strongly recommend you also specify a customer managed key for any archives for the event bus as well.
For more information, see Encrypting archives in the Amazon EventBridge User Guide.
*)name : event_bus_name option;
The name of the event bus.
*)}
An entity that you specified does not exist.
The operation you are attempting is not available in this region.
This exception occurs due to unexpected causes.
There is concurrent modification on a rule, target, archive, or replay.
type nonrec primary = {
health_check : health_check;
The ARN of the health check used by the endpoint to determine whether failover is triggered.
*)}
The primary Region of the endpoint.
The secondary Region that processes events when failover is triggered or replication is enabled.
type nonrec failover_config = {
secondary : secondary;
The Region that events are routed to when failover is triggered or event replication is enabled.
*)primary : primary;
The main Region of the endpoint.
*)}
The failover configuration for an endpoint. This includes what triggers failover and what happens when it's triggered.
type nonrec routing_config = {
failover_config : failover_config;
The failover configuration for an endpoint. This includes what triggers failover and what happens when it's triggered.
*)}
The routing configuration of the endpoint.
type nonrec replication_config = {
state : replication_state option;
The state of event replication.
*)}
Endpoints can replicate all events to the secondary Region.
type nonrec endpoint_event_bus = {
event_bus_arn : non_partner_event_bus_arn;
The ARN of the event bus the endpoint is associated with.
*)}
The event buses the endpoint is associated with.
type nonrec endpoint_event_bus_list = endpoint_event_bus list
type nonrec update_endpoint_response = {
state : endpoint_state option;
The state of the endpoint you updated in this request.
*)endpoint_url : endpoint_url option;
The URL of the endpoint you updated in this request.
*)endpoint_id : endpoint_id option;
The ID of the endpoint you updated in this request.
*)role_arn : iam_role_arn option;
The ARN of the role used by event replication for the endpoint you updated in this request.
*)event_buses : endpoint_event_bus_list option;
The event buses used for replication for the endpoint you updated in this request.
*)replication_config : replication_config option;
Whether event replication was enabled or disabled for the endpoint you updated in this request.
*)routing_config : routing_config option;
The routing configuration you updated in this request.
*)arn : endpoint_arn option;
The ARN of the endpoint you updated in this request.
*)name : endpoint_name option;
The name of the endpoint you updated in this request.
*)}
type nonrec update_endpoint_request = {
role_arn : iam_role_arn option;
The ARN of the role used by event replication for this request.
*)event_buses : endpoint_event_bus_list option;
Define event buses used for replication.
*)replication_config : replication_config option;
Whether event replication was enabled or disabled by this request.
*)routing_config : routing_config option;
Configure the routing policy, including the health check and secondary Region.
*)description : endpoint_description option;
A description for the endpoint.
*)name : endpoint_name;
The name of the endpoint you want to update.
*)}
type nonrec update_connection_response = {
last_modified_time : timestamp option;
A time stamp for the time that the connection was last modified.
*)creation_time : timestamp option;
A time stamp for the time that the connection was created.
*)connection_state : connection_state option;
The state of the connection that was updated.
*)connection_arn : connection_arn option;
The ARN of the connection that was updated.
*)}
type nonrec update_connection_basic_auth_request_parameters = {
password : auth_header_parameters_sensitive option;
The password associated with the user name to use for Basic authorization.
*)username : auth_header_parameters option;
The user name to use for Basic authorization.
*)}
The Basic authorization parameters for the connection.
type nonrec update_connection_o_auth_client_request_parameters = {
client_secret : auth_header_parameters_sensitive option;
The client secret assciated with the client ID to use for OAuth authorization.
*)client_i_d : auth_header_parameters option;
The client ID to use for OAuth authorization.
*)}
The OAuth authorization parameters to use for the connection.
type nonrec connection_header_parameter = {
is_value_secret : boolean_ option;
Specifies whether the value is a secret.
*)value : header_value_sensitive option;
The value associated with the key.
*)key : header_key option;
The key for the parameter.
*)}
Additional parameter included in the header. You can include up to 100 additional header parameters per request. An event payload cannot exceed 64 KB.
type nonrec connection_header_parameters_list =
connection_header_parameter list
type nonrec connection_query_string_parameter = {
is_value_secret : boolean_ option;
Specifies whether the value is secret.
*)value : query_string_value_sensitive option;
The value associated with the key for the query string parameter.
*)key : query_string_key option;
The key for a query string parameter.
*)}
Any additional query string parameter for the connection. You can include up to 100 additional query string parameters per request. Each additional parameter counts towards the event payload size, which cannot exceed 64 KB.
type nonrec connection_query_string_parameters_list =
connection_query_string_parameter list
type nonrec connection_body_parameter = {
is_value_secret : boolean_ option;
Specifies whether the value is secret.
*)value : sensitive_string option;
The value associated with the key.
*)key : string_ option;
The key for the parameter.
*)}
Additional parameter included in the body. You can include up to 100 additional body parameters per request. An event payload cannot exceed 64 KB.
type nonrec connection_body_parameters_list = connection_body_parameter list
type nonrec connection_http_parameters = {
body_parameters : connection_body_parameters_list option;
Any additional body string parameters for the connection.
*)query_string_parameters : connection_query_string_parameters_list option;
Any additional query string parameters for the connection.
*)header_parameters : connection_header_parameters_list option;
Any additional header parameters for the connection.
*)}
Any additional parameters for the connection.
type nonrec update_connection_o_auth_request_parameters = {
o_auth_http_parameters : connection_http_parameters option;
The additional HTTP parameters used for the OAuth authorization request.
*)http_method : connection_o_auth_http_method option;
The method used to connect to the HTTP endpoint.
*)client_parameters : update_connection_o_auth_client_request_parameters option;
The client parameters to use for the connection when OAuth is specified as the authorization type.
*)}
The OAuth request parameters to use for the connection.
type nonrec update_connection_api_key_auth_request_parameters = {
api_key_value : auth_header_parameters_sensitive option;
The value associated with the API key to use for authorization.
*)api_key_name : auth_header_parameters option;
The name of the API key to use for authorization.
*)}
Contains the API key authorization parameters to use to update the connection.
type nonrec connectivity_resource_configuration_arn = {
resource_configuration_arn : resource_configuration_arn;
The Amazon Resource Name (ARN) of the Amazon VPC Lattice resource configuration for the resource endpoint.
*)}
The Amazon Resource Name (ARN) of the Amazon VPC Lattice resource configuration for the resource endpoint.
type nonrec connectivity_resource_parameters = {
resource_parameters : connectivity_resource_configuration_arn;
The parameters for EventBridge to use when invoking the resource endpoint.
*)}
The parameters for EventBridge to use when invoking the resource endpoint.
type nonrec update_connection_auth_request_parameters = {
connectivity_parameters : connectivity_resource_parameters option;
If you specify a private OAuth endpoint, the parameters for EventBridge to use when authenticating against the endpoint.
For more information, see Authorization methods for connections in the Amazon EventBridge User Guide.
*)invocation_http_parameters : connection_http_parameters option;
The additional parameters to use for the connection.
*)api_key_auth_parameters : update_connection_api_key_auth_request_parameters
option;
The authorization parameters for API key authorization.
*)o_auth_parameters : update_connection_o_auth_request_parameters option;
The authorization parameters for OAuth authorization.
*)basic_auth_parameters : update_connection_basic_auth_request_parameters option;
The authorization parameters for Basic authorization.
*)}
Contains the additional parameters to use for the connection.
type nonrec update_connection_request = {
kms_key_identifier : kms_key_identifier option;
The identifier of the KMS customer managed key for EventBridge to use, if you choose to use a customer managed key to encrypt this connection. The identifier can be the key Amazon Resource Name (ARN), KeyId, key alias, or key alias ARN.
If you do not specify a customer managed key identifier, EventBridge uses an Amazon Web Services owned key to encrypt the connection.
For more information, see Identify and view keys in the Key Management Service Developer Guide.
*)invocation_connectivity_parameters : connectivity_resource_parameters option;
For connections to private APIs, the parameters to use for invoking the API.
For more information, see Connecting to private APIs in the Amazon EventBridge User Guide.
*)auth_parameters : update_connection_auth_request_parameters option;
The authorization parameters to use for the connection.
*)description : connection_description option;
A description for the connection.
*)name : connection_name;
The name of the connection to update.
*)}
This request cannot be completed due to throttling issues.
The request failed because it attempted to create resource beyond the allowed service quota.
You do not have the necessary permissions for this action.
type nonrec update_archive_response = {
creation_time : timestamp option;
The time at which the archive was updated.
*)state_reason : archive_state_reason option;
The reason that the archive is in the current state.
*)state : archive_state option;
The state of the archive.
*)archive_arn : archive_arn option;
The ARN of the archive.
*)}
type nonrec update_archive_request = {
kms_key_identifier : kms_key_identifier option;
The identifier of the KMS customer managed key for EventBridge to use, if you choose to use a customer managed key to encrypt this archive. The identifier can be the key Amazon Resource Name (ARN), KeyId, key alias, or key alias ARN.
If you do not specify a customer managed key identifier, EventBridge uses an Amazon Web Services owned key to encrypt the archive.
For more information, see Identify and view keys in the Key Management Service Developer Guide.
If you have specified that EventBridge use a customer managed key for encrypting the source event bus, we strongly recommend you also specify a customer managed key for any archives for the event bus as well.
For more information, see Encrypting archives in the Amazon EventBridge User Guide.
*)retention_days : retention_days option;
The number of days to retain events in the archive.
*)event_pattern : event_pattern option;
The event pattern to use to filter events sent to the archive.
*)description : archive_description option;
The description for the archive.
*)archive_name : archive_name;
The name of the archive to update.
*)}
The event pattern is not valid.
type nonrec update_api_destination_response = {
last_modified_time : timestamp option;
A time stamp for the time that the API destination was last modified.
*)creation_time : timestamp option;
A time stamp for the time that the API destination was created.
*)api_destination_state : api_destination_state option;
The state of the API destination that was updated.
*)api_destination_arn : api_destination_arn option;
The ARN of the API destination that was updated.
*)}
type nonrec update_api_destination_request = {
invocation_rate_limit_per_second : api_destination_invocation_rate_limit_per_second
option;
The maximum number of invocations per second to send to the API destination.
*)http_method : api_destination_http_method option;
The method to use for the API destination.
*)invocation_endpoint : https_endpoint option;
The URL to the endpoint to use for the API destination.
*)connection_arn : connection_arn option;
The ARN of the connection to use for the API destination.
*)description : api_destination_description option;
The name of the API destination to update.
*)name : api_destination_name;
The name of the API destination to update.
*)}
type nonrec tag_key_list = tag_key list
type nonrec untag_resource_request = {
tag_keys : tag_key_list;
The list of tag keys to remove from the resource.
*)resource_ar_n : arn;
The ARN of the EventBridge resource from which you are removing tags.
*)}
This rule was created by an Amazon Web Services service on behalf of your account. It is managed by that service. If you see this error in response to DeleteRule
or RemoveTargets
, you can use the Force
parameter in those calls to delete the rule or remove targets from the rule. You cannot modify these managed rules by using DisableRule
, EnableRule
, PutTargets
, PutRule
, TagResource
, or UntagResource
.
type nonrec transformer_paths =
(input_transformer_path_key * target_input_path) list
type nonrec test_event_pattern_response = {
result : boolean_ option;
Indicates whether the event matches the event pattern.
*)}
type nonrec test_event_pattern_request = {
event : string_;
The event, in JSON format, to test against the event pattern. The JSON must follow the format specified in Amazon Web Services Events, and the following fields are mandatory:
id
account
source
time
region
resources
detail-type
event_pattern : event_pattern;
The event pattern. For more information, see Events and Event Patterns in the Amazon EventBridge User Guide.
*)}
type nonrec input_transformer = {
input_template : transformer_input;
Input template where you specify placeholders that will be filled with the values of the keys from InputPathsMap
to customize the data sent to the target. Enclose each InputPathsMaps
value in brackets: <value>
If InputTemplate
is a JSON object (surrounded by curly braces), the following restrictions apply:
The following example shows the syntax for using InputPathsMap
and InputTemplate
.
"InputTransformer":
{
"InputPathsMap": {"instance": "$.detail.instance","status": "$.detail.status"},
"InputTemplate": " is in state "
}
To have the InputTemplate
include quote marks within a JSON string, escape each quote marks with a slash, as in the following example:
"InputTransformer":
{
"InputPathsMap": {"instance": "$.detail.instance","status": "$.detail.status"},
"InputTemplate": " is in state \"\""
}
The InputTemplate
can also be valid JSON with varibles in quotes or out, as in the following example:
"InputTransformer":
{
"InputPathsMap": {"instance": "$.detail.instance","status": "$.detail.status"},
"InputTemplate": '\{"myInstance": ,"myStatus": " is in state \"\""\}'
}
input_paths_map : transformer_paths option;
Map of JSON paths to be extracted from the event. You can then insert these in the template in InputTemplate
to produce the output you want to be sent to the target.
InputPathsMap
is an array key-value pairs, where each value is a valid JSON path. You can have as many as 100 key-value pairs. You must use JSON dot notation, not bracket notation.
The keys cannot start with "Amazon Web Services."
*)}
Contains the parameters needed for you to provide custom input to a target based on one or more pieces of data extracted from the event.
type nonrec kinesis_parameters = {
partition_key_path : target_partition_key_path;
The JSON path to be extracted from the event and used as the partition key. For more information, see Amazon Kinesis Streams Key Concepts in the Amazon Kinesis Streams Developer Guide.
*)}
This object enables you to specify a JSON path to extract from the event and use as the partition key for the Amazon Kinesis data stream, so that you can control the shard to which the event goes. If you do not include this parameter, the default is to use the eventId
as the partition key.
type nonrec run_command_target_values = run_command_target_value list
type nonrec run_command_target = {
values : run_command_target_values;
If Key
is tag:
tag-key, Values
is a list of tag values. If Key
is InstanceIds
, Values
is a list of Amazon EC2 instance IDs.
key : run_command_target_key;
Can be either tag:
tag-key or InstanceIds
.
}
Information about the EC2 instances that are to be sent the command, specified as key-value pairs. Each RunCommandTarget
block can include only one key, but this key may specify multiple values.
type nonrec run_command_targets = run_command_target list
type nonrec run_command_parameters = {
run_command_targets : run_command_targets;
Currently, we support including only one RunCommandTarget block, which specifies either an array of InstanceIds or a tag.
*)}
This parameter contains the criteria (either InstanceIds or a tag) used to specify which EC2 instances are to be sent the command.
type nonrec string_list = string_ list
type nonrec aws_vpc_configuration = {
assign_public_ip : assign_public_ip option;
Specifies whether the task's elastic network interface receives a public IP address. You can specify ENABLED
only when LaunchType
in EcsParameters
is set to FARGATE
.
security_groups : string_list option;
Specifies the security groups associated with the task. These security groups must all be in the same VPC. You can specify as many as five security groups. If you do not specify a security group, the default security group for the VPC is used.
*)subnets : string_list;
Specifies the subnets associated with the task. These subnets must all be in the same VPC. You can specify as many as 16 subnets.
*)}
This structure specifies the VPC subnets and security groups for the task, and whether a public IP address is to be used. This structure is relevant only for ECS tasks that use the awsvpc
network mode.
type nonrec network_configuration = {
awsvpc_configuration : aws_vpc_configuration option;
Use this structure to specify the VPC subnets and security groups for the task, and whether a public IP address is to be used. This structure is relevant only for ECS tasks that use the awsvpc
network mode.
}
This structure specifies the network configuration for an ECS task.
type nonrec capacity_provider_strategy_item = {
base : capacity_provider_strategy_item_base option;
The base value designates how many tasks, at a minimum, to run on the specified capacity provider. Only one capacity provider in a capacity provider strategy can have a base defined. If no value is specified, the default value of 0 is used.
*)weight : capacity_provider_strategy_item_weight option;
The weight value designates the relative percentage of the total number of tasks launched that should use the specified capacity provider. The weight value is taken into consideration after the base value, if defined, is satisfied.
*)capacity_provider : capacity_provider;
The short name of the capacity provider.
*)}
The details of a capacity provider strategy. To learn more, see CapacityProviderStrategyItem in the Amazon ECS API Reference.
type nonrec capacity_provider_strategy = capacity_provider_strategy_item list
type nonrec placement_constraint = {
expression : placement_constraint_expression option;
A cluster query language expression to apply to the constraint. You cannot specify an expression if the constraint type is distinctInstance
. To learn more, see Cluster Query Language in the Amazon Elastic Container Service Developer Guide.
type_ : placement_constraint_type option;
The type of constraint. Use distinctInstance to ensure that each task in a particular group is running on a different container instance. Use memberOf to restrict the selection to a group of valid candidates.
*)}
An object representing a constraint on task placement. To learn more, see Task Placement Constraints in the Amazon Elastic Container Service Developer Guide.
type nonrec placement_constraints = placement_constraint list
type nonrec placement_strategy = {
field : placement_strategy_field option;
The field to apply the placement strategy against. For the spread placement strategy, valid values are instanceId (or host, which has the same effect), or any platform or custom attribute that is applied to a container instance, such as attribute:ecs.availability-zone. For the binpack placement strategy, valid values are cpu and memory. For the random placement strategy, this field is not used.
*)type_ : placement_strategy_type option;
The type of placement strategy. The random placement strategy randomly places tasks on available candidates. The spread placement strategy spreads placement across available candidates evenly based on the field parameter. The binpack strategy places tasks on available candidates that have the least available amount of the resource that is specified with the field parameter. For example, if you binpack on memory, a task is placed on the instance with the least amount of remaining memory (but still enough to run the task).
*)}
The task placement strategy for a task or service. To learn more, see Task Placement Strategies in the Amazon Elastic Container Service Service Developer Guide.
type nonrec placement_strategies = placement_strategy list
type nonrec tag = {
value : tag_value;
The value for the specified tag key.
*)key : tag_key;
A string you can use to assign a value. The combination of tag keys and values can help you organize and categorize your resources.
*)}
A key-value pair associated with an Amazon Web Services resource. In EventBridge, rules and event buses support tagging.
type nonrec tag_list = tag list
type nonrec ecs_parameters = {
reference_id : reference_id option;
The reference ID to use for the task.
*)placement_strategy : placement_strategies option;
The placement strategy objects to use for the task. You can specify a maximum of five strategy rules per task.
*)placement_constraints : placement_constraints option;
An array of placement constraint objects to use for the task. You can specify up to 10 constraints per task (including constraints in the task definition and those specified at runtime).
*)enable_execute_command : boolean_ option;
Whether or not to enable the execute command functionality for the containers in this task. If true, this enables execute command functionality on all containers in the task.
*)capacity_provider_strategy : capacity_provider_strategy option;
The capacity provider strategy to use for the task.
If a capacityProviderStrategy
is specified, the launchType
parameter must be omitted. If no capacityProviderStrategy
or launchType is specified, the defaultCapacityProviderStrategy
for the cluster is used.
group : string_ option;
Specifies an ECS task group for the task. The maximum length is 255 characters.
*)platform_version : string_ option;
Specifies the platform version for the task. Specify only the numeric portion of the platform version, such as 1.1.0
.
This structure is used only if LaunchType
is FARGATE
. For more information about valid platform versions, see Fargate Platform Versions in the Amazon Elastic Container Service Developer Guide.
network_configuration : network_configuration option;
Use this structure if the Amazon ECS task uses the awsvpc
network mode. This structure specifies the VPC subnets and security groups associated with the task, and whether a public IP address is to be used. This structure is required if LaunchType
is FARGATE
because the awsvpc
mode is required for Fargate tasks.
If you specify NetworkConfiguration
when the target ECS task does not use the awsvpc
network mode, the task fails.
launch_type : launch_type option;
Specifies the launch type on which your task is running. The launch type that you specify here must match one of the launch type (compatibilities) of the target task. The FARGATE
value is supported only in the Regions where Fargate with Amazon ECS is supported. For more information, see Fargate on Amazon ECS in the Amazon Elastic Container Service Developer Guide.
task_count : limit_min1 option;
The number of tasks to create based on TaskDefinition
. The default is 1.
task_definition_arn : arn;
The ARN of the task definition to use if the event target is an Amazon ECS task.
*)}
The custom parameters to be used when the target is an Amazon ECS task.
type nonrec batch_array_properties = {
size : integer option;
The size of the array, if this is an array batch job. Valid values are integers between 2 and 10,000.
*)}
The array properties for the submitted job, such as the size of the array. The array size can be between 2 and 10,000. If you specify array properties for a job, it becomes an array job. This parameter is used only if the target is an Batch job.
type nonrec batch_retry_strategy = {
attempts : integer option;
The number of times to attempt to retry, if the job fails. Valid values are 1–10.
*)}
The retry strategy to use for failed jobs, if the target is an Batch job. If you specify a retry strategy here, it overrides the retry strategy defined in the job definition.
type nonrec batch_parameters = {
retry_strategy : batch_retry_strategy option;
The retry strategy to use for failed jobs, if the target is an Batch job. The retry strategy is the number of times to retry the failed job execution. Valid values are 1–10. When you specify a retry strategy here, it overrides the retry strategy defined in the job definition.
*)array_properties : batch_array_properties option;
The array properties for the submitted job, such as the size of the array. The array size can be between 2 and 10,000. If you specify array properties for a job, it becomes an array job. This parameter is used only if the target is an Batch job.
*)job_name : string_;
The name to use for this execution of the job, if the target is an Batch job.
*)job_definition : string_;
The ARN or name of the job definition to use if the event target is an Batch job. This job definition must already exist.
*)}
The custom parameters to be used when the target is an Batch job.
type nonrec sqs_parameters = {
message_group_id : message_group_id option;
The FIFO message group ID to use as the target.
*)}
This structure includes the custom parameter to be used when the target is an SQS FIFO queue.
type nonrec path_parameter_list = path_parameter list
type nonrec header_parameters_map = (header_key * header_value) list
type nonrec query_string_parameters_map =
(query_string_key * query_string_value) list
type nonrec http_parameters = {
query_string_parameters : query_string_parameters_map option;
The query string keys/values that need to be sent as part of request invoking the API Gateway API or EventBridge ApiDestination.
*)header_parameters : header_parameters_map option;
The headers that need to be sent as part of request invoking the API Gateway API or EventBridge ApiDestination.
*)path_parameter_values : path_parameter_list option;
The path parameter values to be used to populate API Gateway API or EventBridge ApiDestination path wildcards ("*").
*)}
These are custom parameter to be used when the target is an API Gateway APIs or EventBridge ApiDestinations. In the latter case, these are merged with any InvocationParameters specified on the Connection, with any values from the Connection taking precedence.
type nonrec sqls = sql list
type nonrec redshift_data_parameters = {
sqls : sqls option;
One or more SQL statements to run. The SQL statements are run as a single transaction. They run serially in the order of the array. Subsequent SQL statements don't start until the previous statement in the array completes. If any SQL statement fails, then because they are run as one transaction, all work is rolled back.
*)with_event : boolean_ option;
Indicates whether to send an event back to EventBridge after the SQL statement runs.
*)statement_name : statement_name option;
The name of the SQL statement. You can name the SQL statement when you create it to identify the query.
*)sql : sql option;
The SQL statement text to run.
*)db_user : db_user option;
The database user name. Required when authenticating using temporary credentials.
*)database : database;
The name of the database. Required when authenticating using temporary credentials.
*)secret_manager_arn : redshift_secret_manager_arn option;
The name or ARN of the secret that enables access to the database. Required when authenticating using Amazon Web Services Secrets Manager.
*)}
These are custom parameters to be used when the target is a Amazon Redshift cluster to invoke the Amazon Redshift Data API ExecuteStatement based on EventBridge events.
type nonrec sage_maker_pipeline_parameter = {
value : sage_maker_pipeline_parameter_value;
Value of parameter to start execution of a SageMaker AI Model Building Pipeline.
*)name : sage_maker_pipeline_parameter_name;
Name of parameter to start execution of a SageMaker AI Model Building Pipeline.
*)}
Name/Value pair of a parameter to start execution of a SageMaker AI Model Building Pipeline.
type nonrec sage_maker_pipeline_parameter_list =
sage_maker_pipeline_parameter list
type nonrec sage_maker_pipeline_parameters = {
pipeline_parameter_list : sage_maker_pipeline_parameter_list option;
List of Parameter names and values for SageMaker AI Model Building Pipeline execution.
*)}
These are custom parameters to use when the target is a SageMaker AI Model Building Pipeline that starts based on EventBridge events.
type nonrec retry_policy = {
maximum_event_age_in_seconds : maximum_event_age_in_seconds option;
The maximum amount of time, in seconds, to continue to make retry attempts.
*)maximum_retry_attempts : maximum_retry_attempts option;
The maximum number of retry attempts to make before the request fails. Retry attempts continue until either the maximum number of attempts is made or until the duration of the MaximumEventAgeInSeconds
is met.
}
A RetryPolicy
object that includes information about the retry policy settings.
type nonrec app_sync_parameters = {
graph_ql_operation : graph_ql_operation option;
The GraphQL operation; that is, the query, mutation, or subscription to be parsed and executed by the GraphQL service.
For more information, see Operations in the AppSync User Guide.
*)}
Contains the GraphQL operation to be parsed and executed, if the event target is an AppSync API.
type nonrec target = {
app_sync_parameters : app_sync_parameters option;
Contains the GraphQL operation to be parsed and executed, if the event target is an AppSync API.
*)retry_policy : retry_policy option;
The retry policy configuration to use for the dead-letter queue.
*)dead_letter_config : dead_letter_config option;
The DeadLetterConfig
that defines the target queue to send dead-letter queue events to.
sage_maker_pipeline_parameters : sage_maker_pipeline_parameters option;
Contains the SageMaker AI Model Building Pipeline parameters to start execution of a SageMaker AI Model Building Pipeline.
If you specify a SageMaker AI Model Building Pipeline as a target, you can use this to specify parameters to start a pipeline execution based on EventBridge events.
*)redshift_data_parameters : redshift_data_parameters option;
Contains the Amazon Redshift Data API parameters to use when the target is a Amazon Redshift cluster.
If you specify a Amazon Redshift Cluster as a Target, you can use this to specify parameters to invoke the Amazon Redshift Data API ExecuteStatement based on EventBridge events.
*)http_parameters : http_parameters option;
Contains the HTTP parameters to use when the target is a API Gateway endpoint or EventBridge ApiDestination.
If you specify an API Gateway API or EventBridge ApiDestination as a target, you can use this parameter to specify headers, path parameters, and query string keys/values as part of your target invoking request. If you're using ApiDestinations, the corresponding Connection can also have these values configured. In case of any conflicting keys, values from the Connection take precedence.
*)sqs_parameters : sqs_parameters option;
Contains the message group ID to use when the target is a FIFO queue.
If you specify an SQS FIFO queue as a target, the queue must have content-based deduplication enabled.
*)batch_parameters : batch_parameters option;
If the event target is an Batch job, this contains the job definition, job name, and other parameters. For more information, see Jobs in the Batch User Guide.
*)ecs_parameters : ecs_parameters option;
Contains the Amazon ECS task definition and task count to be used, if the event target is an Amazon ECS task. For more information about Amazon ECS tasks, see Task Definitions in the Amazon EC2 Container Service Developer Guide.
*)run_command_parameters : run_command_parameters option;
Parameters used when you are using the rule to invoke Amazon EC2 Run Command.
*)kinesis_parameters : kinesis_parameters option;
The custom parameter you can use to control the shard assignment, when the target is a Kinesis data stream. If you do not include this parameter, the default is to use the eventId
as the partition key.
input_transformer : input_transformer option;
Settings to enable you to provide custom input to a target based on certain event data. You can extract one or more key-value pairs from the event and then use that data to send customized input to the target.
*)input_path : target_input_path option;
The value of the JSONPath that is used for extracting part of the matched event when passing it to the target. You may use JSON dot notation or bracket notation. For more information about JSON paths, see JSONPath.
*)input : target_input option;
Valid JSON text passed to the target. In this case, nothing from the event itself is passed to the target. For more information, see The JavaScript Object Notation (JSON) Data Interchange Format.
*)role_arn : role_arn option;
The Amazon Resource Name (ARN) of the IAM role to be used for this target when the rule is triggered. If one rule triggers multiple targets, you can use a different IAM role for each target.
*)arn : target_arn;
The Amazon Resource Name (ARN) of the target.
*)id : target_id;
The ID of the target within the specified rule. Use this ID to reference the target when updating the rule. We recommend using a memorable and unique string.
*)}
Targets are the resources to be invoked when a rule is triggered. For a complete list of services and resources that can be set as a target, see PutTargets.
If you are setting the event bus of another account as the target, and that account granted permission to your account through an organization instead of directly by the account ID, then you must specify a RoleArn
with proper permissions in the Target
structure. For more information, see Sending and Receiving Events Between Amazon Web Services Accounts in the Amazon EventBridge User Guide.
type nonrec target_list = target list
type nonrec target_id_list = target_id list
type nonrec tag_resource_request = {
resource_ar_n : arn;
The ARN of the EventBridge resource that you're adding tags to.
*)}
type nonrec start_replay_response = {
replay_start_time : timestamp option;
The time at which the replay started.
*)state_reason : replay_state_reason option;
The reason that the replay is in the state.
*)state : replay_state option;
The state of the replay.
*)replay_arn : replay_arn option;
The ARN of the replay.
*)}
type nonrec replay_destination_filters = arn list
type nonrec replay_destination = {
filter_arns : replay_destination_filters option;
A list of ARNs for rules to replay events to.
*)arn : arn;
The ARN of the event bus to replay event to. You can replay events only to the event bus specified to create the archive.
*)}
A ReplayDestination
object that contains details about a replay.
type nonrec start_replay_request = {
destination : replay_destination;
A ReplayDestination
object that includes details about the destination for the replay.
event_end_time : timestamp;
A time stamp for the time to stop replaying events. Only events that occurred between the EventStartTime
and EventEndTime
are replayed.
event_start_time : timestamp;
A time stamp for the time to start replaying events. Only events that occurred between the EventStartTime
and EventEndTime
are replayed.
event_source_arn : archive_arn;
The ARN of the archive to replay events from.
*)description : replay_description option;
A description for the replay to start.
*)replay_name : replay_name;
The name of the replay to start.
*)}
The resource you are trying to create already exists.
type nonrec rule = {
event_bus_name : event_bus_name option;
The name or ARN of the event bus associated with the rule. If you omit this, the default event bus is used.
*)managed_by : managed_by option;
If the rule was created on behalf of your account by an Amazon Web Services service, this field displays the principal name of the service that created the rule.
*)role_arn : role_arn option;
The Amazon Resource Name (ARN) of the role that is used for target invocation.
If you're setting an event bus in another account as the target and that account granted permission to your account through an organization instead of directly by the account ID, you must specify a RoleArn
with proper permissions in the Target
structure, instead of here in this parameter.
schedule_expression : schedule_expression option;
The scheduling expression. For example, "cron(0 20 * * ? *)", "rate(5 minutes)". For more information, see Creating an Amazon EventBridge rule that runs on a schedule.
*)description : rule_description option;
The description of the rule.
*)state : rule_state option;
The state of the rule.
Valid values include:
DISABLED
: The rule is disabled. EventBridge does not match any events against the rule.ENABLED
: The rule is enabled. EventBridge matches events against the rule, except for Amazon Web Services management events delivered through CloudTrail.ENABLED_WITH_ALL_CLOUDTRAIL_MANAGEMENT_EVENTS
: The rule is enabled for all events, including Amazon Web Services management events delivered through CloudTrail.
Management events provide visibility into management operations that are performed on resources in your Amazon Web Services account. These are also known as control plane operations. For more information, see Logging management events in the CloudTrail User Guide, and Filtering management events from Amazon Web Services services in the Amazon EventBridge User Guide.
This value is only valid for rules on the default event bus or custom event buses. It does not apply to partner event buses.
event_pattern : event_pattern option;
The event pattern of the rule. For more information, see Events and Event Patterns in the Amazon EventBridge User Guide.
*)arn : rule_arn option;
The Amazon Resource Name (ARN) of the rule.
*)name : rule_name option;
The name of the rule.
*)}
Contains information about a rule in Amazon EventBridge.
type nonrec rule_response_list = rule list
type nonrec rule_name_list = rule_name list
type nonrec replay = {
replay_end_time : timestamp option;
A time stamp for the time that the replay completed.
*)replay_start_time : timestamp option;
A time stamp for the time that the replay started.
*)event_last_replayed_time : timestamp option;
A time stamp for the time that the last event was replayed.
*)event_end_time : timestamp option;
A time stamp for the time to start replaying events. Any event with a creation time prior to the EventEndTime
specified is replayed.
event_start_time : timestamp option;
A time stamp for the time to start replaying events. This is determined by the time in the event as described in Time.
*)state_reason : replay_state_reason option;
A description of why the replay is in the current state.
*)state : replay_state option;
The current state of the replay.
*)event_source_arn : archive_arn option;
The ARN of the archive to replay event from.
*)replay_name : replay_name option;
The name of the replay.
*)}
A Replay
object that contains details about a replay.
type nonrec replay_list = replay list
type nonrec remove_targets_result_entry = {
error_message : error_message option;
The error message that explains why the target removal failed.
*)error_code : error_code option;
The error code that indicates why the target removal failed. If the value is ConcurrentModificationException
, too many requests were made at the same time.
target_id : target_id option;
The ID of the target.
*)}
Represents a target that failed to be removed from a rule.
type nonrec remove_targets_result_entry_list = remove_targets_result_entry list
type nonrec remove_targets_response = {
failed_entries : remove_targets_result_entry_list option;
The failed target entries.
*)failed_entry_count : integer option;
The number of failed entries.
*)}
type nonrec remove_targets_request = {
force : boolean_ option;
If this is a managed rule, created by an Amazon Web Services service on your behalf, you must specify Force
as True
to remove targets. This parameter is ignored for rules that are not managed rules. You can check whether a rule is a managed rule by using DescribeRule
or ListRules
and checking the ManagedBy
field of the response.
ids : target_id_list;
The IDs of the targets to remove from the rule.
*)event_bus_name : event_bus_name_or_arn option;
The name or ARN of the event bus associated with the rule. If you omit this, the default event bus is used.
*)rule : rule_name;
The name of the rule.
*)}
type nonrec remove_permission_request = {
event_bus_name : non_partner_event_bus_name option;
The name of the event bus to revoke permissions for. If you omit this, the default event bus is used.
*)remove_all_permissions : boolean_ option;
Specifies whether to remove all permissions.
*)statement_id : statement_id option;
The statement ID corresponding to the account that is no longer allowed to put events to the default event bus.
*)}
type nonrec put_targets_result_entry = {
error_message : error_message option;
The error message that explains why the target addition failed.
*)error_code : error_code option;
The error code that indicates why the target addition failed. If the value is ConcurrentModificationException
, too many requests were made at the same time.
target_id : target_id option;
The ID of the target.
*)}
Represents a target that failed to be added to a rule.
type nonrec put_targets_result_entry_list = put_targets_result_entry list
type nonrec put_targets_response = {
failed_entries : put_targets_result_entry_list option;
The failed target entries.
*)failed_entry_count : integer option;
The number of failed entries.
*)}
type nonrec put_targets_request = {
targets : target_list;
The targets to update or add to the rule.
*)event_bus_name : event_bus_name_or_arn option;
The name or ARN of the event bus associated with the rule. If you omit this, the default event bus is used.
*)rule : rule_name;
The name of the rule.
*)}
type nonrec put_rule_response = {
rule_arn : rule_arn option;
The Amazon Resource Name (ARN) of the rule.
*)}
type nonrec put_rule_request = {
event_bus_name : event_bus_name_or_arn option;
The name or ARN of the event bus to associate with this rule. If you omit this, the default event bus is used.
*)role_arn : role_arn option;
The Amazon Resource Name (ARN) of the IAM role associated with the rule.
If you're setting an event bus in another account as the target and that account granted permission to your account through an organization instead of directly by the account ID, you must specify a RoleArn
with proper permissions in the Target
structure, instead of here in this parameter.
description : rule_description option;
A description of the rule.
*)state : rule_state option;
The state of the rule.
Valid values include:
DISABLED
: The rule is disabled. EventBridge does not match any events against the rule.ENABLED
: The rule is enabled. EventBridge matches events against the rule, except for Amazon Web Services management events delivered through CloudTrail.ENABLED_WITH_ALL_CLOUDTRAIL_MANAGEMENT_EVENTS
: The rule is enabled for all events, including Amazon Web Services management events delivered through CloudTrail.
Management events provide visibility into management operations that are performed on resources in your Amazon Web Services account. These are also known as control plane operations. For more information, see Logging management events in the CloudTrail User Guide, and Filtering management events from Amazon Web Services services in the Amazon EventBridge User Guide.
This value is only valid for rules on the default event bus or custom event buses. It does not apply to partner event buses.
event_pattern : event_pattern option;
The event pattern. For more information, see Amazon EventBridge event patterns in the Amazon EventBridge User Guide.
*)schedule_expression : schedule_expression option;
The scheduling expression. For example, "cron(0 20 * * ? *)" or "rate(5 minutes)".
*)name : rule_name;
The name of the rule that you are creating or updating.
*)}
type nonrec condition = {
value : string_;
Specifies the value for the key. Currently, this must be the ID of the organization.
*)key : string_;
Specifies the key for the condition. Currently the only supported key is aws:PrincipalOrgID
.
type_ : string_;
Specifies the type of condition. Currently the only supported value is StringEquals
.
}
A JSON string which you can use to limit the event bus permissions you are granting to only accounts that fulfill the condition. Currently, the only supported condition is membership in a certain Amazon Web Services organization. The string must contain Type
, Key
, and Value
fields. The Value
field specifies the ID of the Amazon Web Services organization. Following is an example value for Condition
:
'{"Type" : "StringEquals", "Key": "aws:PrincipalOrgID", "Value": "o-1234567890"}'
type nonrec put_permission_request = {
policy : string_ option;
A JSON string that describes the permission policy statement. You can include a Policy
parameter in the request instead of using the StatementId
, Action
, Principal
, or Condition
parameters.
condition : condition option;
This parameter enables you to limit the permission to accounts that fulfill a certain condition, such as being a member of a certain Amazon Web Services organization. For more information about Amazon Web Services Organizations, see What Is Amazon Web Services Organizations in the Amazon Web Services Organizations User Guide.
If you specify Condition
with an Amazon Web Services organization ID, and specify "*" as the value for Principal
, you grant permission to all the accounts in the named organization.
The Condition
is a JSON string which must contain Type
, Key
, and Value
fields.
statement_id : statement_id option;
An identifier string for the external account that you are granting permissions to. If you later want to revoke the permission for this external account, specify this StatementId
when you run RemovePermission.
Each StatementId
must be unique.
principal : principal option;
The 12-digit Amazon Web Services account ID that you are permitting to put events to your default event bus. Specify "*" to permit any account to put events to your default event bus.
If you specify "*" without specifying Condition
, avoid creating rules that may match undesirable events. To create more secure rules, make sure that the event pattern for each rule contains an account
field with a specific account ID from which to receive events. Rules with an account field do not match any events sent from other accounts.
action : action option;
The action that you are enabling the other account to perform.
*)event_bus_name : non_partner_event_bus_name option;
The name of the event bus associated with the rule. If you omit this, the default event bus is used.
*)}
The event bus policy is too long. For more information, see the limits.
type nonrec put_partner_events_result_entry = {
error_message : error_message option;
The error message that explains why the event submission failed.
*)error_code : error_code option;
The error code that indicates why the event submission failed.
*)event_id : event_id option;
The ID of the event.
*)}
The result of an event entry the partner submitted in this request. If the event was successfully submitted, the entry has the event ID in it. Otherwise, you can use the error code and error message to identify the problem with the entry.
type nonrec put_partner_events_result_entry_list =
put_partner_events_result_entry list
type nonrec put_partner_events_response = {
entries : put_partner_events_result_entry_list option;
The results for each event entry the partner submitted in this request. If the event was successfully submitted, the entry has the event ID in it. Otherwise, you can use the error code and error message to identify the problem with the entry.
For each record, the index of the response element is the same as the index in the request array.
*)failed_entry_count : integer option;
The number of events from this operation that could not be written to the partner event bus.
*)}
type nonrec event_resource_list = event_resource list
type nonrec put_partner_events_request_entry = {
detail : string_ option;
A valid JSON string. There is no other schema imposed. The JSON string may contain fields and nested sub-objects.
Detail
, DetailType
, and Source
are required for EventBridge to successfully send an event to an event bus. If you include event entries in a request that do not include each of those properties, EventBridge fails that entry. If you submit a request in which none of the entries have each of these properties, EventBridge fails the entire request.
detail_type : string_ option;
A free-form string, with a maximum of 128 characters, used to decide what fields to expect in the event detail.
Detail
, DetailType
, and Source
are required for EventBridge to successfully send an event to an event bus. If you include event entries in a request that do not include each of those properties, EventBridge fails that entry. If you submit a request in which none of the entries have each of these properties, EventBridge fails the entire request.
resources : event_resource_list option;
Amazon Web Services resources, identified by Amazon Resource Name (ARN), which the event primarily concerns. Any number, including zero, may be present.
*)source : event_source_name option;
The event source that is generating the entry.
Detail
, DetailType
, and Source
are required for EventBridge to successfully send an event to an event bus. If you include event entries in a request that do not include each of those properties, EventBridge fails that entry. If you submit a request in which none of the entries have each of these properties, EventBridge fails the entire request.
time : event_time option;
The date and time of the event.
*)}
The details about an event generated by an SaaS partner.
type nonrec put_partner_events_request_entry_list =
put_partner_events_request_entry list
type nonrec put_partner_events_request = {
entries : put_partner_events_request_entry_list;
The list of events to write to the event bus.
*)}
type nonrec put_events_result_entry = {
error_message : error_message option;
The error message that explains why the event submission failed.
*)error_code : error_code option;
The error code that indicates why the event submission failed.
Retryable errors include:
{{:https://docs.aws.amazon.com/eventbridge/latest/APIReference/CommonErrors.html}InternalFailure}
The request processing has failed because of an unknown error, exception or failure.
{{:https://docs.aws.amazon.com/eventbridge/latest/APIReference/CommonErrors.html}ThrottlingException}
The request was denied due to request throttling.
Non-retryable errors include:
{{:https://docs.aws.amazon.com/eventbridge/latest/APIReference/CommonErrors.html}AccessDeniedException}
You do not have sufficient access to perform this action.
InvalidAccountIdException
The account ID provided is not valid.
InvalidArgument
A specified parameter is not valid.
MalformedDetail
The JSON provided is not valid.
RedactionFailure
Redacting the CloudTrail event failed.
NotAuthorizedForSourceException
You do not have permissions to publish events with this source onto this event bus.
NotAuthorizedForDetailTypeException
You do not have permissions to publish events with this detail type onto this event bus.
event_id : event_id option;
The ID of the event.
*)}
Represents the results of an event submitted to an event bus.
If the submission was successful, the entry has the event ID in it. Otherwise, you can use the error code and error message to identify the problem with the entry.
For information about the errors that are common to all actions, see Common Errors.
type nonrec put_events_result_entry_list = put_events_result_entry list
type nonrec put_events_response = {
entries : put_events_result_entry_list option;
The successfully and unsuccessfully ingested events results. If the ingestion was successful, the entry has the event ID in it. Otherwise, you can use the error code and error message to identify the problem with the entry.
For each record, the index of the response element is the same as the index in the request array.
*)failed_entry_count : integer option;
The number of failed entries.
*)}
type nonrec put_events_request_entry = {
trace_header : trace_header option;
An X-Ray trace header, which is an http header (X-Amzn-Trace-Id) that contains the trace-id associated with the event.
To learn more about X-Ray trace headers, see Tracing header in the X-Ray Developer Guide.
*)event_bus_name : non_partner_event_bus_name_or_arn option;
The name or ARN of the event bus to receive the event. Only the rules that are associated with this event bus are used to match the event. If you omit this, the default event bus is used.
If you're using a global endpoint with a custom bus, you can enter either the name or Amazon Resource Name (ARN) of the event bus in either the primary or secondary Region here. EventBridge then determines the corresponding event bus in the other Region based on the endpoint referenced by the EndpointId
. Specifying the event bus ARN is preferred.
detail : string_ option;
A valid JSON object. There is no other schema imposed. The JSON object may contain fields and nested sub-objects.
Detail
, DetailType
, and Source
are required for EventBridge to successfully send an event to an event bus. If you include event entries in a request that do not include each of those properties, EventBridge fails that entry. If you submit a request in which none of the entries have each of these properties, EventBridge fails the entire request.
detail_type : string_ option;
Free-form string, with a maximum of 128 characters, used to decide what fields to expect in the event detail.
Detail
, DetailType
, and Source
are required for EventBridge to successfully send an event to an event bus. If you include event entries in a request that do not include each of those properties, EventBridge fails that entry. If you submit a request in which none of the entries have each of these properties, EventBridge fails the entire request.
resources : event_resource_list option;
Amazon Web Services resources, identified by Amazon Resource Name (ARN), which the event primarily concerns. Any number, including zero, may be present.
*)source : string_ option;
The source of the event.
Detail
, DetailType
, and Source
are required for EventBridge to successfully send an event to an event bus. If you include event entries in a request that do not include each of those properties, EventBridge fails that entry. If you submit a request in which none of the entries have each of these properties, EventBridge fails the entire request.
time : event_time option;
}
Represents an event to be submitted.
type nonrec put_events_request_entry_list = put_events_request_entry list
type nonrec put_events_request = {
endpoint_id : endpoint_id option;
The URL subdomain of the endpoint. For example, if the URL for Endpoint is https://abcde.veo.endpoints.event.amazonaws.com, then the EndpointId is abcde.veo
.
When using Java, you must include auth-crt
on the class path.
entries : put_events_request_entry_list;
The entry that defines an event in your system. You can specify several parameters for the entry such as the source and type of the event, resources associated with the event, and so on.
*)}
type nonrec partner_event_source = {
name : string_ option;
The name of the partner event source.
*)arn : string_ option;
The ARN of the partner event source.
*)}
A partner event source is created by an SaaS partner. If a customer creates a partner event bus that matches this event source, that Amazon Web Services account can receive events from the partner's applications or services.
type nonrec partner_event_source_list = partner_event_source list
type nonrec partner_event_source_account = {
state : event_source_state option;
The state of the event source. If it is ACTIVE, you have already created a matching event bus for this event source, and that event bus is active. If it is PENDING, either you haven't yet created a matching event bus, or that event bus is deactivated. If it is DELETED, you have created a matching event bus, but the event source has since been deleted.
*)expiration_time : timestamp option;
The date and time that the event source will expire, if the Amazon Web Services account doesn't create a matching event bus for it.
*)creation_time : timestamp option;
The date and time the event source was created.
*)account : account_id option;
The Amazon Web Services account ID that the partner event source was offered to.
*)}
The Amazon Web Services account that a partner event source has been offered to.
type nonrec partner_event_source_account_list =
partner_event_source_account list
type nonrec list_targets_by_rule_response = {
next_token : next_token option;
A token indicating there are more results available. If there are no more results, no token is included in the response.
The value of nextToken
is a unique pagination token for each page. To retrieve the next page of results, make the call again using the returned token. Keep all other arguments unchanged.
Using an expired pagination token results in an HTTP 400 InvalidToken
error.
targets : target_list option;
The targets assigned to the rule.
*)}
type nonrec list_targets_by_rule_request = {
limit : limit_max100 option;
The maximum number of results to return.
*)next_token : next_token option;
The token returned by a previous call, which you can use to retrieve the next set of results.
The value of nextToken
is a unique pagination token for each page. To retrieve the next page of results, make the call again using the returned token. Keep all other arguments unchanged.
Using an expired pagination token results in an HTTP 400 InvalidToken
error.
event_bus_name : event_bus_name_or_arn option;
The name or ARN of the event bus associated with the rule. If you omit this, the default event bus is used.
*)rule : rule_name;
The name of the rule.
*)}
type nonrec list_rules_response = {
next_token : next_token option;
A token indicating there are more results available. If there are no more results, no token is included in the response.
The value of nextToken
is a unique pagination token for each page. To retrieve the next page of results, make the call again using the returned token. Keep all other arguments unchanged.
Using an expired pagination token results in an HTTP 400 InvalidToken
error.
rules : rule_response_list option;
The rules that match the specified criteria.
*)}
type nonrec list_rules_request = {
limit : limit_max100 option;
The maximum number of results to return.
*)next_token : next_token option;
The token returned by a previous call, which you can use to retrieve the next set of results.
The value of nextToken
is a unique pagination token for each page. To retrieve the next page of results, make the call again using the returned token. Keep all other arguments unchanged.
Using an expired pagination token results in an HTTP 400 InvalidToken
error.
event_bus_name : event_bus_name_or_arn option;
The name or ARN of the event bus to list the rules for. If you omit this, the default event bus is used.
*)name_prefix : rule_name option;
The prefix matching the rule name.
*)}
type nonrec list_rule_names_by_target_response = {
next_token : next_token option;
A token indicating there are more results available. If there are no more results, no token is included in the response.
The value of nextToken
is a unique pagination token for each page. To retrieve the next page of results, make the call again using the returned token. Keep all other arguments unchanged.
Using an expired pagination token results in an HTTP 400 InvalidToken
error.
rule_names : rule_name_list option;
The names of the rules that can invoke the given target.
*)}
type nonrec list_rule_names_by_target_request = {
limit : limit_max100 option;
The maximum number of results to return.
*)next_token : next_token option;
The token returned by a previous call, which you can use to retrieve the next set of results.
The value of nextToken
is a unique pagination token for each page. To retrieve the next page of results, make the call again using the returned token. Keep all other arguments unchanged.
Using an expired pagination token results in an HTTP 400 InvalidToken
error.
event_bus_name : event_bus_name_or_arn option;
The name or ARN of the event bus to list rules for. If you omit this, the default event bus is used.
*)target_arn : target_arn;
The Amazon Resource Name (ARN) of the target resource.
*)}
type nonrec list_replays_response = {
next_token : next_token option;
A token indicating there are more results available. If there are no more results, no token is included in the response.
The value of nextToken
is a unique pagination token for each page. To retrieve the next page of results, make the call again using the returned token. Keep all other arguments unchanged.
Using an expired pagination token results in an HTTP 400 InvalidToken
error.
replays : replay_list option;
An array of Replay
objects that contain information about the replay.
}
type nonrec list_replays_request = {
limit : limit_max100 option;
The maximum number of replays to retrieve.
*)next_token : next_token option;
The token returned by a previous call, which you can use to retrieve the next set of results.
The value of nextToken
is a unique pagination token for each page. To retrieve the next page of results, make the call again using the returned token. Keep all other arguments unchanged.
Using an expired pagination token results in an HTTP 400 InvalidToken
error.
event_source_arn : archive_arn option;
The ARN of the archive from which the events are replayed.
*)state : replay_state option;
The state of the replay.
*)name_prefix : replay_name option;
A name prefix to filter the replays returned. Only replays with name that match the prefix are returned.
*)}
type nonrec list_partner_event_sources_response = {
next_token : next_token option;
A token indicating there are more results available. If there are no more results, no token is included in the response.
The value of nextToken
is a unique pagination token for each page. To retrieve the next page of results, make the call again using the returned token. Keep all other arguments unchanged.
Using an expired pagination token results in an HTTP 400 InvalidToken
error.
partner_event_sources : partner_event_source_list option;
The list of partner event sources returned by the operation.
*)}
type nonrec list_partner_event_sources_request = {
limit : limit_max100 option;
pecifying this limits the number of results returned by this operation. The operation also returns a NextToken which you can use in a subsequent operation to retrieve the next set of results.
*)next_token : next_token option;
The token returned by a previous call, which you can use to retrieve the next set of results.
The value of nextToken
is a unique pagination token for each page. To retrieve the next page of results, make the call again using the returned token. Keep all other arguments unchanged.
Using an expired pagination token results in an HTTP 400 InvalidToken
error.
name_prefix : partner_event_source_name_prefix;
If you specify this, the results are limited to only those partner event sources that start with the string you specify.
*)}
type nonrec list_partner_event_source_accounts_response = {
next_token : next_token option;
A token indicating there are more results available. If there are no more results, no token is included in the response.
The value of nextToken
is a unique pagination token for each page. To retrieve the next page of results, make the call again using the returned token. Keep all other arguments unchanged.
Using an expired pagination token results in an HTTP 400 InvalidToken
error.
partner_event_source_accounts : partner_event_source_account_list option;
The list of partner event sources returned by the operation.
*)}
type nonrec list_partner_event_source_accounts_request = {
limit : limit_max100 option;
Specifying this limits the number of results returned by this operation. The operation also returns a NextToken which you can use in a subsequent operation to retrieve the next set of results.
*)next_token : next_token option;
The token returned by a previous call, which you can use to retrieve the next set of results.
The value of nextToken
is a unique pagination token for each page. To retrieve the next page of results, make the call again using the returned token. Keep all other arguments unchanged.
Using an expired pagination token results in an HTTP 400 InvalidToken
error.
event_source_name : event_source_name;
The name of the partner event source to display account information about.
*)}
type nonrec event_source = {
state : event_source_state option;
The state of the event source. If it is ACTIVE, you have already created a matching event bus for this event source, and that event bus is active. If it is PENDING, either you haven't yet created a matching event bus, or that event bus is deactivated. If it is DELETED, you have created a matching event bus, but the event source has since been deleted.
*)name : string_ option;
The name of the event source.
*)expiration_time : timestamp option;
The date and time that the event source will expire, if the Amazon Web Services account doesn't create a matching event bus for it.
*)creation_time : timestamp option;
The date and time the event source was created.
*)created_by : string_ option;
The name of the partner that created the event source.
*)arn : string_ option;
The ARN of the event source.
*)}
A partner event source is created by an SaaS partner. If a customer creates a partner event bus that matches this event source, that Amazon Web Services account can receive events from the partner's applications or services.
type nonrec event_source_list = event_source list
type nonrec list_event_sources_response = {
next_token : next_token option;
A token indicating there are more results available. If there are no more results, no token is included in the response.
The value of nextToken
is a unique pagination token for each page. To retrieve the next page of results, make the call again using the returned token. Keep all other arguments unchanged.
Using an expired pagination token results in an HTTP 400 InvalidToken
error.
event_sources : event_source_list option;
The list of event sources.
*)}
type nonrec list_event_sources_request = {
limit : limit_max100 option;
Specifying this limits the number of results returned by this operation. The operation also returns a NextToken which you can use in a subsequent operation to retrieve the next set of results.
*)next_token : next_token option;
The token returned by a previous call, which you can use to retrieve the next set of results.
The value of nextToken
is a unique pagination token for each page. To retrieve the next page of results, make the call again using the returned token. Keep all other arguments unchanged.
Using an expired pagination token results in an HTTP 400 InvalidToken
error.
name_prefix : event_source_name_prefix option;
Specifying this limits the results to only those partner event sources with names that start with the specified prefix.
*)}
type nonrec event_bus = {
last_modified_time : timestamp option;
The time the event bus was last modified.
*)creation_time : timestamp option;
The time the event bus was created.
*)policy : string_ option;
The permissions policy of the event bus, describing which other Amazon Web Services accounts can write events to this event bus.
*)description : event_bus_description option;
The event bus description.
*)arn : string_ option;
The ARN of the event bus.
*)name : string_ option;
The name of the event bus.
*)}
An event bus receives events from a source, uses rules to evaluate them, applies any configured input transformation, and routes them to the appropriate target(s). Your account's default event bus receives events from Amazon Web Services services. A custom event bus can receive events from your custom applications and services. A partner event bus receives events from an event source created by an SaaS partner. These events come from the partners services or applications.
type nonrec event_bus_list = event_bus list
type nonrec list_event_buses_response = {
next_token : next_token option;
A token indicating there are more results available. If there are no more results, no token is included in the response.
The value of nextToken
is a unique pagination token for each page. To retrieve the next page of results, make the call again using the returned token. Keep all other arguments unchanged.
Using an expired pagination token results in an HTTP 400 InvalidToken
error.
event_buses : event_bus_list option;
This list of event buses.
*)}
type nonrec list_event_buses_request = {
limit : limit_max100 option;
Specifying this limits the number of results returned by this operation. The operation also returns a NextToken which you can use in a subsequent operation to retrieve the next set of results.
*)next_token : next_token option;
The token returned by a previous call, which you can use to retrieve the next set of results.
The value of nextToken
is a unique pagination token for each page. To retrieve the next page of results, make the call again using the returned token. Keep all other arguments unchanged.
Using an expired pagination token results in an HTTP 400 InvalidToken
error.
name_prefix : event_bus_name option;
Specifying this limits the results to only those event buses with names that start with the specified prefix.
*)}
type nonrec endpoint = {
last_modified_time : timestamp option;
The last time the endpoint was modified.
*)creation_time : timestamp option;
The time the endpoint was created.
*)state_reason : endpoint_state_reason option;
The reason the endpoint is in its current state.
*)state : endpoint_state option;
The current state of the endpoint.
*)endpoint_url : endpoint_url option;
The URL of the endpoint.
*)endpoint_id : endpoint_id option;
The URL subdomain of the endpoint. For example, if the URL for Endpoint is https://abcde.veo.endpoints.event.amazonaws.com, then the EndpointId is abcde.veo
.
role_arn : iam_role_arn option;
The ARN of the role used by event replication for the endpoint.
*)event_buses : endpoint_event_bus_list option;
The event buses being used by the endpoint.
*)replication_config : replication_config option;
Whether event replication was enabled or disabled for this endpoint. The default state is ENABLED
which means you must supply a RoleArn
. If you don't have a RoleArn
or you don't want event replication enabled, set the state to DISABLED
.
routing_config : routing_config option;
The routing configuration of the endpoint.
*)arn : endpoint_arn option;
The ARN of the endpoint.
*)description : endpoint_description option;
A description for the endpoint.
*)name : endpoint_name option;
The name of the endpoint.
*)}
A global endpoint used to improve your application's availability by making it regional-fault tolerant. For more information about global endpoints, see Making applications Regional-fault tolerant with global endpoints and event replication in the Amazon EventBridge User Guide.
type nonrec endpoint_list = endpoint list
type nonrec list_endpoints_response = {
next_token : next_token option;
A token indicating there are more results available. If there are no more results, no token is included in the response.
The value of nextToken
is a unique pagination token for each page. To retrieve the next page of results, make the call again using the returned token. Keep all other arguments unchanged.
Using an expired pagination token results in an HTTP 400 InvalidToken
error.
endpoints : endpoint_list option;
The endpoints returned by the call.
*)}
type nonrec list_endpoints_request = {
max_results : limit_max100 option;
The maximum number of results returned by the call.
*)next_token : next_token option;
The token returned by a previous call, which you can use to retrieve the next set of results.
The value of nextToken
is a unique pagination token for each page. To retrieve the next page of results, make the call again using the returned token. Keep all other arguments unchanged.
Using an expired pagination token results in an HTTP 400 InvalidToken
error.
home_region : home_region option;
The primary Region of the endpoints associated with this account. For example "HomeRegion": "us-east-1"
.
name_prefix : endpoint_name option;
A value that will return a subset of the endpoints associated with this account. For example, "NamePrefix": "ABC"
will return all endpoints with "ABC" in the name.
}
type nonrec connection = {
last_modified_time : timestamp option;
A time stamp for the time that the connection was last modified.
*)creation_time : timestamp option;
A time stamp for the time that the connection was created.
*)state_reason : connection_state_reason option;
The reason that the connection is in the connection state.
*)connection_state : connection_state option;
The state of the connection.
*)name : connection_name option;
The name of the connection.
*)connection_arn : connection_arn option;
The ARN of the connection.
*)}
Contains information about a connection.
type nonrec connection_response_list = connection list
type nonrec list_connections_response = {
next_token : next_token option;
A token indicating there are more results available. If there are no more results, no token is included in the response.
The value of nextToken
is a unique pagination token for each page. To retrieve the next page of results, make the call again using the returned token. Keep all other arguments unchanged.
Using an expired pagination token results in an HTTP 400 InvalidToken
error.
connections : connection_response_list option;
An array of connections objects that include details about the connections.
*)}
type nonrec list_connections_request = {
limit : limit_max100 option;
The maximum number of connections to return.
*)next_token : next_token option;
The token returned by a previous call, which you can use to retrieve the next set of results.
The value of nextToken
is a unique pagination token for each page. To retrieve the next page of results, make the call again using the returned token. Keep all other arguments unchanged.
Using an expired pagination token results in an HTTP 400 InvalidToken
error.
connection_state : connection_state option;
The state of the connection.
*)name_prefix : connection_name option;
A name prefix to filter results returned. Only connections with a name that starts with the prefix are returned.
*)}
type nonrec archive = {
creation_time : timestamp option;
The time stamp for the time that the archive was created.
*)event_count : long option;
The number of events in the archive.
*)size_bytes : long option;
The size of the archive, in bytes.
*)retention_days : retention_days option;
The number of days to retain events in the archive before they are deleted.
*)state_reason : archive_state_reason option;
A description for the reason that the archive is in the current state.
*)state : archive_state option;
The current state of the archive.
*)event_source_arn : event_bus_arn option;
The ARN of the event bus associated with the archive. Only events from this event bus are sent to the archive.
*)archive_name : archive_name option;
The name of the archive.
*)}
An Archive
object that contains details about an archive.
type nonrec archive_response_list = archive list
type nonrec list_archives_response = {
next_token : next_token option;
A token indicating there are more results available. If there are no more results, no token is included in the response.
The value of nextToken
is a unique pagination token for each page. To retrieve the next page of results, make the call again using the returned token. Keep all other arguments unchanged.
Using an expired pagination token results in an HTTP 400 InvalidToken
error.
archives : archive_response_list option;
An array of Archive
objects that include details about an archive.
}
type nonrec list_archives_request = {
limit : limit_max100 option;
The maximum number of results to return.
*)next_token : next_token option;
The token returned by a previous call, which you can use to retrieve the next set of results.
The value of nextToken
is a unique pagination token for each page. To retrieve the next page of results, make the call again using the returned token. Keep all other arguments unchanged.
Using an expired pagination token results in an HTTP 400 InvalidToken
error.
state : archive_state option;
The state of the archive.
*)event_source_arn : event_bus_arn option;
The ARN of the event source associated with the archive.
*)name_prefix : archive_name option;
A name prefix to filter the archives returned. Only archives with name that match the prefix are returned.
*)}
type nonrec api_destination = {
last_modified_time : timestamp option;
A time stamp for the time that the API destination was last modified.
*)creation_time : timestamp option;
A time stamp for the time that the API destination was created.
*)invocation_rate_limit_per_second : api_destination_invocation_rate_limit_per_second
option;
The maximum number of invocations per second to send to the HTTP endpoint.
*)http_method : api_destination_http_method option;
The method to use to connect to the HTTP endpoint.
*)invocation_endpoint : https_endpoint option;
The URL to the endpoint for the API destination.
*)connection_arn : connection_arn option;
The ARN of the connection specified for the API destination.
*)api_destination_state : api_destination_state option;
The state of the API destination.
*)name : api_destination_name option;
The name of the API destination.
*)api_destination_arn : api_destination_arn option;
The ARN of the API destination.
*)}
Contains details about an API destination.
type nonrec api_destination_response_list = api_destination list
type nonrec list_api_destinations_response = {
next_token : next_token option;
A token indicating there are more results available. If there are no more results, no token is included in the response.
The value of nextToken
is a unique pagination token for each page. To retrieve the next page of results, make the call again using the returned token. Keep all other arguments unchanged.
Using an expired pagination token results in an HTTP 400 InvalidToken
error.
api_destinations : api_destination_response_list option;
An array that includes information about each API destination.
*)}
type nonrec list_api_destinations_request = {
limit : limit_max100 option;
The maximum number of API destinations to include in the response.
*)next_token : next_token option;
The token returned by a previous call, which you can use to retrieve the next set of results.
The value of nextToken
is a unique pagination token for each page. To retrieve the next page of results, make the call again using the returned token. Keep all other arguments unchanged.
Using an expired pagination token results in an HTTP 400 InvalidToken
error.
connection_arn : connection_arn option;
The ARN of the connection specified for the API destination.
*)name_prefix : api_destination_name option;
A name prefix to filter results returned. Only API destinations with a name that starts with the prefix are returned.
*)}
The specified state is not a valid state for an event source.
An error occurred because a replay can be canceled only when the state is Running or Starting.
type nonrec enable_rule_request = {
event_bus_name : event_bus_name_or_arn option;
The name or ARN of the event bus associated with the rule. If you omit this, the default event bus is used.
*)name : rule_name;
The name of the rule.
*)}
type nonrec disable_rule_request = {
event_bus_name : event_bus_name_or_arn option;
The name or ARN of the event bus associated with the rule. If you omit this, the default event bus is used.
*)name : rule_name;
The name of the rule.
*)}
type nonrec describe_rule_response = {
created_by : created_by option;
The account ID of the user that created the rule. If you use PutRule
to put a rule on an event bus in another account, the other account is the owner of the rule, and the rule ARN includes the account ID for that account. However, the value for CreatedBy
is the account ID as the account that created the rule in the other account.
event_bus_name : event_bus_name option;
The name of the event bus associated with the rule.
*)managed_by : managed_by option;
If this is a managed rule, created by an Amazon Web Services service on your behalf, this field displays the principal name of the Amazon Web Services service that created the rule.
*)role_arn : role_arn option;
The Amazon Resource Name (ARN) of the IAM role associated with the rule.
*)description : rule_description option;
The description of the rule.
*)state : rule_state option;
Specifies whether the rule is enabled or disabled.
*)schedule_expression : schedule_expression option;
The scheduling expression. For example, "cron(0 20 * * ? *)", "rate(5 minutes)".
*)event_pattern : event_pattern option;
The event pattern. For more information, see Events and Event Patterns in the Amazon EventBridge User Guide.
*)arn : rule_arn option;
The Amazon Resource Name (ARN) of the rule.
*)name : rule_name option;
The name of the rule.
*)}
type nonrec describe_rule_request = {
event_bus_name : event_bus_name_or_arn option;
The name or ARN of the event bus associated with the rule. If you omit this, the default event bus is used.
*)name : rule_name;
The name of the rule.
*)}
type nonrec describe_replay_response = {
replay_end_time : timestamp option;
A time stamp for the time that the replay stopped.
*)replay_start_time : timestamp option;
A time stamp for the time that the replay started.
*)event_last_replayed_time : timestamp option;
The time that the event was last replayed.
*)event_end_time : timestamp option;
The time stamp for the last event that was replayed from the archive.
*)event_start_time : timestamp option;
The time stamp of the first event that was last replayed from the archive.
*)destination : replay_destination option;
A ReplayDestination
object that contains details about the replay.
event_source_arn : archive_arn option;
The ARN of the archive events were replayed from.
*)state_reason : replay_state_reason option;
The reason that the replay is in the current state.
*)state : replay_state option;
The current state of the replay.
*)description : replay_description option;
The description of the replay.
*)replay_arn : replay_arn option;
The ARN of the replay.
*)replay_name : replay_name option;
The name of the replay.
*)}
type nonrec describe_replay_request = {
replay_name : replay_name;
The name of the replay to retrieve.
*)}
type nonrec describe_partner_event_source_request = {
name : event_source_name;
The name of the event source to display.
*)}
type nonrec describe_event_source_response = {
state : event_source_state option;
The state of the event source. If it is ACTIVE, you have already created a matching event bus for this event source, and that event bus is active. If it is PENDING, either you haven't yet created a matching event bus, or that event bus is deactivated. If it is DELETED, you have created a matching event bus, but the event source has since been deleted.
*)name : string_ option;
The name of the partner event source.
*)expiration_time : timestamp option;
The date and time that the event source will expire if you do not create a matching event bus.
*)creation_time : timestamp option;
The date and time that the event source was created.
*)created_by : string_ option;
The name of the SaaS partner that created the event source.
*)arn : string_ option;
The ARN of the partner event source.
*)}
type nonrec describe_event_source_request = {
name : event_source_name;
The name of the partner event source to display the details of.
*)}
type nonrec describe_event_bus_response = {
last_modified_time : timestamp option;
The time the event bus was last modified.
*)creation_time : timestamp option;
The time the event bus was created.
*)policy : string_ option;
The policy that enables the external account to send events to your account.
*)dead_letter_config : dead_letter_config option;
kms_key_identifier : kms_key_identifier option;
The identifier of the KMS customer managed key for EventBridge to use to encrypt events on this event bus, if one has been specified.
For more information, see Data encryption in EventBridge in the Amazon EventBridge User Guide.
*)description : event_bus_description option;
The event bus description.
*)arn : string_ option;
The Amazon Resource Name (ARN) of the account permitted to write events to the current account.
*)name : string_ option;
The name of the event bus. Currently, this is always default
.
}
type nonrec describe_event_bus_request = {
name : event_bus_name_or_arn option;
The name or ARN of the event bus to show details for. If you omit this, the default event bus is displayed.
*)}
type nonrec describe_endpoint_response = {
last_modified_time : timestamp option;
The last time the endpoint you asked for information about was modified.
*)creation_time : timestamp option;
The time the endpoint you asked for information about was created.
*)state_reason : endpoint_state_reason option;
The reason the endpoint you asked for information about is in its current state.
*)state : endpoint_state option;
The current state of the endpoint you asked for information about.
*)endpoint_url : endpoint_url option;
The URL of the endpoint you asked for information about.
*)endpoint_id : endpoint_id option;
The ID of the endpoint you asked for information about.
*)role_arn : iam_role_arn option;
The ARN of the role used by the endpoint you asked for information about.
*)event_buses : endpoint_event_bus_list option;
The event buses being used by the endpoint you asked for information about.
*)replication_config : replication_config option;
Whether replication is enabled or disabled for the endpoint you asked for information about.
*)routing_config : routing_config option;
The routing configuration of the endpoint you asked for information about.
*)arn : endpoint_arn option;
The ARN of the endpoint you asked for information about.
*)description : endpoint_description option;
The description of the endpoint you asked for information about.
*)name : endpoint_name option;
The name of the endpoint you asked for information about.
*)}
type nonrec describe_endpoint_request = {
home_region : home_region option;
The primary Region of the endpoint you want to get information about. For example "HomeRegion": "us-east-1"
.
name : endpoint_name;
The name of the endpoint you want to get information about. For example, "Name":"us-east-2-custom_bus_A-endpoint"
.
}
type nonrec describe_connection_resource_parameters = {
resource_association_arn : resource_association_arn;
For connections to private APIs, the Amazon Resource Name (ARN) of the resource association EventBridge created between the connection and the private API's resource configuration.
For more information, see Managing service network resource associations for connections in the Amazon EventBridge User Guide.
*)resource_configuration_arn : resource_configuration_arn;
The Amazon Resource Name (ARN) of the resource configuration for the private API.
*)}
The parameters for EventBridge to use when invoking the resource endpoint.
type nonrec describe_connection_connectivity_parameters = {
resource_parameters : describe_connection_resource_parameters;
The parameters for EventBridge to use when invoking the resource endpoint.
*)}
If the connection uses a private OAuth endpoint, the parameters for EventBridge to use when authenticating against the endpoint.
For more information, see Authorization methods for connections in the Amazon EventBridge User Guide.
type nonrec connection_basic_auth_response_parameters = {
username : auth_header_parameters option;
The user name to use for Basic authorization.
*)}
The authorization parameters for the connection if Basic is specified as the authorization type.
type nonrec connection_o_auth_client_response_parameters = {
client_i_d : auth_header_parameters option;
The client ID associated with the response to the connection request.
*)}
The client response parameters for the connection when OAuth is specified as the authorization type.
type nonrec connection_o_auth_response_parameters = {
o_auth_http_parameters : connection_http_parameters option;
The additional HTTP parameters used for the OAuth authorization request.
*)http_method : connection_o_auth_http_method option;
The method used to connect to the HTTP endpoint.
*)client_parameters : connection_o_auth_client_response_parameters option;
Details about the client parameters returned when OAuth is specified as the authorization type.
*)}
The response parameters when OAuth is specified as the authorization type.
type nonrec connection_api_key_auth_response_parameters = {
api_key_name : auth_header_parameters option;
The name of the header to use for the APIKeyValue
used for authorization.
}
Contains the authorization parameters for the connection if API Key is specified as the authorization type.
type nonrec connection_auth_response_parameters = {
connectivity_parameters : describe_connection_connectivity_parameters option;
For private OAuth authentication endpoints. The parameters EventBridge uses to authenticate against the endpoint.
For more information, see Authorization methods for connections in the Amazon EventBridge User Guide.
*)invocation_http_parameters : connection_http_parameters option;
Additional parameters for the connection that are passed through with every invocation to the HTTP endpoint.
*)api_key_auth_parameters : connection_api_key_auth_response_parameters option;
The API Key parameters to use for authorization.
*)o_auth_parameters : connection_o_auth_response_parameters option;
The OAuth parameters to use for authorization.
*)basic_auth_parameters : connection_basic_auth_response_parameters option;
The authorization parameters for Basic authorization.
*)}
Tthe authorization parameters to use for the connection.
type nonrec describe_connection_response = {
last_modified_time : timestamp option;
A time stamp for the time that the connection was last modified.
*)creation_time : timestamp option;
A time stamp for the time that the connection was created.
*)auth_parameters : connection_auth_response_parameters option;
The parameters to use for authorization for the connection.
*)kms_key_identifier : kms_key_identifier option;
The identifier of the KMS customer managed key for EventBridge to use to encrypt the connection, if one has been specified.
For more information, see Encrypting connections in the Amazon EventBridge User Guide.
*)secret_arn : secrets_manager_secret_arn option;
The ARN of the secret created from the authorization parameters specified for the connection.
*)state_reason : connection_state_reason option;
The reason that the connection is in the current connection state.
*)connection_state : connection_state option;
The state of the connection retrieved.
*)invocation_connectivity_parameters : describe_connection_connectivity_parameters
option;
For connections to private APIs The parameters EventBridge uses to invoke the resource endpoint.
For more information, see Connecting to private APIs in the Amazon EventBridge User Guide.
*)description : connection_description option;
The description for the connection retrieved.
*)name : connection_name option;
The name of the connection retrieved.
*)connection_arn : connection_arn option;
The ARN of the connection retrieved.
*)}
type nonrec describe_connection_request = {
name : connection_name;
The name of the connection to retrieve.
*)}
type nonrec describe_archive_response = {
creation_time : timestamp option;
The time at which the archive was created.
*)event_count : long option;
The number of events in the archive.
*)size_bytes : long option;
The size of the archive in bytes.
*)retention_days : retention_days option;
The number of days to retain events for in the archive.
*)kms_key_identifier : kms_key_identifier option;
The identifier of the KMS customer managed key for EventBridge to use to encrypt this archive, if one has been specified.
For more information, see Encrypting archives in the Amazon EventBridge User Guide.
*)state_reason : archive_state_reason option;
The reason that the archive is in the state.
*)state : archive_state option;
The state of the archive.
*)event_pattern : event_pattern option;
The event pattern used to filter events sent to the archive.
*)description : archive_description option;
The description of the archive.
*)event_source_arn : event_bus_arn option;
The ARN of the event source associated with the archive.
*)archive_name : archive_name option;
The name of the archive.
*)archive_arn : archive_arn option;
The ARN of the archive.
*)}
type nonrec describe_archive_request = {
archive_name : archive_name;
The name of the archive to retrieve.
*)}
type nonrec describe_api_destination_response = {
last_modified_time : timestamp option;
A time stamp for the time that the API destination was last modified.
*)creation_time : timestamp option;
A time stamp for the time that the API destination was created.
*)invocation_rate_limit_per_second : api_destination_invocation_rate_limit_per_second
option;
The maximum number of invocations per second to specified for the API destination. Note that if you set the invocation rate maximum to a value lower the rate necessary to send all events received on to the destination HTTP endpoint, some events may not be delivered within the 24-hour retry window. If you plan to set the rate lower than the rate necessary to deliver all events, consider using a dead-letter queue to catch events that are not delivered within 24 hours.
*)http_method : api_destination_http_method option;
The method to use to connect to the HTTP endpoint.
*)invocation_endpoint : https_endpoint option;
The URL to use to connect to the HTTP endpoint.
*)connection_arn : connection_arn option;
The ARN of the connection specified for the API destination retrieved.
*)api_destination_state : api_destination_state option;
The state of the API destination retrieved.
*)description : api_destination_description option;
The description for the API destination retrieved.
*)name : api_destination_name option;
The name of the API destination retrieved.
*)api_destination_arn : api_destination_arn option;
The ARN of the API destination retrieved.
*)}
type nonrec describe_api_destination_request = {
name : api_destination_name;
The name of the API destination to retrieve.
*)}
type nonrec delete_rule_request = {
force : boolean_ option;
If this is a managed rule, created by an Amazon Web Services service on your behalf, you must specify Force
as True
to delete the rule. This parameter is ignored for rules that are not managed rules. You can check whether a rule is a managed rule by using DescribeRule
or ListRules
and checking the ManagedBy
field of the response.
event_bus_name : event_bus_name_or_arn option;
The name or ARN of the event bus associated with the rule. If you omit this, the default event bus is used.
*)name : rule_name;
The name of the rule.
*)}
type nonrec delete_partner_event_source_request = {
account : account_id;
The Amazon Web Services account ID of the Amazon Web Services customer that the event source was created for.
*)name : event_source_name;
The name of the event source to delete.
*)}
type nonrec delete_event_bus_request = {
name : event_bus_name;
The name of the event bus to delete.
*)}
type nonrec delete_endpoint_request = {
name : endpoint_name;
The name of the endpoint you want to delete. For example, "Name":"us-east-2-custom_bus_A-endpoint"
..
}
type nonrec delete_connection_response = {
last_modified_time : timestamp option;
A time stamp for the time that the connection was last modified before it was deleted.
*)creation_time : timestamp option;
A time stamp for the time that the connection was created.
*)connection_state : connection_state option;
The state of the connection before it was deleted.
*)connection_arn : connection_arn option;
The ARN of the connection that was deleted.
*)}
type nonrec delete_connection_request = {
name : connection_name;
The name of the connection to delete.
*)}
type nonrec delete_archive_request = {
archive_name : archive_name;
The name of the archive to delete.
*)}
type nonrec delete_api_destination_request = {
name : api_destination_name;
The name of the destination to delete.
*)}
type nonrec deactivate_event_source_request = {
name : event_source_name;
The name of the partner event source to deactivate.
*)}
type nonrec create_partner_event_source_response = {
event_source_arn : string_ option;
The ARN of the partner event source.
*)}
type nonrec create_partner_event_source_request = {
account : account_id;
The Amazon Web Services account ID that is permitted to create a matching partner event bus for this partner event source.
*)name : event_source_name;
The name of the partner event source. This name must be unique and must be in the format
{i partner_name}/{i event_namespace}/{i event_name}
. The Amazon Web Services account that wants to use this partner event source must create a partner event bus with a name that matches the name of the partner event source.
*)}
type nonrec create_event_bus_response = {
dead_letter_config : dead_letter_config option;
kms_key_identifier : kms_key_identifier option;
The identifier of the KMS customer managed key for EventBridge to use to encrypt events on this event bus, if one has been specified.
For more information, see Data encryption in EventBridge in the Amazon EventBridge User Guide.
*)description : event_bus_description option;
The event bus description.
*)event_bus_arn : string_ option;
The ARN of the new event bus.
*)}
type nonrec create_event_bus_request = {
dead_letter_config : dead_letter_config option;
kms_key_identifier : kms_key_identifier option;
The identifier of the KMS customer managed key for EventBridge to use, if you choose to use a customer managed key to encrypt events on this event bus. The identifier can be the key Amazon Resource Name (ARN), KeyId, key alias, or key alias ARN.
If you do not specify a customer managed key identifier, EventBridge uses an Amazon Web Services owned key to encrypt events on the event bus.
For more information, see Identify and view keys in the Key Management Service Developer Guide.
Schema discovery is not supported for event buses encrypted using a customer managed key. EventBridge returns an error if:
You call
{{:https://docs.aws.amazon.com/eventbridge/latest/schema-reference/v1-discoverers.html#CreateDiscoverer}CreateDiscoverer}
on an event bus set to use a customer managed key for encryption.
You call
{{:https://docs.aws.amazon.com/eventbridge/latest/APIReference/API_UpdatedEventBus.html}UpdatedEventBus}
to set a customer managed key on an event bus with schema discovery enabled.
To enable schema discovery on an event bus, choose to use an Amazon Web Services owned key. For more information, see Encrypting events in the Amazon EventBridge User Guide.
If you have specified that EventBridge use a customer managed key for encrypting the source event bus, we strongly recommend you also specify a customer managed key for any archives for the event bus as well.
For more information, see Encrypting archives in the Amazon EventBridge User Guide.
*)description : event_bus_description option;
The event bus description.
*)event_source_name : event_source_name option;
If you are creating a partner event bus, this specifies the partner event source that the new event bus will be matched with.
*)name : event_bus_name;
The name of the new event bus.
Custom event bus names can't contain the /
character, but you can use the /
character in partner event bus names. In addition, for partner event buses, the name must exactly match the name of the partner event source that this event bus is matched to.
You can't use the name default
for a custom event bus, as this name is already used for your account's default event bus.
}
type nonrec create_endpoint_response = {
state : endpoint_state option;
The state of the endpoint that was created by this request.
*)role_arn : iam_role_arn option;
The ARN of the role used by event replication for this request.
*)event_buses : endpoint_event_bus_list option;
The event buses used by this request.
*)replication_config : replication_config option;
Whether event replication was enabled or disabled by this request.
*)routing_config : routing_config option;
The routing configuration defined by this request.
*)arn : endpoint_arn option;
The ARN of the endpoint that was created by this request.
*)name : endpoint_name option;
The name of the endpoint that was created by this request.
*)}
type nonrec create_endpoint_request = {
role_arn : iam_role_arn option;
The ARN of the role used for replication.
*)event_buses : endpoint_event_bus_list;
Define the event buses used.
The names of the event buses must be identical in each Region.
*)replication_config : replication_config option;
Enable or disable event replication. The default state is ENABLED
which means you must supply a RoleArn
. If you don't have a RoleArn
or you don't want event replication enabled, set the state to DISABLED
.
routing_config : routing_config;
Configure the routing policy, including the health check and secondary Region..
*)description : endpoint_description option;
A description of the global endpoint.
*)name : endpoint_name;
The name of the global endpoint. For example, "Name":"us-east-2-custom_bus_A-endpoint"
.
}
type nonrec create_connection_response = {
last_modified_time : timestamp option;
A time stamp for the time that the connection was last updated.
*)creation_time : timestamp option;
A time stamp for the time that the connection was created.
*)connection_state : connection_state option;
The state of the connection that was created by the request.
*)connection_arn : connection_arn option;
The ARN of the connection that was created by the request.
*)}
type nonrec create_connection_basic_auth_request_parameters = {
password : auth_header_parameters_sensitive;
The password associated with the user name to use for Basic authorization.
*)username : auth_header_parameters;
The user name to use for Basic authorization.
*)}
Contains the Basic authorization parameters to use for the connection.
type nonrec create_connection_o_auth_client_request_parameters = {
client_secret : auth_header_parameters_sensitive;
The client secret associated with the client ID to use for OAuth authorization for the connection.
*)client_i_d : auth_header_parameters;
The client ID to use for OAuth authorization for the connection.
*)}
The Basic authorization parameters to use for the connection.
type nonrec create_connection_o_auth_request_parameters = {
o_auth_http_parameters : connection_http_parameters option;
Details about the additional parameters to use for the connection.
*)http_method : connection_o_auth_http_method;
The method to use for the authorization request.
*)client_parameters : create_connection_o_auth_client_request_parameters;
The client parameters for OAuth authorization.
*)}
Contains the OAuth authorization parameters to use for the connection.
type nonrec create_connection_api_key_auth_request_parameters = {
api_key_value : auth_header_parameters_sensitive;
The value for the API key to use for authorization.
*)api_key_name : auth_header_parameters;
The name of the API key to use for authorization.
*)}
The API key authorization parameters for the connection.
type nonrec create_connection_auth_request_parameters = {
connectivity_parameters : connectivity_resource_parameters option;
If you specify a private OAuth endpoint, the parameters for EventBridge to use when authenticating against the endpoint.
For more information, see Authorization methods for connections in the Amazon EventBridge User Guide.
*)invocation_http_parameters : connection_http_parameters option;
The API key authorization parameters to use for the connection. Note that if you include additional parameters for the target of a rule via HttpParameters
, including query strings, the parameters added for the connection take precedence.
api_key_auth_parameters : create_connection_api_key_auth_request_parameters
option;
The API key authorization parameters to use for the connection.
*)o_auth_parameters : create_connection_o_auth_request_parameters option;
The OAuth authorization parameters to use for the connection.
*)basic_auth_parameters : create_connection_basic_auth_request_parameters option;
The Basic authorization parameters to use for the connection.
*)}
The authorization parameters for the connection.
You must include only authorization parameters for the AuthorizationType
you specify.
type nonrec create_connection_request = {
kms_key_identifier : kms_key_identifier option;
The identifier of the KMS customer managed key for EventBridge to use, if you choose to use a customer managed key to encrypt this connection. The identifier can be the key Amazon Resource Name (ARN), KeyId, key alias, or key alias ARN.
If you do not specify a customer managed key identifier, EventBridge uses an Amazon Web Services owned key to encrypt the connection.
For more information, see Identify and view keys in the Key Management Service Developer Guide.
*)invocation_connectivity_parameters : connectivity_resource_parameters option;
For connections to private APIs, the parameters to use for invoking the API.
For more information, see Connecting to private APIs in the Amazon EventBridge User Guide.
*)auth_parameters : create_connection_auth_request_parameters;
The authorization parameters to use to authorize with the endpoint.
You must include only authorization parameters for the AuthorizationType
you specify.
description : connection_description option;
A description for the connection to create.
*)name : connection_name;
The name for the connection to create.
*)}
type nonrec create_archive_response = {
creation_time : timestamp option;
The time at which the archive was created.
*)state_reason : archive_state_reason option;
The reason that the archive is in the state.
*)state : archive_state option;
The state of the archive that was created.
*)archive_arn : archive_arn option;
The ARN of the archive that was created.
*)}
type nonrec create_archive_request = {
kms_key_identifier : kms_key_identifier option;
The identifier of the KMS customer managed key for EventBridge to use, if you choose to use a customer managed key to encrypt this archive. The identifier can be the key Amazon Resource Name (ARN), KeyId, key alias, or key alias ARN.
If you do not specify a customer managed key identifier, EventBridge uses an Amazon Web Services owned key to encrypt the archive.
For more information, see Identify and view keys in the Key Management Service Developer Guide.
If you have specified that EventBridge use a customer managed key for encrypting the source event bus, we strongly recommend you also specify a customer managed key for any archives for the event bus as well.
For more information, see Encrypting archives in the Amazon EventBridge User Guide.
*)retention_days : retention_days option;
The number of days to retain events for. Default value is 0. If set to 0, events are retained indefinitely
*)event_pattern : event_pattern option;
An event pattern to use to filter events sent to the archive.
*)description : archive_description option;
A description for the archive.
*)event_source_arn : event_bus_arn;
The ARN of the event bus that sends events to the archive.
*)archive_name : archive_name;
The name for the archive to create.
*)}
type nonrec create_api_destination_response = {
last_modified_time : timestamp option;
A time stamp indicating the time that the API destination was last modified.
*)creation_time : timestamp option;
A time stamp indicating the time that the API destination was created.
*)api_destination_state : api_destination_state option;
The state of the API destination that was created by the request.
*)api_destination_arn : api_destination_arn option;
The ARN of the API destination that was created by the request.
*)}
type nonrec create_api_destination_request = {
invocation_rate_limit_per_second : api_destination_invocation_rate_limit_per_second
option;
The maximum number of requests per second to send to the HTTP invocation endpoint.
*)http_method : api_destination_http_method;
The method to use for the request to the HTTP invocation endpoint.
*)invocation_endpoint : https_endpoint;
The URL to the HTTP invocation endpoint for the API destination.
*)connection_arn : connection_arn;
The ARN of the connection to use for the API destination. The destination endpoint must support the authorization type specified for the connection.
*)description : api_destination_description option;
A description for the API destination to create.
*)name : api_destination_name;
The name for the API destination to create.
*)}
type nonrec cancel_replay_response = {
state_reason : replay_state_reason option;
The reason that the replay is in the current state.
*)state : replay_state option;
The current state of the replay.
*)replay_arn : replay_arn option;
The ARN of the replay to cancel.
*)}
type nonrec cancel_replay_request = {
replay_name : replay_name;
The name of the replay to cancel.
*)}
type nonrec activate_event_source_request = {
name : event_source_name;
The name of the partner event source to activate.
*)}