# 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 Connector API
  version: 1.0.0
extends: openapi/microsoft-azure-connector-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: 9
- target: $.paths['/subscriptions/{subscriptionId}/resourcegroups/{resourceGroupName}/providers/Microsoft.ServiceLinker/locations/{location}/dryruns'].get
  update:
    x-apievangelist-phrasing:
      intent: List Service Connector dry-run jobs
      effect: read
      questions:
      - Which Service Connector dry-run checks have I run in this location?
      - Can I see all the pre-creation dry runs for my connectors?
      instructions:
      - text: List Service Connector dry-run jobs in subscription {subscription} and location {location}.
        slots:
          subscription: path.subscriptionId
          location: path.location
      - text: Show every connector dry run I have in subscription {subscription}.
        slots:
          subscription: path.subscriptionId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourcegroups/{resourceGroupName}/providers/Microsoft.ServiceLinker/locations/{location}/dryruns/{dryrunName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a Service Connector dry-run job
      effect: read
      questions:
      - How do I see the results of a Service Connector dry run?
      - Did my connector dry run find missing permissions or other blockers?
      instructions:
      - text: Get dry-run job {dryrun} in location {location} of subscription {subscription}.
        slots:
          dryrun: path.dryrunName
          location: path.location
          subscription: path.subscriptionId
      - text: Show the check results of connector dry run {dryrun}.
        slots:
          dryrun: path.dryrunName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourcegroups/{resourceGroupName}/providers/Microsoft.ServiceLinker/locations/{location}/dryruns/{dryrunName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Start a Service Connector dry run before creation
      effect: write
      questions:
      - How do I test a Service Connector setup before actually creating the connection?
      - Can I run pre-creation checks on a connector configuration?
      instructions:
      - text: Create dry-run job {dryrun} in subscription {subscription} with parameters {properties}.
        slots:
          dryrun: path.dryrunName
          subscription: path.subscriptionId
          properties: requestBody.properties
      - text: Run connector pre-checks in {location} as new dry run {dryrun}.
        slots:
          location: path.location
          dryrun: path.dryrunName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourcegroups/{resourceGroupName}/providers/Microsoft.ServiceLinker/locations/{location}/dryruns/{dryrunName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a Service Connector dry-run job
      effect: destructive
      questions:
      - How do I clean up an old Service Connector dry run?
      - Can I delete a dry-run job once I've reviewed it?
      instructions:
      - text: Delete dry-run job {dryrun} in subscription {subscription}.
        slots:
          dryrun: path.dryrunName
          subscription: path.subscriptionId
      - text: Remove connector dry run {dryrun} from location {location}.
        slots:
          dryrun: path.dryrunName
          location: path.location
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourcegroups/{resourceGroupName}/providers/Microsoft.ServiceLinker/locations/{location}/dryruns/{dryrunName}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update a Service Connector dry-run job
      effect: write
      questions:
      - How do I re-run a Service Connector dry run with changed parameters?
      - Can I edit an existing dry-run job instead of creating another one?
      instructions:
      - text: Update dry-run job {dryrun} in subscription {subscription} with {properties}.
        slots:
          dryrun: path.dryrunName
          subscription: path.subscriptionId
          properties: requestBody.properties
      - text: Change the parameters of existing connector dry run {dryrun} in {location} to {properties}.
        slots:
          dryrun: path.dryrunName
          location: path.location
          properties: requestBody.properties
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourcegroups/{resourceGroupName}/providers/Microsoft.ServiceLinker/locations/{location}/connectors/{connectorName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a Service Connector
      effect: destructive
      questions:
      - How do I delete a Service Connector that links my app to a backing service?
      - Can I remove a location-scoped connector entirely?
      instructions:
      - text: Delete Service Connector {connector} in subscription {subscription}.
        slots:
          connector: path.connectorName
          subscription: path.subscriptionId
      - text: Remove the connector named {connector} in location {location}.
        slots:
          connector: path.connectorName
          location: path.location
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourcegroups/{resourceGroupName}/providers/Microsoft.ServiceLinker/locations/{location}/connectors/{connectorName}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update a Service Connector
      effect: write
      questions:
      - How do I change the auth or target settings of an existing Service Connector?
      - Can I patch a connector without recreating it?
      instructions:
      - text: Update Service Connector {connector} in subscription {subscription} with {properties}.
        slots:
          connector: path.connectorName
          subscription: path.subscriptionId
          properties: requestBody.properties
      - text: Patch connector {connector} in {location} to use settings {properties}.
        slots:
          connector: path.connectorName
          location: path.location
          properties: requestBody.properties
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourcegroups/{resourceGroupName}/providers/Microsoft.ServiceLinker/locations/{location}/connectors/{connectorName}/validate'].post
  update:
    x-apievangelist-phrasing:
      intent: Validate a Service Connector
      effect: read
      questions:
      - How do I check whether my Service Connector is working correctly?
      - Is there a way to validate a connector's connectivity and auth?
      instructions:
      - text: Validate Service Connector {connector} in subscription {subscription}.
        slots:
          connector: path.connectorName
          subscription: path.subscriptionId
      - text: Run a health validation on connector {connector} in location {location}.
        slots:
          connector: path.connectorName
          location: path.location
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourcegroups/{resourceGroupName}/providers/Microsoft.ServiceLinker/locations/{location}/connectors/{connectorName}/generateConfigurations'].post
  update:
    x-apievangelist-phrasing:
      intent: Generate app configuration for a Service Connector
      effect: write
      questions:
      - How do I generate the environment variables my app needs from a Service Connector?
      - Can I customize the configuration key names a connector generates?
      - Can connector configurations be written into an App Configuration store?
      instructions:
      - text: Generate configurations for Service Connector {connector} in location {location}.
        slots:
          connector: path.connectorName
          location: path.location
      - text: Generate connector {connector} configs using customized keys {customized_keys}.
        slots:
          connector: path.connectorName
          customized_keys: requestBody.customizedKeys
      - text: Write connector {connector} configurations to configuration store {store}.
        slots:
          connector: path.connectorName
          store: requestBody.configurationStore
      method: generated
      generated: '2026-10-01'