# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Azure API Management REST Logger API
  version: 1.0.0
extends: openapi/microsoft-azure-api-management-logger-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: 6
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/loggers'].get
  update:
    x-apievangelist-phrasing:
      intent: List the loggers in the service
      effect: read
      questions:
      - Which loggers are set up in my API Management instance?
      - Can I see all the Event Hubs and Application Insights loggers configured?
      instructions:
      - text: List the loggers configured in my {serviceName} API Management service.
        slots:
          serviceName: path.serviceName
      - text: Show every configured logger.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/loggers/{loggerId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a logger's details
      effect: read
      questions:
      - How do I look up where a particular logger sends its data?
      - What type and credentials does one logger use?
      instructions:
      - text: Get the details of logger {loggerId} in {serviceName}.
        slots:
          loggerId: path.loggerId
          serviceName: path.serviceName
      - text: Show the logger by its identifier.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/loggers/{loggerId}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create or replace a logger
      effect: write
      questions:
      - How do I add a logger so API Management can ship logs to Event Hubs?
      - Can I overwrite a logger definition that already exists?
      instructions:
      - text: Create or replace logger {loggerId} in my {serviceName} service.
        slots:
          loggerId: path.loggerId
          serviceName: path.serviceName
      - text: Create or replace this logger.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/loggers/{loggerId}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a logger
      effect: destructive
      questions:
      - Can I remove a logger I no longer send data to?
      - What happens to diagnostics that use a logger once it's deleted?
      instructions:
      - text: Delete logger {loggerId} from service {serviceName}.
        slots:
          loggerId: path.loggerId
          serviceName: path.serviceName
      - text: Remove the unused logger from the service.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/loggers/{loggerId}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update an existing logger
      effect: write
      questions:
      - Can I change the description or credentials of an existing logger?
      - Is a partial update possible for loggers?
      instructions:
      - text: Patch the credentials of existing logger {loggerId} in {serviceName}.
        slots:
          loggerId: path.loggerId
          serviceName: path.serviceName
      - text: Patch the logger's credentials.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/loggers/{loggerId}'].head
  update:
    x-apievangelist-phrasing:
      intent: Check a logger's ETag
      effect: read
      questions:
      - How do I get the ETag of a logger?
      - Can I confirm a logger exists without loading it?
      instructions:
      - text: Get the ETag version of logger {loggerId} on service {serviceName}.
        slots:
          loggerId: path.loggerId
          serviceName: path.serviceName
      - text: Check the logger's ETag.
      method: generated
      generated: '2026-10-01'