# 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.DeviceRegistry management service…
  version: 1.0.0
extends: openapi/microsoft-azure-assetendpointprofiles-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: 6
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.DeviceRegistry/assetEndpointProfiles'].get
  update:
    x-apievangelist-phrasing:
      intent: List asset endpoint profiles in a subscription
      effect: read
      questions:
      - Which Device Registry asset endpoint profiles exist across my subscription?
      - Can I list asset endpoint profiles without picking a resource group?
      instructions:
      - text: List all asset endpoint profiles in my subscription.
      - text: Show every Device Registry asset endpoint profile subscription-wide.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DeviceRegistry/assetEndpointProfiles'].get
  update:
    x-apievangelist-phrasing:
      intent: List asset endpoint profiles in a resource group
      effect: read
      questions:
      - What asset endpoint profiles are in one resource group?
      - Can I scope the asset endpoint profile list to a resource group?
      instructions:
      - text: List asset endpoint profiles in this resource group.
      - text: Show the Device Registry endpoint profiles in my resource group.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DeviceRegistry/assetEndpointProfiles/{assetEndpointProfileName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an asset endpoint profile
      effect: read
      questions:
      - How can I view one asset endpoint profile's connection settings?
      - What does a specific Device Registry asset endpoint profile contain?
      instructions:
      - text: Get asset endpoint profile {assetEndpointProfileName}.
        slots:
          assetEndpointProfileName: path.assetEndpointProfileName
      - text: Show settings of endpoint profile {assetEndpointProfileName}.
        slots:
          assetEndpointProfileName: path.assetEndpointProfileName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DeviceRegistry/assetEndpointProfiles/{assetEndpointProfileName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create or replace an asset endpoint profile
      effect: write
      questions:
      - How do I create an asset endpoint profile for an industrial device server?
      - Which extended location is required when creating an asset endpoint profile?
      instructions:
      - text: Create asset endpoint profile {assetEndpointProfileName} at extended location {extendedLocation}.
        slots:
          assetEndpointProfileName: path.assetEndpointProfileName
          extendedLocation: requestBody.extendedLocation
      - text: Replace endpoint profile {assetEndpointProfileName} with properties {properties} at {extendedLocation}.
        slots:
          assetEndpointProfileName: path.assetEndpointProfileName
          properties: requestBody.properties
          extendedLocation: requestBody.extendedLocation
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DeviceRegistry/assetEndpointProfiles/{assetEndpointProfileName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete an asset endpoint profile
      effect: destructive
      questions:
      - Can I delete an asset endpoint profile from Device Registry?
      - What happens when I remove an asset endpoint profile?
      instructions:
      - text: Delete asset endpoint profile {assetEndpointProfileName}.
        slots:
          assetEndpointProfileName: path.assetEndpointProfileName
      - text: Remove Device Registry endpoint profile {assetEndpointProfileName}.
        slots:
          assetEndpointProfileName: path.assetEndpointProfileName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DeviceRegistry/assetEndpointProfiles/{assetEndpointProfileName}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update an asset endpoint profile
      effect: write
      questions:
      - Can I change tags or properties on an existing asset endpoint profile?
      - Is it possible to patch an endpoint profile without replacing it?
      instructions:
      - text: Update tags on asset endpoint profile {assetEndpointProfileName} to {tags}.
        slots:
          assetEndpointProfileName: path.assetEndpointProfileName
          tags: requestBody.tags
      - text: Patch existing endpoint profile {assetEndpointProfileName} with {properties}.
        slots:
          assetEndpointProfileName: path.assetEndpointProfileName
          properties: requestBody.properties
      method: generated
      generated: '2026-09-26'