# 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 WebSite Management Client Certificate…
  version: 1.0.0
extends: openapi/microsoft-azure-certificateorders-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: 16
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CertificateRegistration/certificateOrders/{certificateOrderName}/certificates/{name}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the certificate attached to a certificate order
      effect: read
      questions:
      - How do I see the Key Vault certificate linked to my App Service certificate order?
      - Which certificate is associated with a given certificate order?
      instructions:
      - text: Get certificate {name} on certificate order {certificateOrderName}.
        slots:
          name: path.name
          certificateOrderName: path.certificateOrderName
      - text: Show certificate {name} for order {certificateOrderName} in {resourceGroupName} of subscription {subscriptionId}.
        slots:
          name: path.name
          certificateOrderName: path.certificateOrderName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CertificateRegistration/certificateOrders/{certificateOrderName}/certificates/{name}'].put
  update:
    x-apievangelist-phrasing:
      intent: Link a Key Vault secret to a certificate order
      effect: write
      questions:
      - How do I tell a certificate order which Key Vault secret should store the issued certificate?
      - Can I associate a Key Vault secret with my certificate order before it is ready?
      instructions:
      - text: Associate Key Vault secret certificate {name} with order {certificateOrderName} at {location}.
        slots:
          name: path.name
          certificateOrderName: path.certificateOrderName
          location: requestBody.location
      - text: Create certificate store binding {name} on order {certificateOrderName} in {resourceGroupName} of subscription {subscriptionId}.
        slots:
          name: path.name
          certificateOrderName: path.certificateOrderName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CertificateRegistration/certificateOrders/{certificateOrderName}/certificates/{name}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Remove the certificate from a certificate order
      effect: destructive
      questions:
      - How do I detach the certificate associated with a certificate order?
      - Can I delete a certificate binding without deleting the order itself?
      instructions:
      - text: Delete certificate {name} from order {certificateOrderName}.
        slots:
          name: path.name
          certificateOrderName: path.certificateOrderName
      - text: Remove certificate {name} on order {certificateOrderName} in {resourceGroupName} of subscription {subscriptionId}.
        slots:
          name: path.name
          certificateOrderName: path.certificateOrderName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CertificateRegistration/certificateOrders/{certificateOrderName}/certificates/{name}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Patch a certificate order's Key Vault binding
      effect: write
      questions:
      - Can I patch the Key Vault secret binding on an existing certificate order certificate?
      - What changes the secret an order's certificate is stored in after setup?
      instructions:
      - text: Patch certificate {name} on order {certificateOrderName} with properties {properties}.
        slots:
          name: path.name
          certificateOrderName: path.certificateOrderName
          properties: requestBody.properties
      - text: Update the Key Vault binding {name} for order {certificateOrderName} in {resourceGroupName} of subscription {subscriptionId} at {location}.
        slots:
          name: path.name
          certificateOrderName: path.certificateOrderName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
          location: requestBody.location
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CertificateRegistration/certificateOrders/{name}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a certificate order
      effect: read
      questions:
      - Where can I check the status of an App Service certificate purchase?
      - What details does a certificate order hold?
      instructions:
      - text: Get certificate order {name} in {resourceGroupName} of subscription {subscriptionId}.
        slots:
          name: path.name
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      - text: Show the certificate purchase order {name}.
        slots:
          name: path.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CertificateRegistration/certificateOrders/{name}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create a certificate purchase order
      effect: write
      questions:
      - How do I buy an SSL certificate through a certificate order?
      - What do I need to supply to place a new certificate purchase order?
      instructions:
      - text: Create certificate purchase order {name} in {resourceGroupName} of subscription {subscriptionId} at {location}.
        slots:
          name: path.name
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
          location: requestBody.location
      - text: Place a certificate order {name} with properties {properties}.
        slots:
          name: path.name
          properties: requestBody.properties
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CertificateRegistration/certificateOrders/{name}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a certificate order
      effect: destructive
      questions:
      - Can I delete an existing certificate order entirely?
      - Is it possible to remove a certificate purchase order I no longer want?
      instructions:
      - text: Delete certificate order {name} in {resourceGroupName} of subscription {subscriptionId}.
        slots:
          name: path.name
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      - text: Remove the certificate purchase order {name}.
        slots:
          name: path.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CertificateRegistration/certificateOrders/{name}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Patch an existing certificate purchase order
      effect: write
      questions:
      - Can I patch settings on a certificate order after I placed it?
      - Which fields on an existing certificate purchase order, such as tags, can be patched?
      instructions:
      - text: Patch certificate order {name} with tags {tags}.
        slots:
          name: path.name
          tags: requestBody.tags
      - text: Update existing certificate order {name} in {resourceGroupName} of subscription {subscriptionId} at {location}.
        slots:
          name: path.name
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
          location: requestBody.location
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CertificateRegistration/certificateOrders'].get
  update:
    x-apievangelist-phrasing:
      intent: List certificate orders in a resource group
      effect: read
      questions:
      - Which certificate orders do I have in a resource group?
      - Can I see all my certificate purchases for one resource group?
      instructions:
      - text: List certificate orders in {resourceGroupName} of subscription {subscriptionId}.
        slots:
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      - text: Show every certificate purchase in resource group {resourceGroupName}.
        slots:
          resourceGroupName: path.resourceGroupName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CertificateRegistration/certificateOrders/{certificateOrderName}/certificates'].get
  update:
    x-apievangelist-phrasing:
      intent: List certificates on a certificate order
      effect: read
      questions:
      - How many certificates can be associated with one certificate order?
      - What certificates are currently tied to my certificate order?
      instructions:
      - text: List certificates on order {certificateOrderName}.
        slots:
          certificateOrderName: path.certificateOrderName
      - text: Show all certificates for order {certificateOrderName} in {resourceGroupName} of subscription {subscriptionId}.
        slots:
          certificateOrderName: path.certificateOrderName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CertificateRegistration/certificateOrders/{name}/reissue'].post
  update:
    x-apievangelist-phrasing:
      intent: Reissue a certificate order
      effect: write
      questions:
      - How do I reissue an SSL certificate I already bought?
      - Can I get a certificate order reissued, for example after rekeying?
      instructions:
      - text: Reissue certificate order {name} in {resourceGroupName} of subscription {subscriptionId}.
        slots:
          name: path.name
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      - text: Reissue order {name} at {location} with properties {properties}.
        slots:
          name: path.name
          location: requestBody.location
          properties: requestBody.properties
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CertificateRegistration/certificateOrders/{name}/renew'].post
  update:
    x-apievangelist-phrasing:
      intent: Renew a certificate order
      effect: write
      questions:
      - What's the way to renew a certificate order before it expires?
      - Can I renew my App Service certificate purchase manually?
      instructions:
      - text: Renew certificate order {name} in {resourceGroupName} of subscription {subscriptionId}.
        slots:
          name: path.name
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      - text: Renew order {name} at {location}.
        slots:
          name: path.name
          location: requestBody.location
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CertificateRegistration/certificateOrders/{name}/retrieveCertificateActions'].post
  update:
    x-apievangelist-phrasing:
      intent: List actions taken on a certificate order
      effect: read
      questions:
      - What actions have happened on my certificate order so far?
      - Can I see the history of certificate actions, like issuance, for an order?
      instructions:
      - text: Retrieve certificate actions for order {name}.
        slots:
          name: path.name
      - text: Show the action log for certificate order {name} in {resourceGroupName} of subscription {subscriptionId}.
        slots:
          name: path.name
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CertificateRegistration/certificateOrders/{name}/retrieveEmailHistory'].post
  update:
    x-apievangelist-phrasing:
      intent: Get the email history of a certificate order
      effect: read
      questions:
      - Which emails were sent for my certificate order?
      - Can I check when the domain verification email went out?
      instructions:
      - text: Retrieve email history for certificate order {name}.
        slots:
          name: path.name
      - text: Show emails sent about order {name} in {resourceGroupName} of subscription {subscriptionId}.
        slots:
          name: path.name
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CertificateRegistration/certificateOrders/{name}/resendEmail'].post
  update:
    x-apievangelist-phrasing:
      intent: Resend the certificate order email
      effect: write
      questions:
      - I never got the certificate email, can it be sent again?
      - Is there a way to resend the verification email for a certificate order?
      instructions:
      - text: Resend the certificate email for order {name}.
        slots:
          name: path.name
      - text: Send the email for certificate order {name} in {resourceGroupName} of subscription {subscriptionId} again.
        slots:
          name: path.name
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CertificateRegistration/certificateOrders/{name}/verifyDomainOwnership'].post
  update:
    x-apievangelist-phrasing:
      intent: Verify domain ownership for a certificate order
      effect: write
      questions:
      - How do I trigger domain ownership verification for my certificate order?
      - Can I re-check that I own the domain on a pending certificate?
      instructions:
      - text: Verify domain ownership for certificate order {name}.
        slots:
          name: path.name
      - text: Run domain verification on order {name} in {resourceGroupName} of subscription {subscriptionId}.
        slots:
          name: path.name
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      method: generated
      generated: '2026-09-26'