# 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 Nginx.NginxPlus Nginx Certificate API
  version: 1.0.0
extends: openapi/microsoft-azure-nginxcertificate-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: 4
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Nginx.NginxPlus/nginxDeployments/{deploymentName}/certificates/{certificateName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a certificate on an NGINX deployment
      effect: read
      questions:
      - How do I check a TLS certificate configured on my NGINXaaS deployment?
      - What does one NGINX deployment certificate record include, like its Key Vault secret?
      instructions:
      - text: Show certificate {certificateName} on NGINX deployment {deploymentName}.
        slots:
          certificateName: path.certificateName
          deploymentName: path.deploymentName
      - text: Get NGINX deployment {deploymentName} certificate {certificateName}.
        slots:
          deploymentName: path.deploymentName
          certificateName: path.certificateName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Nginx.NginxPlus/nginxDeployments/{deploymentName}/certificates/{certificateName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Add or update an NGINX deployment certificate
      effect: write
      questions:
      - How do I add a Key Vault certificate to my NGINX deployment?
      - Can I replace a certificate an NGINX deployment already uses?
      instructions:
      - text: Add certificate {certificateName} to NGINX deployment {deploymentName}.
        slots:
          certificateName: path.certificateName
          deploymentName: path.deploymentName
      - text: Create or update certificate {certificateName} on NGINX deployment {deploymentName} with these properties.
        slots:
          certificateName: path.certificateName
          deploymentName: path.deploymentName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Nginx.NginxPlus/nginxDeployments/{deploymentName}/certificates/{certificateName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a certificate from an NGINX deployment
      effect: destructive
      questions:
      - Can I remove a certificate from my NGINX deployment?
      - What happens to TLS listeners if I delete an NGINX certificate?
      instructions:
      - text: Delete certificate {certificateName} from NGINX deployment {deploymentName}.
        slots:
          certificateName: path.certificateName
          deploymentName: path.deploymentName
      - text: Remove the {certificateName} certificate from deployment {deploymentName}.
        slots:
          certificateName: path.certificateName
          deploymentName: path.deploymentName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Nginx.NginxPlus/nginxDeployments/{deploymentName}/certificates'].get
  update:
    x-apievangelist-phrasing:
      intent: List certificates on an NGINX deployment
      effect: read
      questions:
      - Which certificates are configured on my NGINX deployment?
      - Can I see all TLS certificates an NGINXaaS deployment references?
      instructions:
      - text: List certificates on NGINX deployment {deploymentName}.
        slots:
          deploymentName: path.deploymentName
      - text: Show every certificate attached to NGINX deployment {deploymentName}.
        slots:
          deploymentName: path.deploymentName
      method: generated
      generated: '2026-09-26'