# 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 Microsoft.ServiceLinker Linkers API
  version: 1.0.0
extends: openapi/microsoft-azure-linkers-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: 11
- target: $.paths['/{resourceUri}/providers/Microsoft.ServiceLinker/linkers/{linkerName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a Service Connector linker
      effect: destructive
      questions:
      - How do I remove a service connection from my app?
      - Can I delete a Service Connector linker by name?
      instructions:
      - text: Delete linker {linkerName} on resource {resourceUri}.
        slots:
          linkerName: path.linkerName
          resourceUri: path.resourceUri
      - text: Remove the Service Connector connection {linkerName} from {resourceUri}.
        slots:
          linkerName: path.linkerName
          resourceUri: path.resourceUri
      method: generated
      generated: '2026-09-26'
- target: $.paths['/{resourceUri}/providers/Microsoft.ServiceLinker/linkers/{linkerName}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update an existing Service Connector linker
      effect: write
      questions:
      - How do I change the auth type or target of an existing service connection?
      - Can I patch a linker's properties without recreating it?
      instructions:
      - text: Update linker {linkerName} on resource {resourceUri} with properties {properties}.
        slots:
          linkerName: path.linkerName
          resourceUri: path.resourceUri
          properties: requestBody.properties
      - text: Modify existing Service Connector connection {linkerName} on {resourceUri}.
        slots:
          linkerName: path.linkerName
          resourceUri: path.resourceUri
      method: generated
      generated: '2026-09-26'
- target: $.paths['/{resourceUri}/providers/Microsoft.ServiceLinker/linkers/{linkerName}/validateLinker'].post
  update:
    x-apievangelist-phrasing:
      intent: Validate a Service Connector linker
      effect: read
      questions:
      - How can I check that my service connection is actually working?
      - Does Service Connector tell me why a linker failed validation?
      instructions:
      - text: Validate linker {linkerName} on resource {resourceUri}.
        slots:
          linkerName: path.linkerName
          resourceUri: path.resourceUri
      - text: Run a connectivity check on Service Connector connection {linkerName} for {resourceUri}.
        slots:
          linkerName: path.linkerName
          resourceUri: path.resourceUri
      method: generated
      generated: '2026-09-26'
- target: $.paths['/{resourceUri}/providers/Microsoft.ServiceLinker/linkers/{linkerName}/listConfigurations'].post
  update:
    x-apievangelist-phrasing:
      intent: List source configurations for a linker
      effect: read
      questions:
      - Which app settings or environment variables does a service connection inject?
      - Can I see the source configurations Service Connector set for a linker?
      instructions:
      - text: List source configurations for linker {linkerName} on resource {resourceUri}.
        slots:
          linkerName: path.linkerName
          resourceUri: path.resourceUri
      - text: Show the app settings that connection {linkerName} applies to {resourceUri}.
        slots:
          linkerName: path.linkerName
          resourceUri: path.resourceUri
      method: generated
      generated: '2026-09-26'
- target: $.paths['/{resourceUri}/providers/Microsoft.ServiceLinker/dryruns'].get
  update:
    x-apievangelist-phrasing:
      intent: List Service Connector dry-run jobs
      effect: read
      questions:
      - Which dry-run checks have I created for connections on a resource?
      - How do I see all pending Service Connector dryruns?
      instructions:
      - text: List dryrun jobs on resource {resourceUri}.
        slots:
          resourceUri: path.resourceUri
      - text: Show every Service Connector dry run for {resourceUri}.
        slots:
          resourceUri: path.resourceUri
      method: generated
      generated: '2026-09-26'
- target: $.paths['/{resourceUri}/providers/Microsoft.ServiceLinker/dryruns/{dryrunName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a Service Connector dry-run job
      effect: read
      questions:
      - What did a Service Connector dry run find before I create the connection?
      - Can I read the prerequisite results of one dryrun job?
      instructions:
      - text: Get dryrun job {dryrunName} on resource {resourceUri}.
        slots:
          dryrunName: path.dryrunName
          resourceUri: path.resourceUri
      - text: Show the results of Service Connector dry run {dryrunName} for {resourceUri}.
        slots:
          dryrunName: path.dryrunName
          resourceUri: path.resourceUri
      method: generated
      generated: '2026-09-26'
- target: $.paths['/{resourceUri}/providers/Microsoft.ServiceLinker/dryruns/{dryrunName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create a dry-run check before creating a connection
      effect: write
      questions:
      - How do I test a service connection before actually creating it?
      - Can Service Connector check permissions and prerequisites ahead of time?
      instructions:
      - text: Create dryrun job {dryrunName} on resource {resourceUri} with parameters {properties}.
        slots:
          dryrunName: path.dryrunName
          resourceUri: path.resourceUri
          properties: requestBody.properties
      - text: Start a pre-creation check named {dryrunName} for {resourceUri}.
        slots:
          dryrunName: path.dryrunName
          resourceUri: path.resourceUri
      method: generated
      generated: '2026-09-26'
- target: $.paths['/{resourceUri}/providers/Microsoft.ServiceLinker/dryruns/{dryrunName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a Service Connector dry-run job
      effect: destructive
      questions:
      - Can I clean up an old Service Connector dryrun job?
      - What deletes a dry-run check I no longer need?
      instructions:
      - text: Delete dryrun job {dryrunName} on resource {resourceUri}.
        slots:
          dryrunName: path.dryrunName
          resourceUri: path.resourceUri
      - text: Remove Service Connector dry run {dryrunName} from {resourceUri}.
        slots:
          dryrunName: path.dryrunName
          resourceUri: path.resourceUri
      method: generated
      generated: '2026-09-26'
- target: $.paths['/{resourceUri}/providers/Microsoft.ServiceLinker/dryruns/{dryrunName}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update a Service Connector dry-run job
      effect: write
      questions:
      - Can I change the parameters of an existing dry-run job and rerun its checks?
      - How do I modify a dryrun that already exists on my resource?
      instructions:
      - text: Update dryrun job {dryrunName} on resource {resourceUri} with parameters {properties}.
        slots:
          dryrunName: path.dryrunName
          resourceUri: path.resourceUri
          properties: requestBody.properties
      - text: Revise existing dry run {dryrunName} for {resourceUri}.
        slots:
          dryrunName: path.dryrunName
          resourceUri: path.resourceUri
      method: generated
      generated: '2026-09-26'
- target: $.paths['/{resourceUri}/providers/Microsoft.ServiceLinker/linkers/{linkerName}/generateConfigurations'].post
  update:
    x-apievangelist-phrasing:
      intent: Generate configurations for a linker
      effect: write
      questions:
      - How do I have Service Connector generate connection settings, including custom key names?
      - Can a linker write its configuration into an App Configuration store?
      instructions:
      - text: Generate configurations for linker {linkerName} on resource {resourceUri}.
        slots:
          linkerName: path.linkerName
          resourceUri: path.resourceUri
      - text: Generate config for connection {linkerName} on {resourceUri} with custom keys {customizedKeys}.
        slots:
          linkerName: path.linkerName
          resourceUri: path.resourceUri
          customizedKeys: requestBody.customizedKeys
      - text: Generate settings for linker {linkerName} on {resourceUri} into store {configurationStore}.
        slots:
          linkerName: path.linkerName
          resourceUri: path.resourceUri
          configurationStore: requestBody.configurationStore
      method: generated
      generated: '2026-09-26'
- target: $.paths['/{resourceUri}/providers/Microsoft.ServiceLinker/daprConfigurations'].get
  update:
    x-apievangelist-phrasing:
      intent: List Dapr configurations supported by Service Connector
      effect: read
      questions:
      - Which Dapr components can Service Connector set up for me?
      - What Dapr configuration options does Service Connector support on a resource?
      instructions:
      - text: List the supported Dapr configurations on resource {resourceUri}.
        slots:
          resourceUri: path.resourceUri
      - text: Show which Dapr components Service Connector offers for {resourceUri}.
        slots:
          resourceUri: path.resourceUri
      method: generated
      generated: '2026-09-26'