# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Microsoft Azure Targets API
  version: 1.0.0
extends: openapi/microsoft-azure-targets-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: 14
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{parentProviderNamespace}/{parentResourceType}/{parentResourceName}/providers/Microsoft.Chaos/targets'].get
  update:
    x-apievangelist-phrasing:
      intent: List Chaos Studio targets on a resource
      effect: read
      questions:
      - Which Chaos Studio targets are enabled on this Azure resource?
      - Can I see every chaos experiment target that extends a tracked regional resource?
      instructions:
      - text: List the Chaos Studio targets on {parentProviderNamespace}/{parentResourceType} resource {parentResourceName}.
        slots:
          parentProviderNamespace: path.parentProviderNamespace
          parentResourceType: path.parentResourceType
          parentResourceName: path.parentResourceName
      - text: Show every chaos target attached to parent resource {parentResourceName}.
        slots:
          parentResourceName: path.parentResourceName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{parentProviderNamespace}/{parentResourceType}/{parentResourceName}/providers/Microsoft.Chaos/targets/{targetName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a Chaos Studio target
      effect: read
      questions:
      - Is a particular Chaos Studio target enabled on my resource?
      - What does a single chaos target on a regional resource look like?
      instructions:
      - text: Get Chaos Studio target {targetName} on {parentProviderNamespace}/{parentResourceType} resource {parentResourceName}.
        slots:
          targetName: path.targetName
          parentProviderNamespace: path.parentProviderNamespace
          parentResourceType: path.parentResourceType
          parentResourceName: path.parentResourceName
      - text: Show the details of chaos target {targetName} for parent resource {parentResourceName}.
        slots:
          targetName: path.targetName
          parentResourceName: path.parentResourceName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{parentProviderNamespace}/{parentResourceType}/{parentResourceName}/providers/Microsoft.Chaos/targets/{targetName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Enable a Chaos Studio target on a resource
      effect: write
      questions:
      - How do I onboard a resource as a Chaos Studio target?
      - Can I update an existing chaos target on a regional resource?
      instructions:
      - text: Enable Chaos Studio target {targetName} on {parentProviderNamespace}/{parentResourceType} resource {parentResourceName}.
        slots:
          targetName: path.targetName
          parentProviderNamespace: path.parentProviderNamespace
          parentResourceType: path.parentResourceType
          parentResourceName: path.parentResourceName
      - text: Create or update chaos target {targetName} for parent resource {parentResourceName}.
        slots:
          targetName: path.targetName
          parentResourceName: path.parentResourceName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{parentProviderNamespace}/{parentResourceType}/{parentResourceName}/providers/Microsoft.Chaos/targets/{targetName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Remove a Chaos Studio target from a resource
      effect: destructive
      questions:
      - Can I stop a resource from being a Chaos Studio target?
      - What happens to chaos experiments when I delete the target?
      instructions:
      - text: Delete Chaos Studio target {targetName} from {parentProviderNamespace}/{parentResourceType} resource {parentResourceName}.
        slots:
          targetName: path.targetName
          parentProviderNamespace: path.parentProviderNamespace
          parentResourceType: path.parentResourceType
          parentResourceName: path.parentResourceName
      - text: Offboard parent resource {parentResourceName} from chaos targeting by removing {targetName}.
        slots:
          parentResourceName: path.parentResourceName
          targetName: path.targetName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DatabaseWatcher/watchers/{watcherName}/targets'].get
  update:
    x-apievangelist-phrasing:
      intent: List database watcher targets
      effect: read
      questions:
      - Which databases is my database watcher monitoring?
      - Can I list all targets configured on one database watcher?
      instructions:
      - text: List the targets of database watcher {watcherName}.
        slots:
          watcherName: path.watcherName
      - text: Show every monitored target on watcher {watcherName}.
        slots:
          watcherName: path.watcherName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DatabaseWatcher/watchers/{watcherName}/targets/{targetName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a database watcher target
      effect: read
      questions:
      - What settings does a single database watcher target have?
      - Can I look up one monitored database target by name?
      instructions:
      - text: Get target {targetName} on database watcher {watcherName}.
        slots:
          targetName: path.targetName
          watcherName: path.watcherName
      - text: Show the configuration of watcher target {targetName}.
        slots:
          targetName: path.targetName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DatabaseWatcher/watchers/{watcherName}/targets/{targetName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Add a target to a database watcher
      effect: write
      questions:
      - How do I add a database for a database watcher to monitor?
      - Can I create a new monitored target on an existing watcher?
      instructions:
      - text: Add target {targetName} to database watcher {watcherName}.
        slots:
          targetName: path.targetName
          watcherName: path.watcherName
      - text: Create watcher target {targetName} under {watcherName}.
        slots:
          targetName: path.targetName
          watcherName: path.watcherName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DatabaseWatcher/watchers/{watcherName}/targets/{targetName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Remove a target from a database watcher
      effect: destructive
      questions:
      - Can I stop a database watcher from monitoring one database?
      - Is deleting a watcher target reversible?
      instructions:
      - text: Delete target {targetName} from database watcher {watcherName}.
        slots:
          targetName: path.targetName
          watcherName: path.watcherName
      - text: Stop watcher {watcherName} from monitoring target {targetName}.
        slots:
          watcherName: path.watcherName
          targetName: path.targetName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.IoTOperationsOrchestrator/targets'].get
  update:
    x-apievangelist-phrasing:
      intent: List IoT Operations orchestrator targets in a subscription
      effect: read
      questions:
      - What IoT Operations orchestrator targets exist across my subscription?
      - Is there a subscription-wide list of orchestrator deployment targets?
      instructions:
      - text: List all IoT Operations orchestrator targets in my subscription.
      - text: Show every orchestrator target across the subscription.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.IoTOperationsOrchestrator/targets'].get
  update:
    x-apievangelist-phrasing:
      intent: List IoT Operations orchestrator targets in a group
      effect: read
      questions:
      - Which IoT Operations orchestrator targets are in this resource group?
      - Can I list orchestrator targets for just one resource group?
      instructions:
      - text: List the IoT Operations orchestrator targets in my resource group.
      - text: Show the orchestrator targets defined in this resource group.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.IoTOperationsOrchestrator/targets/{name}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an IoT Operations orchestrator target
      effect: read
      questions:
      - What is configured on a specific IoT Operations orchestrator target?
      - Can I fetch one orchestrator target by name?
      instructions:
      - text: Get IoT Operations orchestrator target {name}.
        slots:
          name: path.name
      - text: Show the extended location and properties of orchestrator target {name}.
        slots:
          name: path.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.IoTOperationsOrchestrator/targets/{name}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create an IoT Operations orchestrator target
      effect: write
      questions:
      - How do I create an orchestrator target for IoT Operations at an extended location?
      - Does creating an IoT Operations orchestrator target require an extended location?
      instructions:
      - text: Create IoT Operations orchestrator target {name} at extended location {extendedLocation}.
        slots:
          name: path.name
          extendedLocation: requestBody.extendedLocation
      - text: Create or replace orchestrator target {name}.
        slots:
          name: path.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.IoTOperationsOrchestrator/targets/{name}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete an IoT Operations orchestrator target
      effect: destructive
      questions:
      - Can I remove an IoT Operations orchestrator target I no longer deploy to?
      - What happens to an orchestrator target once it is deleted?
      instructions:
      - text: Delete IoT Operations orchestrator target {name}.
        slots:
          name: path.name
      - text: Remove orchestrator target {name} from the resource group.
        slots:
          name: path.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.IoTOperationsOrchestrator/targets/{name}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update tags on an IoT Operations orchestrator target
      effect: write
      questions:
      - Can I change the tags on an IoT Operations orchestrator target?
      - Which fields can I patch on an existing orchestrator target?
      instructions:
      - text: Update the tags on IoT Operations orchestrator target {name} to {tags}.
        slots:
          name: path.name
          tags: requestBody.tags
      - text: Retag orchestrator target {name}.
        slots:
          name: path.name
      method: generated
      generated: '2026-09-26'