# 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 BatchManagementClient Batch Account API
  version: 1.0.0
extends: openapi/microsoft-azure-batchaccount-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: 10
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Batch/batchAccounts/{accountName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a Batch account
      effect: read
      questions:
      - What are the settings of my Azure Batch account?
      - Can I look up one Batch account by name in a resource group?
      instructions:
      - text: Get Batch account {accountName} in resource group {resourceGroupName} of subscription {subscriptionId}.
        slots:
          subscriptionId: path.subscriptionId
          accountName: path.accountName
          resourceGroupName: path.resourceGroupName
      - text: Show the configuration of Batch account {accountName}.
        slots:
          accountName: path.accountName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Batch/batchAccounts/{accountName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create a Batch account
      effect: write
      questions:
      - How do I create a new Azure Batch account in a region?
      - Can this call update an existing Batch account, or only create new ones?
      instructions:
      - text: Create Batch account {accountName} in {location} under resource group {resourceGroupName} of subscription {subscriptionId}.
        slots:
          subscriptionId: path.subscriptionId
          accountName: path.accountName
          location: requestBody.location
          resourceGroupName: path.resourceGroupName
      - text: Create a new Batch account named {accountName} in {location}.
        slots:
          accountName: path.accountName
          location: requestBody.location
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Batch/batchAccounts/{accountName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a Batch account
      effect: destructive
      questions:
      - Can I delete a Batch account I no longer use?
      - What is lost when a Batch account is deleted?
      instructions:
      - text: Delete Batch account {accountName} in resource group {resourceGroupName} of subscription {subscriptionId}.
        slots:
          subscriptionId: path.subscriptionId
          accountName: path.accountName
          resourceGroupName: path.resourceGroupName
      - text: Remove the Batch account {accountName}.
        slots:
          accountName: path.accountName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Batch/batchAccounts/{accountName}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update an existing Batch account
      effect: write
      questions:
      - How do I change tags or identity on an existing Batch account?
      - Which properties of a Batch account can be updated after it is created?
      instructions:
      - text: Update the tags on Batch account {accountName} in {resourceGroupName} of subscription {subscriptionId}.
        slots:
          subscriptionId: path.subscriptionId
          accountName: path.accountName
          resourceGroupName: path.resourceGroupName
      - text: Assign identity {identity} to existing Batch account {accountName}.
        slots:
          identity: requestBody.identity
          accountName: path.accountName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.Batch/batchAccounts'].get
  update:
    x-apievangelist-phrasing:
      intent: List Batch accounts in a subscription
      effect: read
      questions:
      - Which Batch accounts are in my Azure subscription?
      - Is there a subscription-wide inventory of Batch accounts?
      instructions:
      - text: List all Batch accounts in subscription {subscriptionId}.
        slots:
          subscriptionId: path.subscriptionId
      - text: Show every Batch account across the subscription.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Batch/batchAccounts'].get
  update:
    x-apievangelist-phrasing:
      intent: List Batch accounts in a resource group
      effect: read
      questions:
      - Which Batch accounts belong to a particular resource group?
      - Can I narrow the Batch account listing to one resource group?
      instructions:
      - text: List Batch accounts in resource group {resourceGroupName} of subscription {subscriptionId}.
        slots:
          subscriptionId: path.subscriptionId
          resourceGroupName: path.resourceGroupName
      - text: Show the Batch accounts under {resourceGroupName} of subscription {subscriptionId}.
        slots:
          subscriptionId: path.subscriptionId
          resourceGroupName: path.resourceGroupName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Batch/batchAccounts/{accountName}/syncAutoStorageKeys'].post
  update:
    x-apievangelist-phrasing:
      intent: Sync auto-storage keys for a Batch account
      effect: write
      questions:
      - My auto-storage keys were rotated; how do I resync them with the Batch account?
      - Does syncing auto-storage keys work when storage key authentication is not used?
      instructions:
      - text: Synchronize the auto-storage keys for Batch account {accountName} in {resourceGroupName} of subscription {subscriptionId}.
        slots:
          subscriptionId: path.subscriptionId
          accountName: path.accountName
          resourceGroupName: path.resourceGroupName
      - text: Resync storage access keys on Batch account {accountName}.
        slots:
          accountName: path.accountName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Batch/batchAccounts/{accountName}/regenerateKeys'].post
  update:
    x-apievangelist-phrasing:
      intent: Regenerate a Batch account key
      effect: destructive
      questions:
      - Can I rotate the primary or secondary shared key on a Batch account?
      - Does regenerating a Batch account key require SharedKey authentication mode?
      instructions:
      - text: Regenerate the {keyName} key for Batch account {accountName} in {resourceGroupName} of subscription {subscriptionId}.
        slots:
          subscriptionId: path.subscriptionId
          keyName: requestBody.keyName
          accountName: path.accountName
          resourceGroupName: path.resourceGroupName
      - text: Rotate Batch account {accountName}'s {keyName} key.
        slots:
          accountName: path.accountName
          keyName: requestBody.keyName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Batch/batchAccounts/{accountName}/listKeys'].post
  update:
    x-apievangelist-phrasing:
      intent: Get a Batch account's access keys
      effect: read
      questions:
      - Where do I find the shared access keys for my Batch account?
      - Why can't I retrieve Batch account keys when SharedKey is not an allowed authentication mode?
      instructions:
      - text: Get the access keys for Batch account {accountName} in {resourceGroupName} of subscription {subscriptionId}.
        slots:
          subscriptionId: path.subscriptionId
          accountName: path.accountName
          resourceGroupName: path.resourceGroupName
      - text: Show the primary and secondary keys of Batch account {accountName}.
        slots:
          accountName: path.accountName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Batch/batchAccounts/{accountName}/outboundNetworkDependenciesEndpoints'].get
  update:
    x-apievangelist-phrasing:
      intent: List a Batch account's outbound network endpoints
      effect: read
      questions:
      - Which outbound endpoints must my virtual network allow for Batch compute nodes?
      - What addresses do Batch pools in a VNet need to reach for service administration?
      instructions:
      - text: List the outbound network dependency endpoints for Batch account {accountName} in {resourceGroupName} of subscription {subscriptionId}.
        slots:
          subscriptionId: path.subscriptionId
          accountName: path.accountName
          resourceGroupName: path.resourceGroupName
      - text: Show which endpoints compute nodes in Batch account {accountName} must reach.
        slots:
          accountName: path.accountName
      method: generated
      generated: '2026-09-26'