Regenerate client from commit e7e2a6e5 of spec repo

Author: ci.datadog-api-spec

.apigentools-info

@@ -4,13 +4,13 @@
     "spec_versions": {
         "v1": {
             "apigentools_version": "1.6.6",
-            "regenerated": "2024-10-10 19:45:58.829299",
-            "spec_repo_commit": "049920eb"
+            "regenerated": "2024-10-15 08:56:14.900283",
+            "spec_repo_commit": "e7e2a6e5"
         },
         "v2": {
             "apigentools_version": "1.6.6",
-            "regenerated": "2024-10-10 19:45:58.847651",
-            "spec_repo_commit": "049920eb"
+            "regenerated": "2024-10-15 08:56:14.918641",
+            "spec_repo_commit": "e7e2a6e5"
         }
     }
 }

.generator/schemas/v2/openapi.yaml

@@ -3951,6 +3951,240 @@ components:
           format: int64
           type: integer
       type: object
+    ChangeEvent:
+      description: Object representing a change event.
+      properties:
+        aggregation_key:
+          description: 'An arbitrary string to use for aggregation. Limited to 100
+            characters.
+
+            If you specify a key, all events using that key are grouped together in
+            the Event Stream.'
+          maxLength: 100
+          type: string
+        attributes:
+          $ref: '#/components/schemas/ChangeEventCustomAttributes'
+        category:
+          $ref: '#/components/schemas/ChangeEventCategory'
+        message:
+          description: The body of the event. Limited to 4000 characters.
+          example: payment_processed feature flag has been enabled
+          maxLength: 4000
+          type: string
+        tags:
+          description: 'A list of tags to apply to the event.
+
+            Refer to [Tags docs](https://docs.datadoghq.com/getting_started/tagging/).'
+          example:
+          - environment:test
+          items:
+            description: A tag.
+            type: string
+          type: array
+        timestamp:
+          description: 'Timestamp in which the event occurred. Must follow [ISO 8601](https://www.iso.org/iso-8601-date-and-time-format.html)
+            format.
+
+            For example `"2017-01-15T01:30:15.010000Z"`.
+
+            Defaults to now. Limited to values no older than 18 hours.'
+          type: string
+        title:
+          description: The event title. Limited to 500 characters.
+          example: payment_processed feature flag updated
+          maxLength: 500
+          type: string
+      required:
+      - title
+      - category
+      - attributes
+      type: object
+    ChangeEventCategory:
+      description: Event category to identify the type of event. Only the value `change`
+        is supported.
+      enum:
+      - change
+      example: change
+      type: string
+      x-enum-varnames:
+      - CHANGE
+    ChangeEventCreateRequest:
+      description: Object representing an event.
+      properties:
+        attributes:
+          $ref: '#/components/schemas/ChangeEvent'
+        type:
+          $ref: '#/components/schemas/ChangeEventCreateRequestType'
+      type: object
+    ChangeEventCreateRequestPayload:
+      description: Create an event.
+      properties:
+        data:
+          $ref: '#/components/schemas/ChangeEventCreateRequest'
+      type: object
+    ChangeEventCreateRequestType:
+      description: Entity type.
+      enum:
+      - event
+      example: event
+      type: string
+      x-enum-varnames:
+      - EVENT
+    ChangeEventCreateResponse:
+      description: Object containing an event response.
+      properties:
+        attributes:
+          $ref: '#/components/schemas/ChangeEventCreateResponseAttributes'
+        type:
+          description: Event type
+          type: string
+      type: object
+    ChangeEventCreateResponseAttributes:
+      description: The definition of `ChangeEventCreateResponseAttributes` object.
+      properties:
+        attributes:
+          $ref: '#/components/schemas/ChangeEventCreateResponseAttributesAttributes'
+      type: object
+    ChangeEventCreateResponseAttributesAttributes:
+      description: The definition of `ChangeEventCreateResponseAttributesAttributes`
+        object.
+      properties:
+        evt:
+          $ref: '#/components/schemas/ChangeEventCreateResponseAttributesAttributesEvt'
+      type: object
+    ChangeEventCreateResponseAttributesAttributesEvt:
+      description: The definition of `ChangeEventCreateResponseAttributesAttributesEvt`
+        object.
+      properties:
+        id:
+          description: Event id
+          type: string
+      type: object
+    ChangeEventCreateResponsePayload:
+      description: Response containing information about created event.
+      properties:
+        data:
+          $ref: '#/components/schemas/ChangeEventCreateResponse'
+      type: object
+    ChangeEventCustomAttributes:
+      description: Object representing custom event attributes.
+      properties:
+        author:
+          $ref: '#/components/schemas/ChangeEventCustomAttributesAuthor'
+        change_metadata:
+          additionalProperties: {}
+          description: Free form object with any related information of the `change`
+            event.
+          example:
+            resource_link: /feature/fallback_payments_test
+            user:
+              email: user@example.com
+              name: dd_user
+          type: object
+        changed_resource:
+          $ref: '#/components/schemas/ChangeEventCustomAttributesChangedResource'
+        impacted_resources:
+          description: 'A list of resources impacted by this change. At least one
+            resource is required. Only resources
+
+            of type `service` are supported.'
+          example:
+          - name: payments_api
+            type: service
+          items:
+            $ref: '#/components/schemas/ChangeEventCustomAttributesImpactedResourcesItems'
+          minItems: 1
+          type: array
+        new_value:
+          additionalProperties: {}
+          description: Free form object to track new value of the changed resource.
+          example:
+            enabled: true
+            percentage: 50%
+            rule:
+              datacenter: us1.prod
+          type: object
+        prev_value:
+          additionalProperties: {}
+          description: Free form object to track previous value of the changed resource.
+          example:
+            enabled: true
+            percentage: 10%
+            rule:
+              datacenter: us1.prod
+          type: object
+      required:
+      - changed_resource
+      type: object
+    ChangeEventCustomAttributesAuthor:
+      description: Object representing the entity which made the change. Optional
+        field but if provided should include `type` and `name`.
+      properties:
+        name:
+          description: Author's name. Limited to 128 characters.
+          example: user_name
+          maxLength: 128
+          type: string
+        type:
+          $ref: '#/components/schemas/ChangeEventCustomAttributesAuthorType'
+      required:
+      - name
+      - type
+      type: object
+    ChangeEventCustomAttributesAuthorType:
+      description: Author's type.
+      enum:
+      - user
+      - system
+      example: user
+      type: string
+      x-enum-varnames:
+      - USER
+      - SYSTEM
+    ChangeEventCustomAttributesChangedResource:
+      description: Object representing a uniquely identified resource. Only the resource
+        type `feature_flag` is supported.
+      properties:
+        name:
+          description: Resource's name.
+          example: fallback_payments_test
+          type: string
+        type:
+          $ref: '#/components/schemas/ChangeEventCustomAttributesChangedResourceType'
+      required:
+      - type
+      - name
+      type: object
+    ChangeEventCustomAttributesChangedResourceType:
+      description: Resource's type.
+      enum:
+      - feature_flag
+      example: feature_flag
+      type: string
+      x-enum-varnames:
+      - FEATURE_FLAG
+    ChangeEventCustomAttributesImpactedResourcesItems:
+      description: Object representing a uniquely identified resource. Only the resource
+        type `service` is supported.
+      properties:
+        name:
+          description: Resource's name.
+          example: payments_api
+          type: string
+        type:
+          $ref: '#/components/schemas/ChangeEventCustomAttributesImpactedResourcesItemsType'
+      required:
+      - type
+      - name
+      type: object
+    ChangeEventCustomAttributesImpactedResourcesItemsType:
+      description: Resource's type.
+      enum:
+      - service
+      example: service
+      type: string
+      x-enum-varnames:
+      - SERVICE
     ChargebackBreakdown:
       description: Charges breakdown.
       properties:
@@ -29664,6 +29898,47 @@ paths:
         operator: OR
         permissions:
         - events_read
+    post:
+      description: This endpoint allows you to post events. Only events with `change`
+        category are supported.
+      operationId: CreateEvent
+      requestBody:
+        content:
+          application/json:
+            schema:
+              $ref: '#/components/schemas/ChangeEventCreateRequestPayload'
+        description: Event request object
+        required: true
+      responses:
+        '200':
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/ChangeEventCreateResponsePayload'
+          description: OK
+        '400':
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/JSONAPIErrorResponse'
+          description: Bad request
+        '403':
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/JSONAPIErrorResponse'
+          description: Forbidden
+        '429':
+          $ref: '#/components/responses/TooManyRequestsResponse'
+      security:
+      - apiKeyAuth: []
+      summary: Post a change event
+      tags:
+      - Events
+      x-codegen-request-body-name: body
+      x-unstable: '**Note**: This endpoint is in **Preview**.
+
+        If you have any feedback, contact [Datadog support](https://docs.datadoghq.com/help/).'
   /api/v2/events/search:
     post:
       description: 'List endpoint returns events that match an events search query.

examples/v2/events/CreateEvent.java

@@ -0,0 +1,88 @@
+// Post a change event returns "OK" response
+
+import com.datadog.api.client.ApiClient;
+import com.datadog.api.client.ApiException;
+import com.datadog.api.client.v2.api.EventsApi;
+import com.datadog.api.client.v2.model.ChangeEvent;
+import com.datadog.api.client.v2.model.ChangeEventCategory;
+import com.datadog.api.client.v2.model.ChangeEventCreateRequest;
+import com.datadog.api.client.v2.model.ChangeEventCreateRequestPayload;
+import com.datadog.api.client.v2.model.ChangeEventCreateRequestType;
+import com.datadog.api.client.v2.model.ChangeEventCreateResponsePayload;
+import com.datadog.api.client.v2.model.ChangeEventCustomAttributes;
+import com.datadog.api.client.v2.model.ChangeEventCustomAttributesAuthor;
+import com.datadog.api.client.v2.model.ChangeEventCustomAttributesAuthorType;
+import com.datadog.api.client.v2.model.ChangeEventCustomAttributesChangedResource;
+import com.datadog.api.client.v2.model.ChangeEventCustomAttributesChangedResourceType;
+import com.datadog.api.client.v2.model.ChangeEventCustomAttributesImpactedResourcesItems;
+import com.datadog.api.client.v2.model.ChangeEventCustomAttributesImpactedResourcesItemsType;
+import java.util.Collections;
+import java.util.Map;
+
+public class Example {
+  public static void main(String[] args) {
+    ApiClient defaultClient = ApiClient.getDefaultApiClient();
+    defaultClient.setUnstableOperationEnabled("v2.createEvent", true);
+    EventsApi apiInstance = new EventsApi(defaultClient);
+
+    ChangeEventCreateRequestPayload body =
+        new ChangeEventCreateRequestPayload()
+            .data(
+                new ChangeEventCreateRequest()
+                    .attributes(
+                        new ChangeEvent()
+                            .attributes(
+                                new ChangeEventCustomAttributes()
+                                    .author(
+                                        new ChangeEventCustomAttributesAuthor()
+                                            .name("user_name")
+                                            .type(ChangeEventCustomAttributesAuthorType.USER))
+                                    .changeMetadata(
+                                        Map.ofEntries(
+                                            Map.entry(
+                                                "resource_link", "/feature/fallback_payments_test"),
+                                            Map.entry(
+                                                "user",
+                                                "{'email': 'user@example.com', 'name':"
+                                                    + " 'dd_user'}")))
+                                    .changedResource(
+                                        new ChangeEventCustomAttributesChangedResource()
+                                            .name("fallback_payments_test")
+                                            .type(
+                                                ChangeEventCustomAttributesChangedResourceType
+                                                    .FEATURE_FLAG))
+                                    .impactedResources(
+                                        Collections.singletonList(
+                                            new ChangeEventCustomAttributesImpactedResourcesItems()
+                                                .name("payments_api")
+                                                .type(
+                                                    ChangeEventCustomAttributesImpactedResourcesItemsType
+                                                        .SERVICE)))
+                                    .newValue(
+                                        Map.ofEntries(
+                                            Map.entry("enabled", "True"),
+                                            Map.entry("percentage", "50%"),
+                                            Map.entry("rule", "{'datacenter': 'us1.prod'}")))
+                                    .prevValue(
+                                        Map.ofEntries(
+                                            Map.entry("enabled", "True"),
+                                            Map.entry("percentage", "10%"),
+                                            Map.entry("rule", "{'datacenter': 'us1.prod'}"))))
+                            .category(ChangeEventCategory.CHANGE)
+                            .message("payment_processed feature flag has been enabled")
+                            .tags(Collections.singletonList("environment:test"))
+                            .title("payment_processed feature flag updated"))
+                    .type(ChangeEventCreateRequestType.EVENT));
+
+    try {
+      ChangeEventCreateResponsePayload result = apiInstance.createEvent(body);
+      System.out.println(result);
+    } catch (ApiException e) {
+      System.err.println("Exception when calling EventsApi#createEvent");
+      System.err.println("Status code: " + e.getCode());
+      System.err.println("Reason: " + e.getResponseBody());
+      System.err.println("Response headers: " + e.getResponseHeaders());
+      e.printStackTrace();
+    }
+  }
+}