Oracle OCI Start Compute Instance

arazzo: 1.0.1
info:
  title: Oracle OCI Start Compute Instance
  summary: Read a stopped instance, send the START action, then poll until it reports RUNNING.
  description: >-
    Powers on a stopped compute instance and confirms it came back online. The
    workflow reads the current instance to capture its ETag, issues the START
    instance action guarded by that ETag, and then polls getInstance until the
    lifecycle state becomes RUNNING. 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: start-instance
  summary: Start a stopped compute instance and confirm it reaches RUNNING.
  description: >-
    Reads the instance, performs the START action with an if-match guard, and
    polls the lifecycle state until the instance is RUNNING.
  inputs:
    type: object
    required:
    - instanceId
    properties:
      instanceId:
        type: string
        description: The OCID of the instance to start.
      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 start 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: startInstance
    description: >-
      Perform the START action on the instance to power it on, guarded by the
      ETag captured when reading the instance.
    operationId: InstanceAction
    parameters:
    - name: instanceId
      in: path
      value: $inputs.instanceId
    - name: action
      in: path
      value: START
    - 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: pollRunning
    description: >-
      Read the instance and check its lifecycle state. Repeat this step until
      the instance reports RUNNING.
    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: running
      type: end
      criteria:
      - context: $response.body
        condition: $.lifecycleState == "RUNNING"
        type: jsonpath
    - name: keepPolling
      type: goto
      stepId: pollRunning
      criteria:
      - context: $response.body
        condition: $.lifecycleState != "RUNNING"
        type: jsonpath
  outputs:
    instanceId: $inputs.instanceId
    lifecycleState: $steps.pollRunning.outputs.lifecycleState