# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Cohesity REST Network API
  version: 1.0.0
extends: openapi/cohesity-network-api-openapi.yml
actions:
- target: $.info
  update:
    x-apievangelist-phrasing:
      method: generated
      generated: '2026-10-01'
      generator: build-phrasing.py
      label: Generated by API Evangelist
      operations: 6
- target: $.paths['/public/network/bonds'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a network bond on a node
      effect: write
      questions:
      - How do I bond network interfaces on a node before it joins a cluster?
      - Which bonding mode can I choose for a new bond?
      instructions:
      - text: Create bond {name} from interfaces {slaves}.
        slots:
          name: requestBody.name
          slaves: requestBody.slaves
      - text: Bond {slaves} as {name} in mode {bondingMode}.
        slots:
          slaves: requestBody.slaves
          name: requestBody.name
          bondingMode: requestBody.bondingMode
      method: generated
      generated: '2026-10-01'
- target: $.paths['/public/network/bonds/{name}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a network bond
      effect: destructive
      questions:
      - How do I remove a network bond from a node?
      - Can I delete a bond after the node is already in a cluster?
      instructions:
      - text: Delete network bond {name}.
        slots:
          name: path.name
      - text: Remove bond {name} from the node.
        slots:
          name: path.name
      method: generated
      generated: '2026-10-01'
- target: $.paths['/public/network/hosts'].get
  update:
    x-apievangelist-phrasing:
      intent: List entries in the cluster hosts file
      effect: read
      questions:
      - What's currently in the cluster's /etc/hosts file?
      - Which hostnames are mapped locally on the cluster?
      instructions:
      - text: Show the cluster's hosts file entries.
      - text: List current /etc/hosts mappings.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/public/network/hosts'].put
  update:
    x-apievangelist-phrasing:
      intent: Edit existing hosts file entries
      effect: write
      questions:
      - How do I change the IP of a hostname already in the cluster hosts file?
      - Can I edit several /etc/hosts entries at once?
      instructions:
      - text: 'Edit these existing hosts entries: {hosts}.'
        slots:
          hosts: requestBody.hosts
      - text: Change the cluster hosts file mappings to {hosts}.
        slots:
          hosts: requestBody.hosts
      method: generated
      generated: '2026-10-01'
- target: $.paths['/public/network/hosts'].post
  update:
    x-apievangelist-phrasing:
      intent: Add new hosts file entries
      effect: write
      questions:
      - How do I add a new hostname mapping to the cluster's /etc/hosts?
      - Can I append several host entries without touching existing ones?
      instructions:
      - text: 'Append these new entries to /etc/hosts: {hosts}.'
        slots:
          hosts: requestBody.hosts
      - text: Add host mapping {hosts} to the cluster.
        slots:
          hosts: requestBody.hosts
      method: generated
      generated: '2026-10-01'
- target: $.paths['/public/network/hosts'].delete
  update:
    x-apievangelist-phrasing:
      intent: Remove hosts file entries by IP
      effect: destructive
      questions:
      - How do I delete entries from the cluster hosts file?
      - Can I remove host mappings for a list of IP addresses?
      instructions:
      - text: Remove /etc/hosts entries for IPs {ips}.
        slots:
          ips: query.ips
      - text: Delete host mappings for {ips}.
        slots:
          ips: query.ips
      method: generated
      generated: '2026-10-01'