Generated by API Evangelist
Written by API Evangelist tooling for Microsoft Azure's API. It is a proposal applied on top of the contract, not a document Microsoft Azure publishes.
# 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 Purview Metadata Policies Service REST API…
version: 1.0.0
extends: openapi/microsoft-azure-metadata-policy-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: 3
- target: $.paths['/metadataPolicies'].get
update:
x-apievangelist-phrasing:
intent: List metadata policies
effect: read
questions:
- Which metadata policies are defined in my data catalog account?
- Can I get only the metadata policy for one collection?
instructions:
- text: List all metadata policies.
- text: Show the metadata policy for collection {collection}.
slots:
collection: query.collectionName
method: generated
generated: '2026-10-01'
- target: $.paths['/metadataPolicies/{policyId}'].get
update:
x-apievangelist-phrasing:
intent: Get a metadata policy by id
effect: read
questions:
- What does a specific metadata policy contain?
- Can I fetch a metadata policy by its policy id?
instructions:
- text: Get metadata policy {policy}.
slots:
policy: path.policyId
- text: Show the full contents of metadata policy {policy}.
slots:
policy: path.policyId
method: generated
generated: '2026-10-01'
- target: $.paths['/metadataPolicies/{policyId}'].put
update:
x-apievangelist-phrasing:
intent: Update a metadata policy
effect: write
questions:
- How do I change who has access in a metadata policy?
- Does updating a metadata policy need its current version?
instructions:
- text: Update metadata policy {policy} with properties {props}.
slots:
policy: path.policyId
props: requestBody.properties
- text: Replace metadata policy {policy} at version {version} with {props}.
slots:
policy: path.policyId
version: requestBody.version
props: requestBody.properties
method: generated
generated: '2026-10-01'
Discovery needs no key. Ratings and market analysis are Pro.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we
store it to create your key and to recognise you if you sign in with another
provider. See our Privacy Policy and
Terms.