Rule
eventbridge.services.k8s.aws/v1alpha1
Type | Link |
---|---|
GoDoc | eventbridge-controller/apis/v1alpha1#Rule |
Metadata
Property | Value |
---|---|
Scope | Namespaced |
Kind | Rule |
ListKind | RuleList |
Plural | rules |
Singular | rule |
Contains information about a rule in Amazon EventBridge.
Spec
description: string
eventBusName: string
eventBusRef:
from:
name: string
namespace: string
eventPattern: string
name: string
roleARN: string
scheduleExpression: string
state: string
tags:
- key: string
value: string
targets:
- arn: string
batchParameters:
arrayProperties:
size: integer
jobDefinition: string
jobName: string
retryStrategy:
attempts: integer
deadLetterConfig:
arn: string
ecsParameters:
capacityProviderStrategy:
- base: integer
capacityProvider: string
weight: integer
enableECSManagedTags: boolean
enableExecuteCommand: boolean
group: string
launchType: string
networkConfiguration:
awsVPCConfiguration:
assignPublicIP: string
securityGroups:
- string
subnets:
- string
placementConstraints:
- expression: string
type_: string
placementStrategy:
- field: string
type_: string
platformVersion: string
propagateTags: string
referenceID: string
tags:
- key: string
value: string
taskCount: integer
taskDefinitionARN: string
httpParameters:
headerParameters: {}
pathParameterValues:
- string
queryStringParameters: {}
id: string
input: string
inputPath: string
inputTransformer:
inputPathsMap: {}
inputTemplate: string
kinesisParameters:
partitionKeyPath: string
redshiftDataParameters:
database: string
dbUser: string
secretManagerARN: string
sql: string
sqls:
- string
statementName: string
withEvent: boolean
retryPolicy:
maximumEventAgeInSeconds: integer
maximumRetryAttempts: integer
roleARN: string
runCommandParameters:
runCommandTargets:
- key: string
values:
- string
sageMakerPipelineParameters:
pipelineParameterList:
- name: string
value: string
sqsParameters:
messageGroupID: string
Field | Description |
---|---|
description Optional | string A description of the rule. |
eventBusName Optional | string The name or ARN of the event bus to associate with this rule. If you omit this, the default event bus is used. |
eventBusRef Optional | object AWSResourceReferenceWrapper provides a wrapper around *AWSResourceReference type to provide more user friendly syntax for references using ‘from’ field Ex: APIIDRef: from: name: my-api |
eventBusRef.from Optional | object AWSResourceReference provides all the values necessary to reference another k8s resource for finding the identifier(Id/ARN/Name) |
eventBusRef.from.name Optional | string |
eventBusRef.from.namespace Optional | string |
eventPattern Optional | string The event pattern. For more information, see Amazon EventBridge event patterns (https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-event-patterns.html) in the Amazon EventBridge User Guide. |
name Required | string The name of the rule that you are creating or updating. |
roleARN Optional | string 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. |
scheduleExpression Optional | string The scheduling expression. For example, “cron(0 20 * * ? *)” or “rate(5 minutes)”. |
state Optional | string 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 (https://docs.aws.amazon.com/awscloudtrail/latest/userguide/logging-management-events-with-cloudtrail.html#logging-management-events) in the CloudTrail User Guide, and Filtering management events from Amazon Web Services services (https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-service-event.html#eb-service-event-cloudtrail) in the Amazon EventBridge User Guide. This value is only valid for rules on the default (https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-what-is-how-it-works-concepts.html#eb-bus-concepts-buses) event bus or custom event buses (https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-create-event-bus.html). It does not apply to partner event buses (https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-saas.html). |
tags Optional | array The list of key-value pairs to associate with the rule. |
tags.[] Required | object A key-value pair associated with an Amazon Web Services resource. In EventBridge, |
rules and event buses support tagging. | |
tags.[].value Optional | string |
targets Optional | array |
targets.[] Required | object 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 | |
(https://docs.aws.amazon.com/eventbridge/latest/APIReference/API_PutTargets.html). |
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 (https://docs.aws.amazon.com/eventbridge/latest/userguide/eventbridge-cross-account-event-delivery.html)
in the Amazon EventBridge User Guide. || targets.[].arn
Optional | string
|
| targets.[].batchParameters
Optional | object
The custom parameters to be used when the target is an Batch job. |
| targets.[].batchParameters.arrayProperties
Optional | object
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. |
| targets.[].batchParameters.arrayProperties.size
Optional | integer
|
| targets.[].batchParameters.jobDefinition
Optional | string
|
| targets.[].batchParameters.jobName
Optional | string
|
| targets.[].batchParameters.retryStrategy
Optional | object
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. |
| targets.[].batchParameters.retryStrategy.attempts
Optional | integer
|
| targets.[].deadLetterConfig
Optional | object
A DeadLetterConfig object that contains information about a dead-letter queue
configuration. |
| targets.[].deadLetterConfig.arn
Optional | string
|
| targets.[].ecsParameters
Optional | object
The custom parameters to be used when the target is an Amazon ECS task. |
| targets.[].ecsParameters.capacityProviderStrategy
Optional | array
|
| targets.[].ecsParameters.capacityProviderStrategy.[]
Required | object
The details of a capacity provider strategy. To learn more, see CapacityProviderStrategyItem
(https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_CapacityProviderStrategyItem.html)
in the Amazon ECS API Reference. || targets.[].ecsParameters.capacityProviderStrategy.[].base
Optional | integer
|
| targets.[].ecsParameters.capacityProviderStrategy.[].capacityProvider
Optional | string
|
| targets.[].ecsParameters.capacityProviderStrategy.[].weight
Optional | integer
|
| targets.[].ecsParameters.enableECSManagedTags
Optional | boolean
|
| targets.[].ecsParameters.enableExecuteCommand
Optional | boolean
|
| targets.[].ecsParameters.group
Optional | string
|
| targets.[].ecsParameters.launchType
Optional | string
|
| targets.[].ecsParameters.networkConfiguration
Optional | object
This structure specifies the network configuration for an ECS task. |
| targets.[].ecsParameters.networkConfiguration.awsVPCConfiguration
Optional | object
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. |
| targets.[].ecsParameters.networkConfiguration.awsVPCConfiguration.assignPublicIP
Optional | string
|
| targets.[].ecsParameters.networkConfiguration.awsVPCConfiguration.securityGroups
Optional | array
|
| targets.[].ecsParameters.networkConfiguration.awsVPCConfiguration.securityGroups.[]
Required | string
|| targets.[].ecsParameters.networkConfiguration.awsVPCConfiguration.subnets
Optional | array
|
| targets.[].ecsParameters.networkConfiguration.awsVPCConfiguration.subnets.[]
Required | string
|| targets.[].ecsParameters.placementConstraints
Optional | array
|
| targets.[].ecsParameters.placementConstraints.[]
Required | object
An object representing a constraint on task placement. To learn more, see
Task Placement Constraints (https://docs.aws.amazon.com/AmazonECS/latest/developerguide/task-placement-constraints.html)
in the Amazon Elastic Container Service Developer Guide. || targets.[].ecsParameters.placementConstraints.[].expression
Optional | string
|
| **targets.[].ecsParameters.placementConstraints.[].type_**
Optional | **string**
|
| **targets.[].ecsParameters.placementStrategy**
Optional | **array**
|
| **targets.[].ecsParameters.placementStrategy.[]**
Required | **object**
The task placement strategy for a task or service. To learn more, see Task
Placement Strategies (https://docs.aws.amazon.com/AmazonECS/latest/developerguide/task-placement-strategies.html)
in the Amazon Elastic Container Service Service Developer Guide. || **targets.[].ecsParameters.placementStrategy.[].field**
Optional | **string**
|
| **targets.[].ecsParameters.placementStrategy.[].type_**
Optional | **string**
|
| **targets.[].ecsParameters.platformVersion**
Optional | **string**
|
| **targets.[].ecsParameters.propagateTags**
Optional | **string**
|
| **targets.[].ecsParameters.referenceID**
Optional | **string**
|
| **targets.[].ecsParameters.tags**
Optional | **array**
|
| **targets.[].ecsParameters.tags.[]**
Required | **object**
A key-value pair associated with an Amazon Web Services resource. In EventBridge,
rules and event buses support tagging. || **targets.[].ecsParameters.tags.[].key**
Optional | **string**
|
| **targets.[].ecsParameters.tags.[].value**
Optional | **string**
|
| **targets.[].ecsParameters.taskCount**
Optional | **integer**
|
| **targets.[].ecsParameters.taskDefinitionARN**
Optional | **string**
|
| **targets.[].httpParameters**
Optional | **object**
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. |
| **targets.[].httpParameters.headerParameters**
Optional | **object**
|
| **targets.[].httpParameters.pathParameterValues**
Optional | **array**
|
| **targets.[].httpParameters.pathParameterValues.[]**
Required | **string**
|| **targets.[].httpParameters.queryStringParameters**
Optional | **object**
|
| **targets.[].id**
Optional | **string**
|
| **targets.[].input**
Optional | **string**
|
| **targets.[].inputPath**
Optional | **string**
|
| **targets.[].inputTransformer**
Optional | **object**
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. |
| **targets.[].inputTransformer.inputPathsMap**
Optional | **object**
|
| **targets.[].inputTransformer.inputTemplate**
Optional | **string**
|
| **targets.[].kinesisParameters**
Optional | **object**
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. |
| **targets.[].kinesisParameters.partitionKeyPath**
Optional | **string**
|
| **targets.[].redshiftDataParameters**
Optional | **object**
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. |
| **targets.[].redshiftDataParameters.database**
Optional | **string**
Redshift Database |
| **targets.[].redshiftDataParameters.dbUser**
Optional | **string**
Database user name |
| **targets.[].redshiftDataParameters.secretManagerARN**
Optional | **string**
Optional SecretManager ARN which stores the database credentials |
| **targets.[].redshiftDataParameters.sql**
Optional | **string**
A single Redshift SQL |
| **targets.[].redshiftDataParameters.sqls**
Optional | **array**
A list of SQLs. |
| **targets.[].redshiftDataParameters.sqls.[]**
Required | **string**
|| **targets.[].redshiftDataParameters.statementName**
Optional | **string**
A name for Redshift DataAPI statement which can be used as filter of ListStatement. |
| **targets.[].redshiftDataParameters.withEvent**
Optional | **boolean**
|
| **targets.[].retryPolicy**
Optional | **object**
A RetryPolicy object that includes information about the retry policy settings. |
| **targets.[].retryPolicy.maximumEventAgeInSeconds**
Optional | **integer**
|
| **targets.[].retryPolicy.maximumRetryAttempts**
Optional | **integer**
|
| **targets.[].roleARN**
Optional | **string**
|
| **targets.[].runCommandParameters**
Optional | **object**
This parameter contains the criteria (either InstanceIds or a tag) used to
specify which EC2 instances are to be sent the command. |
| **targets.[].runCommandParameters.runCommandTargets**
Optional | **array**
|
| **targets.[].runCommandParameters.runCommandTargets.[]**
Required | **object**
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. || **targets.[].runCommandParameters.runCommandTargets.[].key**
Optional | **string**
|
| **targets.[].runCommandParameters.runCommandTargets.[].values**
Optional | **array**
|
| **targets.[].runCommandParameters.runCommandTargets.[].values.[]**
Required | **string**
|| **targets.[].sageMakerPipelineParameters**
Optional | **object**
These are custom parameters to use when the target is a SageMaker Model Building
Pipeline that starts based on EventBridge events. |
| **targets.[].sageMakerPipelineParameters.pipelineParameterList**
Optional | **array**
|
| **targets.[].sageMakerPipelineParameters.pipelineParameterList.[]**
Required | **object**
Name/Value pair of a parameter to start execution of a SageMaker Model Building
Pipeline. || **targets.[].sageMakerPipelineParameters.pipelineParameterList.[].name**
Optional | **string**
|
| **targets.[].sageMakerPipelineParameters.pipelineParameterList.[].value**
Optional | **string**
|
| **targets.[].sqsParameters**
Optional | **object**
This structure includes the custom parameter to be used when the target is
an SQS FIFO queue. |
| **targets.[].sqsParameters.messageGroupID**
Optional | **string**
|
Status
ackResourceMetadata:
arn: string
ownerAccountID: string
region: string
conditions:
- lastTransitionTime: string
message: string
reason: string
status: string
type: string
Field | Description |
---|---|
ackResourceMetadata Optional | object All CRs managed by ACK have a common Status.ACKResourceMetadata memberthat is used to contain resource sync state, account ownership, constructed ARN for the resource |
ackResourceMetadata.arn Optional | string ARN is the Amazon Resource Name for the resource. This is a globally-unique identifier and is set only by the ACK service controller once the controller has orchestrated the creation of the resource OR when it has verified that an “adopted” resource (a resource where the ARN annotation was set by the Kubernetes user on the CR) exists and matches the supplied CR’s Spec field values. https://github.com/aws/aws-controllers-k8s/issues/270 |
ackResourceMetadata.ownerAccountID Required | string OwnerAccountID is the AWS Account ID of the account that owns the backend AWS service API resource. |
ackResourceMetadata.region Required | string Region is the AWS region in which the resource exists or will exist. |
conditions Optional | array All CRS managed by ACK have a common Status.Conditions member thatcontains a collection of ackv1alpha1.Condition objects that describethe various terminal states of the CR and its backend AWS service API resource |
conditions.[] Required | object Condition is the common struct used by all CRDs managed by ACK service |
controllers to indicate terminal states of the CR and its backend AWS | |
service API resource | |
conditions.[].message Optional | string A human readable message indicating details about the transition. |
conditions.[].reason Optional | string The reason for the condition’s last transition. |
conditions.[].status Optional | string Status of the condition, one of True, False, Unknown. |
conditions.[].type Optional | string Type is the type of the Condition |