# 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 Data Tiering API
  version: 1.0.0
extends: openapi/cohesity-data-tiering-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: 16
- target: $.paths['/data-tiering/analysis-groups'].get
  update:
    x-apievangelist-phrasing:
      intent: List data tiering analysis groups
      effect: read
      questions:
      - Which data tiering analysis groups are set up on my cluster?
      - Can I look up several analysis groups by their ids?
      instructions:
      - text: List all data tiering analysis groups.
      - text: Show data tiering analysis groups {ids}.
        slots:
          ids: query.ids
      method: generated
      generated: '2026-10-01'
- target: $.paths['/data-tiering/analysis-groups'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a data tiering analysis group
      effect: write
      questions:
      - How do I set up analysis to see which data could be tiered?
      - Can I create an analysis group for a NAS source?
      instructions:
      - text: Create a data tiering analysis group named {name} for source {source}.
        slots:
          name: requestBody.name
          source: requestBody.source
      - text: Set up tiering analysis {name} on source {source}.
        slots:
          name: requestBody.name
          source: requestBody.source
      method: generated
      generated: '2026-10-01'
- target: $.paths['/data-tiering/analysis-groups/states'].post
  update:
    x-apievangelist-phrasing:
      intent: Pause or resume analysis groups
      effect: write
      questions:
      - Can I pause data tiering analysis for several sources at once?
      - How do I resume paused analysis groups?
      instructions:
      - text: Apply {action} to analysis groups {ids}.
        slots:
          action: requestBody.action
          ids: requestBody.ids
      - text: Pause analysis groups {ids} with action {action}.
        slots:
          ids: requestBody.ids
          action: requestBody.action
      method: generated
      generated: '2026-10-01'
- target: $.paths['/data-tiering/analysis-groups/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a data tiering analysis group
      effect: read
      questions:
      - What are the settings of one tiering analysis group?
      - Where can I view a single analysis group by its id?
      instructions:
      - text: Show data tiering analysis group {id}.
        slots:
          id: path.id
      - text: Get the analysis group {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/data-tiering/analysis-groups/{id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a data tiering analysis group
      effect: destructive
      questions:
      - How do I remove a data tiering analysis group?
      - Can I delete an analysis group I no longer need?
      instructions:
      - text: Delete data tiering analysis group {id}.
        slots:
          id: path.id
      - text: Remove analysis group {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/data-tiering/analysis-groups/{id}/config'].put
  update:
    x-apievangelist-phrasing:
      intent: Update an analysis group's tag config
      effect: write
      questions:
      - Can I change the tags used by a data tiering analysis group?
      - How do I configure tag info on an analysis group?
      instructions:
      - text: Set the tags info on analysis group {id} to {tagsInfo}.
        slots:
          id: path.id
          tagsInfo: requestBody.tagsInfo
      - text: Update the config of analysis group {id} with tags {tagsInfo}.
        slots:
          id: path.id
          tagsInfo: requestBody.tagsInfo
      method: generated
      generated: '2026-10-01'
- target: $.paths['/data-tiering/analysis-groups/{id}/runs'].post
  update:
    x-apievangelist-phrasing:
      intent: Run a data tiering analysis
      effect: write
      questions:
      - How do I start an analysis run to find cold data?
      - Can I trigger an analysis group run on demand?
      instructions:
      - text: Start an analysis run for group {id}.
        slots:
          id: path.id
      - text: Run data tiering analysis group {id} now.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/data-tiering/analysis-groups/{id}/runs/{runId}/cancel'].post
  update:
    x-apievangelist-phrasing:
      intent: Cancel a data tiering analysis run
      effect: destructive
      questions:
      - How do I stop an analysis run that's in progress?
      - Can I cancel one analysis run without deleting the group?
      instructions:
      - text: Cancel analysis run {runId} of group {id}.
        slots:
          runId: path.runId
          id: path.id
      - text: Stop the in-progress analysis {runId} for analysis group {id}.
        slots:
          runId: path.runId
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/data-tiering/tasks'].get
  update:
    x-apievangelist-phrasing:
      intent: List data tiering tasks
      effect: read
      questions:
      - Which data tiering tasks are configured?
      - Can I look up several tiering tasks by id?
      instructions:
      - text: List all data tiering tasks.
      - text: Show data tiering tasks {ids}.
        slots:
          ids: query.ids
      method: generated
      generated: '2026-10-01'
- target: $.paths['/data-tiering/tasks'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a data tiering task
      effect: write
      questions:
      - How do I set up a task that moves data between tiers?
      - Can I schedule a tiering task from a source to a target?
      instructions:
      - text: Create a data tiering task {name} of type {type}.
        slots:
          name: requestBody.name
          type: requestBody.type
      - text: Set up tiering task {name} of type {type} from {source} to {target}.
        slots:
          name: requestBody.name
          type: requestBody.type
          source: requestBody.source
          target: requestBody.target
      method: generated
      generated: '2026-10-01'
- target: $.paths['/data-tiering/tasks/states'].post
  update:
    x-apievangelist-phrasing:
      intent: Pause or resume tiering tasks
      effect: write
      questions:
      - Can I pause several data tiering tasks at once?
      - How do I resume tiering tasks I paused?
      instructions:
      - text: Apply {action} to tiering tasks {ids}.
        slots:
          action: requestBody.action
          ids: requestBody.ids
      - text: Resume tiering tasks {ids} with action {action}.
        slots:
          ids: requestBody.ids
          action: requestBody.action
      method: generated
      generated: '2026-10-01'
- target: $.paths['/data-tiering/tasks/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a data tiering task
      effect: read
      questions:
      - What's the schedule and target of one tiering task?
      - Where can I view a single tiering task by its id?
      instructions:
      - text: Show data tiering task {id}.
        slots:
          id: path.id
      - text: Get tiering task {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/data-tiering/tasks/{id}'].put
  update:
    x-apievangelist-phrasing:
      intent: Update a data tiering task
      effect: write
      questions:
      - Can I change the schedule or target of an existing tiering task?
      - How do I edit a data tiering task's alert policy?
      instructions:
      - text: Update tiering task {id} with name {name} and type {type}.
        slots:
          id: path.id
          name: requestBody.name
          type: requestBody.type
      - text: Change the schedule of tiering task {id} to {schedule}, keeping name {name} and type {type}.
        slots:
          id: path.id
          schedule: requestBody.schedule
          name: requestBody.name
          type: requestBody.type
      method: generated
      generated: '2026-10-01'
- target: $.paths['/data-tiering/tasks/{id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a data tiering task
      effect: destructive
      questions:
      - How do I remove a data tiering task?
      - Can I delete a tiering task I set up by mistake?
      instructions:
      - text: Delete data tiering task {id}.
        slots:
          id: path.id
      - text: Remove tiering task {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/data-tiering/tasks/{id}/runs'].post
  update:
    x-apievangelist-phrasing:
      intent: Run a data tiering task
      effect: write
      questions:
      - How do I trigger a tiering task run right now?
      - Can I uptier a specific path back with a task run?
      instructions:
      - text: Start a run of tiering task {id}.
        slots:
          id: path.id
      - text: Run tiering task {id} to uptier path {uptierPath}.
        slots:
          id: path.id
          uptierPath: requestBody.uptierPath
      method: generated
      generated: '2026-10-01'
- target: $.paths['/data-tiering/tasks/{id}/runs/{runId}/cancel'].post
  update:
    x-apievangelist-phrasing:
      intent: Cancel a data tiering task run
      effect: destructive
      questions:
      - How do I stop a tiering task run that's underway?
      - Can I cancel one run of a tiering task?
      instructions:
      - text: Cancel run {runId} of tiering task {id}.
        slots:
          runId: path.runId
          id: path.id
      - text: Stop tiering task {id} run {runId}.
        slots:
          id: path.id
          runId: path.runId
      method: generated
      generated: '2026-10-01'