Oracle Enterprise Manager End Active Blackout

arazzo: 1.0.1
info:
  title: Oracle Enterprise Manager End Active Blackout
  summary: Find a started blackout for a target and stop it early to resume monitoring.
  description: >-
    Ends an in-progress maintenance window early. The workflow lists blackouts
    filtered to STARTED status (optionally scoped to a target), selects the
    first active blackout, reads it back to confirm it is still stoppable, and
    then issues the stop action so monitoring and alerting resume immediately.
    A branch ensures the stop only runs when an active blackout was found, and
    the stop step documents the 409 "not stoppable" outcome.
  version: 1.0.0
  x-realizes-capability-ids:
  - BC-600.40
  x-capability-derivation:
    method: 'deterministic join: sourceDescriptions -> per-tag OpenAPI -> tag/capability edge. No classification at this step.'
    min_confidence: 0.7
    sources:
    - capability_id: BC-600.40
      capability_name: IT Operations Management
      spec: oracle-enterprise-manager-blackouts-api-openapi.yml
      confidence: 0.75
    model: Turbo EA Capabilities by Vincent Verdet — Turbo EA, https://github.com/vincentmakes/turbo-ea-capabilities, CC BY 4.0
sourceDescriptions:
- name: blackoutsApi
  url: ../openapi/oracle-enterprise-manager-blackouts-api-openapi.yml
  type: openapi
workflows:
- workflowId: end-active-blackout
  summary: Locate a started blackout and stop it early.
  description: >-
    Lists STARTED blackouts, picks the first, confirms it, and stops it so
    monitoring resumes for the affected targets.
  inputs:
    type: object
    properties:
      targetName:
        type: string
        description: Optional target name to scope the active-blackout search.
      limit:
        type: integer
        description: Maximum number of blackouts to scan.
        default: 25
  steps:
  - stepId: listActiveBlackouts
    description: List blackouts currently in the STARTED state.
    operationId: listBlackouts
    parameters:
    - name: status
      in: query
      value: STARTED
    - name: targetName
      in: query
      value: $inputs.targetName
    - name: limit
      in: query
      value: $inputs.limit
    successCriteria:
    - condition: $statusCode == 200
    outputs:
      activeBlackoutId: $response.body#/items/0/blackoutId
    onSuccess:
    - name: blackoutFound
      type: goto
      stepId: confirmBlackout
      criteria:
      - context: $response.body
        condition: $.items.length > 0
        type: jsonpath
  - stepId: confirmBlackout
    description: Read the selected blackout to confirm its current status before stopping.
    operationId: getBlackout
    parameters:
    - name: blackoutId
      in: path
      value: $steps.listActiveBlackouts.outputs.activeBlackoutId
    successCriteria:
    - condition: $statusCode == 200
    outputs:
      blackoutId: $response.body#/blackoutId
      status: $response.body#/status
  - stepId: stopTheBlackout
    description: >-
      Stop the active blackout so monitoring and alerting resume immediately.
      A 200 confirms the stop; a 409 indicates the blackout was not in a
      stoppable state.
    operationId: stopBlackout
    parameters:
    - name: blackoutId
      in: path
      value: $steps.confirmBlackout.outputs.blackoutId
    successCriteria:
    - condition: $statusCode == 200
    outputs:
      blackoutId: $response.body#/blackoutId
      stoppedStatus: $response.body#/status
  outputs:
    blackoutId: $steps.confirmBlackout.outputs.blackoutId
    stoppedStatus: $steps.stopTheBlackout.outputs.stoppedStatus