# 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 Credential API
  version: 1.0.0
extends: openapi/microsoft-azure-credential-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: 8
- target: $.paths['/credentials'].get
  update:
    x-apievangelist-phrasing:
      intent: List Metrics Advisor data source credentials
      effect: read
      questions:
      - Which data source credentials are stored in my Metrics Advisor resource?
      - Can I page through Metrics Advisor credentials a few at a time?
      instructions:
      - text: List all Metrics Advisor data source credentials.
      - text: Show {size} Metrics Advisor data source credentials per page, skipping the first {skip}.
        slots:
          size: query.$maxpagesize
          skip: query.$skip
      method: generated
      generated: '2026-09-26'
- target: $.paths['/credentials'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a Metrics Advisor data source credential
      effect: write
      questions:
      - How do I store a new data source credential for Metrics Advisor?
      - What credential types can a Metrics Advisor data source credential use?
      instructions:
      - text: Create a Metrics Advisor {type} data source credential named {name}.
        slots:
          type: requestBody.dataSourceCredentialType
          name: requestBody.dataSourceCredentialName
      - text: Add data source credential {name} of type {type} described as {desc}.
        slots:
          name: requestBody.dataSourceCredentialName
          type: requestBody.dataSourceCredentialType
          desc: requestBody.dataSourceCredentialDescription
      method: generated
      generated: '2026-09-26'
- target: $.paths['/credentials/{credentialId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a Metrics Advisor data source credential
      effect: read
      questions:
      - What type and name does a given Metrics Advisor data source credential have?
      - Can I look up one data source credential by its ID?
      instructions:
      - text: Get Metrics Advisor data source credential {id}.
        slots:
          id: path.credentialId
      - text: Show the details of data source credential ID {id}.
        slots:
          id: path.credentialId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/credentials/{credentialId}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a Metrics Advisor data source credential
      effect: destructive
      questions:
      - How do I delete a data source credential from Metrics Advisor?
      - Can I remove a Metrics Advisor credential by its ID?
      instructions:
      - text: Delete Metrics Advisor data source credential {id}.
        slots:
          id: path.credentialId
      - text: Remove the data source credential with ID {id}.
        slots:
          id: path.credentialId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/credentials/{credentialId}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update a Metrics Advisor data source credential
      effect: write
      questions:
      - Can I rename or re-describe an existing Metrics Advisor data source credential?
      - How do I change a data source credential that already exists?
      instructions:
      - text: Rename Metrics Advisor data source credential {id} to {name}.
        slots:
          id: path.credentialId
          name: requestBody.dataSourceCredentialName
      - text: Update the description of {type} data source credential {id} to {desc}.
        slots:
          type: requestBody.dataSourceCredentialType
          id: path.credentialId
          desc: requestBody.dataSourceCredentialDescription
      method: generated
      generated: '2026-09-26'
- target: $.paths['/credentials/{credentialName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a scanning credential by name
      effect: read
      questions:
      - What is stored in a named credential used by Purview scanning?
      - Can I fetch a scan credential by its name rather than an ID?
      instructions:
      - text: Get scanning credential {name}.
        slots:
          name: path.credentialName
      - text: Show the scanning credential named {name} using API version {v}.
        slots:
          name: path.credentialName
          v: query.api-version
      method: generated
      generated: '2026-09-26'
- target: $.paths['/credentials/{credentialName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create or update a named scanning credential
      effect: write
      questions:
      - How do I create a credential for Purview data source scans?
      - Which kind of credential can I register for scanning?
      instructions:
      - text: Create scanning credential {name} of kind {kind}.
        slots:
          name: path.credentialName
          kind: requestBody.kind
      - text: Create or replace the named scanning credential {name}.
        slots:
          name: path.credentialName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/credentials/{credentialName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a named scanning credential
      effect: destructive
      questions:
      - How do I delete a scanning credential from my account?
      - Can I remove a scan credential by name?
      instructions:
      - text: Delete scanning credential {name}.
        slots:
          name: path.credentialName
      - text: Remove the named scan credential {name} from the account.
        slots:
          name: path.credentialName
      method: generated
      generated: '2026-09-26'