Acronis · OpenAPI Overlay 1.0.0

API Evangelist conversational phrasing for Disaster Recovery Servers API

6 actions 6 updates phrasing extends openapi/acronis-servers-api-openapi.yml

Generated by API Evangelist Written by API Evangelist tooling for Acronis's API. It is a proposal applied on top of the contract, not a document Acronis publishes.

View Overlay File View on GitHub Overlay Specification

What the actions change

x-apievangelist-phrasing

Targets 6

$.info

$.paths['/servers'].get

$.paths['/servers/{uuid}'].get

$.paths['/servers/{uuid}:start_failover_prod'].post

$.paths['/servers/{uuid}:start_failover_test'].post

$.paths['/servers/{uuid}:stop_failover'].post

OpenAPI Overlay

# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Disaster Recovery Servers API
  version: 1.0.0
extends: openapi/acronis-servers-api-openapi.yml
actions:
- target: $.info
  update:
    x-apievangelist-phrasing:
      method: generated
      generated: '2026-09-26'
      generator: build-phrasing.py
      label: Generated by API Evangelist
      operations: 5
- target: $.paths['/servers'].get
  update:
    x-apievangelist-phrasing:
      intent: List disaster recovery cloud servers
      effect: read
      questions:
      - Which cloud servers do I have for disaster recovery?
      - Can I list only recovery servers for a specific protected resource?
      instructions:
      - text: List cloud servers of type {type}.
        slots:
          type: query.type
      - text: List recovery servers for resource {recovery.resource_id}.
        slots:
          recovery.resource_id: query.recovery.resource_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/servers/{uuid}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a cloud server
      effect: read
      questions:
      - How do I check the details of one cloud server?
      - Is my recovery server currently in failover?
      instructions:
      - text: Show cloud server {uuid}.
        slots:
          uuid: path.uuid
      - text: Get the state of recovery server {uuid}.
        slots:
          uuid: path.uuid
      method: generated
      generated: '2026-09-26'
- target: $.paths['/servers/{uuid}:start_failover_prod'].post
  update:
    x-apievangelist-phrasing:
      intent: Start a production failover
      effect: write
      questions:
      - How do I fail over production to a cloud recovery server?
      - Can I choose which recovery point to fail over to?
      instructions:
      - text: Start production failover on cloud server {uuid}.
        slots:
          uuid: path.uuid
      - text: Fail production over to server {uuid} from recovery point {recovery_point}.
        slots:
          uuid: path.uuid
          recovery_point: requestBody.recovery_point
      method: generated
      generated: '2026-09-26'
- target: $.paths['/servers/{uuid}:start_failover_test'].post
  update:
    x-apievangelist-phrasing:
      intent: Start a test failover
      effect: write
      questions:
      - How do I run a test failover without affecting production?
      - Can I test failover to an older recovery point?
      instructions:
      - text: Start a test failover on cloud server {uuid}.
        slots:
          uuid: path.uuid
      - text: Test failover server {uuid} using recovery point {recovery_point}.
        slots:
          uuid: path.uuid
          recovery_point: requestBody.recovery_point
      method: generated
      generated: '2026-09-26'
- target: $.paths['/servers/{uuid}:stop_failover'].post
  update:
    x-apievangelist-phrasing:
      intent: Stop a running failover
      effect: write
      questions:
      - How do I stop a failover that is running on a cloud server?
      - Can I end a test failover when I'm done checking it?
      instructions:
      - text: Stop failover on cloud server {uuid}.
        slots:
          uuid: path.uuid
      - text: End the running failover for server {uuid}.
        slots:
          uuid: path.uuid
      method: generated
      generated: '2026-09-26'