API Evangelist conversational phrasing for Microsoft Azure ProviderHub Resource Type Sku API

# 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 ProviderHub Resource Type Sku API
  version: 1.0.0
extends: openapi/microsoft-azure-resourcetypesku-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: 16
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.ProviderHub/providerRegistrations/{providerNamespace}/resourcetypeRegistrations/{resourceType}/skus/{sku}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a SKU of a registered resource type
      effect: read
      questions:
      - How do I read the definition of one SKU on a top-level resource type I registered in ProviderHub?
      - What settings does a named SKU have on my provider's resource type?
      instructions:
      - text: Get SKU {sku} on resource type {resourceType} of provider {providerNamespace}.
        slots:
          sku: path.sku
          resourceType: path.resourceType
          providerNamespace: path.providerNamespace
      - text: Show the top-level SKU {sku} registered for {resourceType}.
        slots:
          sku: path.sku
          resourceType: path.resourceType
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.ProviderHub/providerRegistrations/{providerNamespace}/resourcetypeRegistrations/{resourceType}/skus/{sku}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create or update a SKU on a resource type
      effect: write
      questions:
      - How do I add a SKU to a top-level resource type in my provider registration?
      - Can I change the properties of an existing SKU on a registered resource type?
      instructions:
      - text: Create SKU {sku} on resource type {resourceType} of provider {providerNamespace}.
        slots:
          sku: path.sku
          resourceType: path.resourceType
          providerNamespace: path.providerNamespace
      - text: Set the properties of top-level SKU {sku} on {resourceType} to {properties}.
        slots:
          sku: path.sku
          resourceType: path.resourceType
          properties: requestBody.properties
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.ProviderHub/providerRegistrations/{providerNamespace}/resourcetypeRegistrations/{resourceType}/skus/{sku}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a SKU from a resource type
      effect: destructive
      questions:
      - How do I remove a SKU from a top-level resource type in ProviderHub?
      - Can I retire a SKU I no longer offer on my resource type?
      instructions:
      - text: Delete SKU {sku} from resource type {resourceType} of provider {providerNamespace}.
        slots:
          sku: path.sku
          resourceType: path.resourceType
          providerNamespace: path.providerNamespace
      - text: Remove top-level SKU {sku} from {resourceType}.
        slots:
          sku: path.sku
          resourceType: path.resourceType
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.ProviderHub/providerRegistrations/{providerNamespace}/resourcetypeRegistrations/{resourceType}/resourcetypeRegistrations/{nestedResourceTypeFirst}/skus/{sku}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a SKU of a first-level nested resource type
      effect: read
      questions:
      - How can I read a SKU defined on a child resource type one level below the parent?
      - What does a SKU look like on a first-level nested resource type?
      instructions:
      - text: Get SKU {sku} on nested type {nestedResourceTypeFirst} under {resourceType} of provider {providerNamespace}.
        slots:
          sku: path.sku
          nestedResourceTypeFirst: path.nestedResourceTypeFirst
          resourceType: path.resourceType
          providerNamespace: path.providerNamespace
      - text: Show the SKU {sku} on child type {nestedResourceTypeFirst}.
        slots:
          sku: path.sku
          nestedResourceTypeFirst: path.nestedResourceTypeFirst
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.ProviderHub/providerRegistrations/{providerNamespace}/resourcetypeRegistrations/{resourceType}/resourcetypeRegistrations/{nestedResourceTypeFirst}/skus/{sku}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create or update a SKU on a first-level nested type
      effect: write
      questions:
      - How do I register a SKU on a child resource type one level deep?
      - Can I update a SKU that lives on a first-level nested resource type?
      instructions:
      - text: Create SKU {sku} on nested type {nestedResourceTypeFirst} under {resourceType} of provider {providerNamespace}.
        slots:
          sku: path.sku
          nestedResourceTypeFirst: path.nestedResourceTypeFirst
          resourceType: path.resourceType
          providerNamespace: path.providerNamespace
      - text: Update child-type SKU {sku} on {nestedResourceTypeFirst} with properties {properties}.
        slots:
          sku: path.sku
          nestedResourceTypeFirst: path.nestedResourceTypeFirst
          properties: requestBody.properties
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.ProviderHub/providerRegistrations/{providerNamespace}/resourcetypeRegistrations/{resourceType}/resourcetypeRegistrations/{nestedResourceTypeFirst}/skus/{sku}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a SKU from a first-level nested type
      effect: destructive
      questions:
      - How do I delete a SKU from a child resource type one level down?
      - Can I drop a SKU from a first-level nested type without touching the parent's SKUs?
      instructions:
      - text: Delete SKU {sku} from nested type {nestedResourceTypeFirst} under {resourceType} of provider {providerNamespace}.
        slots:
          sku: path.sku
          nestedResourceTypeFirst: path.nestedResourceTypeFirst
          resourceType: path.resourceType
          providerNamespace: path.providerNamespace
      - text: Remove child-type SKU {sku} from {nestedResourceTypeFirst}.
        slots:
          sku: path.sku
          nestedResourceTypeFirst: path.nestedResourceTypeFirst
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.ProviderHub/providerRegistrations/{providerNamespace}/resourcetypeRegistrations/{resourceType}/resourcetypeRegistrations/{nestedResourceTypeFirst}/resourcetypeRegistrations/{nestedResourceTypeSecond}/skus/{sku}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a SKU of a second-level nested resource type
      effect: read
      questions:
      - How do I read a SKU on a resource type nested two levels deep?
      - What is configured for a SKU on a grandchild resource type?
      instructions:
      - text: Get SKU {sku} on second-level type {nestedResourceTypeSecond} under {nestedResourceTypeFirst}, {resourceType}, provider {providerNamespace}.
        slots:
          sku: path.sku
          nestedResourceTypeSecond: path.nestedResourceTypeSecond
          nestedResourceTypeFirst: path.nestedResourceTypeFirst
          resourceType: path.resourceType
          providerNamespace: path.providerNamespace
      - text: Show grandchild-type SKU {sku} on {nestedResourceTypeSecond}.
        slots:
          sku: path.sku
          nestedResourceTypeSecond: path.nestedResourceTypeSecond
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.ProviderHub/providerRegistrations/{providerNamespace}/resourcetypeRegistrations/{resourceType}/resourcetypeRegistrations/{nestedResourceTypeFirst}/resourcetypeRegistrations/{nestedResourceTypeSecond}/skus/{sku}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create or update a SKU on a second-level nested type
      effect: write
      questions:
      - How do I add a SKU to a resource type nested two levels below the parent?
      - Can I change a SKU on a grandchild resource type?
      instructions:
      - text: Create SKU {sku} on second-level type {nestedResourceTypeSecond} under {nestedResourceTypeFirst}, {resourceType}, provider {providerNamespace}.
        slots:
          sku: path.sku
          nestedResourceTypeSecond: path.nestedResourceTypeSecond
          nestedResourceTypeFirst: path.nestedResourceTypeFirst
          resourceType: path.resourceType
          providerNamespace: path.providerNamespace
      - text: Update grandchild-type SKU {sku} on {nestedResourceTypeSecond} with properties {properties}.
        slots:
          sku: path.sku
          nestedResourceTypeSecond: path.nestedResourceTypeSecond
          properties: requestBody.properties
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.ProviderHub/providerRegistrations/{providerNamespace}/resourcetypeRegistrations/{resourceType}/resourcetypeRegistrations/{nestedResourceTypeFirst}/resourcetypeRegistrations/{nestedResourceTypeSecond}/skus/{sku}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a SKU from a second-level nested type
      effect: destructive
      questions:
      - How do I remove a SKU from a grandchild resource type?
      - Can I delete a SKU sitting two levels deep in my resource type hierarchy?
      instructions:
      - text: Delete SKU {sku} from second-level type {nestedResourceTypeSecond} under {nestedResourceTypeFirst}, {resourceType}, provider {providerNamespace}.
        slots:
          sku: path.sku
          nestedResourceTypeSecond: path.nestedResourceTypeSecond
          nestedResourceTypeFirst: path.nestedResourceTypeFirst
          resourceType: path.resourceType
          providerNamespace: path.providerNamespace
      - text: Remove grandchild-type SKU {sku} from {nestedResourceTypeSecond}.
        slots:
          sku: path.sku
          nestedResourceTypeSecond: path.nestedResourceTypeSecond
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.ProviderHub/providerRegistrations/{providerNamespace}/resourcetypeRegistrations/{resourceType}/resourcetypeRegistrations/{nestedResourceTypeFirst}/resourcetypeRegistrations/{nestedResourceTypeSecond}/resourcetypeRegistrations/{nestedResourceTypeThird}/skus/{sku}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a SKU of a third-level nested resource type
      effect: read
      questions:
      - How do I read a SKU on the deepest, third-level nested resource type?
      - What does a SKU three levels down in my provider's type tree contain?
      instructions:
      - text: Get level-3 SKU {sku} at {providerNamespace}/{resourceType}/{nestedResourceTypeFirst}/{nestedResourceTypeSecond}/{nestedResourceTypeThird}.
        slots:
          sku: path.sku
          nestedResourceTypeThird: path.nestedResourceTypeThird
          nestedResourceTypeSecond: path.nestedResourceTypeSecond
          nestedResourceTypeFirst: path.nestedResourceTypeFirst
          resourceType: path.resourceType
          providerNamespace: path.providerNamespace
      - text: Show third-level SKU {sku} on {nestedResourceTypeThird}.
        slots:
          sku: path.sku
          nestedResourceTypeThird: path.nestedResourceTypeThird
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.ProviderHub/providerRegistrations/{providerNamespace}/resourcetypeRegistrations/{resourceType}/resourcetypeRegistrations/{nestedResourceTypeFirst}/resourcetypeRegistrations/{nestedResourceTypeSecond}/resourcetypeRegistrations/{nestedResourceTypeThird}/skus/{sku}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create or update a SKU on a third-level nested type
      effect: write
      questions:
      - How do I register a SKU on a resource type nested three levels deep?
      - Can I update a SKU on the third level of nested resource types?
      instructions:
      - text: Create level-3 SKU {sku} at {providerNamespace}/{resourceType}/{nestedResourceTypeFirst}/{nestedResourceTypeSecond}/{nestedResourceTypeThird}.
        slots:
          sku: path.sku
          nestedResourceTypeThird: path.nestedResourceTypeThird
          nestedResourceTypeSecond: path.nestedResourceTypeSecond
          nestedResourceTypeFirst: path.nestedResourceTypeFirst
          resourceType: path.resourceType
          providerNamespace: path.providerNamespace
      - text: Update third-level SKU {sku} on {nestedResourceTypeThird} with properties {properties}.
        slots:
          sku: path.sku
          nestedResourceTypeThird: path.nestedResourceTypeThird
          properties: requestBody.properties
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.ProviderHub/providerRegistrations/{providerNamespace}/resourcetypeRegistrations/{resourceType}/resourcetypeRegistrations/{nestedResourceTypeFirst}/resourcetypeRegistrations/{nestedResourceTypeSecond}/resourcetypeRegistrations/{nestedResourceTypeThird}/skus/{sku}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a SKU from a third-level nested type
      effect: destructive
      questions:
      - How do I delete a SKU from a third-level nested resource type?
      - Can I remove a SKU at the deepest level of my resource type nesting?
      instructions:
      - text: Delete level-3 SKU {sku} at {providerNamespace}/{resourceType}/{nestedResourceTypeFirst}/{nestedResourceTypeSecond}/{nestedResourceTypeThird}.
        slots:
          sku: path.sku
          nestedResourceTypeThird: path.nestedResourceTypeThird
          nestedResourceTypeSecond: path.nestedResourceTypeSecond
          nestedResourceTypeFirst: path.nestedResourceTypeFirst
          resourceType: path.resourceType
          providerNamespace: path.providerNamespace
      - text: Remove third-level SKU {sku} from {nestedResourceTypeThird}.
        slots:
          sku: path.sku
          nestedResourceTypeThird: path.nestedResourceTypeThird
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.ProviderHub/providerRegistrations/{providerNamespace}/resourcetypeRegistrations/{resourceType}/skus'].get
  update:
    x-apievangelist-phrasing:
      intent: List SKUs of a top-level resource type
      effect: read
      questions:
      - Which SKUs have I registered on a top-level resource type in ProviderHub?
      - What SKUs does my provider currently offer for a given resource type?
      instructions:
      - text: List SKUs on resource type {resourceType} of provider {providerNamespace}.
        slots:
          resourceType: path.resourceType
          providerNamespace: path.providerNamespace
      - text: Show all top-level SKUs for {resourceType}.
        slots:
          resourceType: path.resourceType
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.ProviderHub/providerRegistrations/{providerNamespace}/resourcetypeRegistrations/{resourceType}/resourcetypeRegistrations/{nestedResourceTypeFirst}/skus'].get
  update:
    x-apievangelist-phrasing:
      intent: List SKUs of a first-level nested resource type
      effect: read
      questions:
      - Which SKUs exist on a child resource type one level below the parent?
      - Can I list every SKU on a first-level nested type?
      instructions:
      - text: List SKUs on nested type {nestedResourceTypeFirst} under {resourceType} of provider {providerNamespace}.
        slots:
          nestedResourceTypeFirst: path.nestedResourceTypeFirst
          resourceType: path.resourceType
          providerNamespace: path.providerNamespace
      - text: Show all child-type SKUs for {nestedResourceTypeFirst}.
        slots:
          nestedResourceTypeFirst: path.nestedResourceTypeFirst
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.ProviderHub/providerRegistrations/{providerNamespace}/resourcetypeRegistrations/{resourceType}/resourcetypeRegistrations/{nestedResourceTypeFirst}/resourcetypeRegistrations/{nestedResourceTypeSecond}/skus'].get
  update:
    x-apievangelist-phrasing:
      intent: List SKUs of a second-level nested resource type
      effect: read
      questions:
      - Which SKUs are registered on a grandchild resource type?
      - Can I see all SKUs two levels deep under a resource type?
      instructions:
      - text: List SKUs on second-level type {nestedResourceTypeSecond} under {nestedResourceTypeFirst}, {resourceType}, provider {providerNamespace}.
        slots:
          nestedResourceTypeSecond: path.nestedResourceTypeSecond
          nestedResourceTypeFirst: path.nestedResourceTypeFirst
          resourceType: path.resourceType
          providerNamespace: path.providerNamespace
      - text: Show all grandchild-type SKUs for {nestedResourceTypeSecond}.
        slots:
          nestedResourceTypeSecond: path.nestedResourceTypeSecond
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.ProviderHub/providerRegistrations/{providerNamespace}/resourcetypeRegistrations/{resourceType}/resourcetypeRegistrations/{nestedResourceTypeFirst}/resourcetypeRegistrations/{nestedResourceTypeSecond}/resourcetypeRegistrations/{nestedResourceTypeThird}/skus'].get
  update:
    x-apievangelist-phrasing:
      intent: List SKUs of a third-level nested resource type
      effect: read
      questions:
      - Which SKUs are defined on a third-level nested resource type?
      - Can I list the SKUs at the deepest level of my nested resource types?
      instructions:
      - text: List level-3 SKUs at {providerNamespace}/{resourceType}/{nestedResourceTypeFirst}/{nestedResourceTypeSecond}/{nestedResourceTypeThird}.
        slots:
          nestedResourceTypeThird: path.nestedResourceTypeThird
          nestedResourceTypeSecond: path.nestedResourceTypeSecond
          nestedResourceTypeFirst: path.nestedResourceTypeFirst
          resourceType: path.resourceType
          providerNamespace: path.providerNamespace
      - text: Show all third-level SKUs for {nestedResourceTypeThird}.
        slots:
          nestedResourceTypeThird: path.nestedResourceTypeThird
      method: generated
      generated: '2026-09-26'