# 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 ApiManagementClient Product Policy API
  version: 1.0.0
extends: openapi/microsoft-azure-productpolicy-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: 5
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/workspaces/{workspaceId}/products/{productId}/policies'].get
  update:
    x-apievangelist-phrasing:
      intent: List policies on an API Management product
      effect: read
      questions:
      - What policy configuration is applied to a product in my API Management workspace?
      - Can I list all the policies attached at the product level?
      instructions:
      - text: List the policies on product {product} in workspace {workspace} of API Management service {service}.
        slots:
          product: path.productId
          workspace: path.workspaceId
          service: path.serviceName
      - text: Show every product-level policy in the workspace.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/workspaces/{workspaceId}/products/{productId}/policies/{policyId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a product-level policy
      effect: read
      questions:
      - How do I read the XML of the policy applied to an API Management product?
      - Which rate limits and transformations does my product policy enforce?
      instructions:
      - text: Read policy {policy} attached to product {product} in workspace {workspace} on APIM service {service}.
        slots:
          policy: path.policyId
          product: path.productId
          workspace: path.workspaceId
          service: path.serviceName
      - text: Show the product policy's current XML.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/workspaces/{workspaceId}/products/{productId}/policies/{policyId}'].put
  update:
    x-apievangelist-phrasing:
      intent: Set the policy on an API Management product
      effect: write
      questions:
      - How do I apply a new policy to a product in an API Management workspace?
      - Can I overwrite a product's existing policy configuration?
      instructions:
      - text: Apply policy {policy} to product {product} in workspace {workspace} of service {service}, overwriting what is there.
        slots:
          policy: path.policyId
          product: path.productId
          workspace: path.workspaceId
          service: path.serviceName
      - text: Replace the product-level policy with an updated version.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/workspaces/{workspaceId}/products/{productId}/policies/{policyId}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a product-level policy
      effect: destructive
      questions:
      - How do I remove the policy from an API Management product?
      - Can I clear a product's policy configuration entirely?
      instructions:
      - text: Delete policy {policy} from product {product} in API Management workspace {workspace} on service {service}.
        slots:
          policy: path.policyId
          product: path.productId
          workspace: path.workspaceId
          service: path.serviceName
      - text: Remove the product-level policy configuration.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/workspaces/{workspaceId}/products/{productId}/policies/{policyId}'].head
  update:
    x-apievangelist-phrasing:
      intent: Get the ETag of a product policy
      effect: read
      questions:
      - How do I get the current ETag of a product policy before updating it?
      - Has the product policy changed since I last read it?
      instructions:
      - text: Fetch only the ETag of policy {policy} on product {product}, workspace {workspace}, service {service}.
        slots:
          policy: path.policyId
          product: path.productId
          workspace: path.workspaceId
          service: path.serviceName
      - text: Check the entity tag on my workspace product's policy.
      method: generated
      generated: '2026-10-01'