# 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 Application Package…
  version: 1.0.0
extends: openapi/microsoft-azure-applicationpackage-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: 5
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Batch/batchAccounts/{accountName}/applications/{applicationName}/versions/{versionName}/activate'].post
  update:
    x-apievangelist-phrasing:
      intent: Activate a Batch application package
      effect: write
      questions:
      - What do I need to do after uploading a Batch application package before pools can use it?
      - How do I activate an application package version with a zip format?
      instructions:
      - text: Activate package version {versionName} of application {applicationName} in Batch account {accountName} with format {format}.
        slots:
          versionName: path.versionName
          applicationName: path.applicationName
          accountName: path.accountName
          format: requestBody.format
      - text: Activate application {applicationName} version {versionName} in {resourceGroupName} of subscription {subscriptionId}.
        slots:
          applicationName: path.applicationName
          versionName: path.versionName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Batch/batchAccounts/{accountName}/applications/{applicationName}/versions/{versionName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a Batch application package
      effect: read
      questions:
      - How do I check whether a Batch application package version is active?
      - Where do I find the storage URL for an application package I created?
      instructions:
      - text: Get package version {versionName} of application {applicationName} in Batch account {accountName}.
        slots:
          versionName: path.versionName
          applicationName: path.applicationName
          accountName: path.accountName
      - text: Show application {applicationName} package {versionName} in {resourceGroupName} of subscription {subscriptionId}.
        slots:
          applicationName: path.applicationName
          versionName: path.versionName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Batch/batchAccounts/{accountName}/applications/{applicationName}/versions/{versionName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create a Batch application package record
      effect: write
      questions:
      - Can I create a new application package version and get a URL to upload it to?
      - What's the first step to add a new version of a Batch application?
      instructions:
      - text: Create package version {versionName} for application {applicationName} in Batch account {accountName}.
        slots:
          versionName: path.versionName
          applicationName: path.applicationName
          accountName: path.accountName
      - text: Add application {applicationName} version {versionName} in {resourceGroupName} of subscription {subscriptionId}.
        slots:
          applicationName: path.applicationName
          versionName: path.versionName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Batch/batchAccounts/{accountName}/applications/{applicationName}/versions/{versionName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a Batch application package
      effect: destructive
      questions:
      - How do I delete an old version of a Batch application package and its binary?
      - Does removing an application package also delete the uploaded file?
      instructions:
      - text: Delete package version {versionName} of application {applicationName} in Batch account {accountName}.
        slots:
          versionName: path.versionName
          applicationName: path.applicationName
          accountName: path.accountName
      - text: Remove application {applicationName} version {versionName} from {resourceGroupName} in subscription {subscriptionId}.
        slots:
          applicationName: path.applicationName
          versionName: path.versionName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Batch/batchAccounts/{accountName}/applications/{applicationName}/versions'].get
  update:
    x-apievangelist-phrasing:
      intent: List a Batch application's package versions
      effect: read
      questions:
      - Which package versions exist for a Batch application?
      - Can I cap the number of application package versions returned?
      instructions:
      - text: List package versions of application {applicationName} in Batch account {accountName} in {resourceGroupName} of subscription {subscriptionId}.
        slots:
          applicationName: path.applicationName
          accountName: path.accountName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      - text: Show up to {maxresults} versions of application {applicationName}.
        slots:
          maxresults: query.maxresults
          applicationName: path.applicationName
      method: generated
      generated: '2026-09-26'