Add Amazon EventBridge endpoints to AWS Integration API (#1724)

Co-authored-by: ci.datadog-api-spec <[email protected]>

Author: api-clients-generation-pipeline[bot]

.apigentools-info

@@ -4,13 +4,13 @@
     "spec_versions": {
         "v1": {
             "apigentools_version": "1.6.6",
-            "regenerated": "2023-10-25 13:57:25.705674",
-            "spec_repo_commit": "fb2f4134"
+            "regenerated": "2023-10-25 15:29:12.611442",
+            "spec_repo_commit": "dfb87dda"
         },
         "v2": {
             "apigentools_version": "1.6.6",
-            "regenerated": "2023-10-25 13:57:25.768693",
-            "spec_repo_commit": "fb2f4134"
+            "regenerated": "2023-10-25 15:29:12.633028",
+            "spec_repo_commit": "dfb87dda"
         }
     }
 }

.generator/schemas/v1/openapi.yaml

@@ -56,7 +56,7 @@ components:
           type: string
         account_id:
           description: Your AWS Account ID without dashes.
-          example: '1234567'
+          example: '123456789012'
           type: string
         account_specific_namespace_rules:
           additionalProperties:
@@ -80,7 +80,9 @@ components:
           example: true
           type: boolean
         excluded_regions:
-          description: An array of AWS regions to exclude from metrics collection.
+          description: 'An array of [AWS regions](https://docs.aws.amazon.com/general/latest/gr/rande.html#regional-endpoints)
+
+            to exclude from metrics collection.'
           example:
           - us-east-1
           - us-west-2
@@ -116,7 +118,7 @@ components:
           example:
           - $KEY:$VALUE
           items:
-            description: The list of the the host_tags.
+            description: The list of the host_tags.
             type: string
           type: array
         metrics_collection_enabled:
@@ -171,7 +173,7 @@ components:
           type: string
         account_id:
           description: Your AWS Account ID without dashes.
-          example: '1234567'
+          example: '123456789012'
           type: string
         role_name:
           description: Your Datadog role delegation name.
@@ -187,6 +189,136 @@ components:
             $ref: '#/components/schemas/AWSAccount'
           type: array
       type: object
+    AWSEventBridgeAccountConfiguration:
+      description: The EventBridge configuration for one AWS account.
+      properties:
+        accountId:
+          description: Your AWS Account ID without dashes.
+          example: '123456789012'
+          type: string
+        eventHubs:
+          description: Array of AWS event sources associated with this account.
+          items:
+            $ref: '#/components/schemas/AWSEventBridgeSource'
+          type: array
+        tags:
+          description: 'Array of tags (in the form `key:value`) which are added to
+            all hosts
+
+            and metrics reporting through the main AWS integration.'
+          example:
+          - $KEY:$VALUE
+          items:
+            description: The list of the host_tags.
+            type: string
+          type: array
+      type: object
+    AWSEventBridgeCreateRequest:
+      description: An object used to create an EventBridge source.
+      properties:
+        account_id:
+          description: Your AWS Account ID without dashes.
+          example: '123456789012'
+          type: string
+        create_event_bus:
+          description: 'True if Datadog should create the event bus in addition to
+            the event
+
+            source. Requires the `events:CreateEventBus` permission.'
+          example: true
+          type: boolean
+        event_generator_name:
+          description: 'The given part of the event source name, which is then combined
+            with an
+
+            assigned suffix to form the full name.'
+          example: app-alerts
+          type: string
+        region:
+          description: The event source's [AWS region](https://docs.aws.amazon.com/general/latest/gr/rande.html#regional-endpoints).
+          example: us-east-1
+          type: string
+      type: object
+    AWSEventBridgeCreateResponse:
+      description: A created EventBridge source.
+      properties:
+        event_source_name:
+          description: The event source name.
+          example: app-alerts-zyxw3210
+          type: string
+        has_bus:
+          description: True if the event bus was created in addition to the source.
+          example: true
+          type: boolean
+        region:
+          description: The event source's [AWS region](https://docs.aws.amazon.com/general/latest/gr/rande.html#regional-endpoints).
+          example: us-east-1
+          type: string
+        status:
+          $ref: '#/components/schemas/AWSEventBridgeCreateStatus'
+      type: object
+    AWSEventBridgeCreateStatus:
+      description: The event source status "created".
+      enum:
+      - created
+      example: created
+      type: string
+      x-enum-varnames:
+      - CREATED
+    AWSEventBridgeDeleteRequest:
+      description: An object used to delete an EventBridge source.
+      properties:
+        account_id:
+          description: Your AWS Account ID without dashes.
+          example: '123456789012'
+          type: string
+        event_generator_name:
+          description: The event source name.
+          example: app-alerts-zyxw3210
+          type: string
+        region:
+          description: The event source's [AWS region](https://docs.aws.amazon.com/general/latest/gr/rande.html#regional-endpoints).
+          example: us-east-1
+          type: string
+      type: object
+    AWSEventBridgeDeleteResponse:
+      description: An indicator of the successful deletion of an EventBridge source.
+      properties:
+        status:
+          $ref: '#/components/schemas/AWSEventBridgeDeleteStatus'
+      type: object
+    AWSEventBridgeDeleteStatus:
+      description: The event source status "empty".
+      enum:
+      - empty
+      example: empty
+      type: string
+      x-enum-varnames:
+      - EMPTY
+    AWSEventBridgeListResponse:
+      description: An object describing the EventBridge configuration for multiple
+        accounts.
+      properties:
+        accounts:
+          description: List of accounts with their event sources.
+          items:
+            $ref: '#/components/schemas/AWSEventBridgeAccountConfiguration'
+          type: array
+        isInstalled:
+          description: True if the EventBridge sub-integration is enabled for your
+            organization.
+          type: boolean
+      type: object
+    AWSEventBridgeSource:
+      description: An EventBridge source.
+      properties:
+        name:
+          description: The event source name.
+          type: string
+        region:
+          description: The event source's [AWS region](https://docs.aws.amazon.com/general/latest/gr/rande.html#regional-endpoints).
+          type: string
+      type: object
     AWSLogsAsyncError:
       description: Description of errors.
       properties:
@@ -323,7 +455,7 @@ components:
       properties:
         account_id:
           description: Your AWS Account ID without dashes.
-          example: '1234567'
+          example: '123456789012'
           type: string
         namespace:
           $ref: '#/components/schemas/AWSNamespace'
@@ -23392,6 +23524,107 @@ paths:
       summary: List namespace rules
       tags:
       - AWS Integration
+  /api/v1/integration/aws/event_bridge:
+    delete:
+      description: Delete an Amazon EventBridge source.
+      operationId: DeleteAWSEventBridgeSource
+      requestBody:
+        content:
+          application/json:
+            schema:
+              $ref: '#/components/schemas/AWSEventBridgeDeleteRequest'
+        description: Delete the Amazon EventBridge source with the given name, region,
+          and associated AWS account.
+        required: true
+      responses:
+        '200':
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/AWSEventBridgeDeleteResponse'
+          description: OK
+        '400':
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/APIErrorResponse'
+          description: Bad Request
+        '403':
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/APIErrorResponse'
+          description: Authentication Error
+        '429':
+          $ref: '#/components/responses/TooManyRequestsResponse'
+      summary: Delete an Amazon EventBridge source
+      tags:
+      - AWS Integration
+      x-codegen-request-body-name: body
+    get:
+      description: Get all Amazon EventBridge sources.
+      operationId: ListAWSEventBridgeSources
+      parameters: []
+      responses:
+        '200':
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/AWSEventBridgeListResponse'
+          description: OK
+        '400':
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/APIErrorResponse'
+          description: Bad Request
+        '403':
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/APIErrorResponse'
+          description: Authentication Error
+        '429':
+          $ref: '#/components/responses/TooManyRequestsResponse'
+      summary: Get all Amazon EventBridge sources
+      tags:
+      - AWS Integration
+    post:
+      description: Create an Amazon EventBridge source.
+      operationId: CreateAWSEventBridgeSource
+      requestBody:
+        content:
+          application/json:
+            schema:
+              $ref: '#/components/schemas/AWSEventBridgeCreateRequest'
+        description: Create an Amazon EventBridge source for an AWS account with a
+          given name and region.
+        required: true
+      responses:
+        '200':
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/AWSEventBridgeCreateResponse'
+          description: OK
+        '400':
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/APIErrorResponse'
+          description: Bad Request
+        '403':
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/APIErrorResponse'
+          description: Authentication Error
+        '429':
+          $ref: '#/components/responses/TooManyRequestsResponse'
+      summary: Create an Amazon EventBridge source
+      tags:
+      - AWS Integration
+      x-codegen-request-body-name: body
   /api/v1/integration/aws/filtering:
     delete:
       description: Delete a tag filtering entry.

docs/datadog_api_client.v1.model.rst

@@ -162,6 +162,69 @@ aws\_account\_list\_response
    :members:
    :show-inheritance:
 
+aws\_event\_bridge\_account\_configuration
+------------------------------------------
+
+.. automodule:: datadog_api_client.v1.model.aws_event_bridge_account_configuration
+   :members:
+   :show-inheritance:
+
+aws\_event\_bridge\_create\_request
+-----------------------------------
+
+.. automodule:: datadog_api_client.v1.model.aws_event_bridge_create_request
+   :members:
+   :show-inheritance:
+
+aws\_event\_bridge\_create\_response
+------------------------------------
+
+.. automodule:: datadog_api_client.v1.model.aws_event_bridge_create_response
+   :members:
+   :show-inheritance:
+
+aws\_event\_bridge\_create\_status
+----------------------------------
+
+.. automodule:: datadog_api_client.v1.model.aws_event_bridge_create_status
+   :members:
+   :show-inheritance:
+
+aws\_event\_bridge\_delete\_request
+-----------------------------------
+
+.. automodule:: datadog_api_client.v1.model.aws_event_bridge_delete_request
+   :members:
+   :show-inheritance:
+
+aws\_event\_bridge\_delete\_response
+------------------------------------
+
+.. automodule:: datadog_api_client.v1.model.aws_event_bridge_delete_response
+   :members:
+   :show-inheritance:
+
+aws\_event\_bridge\_delete\_status
+----------------------------------
+
+.. automodule:: datadog_api_client.v1.model.aws_event_bridge_delete_status
+   :members:
+   :show-inheritance:
+
+aws\_event\_bridge\_list\_response
+----------------------------------
+
+.. automodule:: datadog_api_client.v1.model.aws_event_bridge_list_response
+   :members:
+   :show-inheritance:
+
+aws\_event\_bridge\_source
+--------------------------
+
+.. automodule:: datadog_api_client.v1.model.aws_event_bridge_source
+   :members:
+   :show-inheritance:
+
 aws\_logs\_async\_error
 -----------------------
 

examples/v1/aws-integration/CreateAWSAccount.py

@@ -7,7 +7,7 @@
 from datadog_api_client.v1.model.aws_account import AWSAccount
 
 body = AWSAccount(
-    account_id="1234567",
+    account_id="123456789012",
     account_specific_namespace_rules=dict(
         auto_scaling=False,
         opswork=False,