# 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 HybridCloud Cloud Connections API
  version: 1.0.0
extends: openapi/microsoft-azure-cloud-connections-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: 6
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.HybridCloud/cloudConnections'].get
  update:
    x-apievangelist-phrasing:
      intent: List cloud connections in a subscription
      effect: read
      questions:
      - Which hybrid cloud connections exist across my whole Azure subscription?
      - Can I list every cloud connection in the subscription regardless of resource group?
      instructions:
      - text: List all cloud connections in my subscription.
      - text: Show every hybrid cloud connection across the subscription using API version {apiversion}.
        slots:
          apiversion: query.api-version
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.HybridCloud/cloudConnections'].get
  update:
    x-apievangelist-phrasing:
      intent: List cloud connections in a resource group
      effect: read
      questions:
      - Which cloud connections are in one particular resource group?
      - Can I narrow the hybrid cloud connection list to a single resource group?
      instructions:
      - text: List the cloud connections in my resource group.
      - text: Show the hybrid cloud connections scoped to this resource group only, API version {apiversion}.
        slots:
          apiversion: query.api-version
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.HybridCloud/cloudConnections/{cloudConnectionName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a cloud connection
      effect: read
      questions:
      - What are the properties of one of my hybrid cloud connections?
      - Can I look up a single cloud connection by name?
      instructions:
      - text: Get cloud connection {cloudConnectionName}.
        slots:
          cloudConnectionName: path.cloudConnectionName
      - text: Show the details of hybrid cloud connection {cloudConnectionName}.
        slots:
          cloudConnectionName: path.cloudConnectionName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.HybridCloud/cloudConnections/{cloudConnectionName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create or update a cloud connection
      effect: write
      questions:
      - What do I need to create a hybrid cloud connection resource?
      - Can I replace the properties of an existing cloud connection?
      instructions:
      - text: Create cloud connection {cloudConnectionName}.
        slots:
          cloudConnectionName: path.cloudConnectionName
      - text: Create or update hybrid cloud connection {cloudConnectionName} with new properties.
        slots:
          cloudConnectionName: path.cloudConnectionName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.HybridCloud/cloudConnections/{cloudConnectionName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a cloud connection
      effect: destructive
      questions:
      - Can I delete a hybrid cloud connection I no longer need?
      - What is the call to remove a cloud connection resource?
      instructions:
      - text: Delete cloud connection {cloudConnectionName}.
        slots:
          cloudConnectionName: path.cloudConnectionName
      - text: Remove hybrid cloud connection {cloudConnectionName}.
        slots:
          cloudConnectionName: path.cloudConnectionName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.HybridCloud/cloudConnections/{cloudConnectionName}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update tags on a cloud connection
      effect: write
      questions:
      - Can I change only the tags on a cloud connection without touching its settings?
      - Which call updates resource tags on a hybrid cloud connection?
      instructions:
      - text: Update the tags on cloud connection {cloudConnectionName}.
        slots:
          cloudConnectionName: path.cloudConnectionName
      - text: Set tags {tags} on hybrid cloud connection {cloudConnectionName}.
        slots:
          tags: requestBody.tags
          cloudConnectionName: path.cloudConnectionName
      method: generated
      generated: '2026-10-01'