# 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 Resource API
  version: 1.0.0
extends: openapi/microsoft-azure-resource-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: 19
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.HealthcareApis/services/{resourceName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a healthcare APIs service instance
      effect: read
      questions:
      - What are the settings of my Azure API for FHIR service instance?
      - Can I look up the metadata of one healthcare APIs service by name?
      instructions:
      - text: Get healthcare service {resourceName} in resource group {resourceGroupName} of subscription {subscriptionId}.
        slots:
          resourceName: path.resourceName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      - text: Show the metadata of healthcare APIs instance {resourceName}.
        slots:
          resourceName: path.resourceName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.HealthcareApis/services/{resourceName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create or replace a healthcare APIs service
      effect: write
      questions:
      - How do I provision a new healthcare APIs service instance?
      - Which kind and location must I give when creating a FHIR service instance?
      instructions:
      - text: Create healthcare service {resourceName} of kind {kind} in {location} under group {resourceGroupName}, subscription {subscriptionId}.
        slots:
          resourceName: path.resourceName
          kind: requestBody.kind
          location: requestBody.location
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      - text: Replace the full configuration of healthcare instance {resourceName} with kind {kind} in {location}.
        slots:
          resourceName: path.resourceName
          kind: requestBody.kind
          location: requestBody.location
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.HealthcareApis/services/{resourceName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a healthcare APIs service instance
      effect: destructive
      questions:
      - How do I remove a healthcare APIs service I no longer need?
      - Can I decommission a FHIR service instance through the API?
      instructions:
      - text: Delete healthcare service {resourceName} from group {resourceGroupName} in subscription {subscriptionId}.
        slots:
          resourceName: path.resourceName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      - text: Decommission healthcare APIs instance {resourceName}.
        slots:
          resourceName: path.resourceName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.HealthcareApis/services/{resourceName}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update tags on a healthcare APIs service
      effect: write
      questions:
      - Can I change just the tags on an existing healthcare service instance?
      - What can I patch on a FHIR service without recreating it?
      instructions:
      - text: Set tags {tags} on healthcare service {resourceName} in group {resourceGroupName}, subscription {subscriptionId}.
        slots:
          tags: requestBody.tags
          resourceName: path.resourceName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      - text: Patch the tags of healthcare APIs instance {resourceName}.
        slots:
          resourceName: path.resourceName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.HealthcareApis/locations/{locationName}/operationresults/{operationResultId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Check a long-running healthcare APIs operation
      effect: read
      questions:
      - Has my long-running healthcare service provisioning finished?
      - Where do I poll the result of an async healthcare APIs operation?
      instructions:
      - text: Get operation result {operationResultId} in {locationName} for subscription {subscriptionId}.
        slots:
          operationResultId: path.operationResultId
          locationName: path.locationName
          subscriptionId: path.subscriptionId
      - text: Poll healthcare operation {operationResultId} until it completes.
        slots:
          operationResultId: path.operationResultId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.M365SecurityAndCompliance/privateLinkServicesForSCCPowershell/{resourceName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an M365 compliance PowerShell private link
      effect: read
      questions:
      - What is configured on my M365 Security and Compliance PowerShell private link resource?
      - Can I read the M365SecurityAndCompliance version of the SCC PowerShell private link?
      instructions:
      - text: Show the M365 Security and Compliance private link for SCC PowerShell named {resource}.
        slots:
          resource: path.resourceName
      - text: Get the M365SecurityAndCompliance SCC PowerShell private link metadata.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.M365SecurityAndCompliance/privateLinkServicesForSCCPowershell/{resourceName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create an M365 compliance PowerShell private link
      effect: write
      questions:
      - How do I set up a private link for SCC PowerShell under M365 Security and Compliance?
      - Can I replace the properties of my M365SecurityAndCompliance PowerShell private link?
      instructions:
      - text: Create an M365 Security and Compliance SCC PowerShell private link with properties {properties}.
        slots:
          properties: requestBody.properties
      - text: Create or replace the M365SecurityAndCompliance PowerShell private link resource {resource}.
        slots:
          resource: path.resourceName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.M365SecurityAndCompliance/privateLinkServicesForSCCPowershell/{resourceName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete an M365 compliance PowerShell private link
      effect: destructive
      questions:
      - How do I remove the M365 Security and Compliance PowerShell private link?
      - Can I delete the M365SecurityAndCompliance SCC PowerShell private link resource?
      instructions:
      - text: Delete the M365 Security and Compliance SCC PowerShell private link {resource}.
        slots:
          resource: path.resourceName
      - text: Remove the M365SecurityAndCompliance PowerShell private link instance.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.M365SecurityAndCompliance/privateLinkServicesForSCCPowershell/{resourceName}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update an M365 compliance PowerShell private link
      effect: write
      questions:
      - Can I patch the metadata of my M365 Security and Compliance PowerShell private link?
      - What changes can I make to the M365SecurityAndCompliance SCC private link after creation?
      instructions:
      - text: Patch the M365 Security and Compliance SCC PowerShell private link metadata on {resource}.
        slots:
          resource: path.resourceName
      - text: Update the M365SecurityAndCompliance PowerShell private link in place.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.MixedReality/remoteRenderingAccounts'].get
  update:
    x-apievangelist-phrasing:
      intent: List Remote Rendering accounts in a subscription
      effect: read
      questions:
      - Which Remote Rendering accounts exist across my whole subscription?
      - Can I see every mixed reality rendering account I own subscription-wide?
      instructions:
      - text: List all Remote Rendering accounts in my subscription.
      - text: Show every mixed reality Remote Rendering account across the subscription.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.MixedReality/remoteRenderingAccounts'].get
  update:
    x-apievangelist-phrasing:
      intent: List Remote Rendering accounts in a resource group
      effect: read
      questions:
      - What Remote Rendering accounts are in one particular resource group?
      - Can I scope my Remote Rendering account list to a single resource group?
      instructions:
      - text: List the Remote Rendering accounts in this resource group.
      - text: Show only the rendering accounts that live in my resource group.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.MixedReality/remoteRenderingAccounts/{accountName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a Remote Rendering account
      effect: read
      questions:
      - How do I view the details of one Remote Rendering account?
      - What settings does a specific Remote Rendering account have?
      instructions:
      - text: Retrieve the Remote Rendering account {account}.
        slots:
          account: path.accountName
      - text: Show me the configuration of this Remote Rendering account.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.MixedReality/remoteRenderingAccounts/{accountName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create or replace a Remote Rendering account
      effect: write
      questions:
      - How do I create a new Remote Rendering account for mixed reality rendering?
      - Can I overwrite a Remote Rendering account's full definition?
      instructions:
      - text: Create Remote Rendering account {account} from definition {remoteRenderingAccount}.
        slots:
          account: path.accountName
          remoteRenderingAccount: body.remoteRenderingAccount
      - text: Provision a new Remote Rendering account using {remoteRenderingAccount}.
        slots:
          remoteRenderingAccount: body.remoteRenderingAccount
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.MixedReality/remoteRenderingAccounts/{accountName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a Remote Rendering account
      effect: destructive
      questions:
      - How do I delete a Remote Rendering account I no longer use?
      - Is removing a Remote Rendering account permanent?
      instructions:
      - text: Delete Remote Rendering account {account}.
        slots:
          account: path.accountName
      - text: Remove the Remote Rendering account from my resource group.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.MixedReality/remoteRenderingAccounts/{accountName}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update an existing Remote Rendering account
      effect: write
      questions:
      - Can I patch an existing Remote Rendering account without recreating it?
      - What fields can I change on a Remote Rendering account after it exists?
      instructions:
      - text: Patch the existing Remote Rendering account {account} with {remoteRenderingAccount}.
        slots:
          account: path.accountName
          remoteRenderingAccount: body.remoteRenderingAccount
      - text: Apply changes {remoteRenderingAccount} to my current rendering account.
        slots:
          remoteRenderingAccount: body.remoteRenderingAccount
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.SecurityAndCompliance/privateLinkServicesForSCCPowershell/{resourceName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a SecurityAndCompliance PowerShell private link
      effect: read
      questions:
      - What does my Microsoft.SecurityAndCompliance SCC PowerShell private link look like?
      - Can I fetch the older SecurityAndCompliance provider's PowerShell private link?
      instructions:
      - text: Show the SecurityAndCompliance provider's SCC PowerShell private link {resource}.
        slots:
          resource: path.resourceName
      - text: Get the Microsoft.SecurityAndCompliance PowerShell private link record.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.SecurityAndCompliance/privateLinkServicesForSCCPowershell/{resourceName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create a SecurityAndCompliance PowerShell private link
      effect: write
      questions:
      - How do I create an SCC PowerShell private link under the SecurityAndCompliance provider?
      - Can I replace properties on the Microsoft.SecurityAndCompliance PowerShell link?
      instructions:
      - text: Create a SecurityAndCompliance SCC PowerShell private link with {properties}.
        slots:
          properties: requestBody.properties
      - text: Create or replace the Microsoft.SecurityAndCompliance PowerShell private link named {resource}.
        slots:
          resource: path.resourceName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.SecurityAndCompliance/privateLinkServicesForSCCPowershell/{resourceName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a SecurityAndCompliance PowerShell private link
      effect: destructive
      questions:
      - How do I delete the SCC PowerShell private link from the SecurityAndCompliance provider?
      - Can I remove a Microsoft.SecurityAndCompliance PowerShell link instance?
      instructions:
      - text: Delete the SecurityAndCompliance SCC PowerShell private link {resource}.
        slots:
          resource: path.resourceName
      - text: Remove the Microsoft.SecurityAndCompliance PowerShell private link instance.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.SecurityAndCompliance/privateLinkServicesForSCCPowershell/{resourceName}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update a SecurityAndCompliance PowerShell private link
      effect: write
      questions:
      - Can I patch metadata on the SecurityAndCompliance SCC PowerShell private link?
      - What can I change on a Microsoft.SecurityAndCompliance PowerShell link in place?
      instructions:
      - text: Patch the SecurityAndCompliance SCC PowerShell private link metadata on {resource}.
        slots:
          resource: path.resourceName
      - text: Update the Microsoft.SecurityAndCompliance PowerShell private link in place.
      method: generated
      generated: '2026-10-01'