# 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 Inventory Items API
  version: 1.0.0
extends: openapi/microsoft-azure-inventory-items-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: 8
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ConnectedVMwarevSphere/vcenters/{vcenterName}/inventoryItems/{inventoryItemName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a vCenter inventory item
      effect: read
      questions:
      - How do I look up one inventory item discovered in a vCenter connected to Azure Arc?
      - Can I read a single vSphere inventory item by name?
      instructions:
      - text: Get inventory item {item} in vCenter {vcenter}, resource group {rg}, subscription {sub}.
        slots:
          item: path.inventoryItemName
          vcenter: path.vcenterName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Show vCenter {vcenter} inventory item {item}.
        slots:
          vcenter: path.vcenterName
          item: path.inventoryItemName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ConnectedVMwarevSphere/vcenters/{vcenterName}/inventoryItems/{inventoryItemName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create or update a vCenter inventory item
      effect: write
      questions:
      - Can I create or update an inventory item under a vCenter in Azure?
      - What properties are required when adding a vSphere inventory item?
      instructions:
      - text: Create inventory item {item} in vCenter {vcenter}, resource group {rg}, subscription {sub} with properties {properties}.
        slots:
          item: path.inventoryItemName
          vcenter: path.vcenterName
          rg: path.resourceGroupName
          sub: path.subscriptionId
          properties: requestBody.properties
      - text: Upsert vCenter {vcenter} inventory item {item} of kind {kind} with {properties}.
        slots:
          vcenter: path.vcenterName
          item: path.inventoryItemName
          kind: requestBody.kind
          properties: requestBody.properties
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ConnectedVMwarevSphere/vcenters/{vcenterName}/inventoryItems/{inventoryItemName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a vCenter inventory item
      effect: destructive
      questions:
      - Can I delete an inventory item from a vCenter connected to Azure?
      - How do I remove a stale vSphere inventory item?
      instructions:
      - text: Delete inventory item {item} from vCenter {vcenter}, resource group {rg}, subscription {sub}.
        slots:
          item: path.inventoryItemName
          vcenter: path.vcenterName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Remove vCenter {vcenter} inventory entry {item}.
        slots:
          vcenter: path.vcenterName
          item: path.inventoryItemName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ConnectedVMwarevSphere/vcenters/{vcenterName}/inventoryItems'].get
  update:
    x-apievangelist-phrasing:
      intent: List inventory items in a vCenter
      effect: read
      questions:
      - What inventory items has Azure discovered in my vCenter?
      - Can I see the whole discovered inventory of one vCenter in a single list?
      instructions:
      - text: List inventory items of vCenter {vcenter} in resource group {rg}, subscription {sub}.
        slots:
          vcenter: path.vcenterName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Show all inventory for vCenter {vcenter}.
        slots:
          vcenter: path.vcenterName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ScVmm/vmmServers/{vmmServerName}/inventoryItems/{inventoryItemName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an SCVMM server inventory item
      effect: read
      questions:
      - How do I look up one inventory item on an SCVMM server managed through Azure?
      - Can I read a single System Center VMM inventory item by name?
      instructions:
      - text: Get inventory item {item} on VMM server {vmm}, resource group {rg}, subscription {sub}.
        slots:
          item: path.inventoryItemName
          vmm: path.vmmServerName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Show VMM server {vmm} inventory item {item}.
        slots:
          vmm: path.vmmServerName
          item: path.inventoryItemName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ScVmm/vmmServers/{vmmServerName}/inventoryItems/{inventoryItemName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create or update an SCVMM inventory item
      effect: write
      questions:
      - Can I create or update an inventory item on a System Center VMM server in Azure?
      - What properties do I need to add an SCVMM inventory item?
      instructions:
      - text: Create inventory item {item} on VMM server {vmm}, resource group {rg}, subscription {sub} with properties {properties}.
        slots:
          item: path.inventoryItemName
          vmm: path.vmmServerName
          rg: path.resourceGroupName
          sub: path.subscriptionId
          properties: requestBody.properties
      - text: Upsert VMM server {vmm} inventory item {item} of kind {kind} with {properties}.
        slots:
          vmm: path.vmmServerName
          item: path.inventoryItemName
          kind: requestBody.kind
          properties: requestBody.properties
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ScVmm/vmmServers/{vmmServerName}/inventoryItems/{inventoryItemName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete an SCVMM inventory item
      effect: destructive
      questions:
      - Can I delete an inventory item from an SCVMM server in Azure?
      - How do I clean up an outdated System Center VMM inventory item?
      instructions:
      - text: Delete inventory item {item} from VMM server {vmm}, resource group {rg}, subscription {sub}.
        slots:
          item: path.inventoryItemName
          vmm: path.vmmServerName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Remove VMM server {vmm} inventory entry {item}.
        slots:
          vmm: path.vmmServerName
          item: path.inventoryItemName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ScVmm/vmmServers/{vmmServerName}/inventoryItems'].get
  update:
    x-apievangelist-phrasing:
      intent: List inventory items on an SCVMM server
      effect: read
      questions:
      - What inventory items has Azure found on my System Center VMM server?
      - Can I list every inventory entry for one SCVMM server?
      instructions:
      - text: List inventory items on VMM server {vmm} in resource group {rg}, subscription {sub}.
        slots:
          vmm: path.vmmServerName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Show all inventory for VMM server {vmm}.
        slots:
          vmm: path.vmmServerName
      method: generated
      generated: '2026-10-01'