# 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 Managers API
  version: 1.0.0
extends: openapi/microsoft-azure-managers-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: 20
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.StorSimple/managers'].get
  update:
    x-apievangelist-phrasing:
      intent: List StorSimple managers across a subscription
      effect: read
      questions:
      - Which StorSimple managers exist anywhere in my Azure subscription?
      - Can I see every StorSimple device manager I own without picking a resource group first?
      instructions:
      - text: List all StorSimple managers in subscription {subscriptionId}.
        slots:
          subscriptionId: path.subscriptionId
      - text: Show me every StorSimple manager across all resource groups of subscription {subscriptionId}.
        slots:
          subscriptionId: path.subscriptionId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.StorSimple/managers'].get
  update:
    x-apievangelist-phrasing:
      intent: List StorSimple managers in a resource group
      effect: read
      questions:
      - What StorSimple managers are in a particular resource group?
      - Can I narrow my StorSimple manager list down to one resource group?
      instructions:
      - text: List the StorSimple managers in resource group {resourceGroupName} of subscription {subscriptionId}.
        slots:
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      - text: Show which StorSimple managers live under resource group {resourceGroupName}.
        slots:
          resourceGroupName: path.resourceGroupName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.StorSimple/managers/{managerName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a StorSimple manager's properties
      effect: read
      questions:
      - How do I look up the properties of one specific StorSimple manager?
      - What location and SKU does my StorSimple manager have?
      instructions:
      - text: Get StorSimple manager {managerName} in resource group {resourceGroupName}, subscription {subscriptionId}.
        slots:
          managerName: path.managerName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      - text: Show me the details of StorSimple manager {managerName}.
        slots:
          managerName: path.managerName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.StorSimple/managers/{managerName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create or replace a StorSimple manager
      effect: write
      questions:
      - How do I create a new StorSimple manager in a given Azure region?
      - Can I overwrite an existing StorSimple manager's full definition in one call?
      instructions:
      - text: Create StorSimple manager {managerName} in {resourceGroupName} (subscription {subscriptionId}) located in {location}.
        slots:
          managerName: path.managerName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
          location: requestBody.location
      - text: Provision StorSimple manager {managerName} in {location} with tags {tags}.
        slots:
          managerName: path.managerName
          location: requestBody.location
          tags: requestBody.tags
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.StorSimple/managers/{managerName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a StorSimple manager
      effect: destructive
      questions:
      - How do I remove a StorSimple manager I no longer use?
      - Can I delete a whole StorSimple manager resource from a resource group?
      instructions:
      - text: Delete StorSimple manager {managerName} in {resourceGroupName}, subscription {subscriptionId}.
        slots:
          managerName: path.managerName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      - text: Tear down StorSimple manager {managerName} entirely.
        slots:
          managerName: path.managerName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.StorSimple/managers/{managerName}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update tags on a StorSimple manager
      effect: write
      questions:
      - Can I change just the tags on an existing StorSimple manager?
      - What can I patch on a StorSimple manager without recreating it?
      instructions:
      - text: Set the tags on StorSimple manager {managerName} to {tags}.
        slots:
          managerName: path.managerName
          tags: requestBody.tags
      - text: Patch the tags of manager {managerName} in {resourceGroupName}, subscription {subscriptionId}, with {tags}.
        slots:
          managerName: path.managerName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
          tags: requestBody.tags
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.StorSimple/managers/{managerName}/devices/{deviceName}/publicEncryptionKey'].post
  update:
    x-apievangelist-phrasing:
      intent: Get a StorSimple device's public encryption key
      effect: read
      questions:
      - Where do I find the public encryption key for one specific StorSimple device?
      - Can I retrieve a device-level public key rather than the manager's key?
      instructions:
      - text: Get the public encryption key of device {deviceName} under manager {managerName} in {resourceGroupName}, subscription {subscriptionId}.
        slots:
          deviceName: path.deviceName
          managerName: path.managerName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      - text: Fetch StorSimple device {deviceName}'s public encryption key.
        slots:
          deviceName: path.deviceName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.StorSimple/managers/{managerName}/encryptionSettings/default'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a StorSimple manager's encryption settings
      effect: read
      questions:
      - Is encryption enabled on my StorSimple manager?
      - What are the default encryption settings configured for a StorSimple manager?
      instructions:
      - text: Show the encryption settings of StorSimple manager {managerName}.
        slots:
          managerName: path.managerName
      - text: Check the encryption status for manager {managerName} in {resourceGroupName}, subscription {subscriptionId}.
        slots:
          managerName: path.managerName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.StorSimple/managers/{managerName}/extendedInformation/vaultExtendedInfo'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a StorSimple manager's vault extended info
      effect: read
      questions:
      - What vault extended information is stored for my StorSimple manager?
      - Can I read the extended info record attached to a StorSimple manager?
      instructions:
      - text: Get the vault extended info of StorSimple manager {managerName}.
        slots:
          managerName: path.managerName
      - text: Read the extended information for manager {managerName} in {resourceGroupName}, subscription {subscriptionId}.
        slots:
          managerName: path.managerName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.StorSimple/managers/{managerName}/extendedInformation/vaultExtendedInfo'].put
  update:
    x-apievangelist-phrasing:
      intent: Create vault extended info for a StorSimple manager
      effect: write
      questions:
      - How do I add extended info to a StorSimple manager that has none yet?
      - Can I attach a new extended info record to a manager in one PUT?
      instructions:
      - text: Create the extended info for StorSimple manager {managerName} with properties {properties}.
        slots:
          managerName: path.managerName
          properties: requestBody.properties
      - text: Initialize vault extended info on manager {managerName} in {resourceGroupName}, subscription {subscriptionId}.
        slots:
          managerName: path.managerName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.StorSimple/managers/{managerName}/extendedInformation/vaultExtendedInfo'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a StorSimple manager's extended info
      effect: destructive
      questions:
      - Can I remove only the extended info from a StorSimple manager and keep the manager?
      - What happens if I clear the vault extended information on my manager?
      instructions:
      - text: Delete the extended info of StorSimple manager {managerName}.
        slots:
          managerName: path.managerName
      - text: Clear vault extended information from manager {managerName} in {resourceGroupName}, subscription {subscriptionId}.
        slots:
          managerName: path.managerName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.StorSimple/managers/{managerName}/extendedInformation/vaultExtendedInfo'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update a StorSimple manager's extended info
      effect: write
      questions:
      - Why does updating a manager's extended info require an If-Match etag?
      - Can I modify existing extended info on a StorSimple manager without deleting it?
      instructions:
      - text: Update the extended info of manager {managerName} in {resourceGroupName}, subscription {subscriptionId}, using etag {etag}.
        slots:
          managerName: path.managerName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
          etag: header.If-Match
      - text: Patch extended info on StorSimple manager {managerName} with {properties}, matching etag {etag}.
        slots:
          managerName: path.managerName
          properties: requestBody.properties
          etag: header.If-Match
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.StorSimple/managers/{managerName}/features'].get
  update:
    x-apievangelist-phrasing:
      intent: List feature support status for a StorSimple manager
      effect: read
      questions:
      - Which features does my StorSimple manager support?
      - Can I filter the feature support list for a manager?
      instructions:
      - text: List the features and their support status for StorSimple manager {managerName} in {resourceGroupName}, subscription {subscriptionId}.
        slots:
          managerName: path.managerName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      - text: Show feature support for manager {managerName} filtered by {filter}.
        slots:
          managerName: path.managerName
          filter: query.$filter
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.StorSimple/managers/{managerName}/listActivationKey'].post
  update:
    x-apievangelist-phrasing:
      intent: Get a StorSimple manager's activation key
      effect: read
      questions:
      - Where do I get the activation key needed to register a StorSimple device?
      - Can I see the current activation key without regenerating it?
      instructions:
      - text: Get the current activation key for StorSimple manager {managerName} in {resourceGroupName}, subscription {subscriptionId}.
        slots:
          managerName: path.managerName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      - text: Show me manager {managerName}'s existing activation key.
        slots:
          managerName: path.managerName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.StorSimple/managers/{managerName}/listPublicEncryptionKey'].post
  update:
    x-apievangelist-phrasing:
      intent: Get a StorSimple manager's public encryption key
      effect: read
      questions:
      - What is the symmetric-encrypted public encryption key of my StorSimple manager?
      - Is there one public key for the whole StorSimple manager, separate from each device?
      instructions:
      - text: Get the public encryption key of StorSimple manager {managerName}.
        slots:
          managerName: path.managerName
      - text: Retrieve manager {managerName}'s public encryption key in {resourceGroupName}, subscription {subscriptionId}.
        slots:
          managerName: path.managerName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.StorSimple/managers/{managerName}/metrics'].get
  update:
    x-apievangelist-phrasing:
      intent: Get metrics for a StorSimple manager
      effect: read
      questions:
      - What performance metrics can I pull for a StorSimple manager?
      - Does querying StorSimple manager metrics require a filter?
      instructions:
      - text: Get metrics for StorSimple manager {managerName} in {resourceGroupName}, subscription {subscriptionId}, using filter {filter}.
        slots:
          managerName: path.managerName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
          filter: query.$filter
      - text: Pull manager {managerName} metric values matching {filter}.
        slots:
          managerName: path.managerName
          filter: query.$filter
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.StorSimple/managers/{managerName}/metricsDefinitions'].get
  update:
    x-apievangelist-phrasing:
      intent: List metric definitions for a StorSimple manager
      effect: read
      questions:
      - Which metric names are available to query for a StorSimple manager?
      - Can I discover the metric definitions before requesting manager metrics?
      instructions:
      - text: List the metric definitions for StorSimple manager {managerName} in {resourceGroupName}, subscription {subscriptionId}.
        slots:
          managerName: path.managerName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      - text: Show what metrics manager {managerName} exposes.
        slots:
          managerName: path.managerName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.StorSimple/managers/{managerName}/regenerateActivationKey'].post
  update:
    x-apievangelist-phrasing:
      intent: Regenerate a StorSimple manager's activation key
      effect: write
      questions:
      - How do I rotate the activation key for my StorSimple manager?
      - Can I issue a fresh activation key if the old one leaked?
      instructions:
      - text: Regenerate the activation key for StorSimple manager {managerName}.
        slots:
          managerName: path.managerName
      - text: Issue a new activation key for manager {managerName} in {resourceGroupName}, subscription {subscriptionId}.
        slots:
          managerName: path.managerName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.StorSimple/managers/{managerName}/certificates/{certificateName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Upload a vault credential certificate to a manager
      effect: write
      questions:
      - How can I upload a vault credential certificate to a StorSimple manager?
      - Can I name the registration certificate I upload for a manager?
      instructions:
      - text: Upload certificate {certificateName} to StorSimple manager {managerName} with properties {properties}.
        slots:
          certificateName: path.certificateName
          managerName: path.managerName
          properties: requestBody.properties
      - text: Register vault cred certificate {certificateName} on manager {managerName} in {resourceGroupName}, subscription {subscriptionId}.
        slots:
          certificateName: path.certificateName
          managerName: path.managerName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.StorSimple/managers/{managerName}/getEncryptionKey'].post
  update:
    x-apievangelist-phrasing:
      intent: Get a StorSimple manager's symmetric encryption key
      effect: read
      questions:
      - Where can I retrieve the symmetric encryption key used by my StorSimple manager?
      - Can I get the manager's symmetric key rather than its public key?
      instructions:
      - text: Get the symmetric encryption key of StorSimple manager {managerName}.
        slots:
          managerName: path.managerName
      - text: Fetch manager {managerName}'s symmetric encryption key from {resourceGroupName}, subscription {subscriptionId}.
        slots:
          managerName: path.managerName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      method: generated
      generated: '2026-09-26'