Oracle OCI Stop Compute Instance

arazzo: 1.0.1
info:
  title: Oracle OCI Stop Compute Instance
  summary: Read an instance, send the STOP action, then poll until it reports STOPPED.
  description: >-
    Gracefully powers off a running compute instance and confirms the shutdown
    completed. The workflow reads the current instance to capture its ETag for
    optimistic concurrency, issues the STOP instance action guarded by that
    ETag, and then polls getInstance until the lifecycle state becomes STOPPED.
    Every step spells out its request inline so the flow can be read and executed
    without opening the underlying OpenAPI description.
  version: 1.0.0
  x-realizes-capability-ids:
  - BC-600.50
  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.50
      capability_name: IT Infrastructure Management
      spec: oracle-compute-api-openapi.yml
      confidence: 0.9
    model: Turbo EA Capabilities by Vincent Verdet — Turbo EA, https://github.com/vincentmakes/turbo-ea-capabilities, CC BY 4.0
sourceDescriptions:
- name: computeApi
  url: ../openapi/oracle-compute-api-openapi.yml
  type: openapi
workflows:
- workflowId: stop-instance
  summary: Stop a running compute instance and confirm it reaches STOPPED.
  description: >-
    Reads the instance, performs the STOP action with an if-match guard, and
    polls the lifecycle state until the instance is STOPPED.
  inputs:
    type: object
    required:
    - instanceId
    properties:
      instanceId:
        type: string
        description: The OCID of the instance to stop.
      authToken:
        type: string
        description: OCI request-signing bearer credential for the Authorization header.
  steps:
  - stepId: readInstance
    description: >-
      Read the instance to confirm it exists and capture its current ETag for
      optimistic concurrency control on the stop action.
    operationId: GetInstance
    parameters:
    - name: instanceId
      in: path
      value: $inputs.instanceId
    - name: Authorization
      in: header
      value: $inputs.authToken
    successCriteria:
    - condition: $statusCode == 200
    outputs:
      etag: $response.headers.etag
      lifecycleState: $response.body#/lifecycleState
  - stepId: stopInstance
    description: >-
      Perform the STOP action on the instance, equivalent to pressing the power
      button, guarded by the ETag captured when reading the instance.
    operationId: InstanceAction
    parameters:
    - name: instanceId
      in: path
      value: $inputs.instanceId
    - name: action
      in: path
      value: STOP
    - name: if-match
      in: header
      value: $steps.readInstance.outputs.etag
    - name: Authorization
      in: header
      value: $inputs.authToken
    successCriteria:
    - condition: $statusCode == 200
    outputs:
      lifecycleState: $response.body#/lifecycleState
  - stepId: pollStopped
    description: >-
      Read the instance and check its lifecycle state. Repeat this step until
      the instance reports STOPPED.
    operationId: GetInstance
    parameters:
    - name: instanceId
      in: path
      value: $inputs.instanceId
    - name: Authorization
      in: header
      value: $inputs.authToken
    successCriteria:
    - condition: $statusCode == 200
    outputs:
      lifecycleState: $response.body#/lifecycleState
    onSuccess:
    - name: stopped
      type: end
      criteria:
      - context: $response.body
        condition: $.lifecycleState == "STOPPED"
        type: jsonpath
    - name: keepPolling
      type: goto
      stepId: pollStopped
      criteria:
      - context: $response.body
        condition: $.lifecycleState != "STOPPED"
        type: jsonpath
  outputs:
    instanceId: $inputs.instanceId
    lifecycleState: $steps.pollStopped.outputs.lifecycleState