# 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.Community Community Trainings API
  version: 1.0.0
extends: openapi/microsoft-azure-communitytrainings-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.Community/communityTrainings'].get
  update:
    x-apievangelist-phrasing:
      intent: List Community Training instances in a subscription
      effect: read
      questions:
      - Which Community Training resources exist across my subscription?
      - Can I see every Community Training portal I've provisioned in Azure?
      instructions:
      - text: List all Community Training resources in my subscription.
      - text: Show every Community Training instance I own.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Community/communityTrainings'].get
  update:
    x-apievangelist-phrasing:
      intent: List Community Training instances in a resource group
      effect: read
      questions:
      - What Community Training resources are in one resource group?
      - Can I narrow my Community Training list to a single resource group?
      instructions:
      - text: List the Community Training resources in this resource group.
      - text: Show Community Training instances grouped under my current resource group.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Community/communityTrainings/{communityTrainingName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a Community Training instance
      effect: read
      questions:
      - How do I look up the settings of one Community Training resource?
      - What SKU and properties does a specific Community Training instance have?
      instructions:
      - text: Get Community Training resource {training}.
        slots:
          training: path.communityTrainingName
      - text: Show the details of Community Training {training}.
        slots:
          training: path.communityTrainingName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Community/communityTrainings/{communityTrainingName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create a Community Training instance
      effect: write
      questions:
      - How do I provision a new Community Training platform in Azure?
      - Can I choose a SKU when creating a Community Training resource?
      instructions:
      - text: Create Community Training resource {training}.
        slots:
          training: path.communityTrainingName
      - text: Provision Community Training {training} on the {sku} SKU.
        slots:
          training: path.communityTrainingName
          sku: requestBody.sku
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Community/communityTrainings/{communityTrainingName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a Community Training instance
      effect: destructive
      questions:
      - Can I remove a Community Training resource I no longer need?
      - How do I delete a Community Training portal?
      instructions:
      - text: Delete Community Training resource {training}.
        slots:
          training: path.communityTrainingName
      - text: Tear down the {training} Community Training instance.
        slots:
          training: path.communityTrainingName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Community/communityTrainings/{communityTrainingName}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update a Community Training instance
      effect: write
      questions:
      - Can I change the tags or SKU of an existing Community Training resource?
      - Is there a way to patch a Community Training instance's properties?
      instructions:
      - text: Update tags on Community Training {training} to {tags}.
        slots:
          training: path.communityTrainingName
          tags: requestBody.tags
      - text: Change the SKU of existing Community Training {training} to {sku}.
        slots:
          training: path.communityTrainingName
          sku: requestBody.sku
      method: generated
      generated: '2026-09-26'