API Evangelist conversational phrasing for Microsoft Azure DeploymentAdminClient Product Secrets 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 DeploymentAdminClient Product Secrets API
  version: 1.0.0
extends: openapi/microsoft-azure-productsecrets-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: 4
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.Deployment.Admin/locations/global/productPackages/{packageId}/secrets'].get
  update:
    x-apievangelist-phrasing:
      intent: List product package secrets
      effect: read
      questions:
      - Which secrets does a deployment product package need?
      - Can I see all the secrets defined for a product package in Azure Stack deployment admin?
      instructions:
      - text: List the secrets for product package {packageId}.
        slots:
          packageId: path.packageId
      - text: Show every product secret defined in package {packageId}.
        slots:
          packageId: path.packageId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.Deployment.Admin/locations/global/productPackages/{packageId}/secrets/{secretName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a product package secret
      effect: read
      questions:
      - How do I look up one specific product secret?
      - What does a single product package secret record contain?
      instructions:
      - text: Get product secret {secretName} from package {packageId}.
        slots:
          secretName: path.secretName
          packageId: path.packageId
      - text: Show the details of package secret {secretName}.
        slots:
          secretName: path.secretName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.Deployment.Admin/locations/global/productPackages/{packageId}/secrets/{secretName}/import'].post
  update:
    x-apievangelist-phrasing:
      intent: Import a product package secret
      effect: write
      questions:
      - How do I import a certificate or password as a product secret?
      - Can I set the value of a product package secret before deployment?
      instructions:
      - text: Import secret {secretName} into package {packageId} with parameters {secretParameters}.
        slots:
          secretName: path.secretName
          packageId: path.packageId
          secretParameters: body.secretParameters
      - text: Upload a value into product secret {secretName} using {secretParameters}.
        slots:
          secretName: path.secretName
          secretParameters: body.secretParameters
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.Deployment.Admin/locations/global/productPackages/{packageId}/secrets/{secretName}/validate'].post
  update:
    x-apievangelist-phrasing:
      intent: Validate a product package secret
      effect: read
      questions:
      - Can I check a product secret value is valid before I import it?
      - Is there a way to test secret parameters without saving them?
      instructions:
      - text: Validate product secret {secretName} in package {packageId} with parameters {secretParameters}.
        slots:
          secretName: path.secretName
          packageId: path.packageId
          secretParameters: body.secretParameters
      - text: Check whether {secretParameters} is acceptable for secret {secretName}.
        slots:
          secretParameters: body.secretParameters
          secretName: path.secretName
      method: generated
      generated: '2026-10-01'