# 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 Subscriptions API version: 1.0.0 extends: openapi/microsoft-azure-subscriptions-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: 749 - target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.Web/billingMeters'].get update: x-apievangelist-phrasing: intent: List App Service billing meters for a location effect: read questions: - Which App Service billing meters apply in a given Azure billing location? - Can I filter App Service billing meters by operating system type? instructions: - text: List the App Service billing meters for subscription {subscriptionId}. slots: subscriptionId: path.subscriptionId - text: Show App Service billing meters in {billingLocation} for {osType} plans in subscription {subscriptionId}. slots: billingLocation: query.billingLocation osType: query.osType subscriptionId: path.subscriptionId method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.Web/checknameavailability'].post update: x-apievangelist-phrasing: intent: Check if an App Service resource name is free effect: read questions: - Is my web app name still available on App Service before I create it? - Can I check whether a fully qualified hostname is taken for an App Service resource? instructions: - text: Check whether the App Service name {name} of type {type} is available in subscription {subscriptionId}. slots: name: requestBody.name type: requestBody.type subscriptionId: path.subscriptionId - text: Verify the App Service resource name {name} ({type}) is unused before I deploy. slots: name: requestBody.name type: requestBody.type method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.Web/customhostnameSites'].get update: x-apievangelist-phrasing: intent: List custom hostnames on web apps in a subscription effect: read questions: - Which custom hostnames are bound to web apps across my subscription? - Can I look up which App Service site uses a particular custom hostname? instructions: - text: List every custom hostname assigned to App Service sites in subscription {subscriptionId}. slots: subscriptionId: path.subscriptionId - text: Find the App Service custom hostname entry for {hostname} in subscription {subscriptionId}. slots: hostname: query.hostname subscriptionId: path.subscriptionId method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.Web/deploymentLocations'].get update: x-apievangelist-phrasing: intent: Get App Service deployment regions and ministamps effect: read questions: - Where can I deploy App Service apps, including the available ministamps? - What geo regions and ministamps does App Service offer to my subscription? instructions: - text: Show App Service deployment locations and ministamps for subscription {subscriptionId}. slots: subscriptionId: path.subscriptionId - text: Get the list of geo regions plus ministamps I can deploy web apps into. method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.Web/aseRegions'].get update: x-apievangelist-phrasing: intent: List App Service Environment regions and SKUs effect: read questions: - Which regions support App Service Environments, and with what SKUs? - Can I see the SKUs supported for an App Service Environment in each region? instructions: - text: List the regions available for App Service Environments in subscription {subscriptionId}. slots: subscriptionId: path.subscriptionId - text: Show me every ASE region and its supported SKUs. method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.Web/geoRegions'].get update: x-apievangelist-phrasing: intent: List App Service geographical regions effect: read questions: - Which geographical regions can host App Service plans for a given SKU? - Can I list only regions that support Linux workers for App Service? - What regions offer Linux dynamic (consumption) workers for my apps? instructions: - text: List App Service geo regions that support the {sku} SKU in subscription {subscriptionId}. slots: sku: query.sku subscriptionId: path.subscriptionId - text: Show App Service regions where Linux workers enabled is {linuxWorkersEnabled}. slots: linuxWorkersEnabled: query.linuxWorkersEnabled - text: List App Service regions with Xenon workers enabled set to {xenonWorkersEnabled} for subscription {subscriptionId}. slots: xenonWorkersEnabled: query.xenonWorkersEnabled subscriptionId: path.subscriptionId method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.Web/listSitesAssignedToHostName'].post update: x-apievangelist-phrasing: intent: List web apps assigned to a hostname effect: read questions: - Which web apps are assigned to a particular hostname? - Can I find every App Service site that a hostname is pointing at? instructions: - text: List the App Service site identifiers assigned to a hostname in subscription {subscriptionId}. slots: subscriptionId: path.subscriptionId - text: Find all apps bound to the hostname I give you. method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.Web/premieraddonoffers'].get update: x-apievangelist-phrasing: intent: List App Service premier add-on offers effect: read questions: - What premier add-on offers are available for App Service? - Which premier add-ons can I attach to my web apps? instructions: - text: List all premier add-on offers for subscription {subscriptionId}. slots: subscriptionId: path.subscriptionId - text: Show me the App Service premier add-on catalog. method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.Web/skus'].get update: x-apievangelist-phrasing: intent: List App Service SKUs effect: read questions: - Which App Service SKUs can my subscription use? - What pricing tiers are available for App Service plans? instructions: - text: List all App Service SKUs available to subscription {subscriptionId}. slots: subscriptionId: path.subscriptionId - text: Show every App Service plan SKU I can choose from. method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.Web/locations/{location}/usages'].get update: x-apievangelist-phrasing: intent: List App Service core usage in a location effect: read questions: - How many App Service cores am I using per SKU in a region? - Am I close to my App Service core quota in a specific location? instructions: - text: List App Service core usages across SKUs for subscription {subscriptionId} in a location. slots: subscriptionId: path.subscriptionId - text: Show my App Service quota usage in cores for region {location}. slots: location: path.location method: generated generated: '2026-10-01' - target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.Web/verifyHostingEnvironmentVnet'].post update: x-apievangelist-phrasing: intent: Check a VNET is compatible with an ASE effect: read questions: - Will my virtual network work with an App Service Environment given its NSG rules? - Can I validate network security group rules before creating an App Service Environment? instructions: - text: Verify that the VNET described in {properties} is compatible with an App Service Environment. slots: properties: requestBody.properties - text: Check my VNET's NSG rules for App Service Environment compatibility in subscription {subscriptionId}. slots: subscriptionId: path.subscriptionId method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/moveResources'].post update: x-apievangelist-phrasing: intent: Move resources to another resource group effect: write questions: - How do I move web app resources from one resource group to another? - Can I relocate several App Service resources to a different resource group at once? instructions: - text: Move {resources} from resource group {resourceGroupName} to {targetResourceGroup}. slots: resources: requestBody.resources resourceGroupName: path.resourceGroupName targetResourceGroup: requestBody.targetResourceGroup - text: Relocate the listed resources out of {resourceGroupName} in subscription {subscriptionId}. slots: resourceGroupName: path.resourceGroupName subscriptionId: path.subscriptionId method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/validate'].post update: x-apievangelist-phrasing: intent: Validate an App Service resource can be created effect: read questions: - Will this App Service resource deploy successfully before I actually create it? - Can I dry-run the creation of a web app or plan to catch errors? instructions: - text: Validate that {type} resource {name} can be created in {location} under resource group {resourceGroupName}. slots: type: requestBody.type name: requestBody.name location: requestBody.location resourceGroupName: path.resourceGroupName - text: Pre-check creating App Service resource {name} with properties {properties}. slots: name: requestBody.name properties: requestBody.properties - text: In subscription {subscriptionId}, test-create {name} in {resourceGroupName} without deploying it. slots: subscriptionId: path.subscriptionId name: requestBody.name resourceGroupName: path.resourceGroupName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/validateMoveResources'].post update: x-apievangelist-phrasing: intent: Validate resources can be moved between groups effect: read questions: - Can these resources be moved to another resource group without errors? - Is there a way to test a resource group move before doing it? instructions: - text: Validate moving {resources} from {resourceGroupName} to {targetResourceGroup} without moving them. slots: resources: requestBody.resources resourceGroupName: path.resourceGroupName targetResourceGroup: requestBody.targetResourceGroup - text: Check whether resources in {resourceGroupName} are eligible to move. slots: resourceGroupName: path.resourceGroupName - text: Dry-run a move of resources out of {resourceGroupName} in subscription {subscriptionId}. slots: resourceGroupName: path.resourceGroupName subscriptionId: path.subscriptionId method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/workspaces/{workspaceId}/apis'].get update: x-apievangelist-phrasing: intent: List APIs in an API Management workspace effect: read questions: - Which APIs live in a particular API Management workspace? - Can I filter the APIs in an APIM workspace by tag? instructions: - text: List the APIs in workspace {workspaceId} of API Management service {serviceName} tagged {tags}. slots: workspaceId: path.workspaceId serviceName: path.serviceName tags: query.tags - text: Show workspace APIs matching {filter} with their version sets expanded ({expandApiVersionSet}). slots: filter: query.$filter expandApiVersionSet: query.expandApiVersionSet method: generated generated: '2026-10-01' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/workspaces/{workspaceId}/apis/{apiId}'].get update: x-apievangelist-phrasing: intent: Get an API in an API Management workspace effect: read questions: - What are the settings of one API inside my APIM workspace? - Can I read the full definition details of a workspace-scoped API? instructions: - text: Get the details of API {apiId} in workspace {workspaceId} of API Management service {serviceName}. slots: apiId: path.apiId workspaceId: path.workspaceId serviceName: path.serviceName - text: Show me the workspace API's path, protocols and service URL. method: generated generated: '2026-10-01' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/workspaces/{workspaceId}/apis/{apiId}'].put update: x-apievangelist-phrasing: intent: Create or update an API in an APIM workspace effect: write questions: - How do I add a new API to an API Management workspace? - Can I overwrite an existing workspace API's definition in APIM? instructions: - text: Create API {apiId} in workspace {workspaceId} of API Management service {serviceName}. slots: apiId: path.apiId workspaceId: path.workspaceId serviceName: path.serviceName - text: Replace the definition of the existing workspace API with the new one. method: generated generated: '2026-10-01' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/workspaces/{workspaceId}/apis/{apiId}'].delete update: x-apievangelist-phrasing: intent: Delete an API from an APIM workspace effect: destructive questions: - How do I remove an API from an API Management workspace? - Can I delete all revisions of a workspace API at the same time? instructions: - text: Delete this API from my APIM workspace, with delete revisions set to {deleteRevisions}. slots: deleteRevisions: query.deleteRevisions - text: Remove workspace API {apiId} and all of its revisions from workspace {workspaceId} on service {serviceName}. slots: apiId: path.apiId workspaceId: path.workspaceId serviceName: path.serviceName method: generated generated: '2026-10-01' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/workspaces/{workspaceId}/apis/{apiId}'].patch update: x-apievangelist-phrasing: intent: Patch an API in an APIM workspace effect: write questions: - Can I change just a few fields of a workspace API without resending the whole definition? - How would I rename or change the path of an API in an APIM workspace? instructions: - text: Partially update the display name of API {apiId} in workspace {workspaceId} on service {serviceName}. slots: apiId: path.apiId workspaceId: path.workspaceId serviceName: path.serviceName - text: Patch the service URL on my API Management workspace API. method: generated generated: '2026-10-01' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/workspaces/{workspaceId}/apis/{apiId}'].head update: x-apievangelist-phrasing: intent: Get the ETag of an APIM workspace API effect: read questions: - What is the current ETag version of a workspace API in API Management? - Can I check a workspace API exists without downloading its details? instructions: - text: Fetch only the entity tag for API {apiId} in workspace {workspaceId} on service {serviceName}. slots: apiId: path.apiId workspaceId: path.workspaceId serviceName: path.serviceName - text: Check the ETag of the APIM workspace API before I update it. method: generated generated: '2026-10-01' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/workspaces/{workspaceId}/tags'].get update: x-apievangelist-phrasing: intent: List tags in an API Management workspace effect: read questions: - What tags are defined in my API Management workspace? - Can I list workspace tags limited to a certain scope? instructions: - text: List the tags in workspace {workspaceId} of APIM service {serviceName} matching {filter}. slots: workspaceId: path.workspaceId serviceName: path.serviceName filter: query.$filter - text: Show workspace tags within scope {scope}. slots: scope: query.scope method: generated generated: '2026-10-01' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/workspaces/{workspaceId}/tags/{tagId}'].get update: x-apievangelist-phrasing: intent: Get a tag in an API Management workspace effect: read questions: - What is the display name of a specific tag in my APIM workspace? - Can I look up one workspace tag by its identifier? instructions: - text: Look up tag {tagId} in workspace {workspaceId} of APIM service {serviceName}. slots: tagId: path.tagId workspaceId: path.workspaceId serviceName: path.serviceName - text: Show me the workspace tag's display name. method: generated generated: '2026-10-01' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/workspaces/{workspaceId}/tags/{tagId}'].put update: x-apievangelist-phrasing: intent: Create a tag in an API Management workspace effect: write questions: - How do I create a new tag inside an API Management workspace? - Can I add a tag to a workspace so I can label its APIs? instructions: - text: Create tag {tagId} in workspace {workspaceId} of APIM service {serviceName}. slots: tagId: path.tagId workspaceId: path.workspaceId serviceName: path.serviceName - text: Add a new workspace-level tag for grouping APIs. method: generated generated: '2026-10-01' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/workspaces/{workspaceId}/tags/{tagId}'].delete update: x-apievangelist-phrasing: intent: Delete a tag from an API Management workspace effect: destructive questions: - How do I remove a tag from an API Management workspace? - What happens to APIs when I delete a workspace tag? instructions: - text: Delete tag {tagId} from workspace {workspaceId} in API Management service {serviceName}. slots: tagId: path.tagId workspaceId: path.workspaceId serviceName: path.serviceName - text: Remove the unused workspace tag. method: generated generated: '2026-10-01' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/workspaces/{workspaceId}/tags/{tagId}'].patch update: x-apievangelist-phrasing: intent: Update a tag in an API Management workspace effect: write questions: - Can I rename a tag that already exists in my APIM workspace? - How do I change the display name of a workspace tag? instructions: - text: Update the display name of tag {tagId} in workspace {workspaceId} on service {serviceName}. slots: tagId: path.tagId workspaceId: path.workspaceId serviceName: path.serviceName - text: Rename the existing tag in my APIM workspace. method: generated generated: '2026-10-01' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/workspaces/{workspaceId}/tags/{tagId}'].head update: x-apievangelist-phrasing: intent: Get the ETag of an APIM workspace tag effect: read questions: - What entity state version does my workspace tag currently have? - Can I check a tag exists in an APIM workspace with a HEAD call? instructions: - text: Fetch just the entity state version of tag {tagId} in workspace {workspaceId} on service {serviceName}. slots: tagId: path.tagId workspaceId: path.workspaceId serviceName: path.serviceName - text: Check the ETag on the APIM workspace tag before editing it. method: generated generated: '2026-10-01' - target: $.paths['/subscriptions/{subscriptionId}/resourcegroups/{resourceGroupName}/providers/Microsoft.Insights/components/{applicationName}/query'].get update: x-apievangelist-phrasing: intent: Run an Application Insights Analytics query via GET effect: read questions: - How do I run a quick Analytics query against my Application Insights app using a URL? - Can I limit an Application Insights query to a timespan? instructions: - text: Run the query {query} against Application Insights app {applicationName} using a GET request. slots: query: query.query applicationName: path.applicationName - text: Query {applicationName} in {resourceGroupName} with {query} over timespan {timespan}. slots: applicationName: path.applicationName resourceGroupName: path.resourceGroupName query: query.query timespan: query.timespan - text: In subscription {subscriptionId}, run {query} on App Insights app {applicationName} in {resourceGroupName} via the URL form. slots: subscriptionId: path.subscriptionId query: query.query applicationName: path.applicationName resourceGroupName: path.resourceGroupName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourcegroups/{resourceGroupName}/providers/Microsoft.Insights/components/{applicationName}/query'].post update: x-apievangelist-phrasing: intent: Run an Application Insights Analytics query via POST effect: read questions: - How do I send a long Analytics query to Application Insights in a request body? - Can I post a query with its timespan in the body for my App Insights app? instructions: - text: Post the Analytics query body {body} to Application Insights app {applicationName}. slots: body: body.body applicationName: path.applicationName - text: Execute a POSTed query against {applicationName} in subscription {subscriptionId}. slots: applicationName: path.applicationName subscriptionId: path.subscriptionId - text: Send a POST query body to App Insights app {applicationName} in resource group {resourceGroupName}. slots: applicationName: path.applicationName resourceGroupName: path.resourceGroupName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourcegroups/{resourceGroupName}/providers/Microsoft.Insights/components/{applicationName}/metadata'].get update: x-apievangelist-phrasing: intent: Get Application Insights schema metadata via GET effect: read questions: - What tables and schema does my Application Insights app expose for queries? - Can I fetch Application Insights query metadata with a simple GET? instructions: - text: Get the metadata and schema for Application Insights app {applicationName} using GET. slots: applicationName: path.applicationName - text: Show the query schema of {applicationName} in {resourceGroupName}. slots: applicationName: path.applicationName resourceGroupName: path.resourceGroupName - text: GET the schema of App Insights app {applicationName} in {resourceGroupName}, subscription {subscriptionId}. slots: applicationName: path.applicationName resourceGroupName: path.resourceGroupName subscriptionId: path.subscriptionId method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourcegroups/{resourceGroupName}/providers/Microsoft.Insights/components/{applicationName}/metadata'].post update: x-apievangelist-phrasing: intent: Get Application Insights schema metadata via POST effect: read questions: - Is there a POST form of the Application Insights metadata call? - Can I retrieve my App Insights schema through a POST request instead of GET? instructions: - text: Retrieve metadata for Application Insights app {applicationName} using the POST endpoint. slots: applicationName: path.applicationName - text: POST for the schema of {applicationName} in subscription {subscriptionId}. slots: applicationName: path.applicationName subscriptionId: path.subscriptionId - text: POST for App Insights metadata of {applicationName} in resource group {resourceGroupName}. slots: applicationName: path.applicationName resourceGroupName: path.resourceGroupName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourcegroups/{resourceGroupName}/providers/Microsoft.Insights/components/{applicationName}/metrics/{metricId}'].get update: x-apievangelist-phrasing: intent: Get values for an Application Insights metric effect: read questions: - What were the request counts for my Application Insights app over the last day? - Can I segment an Application Insights metric by a dimension and take the top values? - Which aggregation types can I apply when pulling a single metric? instructions: - text: Get metric {metricId} for Application Insights app {applicationName} over {timespan}. slots: metricId: path.metricId applicationName: path.applicationName timespan: query.timespan - text: Pull {metricId} for {applicationName} with {aggregation} aggregation at {interval} intervals. slots: metricId: path.metricId applicationName: path.applicationName aggregation: query.aggregation interval: query.interval - text: Segment metric {metricId} of {applicationName} by {segment} and return the top {top}. slots: metricId: path.metricId applicationName: path.applicationName segment: query.segment top: query.top - text: Fetch metric {metricId} for {applicationName} in {resourceGroupName} under subscription {subscriptionId}. slots: metricId: path.metricId applicationName: path.applicationName resourceGroupName: path.resourceGroupName subscriptionId: path.subscriptionId method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourcegroups/{resourceGroupName}/providers/Microsoft.Insights/components/{applicationName}/metrics/metadata'].get update: x-apievangelist-phrasing: intent: List available Application Insights metrics effect: read questions: - Which metrics can I query for my Application Insights app? - What dimensions and aggregations does each App Insights metric support? instructions: - text: Describe the available metrics for Application Insights app {applicationName}. slots: applicationName: path.applicationName - text: Get metric metadata for {applicationName} in {resourceGroupName}. slots: applicationName: path.applicationName resourceGroupName: path.resourceGroupName - text: List metric definitions for {applicationName} in {resourceGroupName}, subscription {subscriptionId}. slots: applicationName: path.applicationName resourceGroupName: path.resourceGroupName subscriptionId: path.subscriptionId method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourcegroups/{resourceGroupName}/providers/Microsoft.Insights/components/{applicationName}/events/{eventType}'].get update: x-apievangelist-phrasing: intent: Query Application Insights events by type effect: read questions: - How can I pull all exception events from Application Insights for the last hour? - Can I filter, order and page through App Insights events with OData? - Which event types can I query, like requests, traces or exceptions? instructions: - text: Query {eventType} events for Application Insights app {applicationName} over {timespan}. slots: eventType: path.eventType applicationName: path.applicationName timespan: query.timespan - text: Get the top {top} {eventType} events from {applicationName} matching {filter}. slots: top: query.$top eventType: path.eventType applicationName: path.applicationName filter: query.$filter - text: Query {eventType} telemetry of {applicationName} in {resourceGroupName} under subscription {subscriptionId}. slots: eventType: path.eventType applicationName: path.applicationName resourceGroupName: path.resourceGroupName subscriptionId: path.subscriptionId method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourcegroups/{resourceGroupName}/providers/Microsoft.Insights/components/{applicationName}/events/{eventType}/{eventId}'].get update: x-apievangelist-phrasing: intent: Get a single Application Insights event effect: read questions: - How do I look up one specific telemetry event by its ID? - Can I retrieve the full data of a single App Insights exception event? instructions: - text: Get {eventType} event {eventId} from Application Insights app {applicationName}. slots: eventType: path.eventType eventId: path.eventId applicationName: path.applicationName - text: Fetch event {eventId} of type {eventType} within timespan {timespan}. slots: eventId: path.eventId eventType: path.eventType timespan: query.timespan - text: Look up event {eventId} ({eventType}) for {applicationName} in {resourceGroupName}, subscription {subscriptionId}. slots: eventId: path.eventId eventType: path.eventType applicationName: path.applicationName resourceGroupName: path.resourceGroupName subscriptionId: path.subscriptionId method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourcegroups/{resourceGroupName}/providers/Microsoft.Insights/components/{applicationName}/events/$metadata'].get update: x-apievangelist-phrasing: intent: Get the OData model for App Insights events effect: read questions: - What does the OData EDMX data model for Application Insights events look like? - Can I get the event schema to build OData queries against App Insights? instructions: - text: Get the OData EDMX metadata for events in Application Insights app {applicationName}. slots: applicationName: path.applicationName - text: Download the event data model for {applicationName} in {resourceGroupName}. slots: applicationName: path.applicationName resourceGroupName: path.resourceGroupName - text: Get the EDMX event model for {applicationName} in {resourceGroupName} under subscription {subscriptionId}. slots: applicationName: path.applicationName resourceGroupName: path.resourceGroupName subscriptionId: path.subscriptionId method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/microsoft.insights/components/{resourceName}/linkedStorageAccounts/{storageType}'].get update: x-apievangelist-phrasing: intent: Get linked storage for an App Insights component effect: read questions: - Which storage account is linked to my Application Insights component? - Can I check the linked storage settings for profiler data on App Insights? instructions: - text: Get the {storageType} linked storage account for Application Insights component {resourceName}. slots: storageType: path.storageType resourceName: path.resourceName - text: Show the current linked storage settings on {resourceName}. slots: resourceName: path.resourceName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/microsoft.insights/components/{resourceName}/linkedStorageAccounts/{storageType}'].put update: x-apievangelist-phrasing: intent: Replace linked storage on an App Insights component effect: write questions: - How do I link my own storage account to an Application Insights component? - Can I swap the linked storage account used by App Insights? instructions: - text: Replace the {storageType} linked storage on component {resourceName} with {properties}. slots: storageType: path.storageType resourceName: path.resourceName properties: requestBody.properties - text: Link a new storage account to Application Insights component {resourceName}. slots: resourceName: path.resourceName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/microsoft.insights/components/{resourceName}/linkedStorageAccounts/{storageType}'].delete update: x-apievangelist-phrasing: intent: Unlink storage from an App Insights component effect: destructive questions: - How do I remove the linked storage account from Application Insights? - Can I stop using my own storage account for an App Insights component? instructions: - text: Delete the {storageType} linked storage account from component {resourceName}. slots: storageType: path.storageType resourceName: path.resourceName - text: Unlink storage from Application Insights component {resourceName}. slots: resourceName: path.resourceName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/microsoft.insights/components/{resourceName}/linkedStorageAccounts/{storageType}'].patch update: x-apievangelist-phrasing: intent: Update linked storage on an App Insights component effect: write questions: - Can I patch the linked storage account settings on an App Insights component? - How would I point the existing App Insights storage link at a different account? instructions: - text: Patch the {storageType} linked storage on component {resourceName} to {properties}. slots: storageType: path.storageType resourceName: path.resourceName properties: requestBody.properties - text: Update the linked storage account of {resourceName} in place. slots: resourceName: path.resourceName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.Insights/components'].get update: x-apievangelist-phrasing: intent: List Application Insights components in a subscription effect: read questions: - What Application Insights components exist across my whole subscription? - Can I inventory every App Insights resource I own? instructions: - text: List all Application Insights components in my subscription. - text: Show every App Insights component subscription-wide. method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Insights/components'].get update: x-apievangelist-phrasing: intent: List Application Insights components in a resource group effect: read questions: - Which Application Insights components are in one resource group? - Can I narrow my App Insights inventory to a single resource group? instructions: - text: List the Application Insights components in this resource group. - text: Show App Insights components scoped to my resource group. method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Insights/components/{resourceName}'].get update: x-apievangelist-phrasing: intent: Get an Application Insights component effect: read questions: - What is the instrumentation key and connection string of my App Insights component? - Can I see the settings of one Application Insights resource? instructions: - text: Get Application Insights component {resourceName}. slots: resourceName: path.resourceName - text: Show the instrumentation key for App Insights component {resourceName}. slots: resourceName: path.resourceName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Insights/components/{resourceName}'].put update: x-apievangelist-phrasing: intent: Create or update an Application Insights component effect: write questions: - How do I create a new Application Insights resource for a web app? - Can I change the instrumentation key when updating an App Insights component? instructions: - text: Create Application Insights component {resourceName} of kind {kind} in {location}. slots: resourceName: path.resourceName kind: requestBody.kind location: requestBody.location - text: Update component {resourceName} with properties {properties}. slots: resourceName: path.resourceName properties: requestBody.properties method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Insights/components/{resourceName}'].delete update: x-apievangelist-phrasing: intent: Delete an Application Insights component effect: destructive questions: - How do I delete an Application Insights resource I no longer need? - What happens to telemetry when I remove an App Insights component? instructions: - text: Delete Application Insights component {resourceName}. slots: resourceName: path.resourceName - text: Remove the App Insights resource {resourceName} from this resource group. slots: resourceName: path.resourceName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Insights/components/{resourceName}'].patch update: x-apievangelist-phrasing: intent: Update tags on an Application Insights component effect: write questions: - How do I change only the tags on an App Insights component? - Can I tag an Application Insights resource without touching its other settings? instructions: - text: Set tags {tags} on Application Insights component {resourceName}. slots: tags: requestBody.tags resourceName: path.resourceName - text: Replace the tags of App Insights component {resourceName}. slots: resourceName: path.resourceName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Insights/components/{resourceName}/purge'].post update: x-apievangelist-phrasing: intent: Purge data from an Application Insights component effect: destructive questions: - How do I permanently delete personal data from Application Insights telemetry? - Are Application Insights purge requests throttled, and how many can I send? instructions: - text: Purge data from Application Insights component {resourceName} matching filters {body}. slots: resourceName: path.resourceName body: body.body - text: Erase telemetry in {resourceName} that matches my purge filter. slots: resourceName: path.resourceName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Insights/components/{resourceName}/operations/{purgeId}'].get update: x-apievangelist-phrasing: intent: Check status of an App Insights purge effect: read questions: - Has my Application Insights data purge finished yet? - Can I track the progress of a purge operation by its ID? instructions: - text: Get the status of purge {purgeId} on component {resourceName}. slots: purgeId: path.purgeId resourceName: path.resourceName - text: Check whether App Insights purge {purgeId} is still pending. slots: purgeId: path.purgeId method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.PolicyInsights/attestations'].get update: x-apievangelist-phrasing: intent: List policy attestations in a subscription effect: read questions: - Which Azure Policy attestations have been recorded across my subscription? - Can I filter subscription attestations or cap how many come back? instructions: - text: List policy attestations for my subscription matching {filter}. slots: filter: query.$filter - text: Show the first {top} policy attestations at subscription scope. slots: top: query.$top method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.PolicyInsights/attestations/{attestationName}'].get update: x-apievangelist-phrasing: intent: Get a policy attestation at subscription scope effect: read questions: - What compliance state was recorded in a subscription-level attestation? - Can I read one Azure Policy attestation on my subscription by name? instructions: - text: Get subscription-level attestation {attestationName}. slots: attestationName: path.attestationName - text: Show the evidence and owner on subscription attestation {attestationName}. slots: attestationName: path.attestationName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.PolicyInsights/attestations/{attestationName}'].put update: x-apievangelist-phrasing: intent: Create or update a subscription policy attestation effect: write questions: - How do I attest compliance for a manual policy across my whole subscription? - Can I update an existing subscription attestation with new evidence? instructions: - text: Create subscription attestation {attestationName} with properties {properties}. slots: attestationName: path.attestationName properties: requestBody.properties - text: Update the subscription-scope attestation {attestationName} to mark it compliant. slots: attestationName: path.attestationName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.PolicyInsights/attestations/{attestationName}'].delete update: x-apievangelist-phrasing: intent: Delete a subscription policy attestation effect: destructive questions: - How do I withdraw a policy attestation made at subscription scope? - Can I delete an attestation recorded against my entire subscription? instructions: - text: Delete subscription attestation {attestationName}. slots: attestationName: path.attestationName - text: Remove the subscription-wide policy attestation named {attestationName}. slots: attestationName: path.attestationName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.PolicyInsights/attestations'].get update: x-apievangelist-phrasing: intent: List policy attestations in a resource group effect: read questions: - What Azure Policy attestations exist for a single resource group? - Can I limit the resource group attestation list to a filter? instructions: - text: List the policy attestations in this resource group matching {filter}. slots: filter: query.$filter - text: Show the top {top} attestations for my resource group. slots: top: query.$top method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.PolicyInsights/attestations/{attestationName}'].get update: x-apievangelist-phrasing: intent: Get a policy attestation at resource group scope effect: read questions: - What does a resource-group-level policy attestation say? - Can I look up one attestation in a resource group by name? instructions: - text: Get resource group attestation {attestationName}. slots: attestationName: path.attestationName - text: Show compliance state recorded in resource-group attestation {attestationName}. slots: attestationName: path.attestationName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.PolicyInsights/attestations/{attestationName}'].put update: x-apievangelist-phrasing: intent: Create or update a resource group attestation effect: write questions: - How do I attest a manual policy for just one resource group? - Can I change an existing resource group attestation's compliance state? instructions: - text: Create resource group attestation {attestationName} with properties {properties}. slots: attestationName: path.attestationName properties: requestBody.properties - text: Update the resource-group-scope attestation {attestationName} with fresh evidence. slots: attestationName: path.attestationName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.PolicyInsights/attestations/{attestationName}'].delete update: x-apievangelist-phrasing: intent: Delete a resource group policy attestation effect: destructive questions: - How do I delete a policy attestation scoped to a resource group? - Can I retract an attestation for one resource group only? instructions: - text: Delete resource group attestation {attestationName}. slots: attestationName: path.attestationName - text: Remove the attestation {attestationName} from this resource group. slots: attestationName: path.attestationName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Insights/actionGroups/{actionGroupName}'].get update: x-apievangelist-phrasing: intent: Get an Azure Monitor action group effect: read questions: - Who gets notified by one of my Azure Monitor action groups? - Can I see the email and SMS receivers configured on an action group? instructions: - text: Get action group {actionGroupName}. slots: actionGroupName: path.actionGroupName - text: Show the receivers configured on action group {actionGroupName}. slots: actionGroupName: path.actionGroupName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Insights/actionGroups/{actionGroupName}'].put update: x-apievangelist-phrasing: intent: Create or update an Azure Monitor action group effect: write questions: - How do I set up an action group that emails and texts my on-call team? - Can I replace the receivers on an existing action group in one call? instructions: - text: Create action group {actionGroupName} in {location} with properties {properties}. slots: actionGroupName: path.actionGroupName location: requestBody.location properties: requestBody.properties - text: Overwrite action group {actionGroupName} with a new receiver configuration. slots: actionGroupName: path.actionGroupName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Insights/actionGroups/{actionGroupName}'].delete update: x-apievangelist-phrasing: intent: Delete an Azure Monitor action group effect: destructive questions: - How do I delete an action group that alerts no longer use? - What happens to alert rules that point at an action group I delete? instructions: - text: Delete action group {actionGroupName}. slots: actionGroupName: path.actionGroupName - text: Remove the Azure Monitor action group {actionGroupName} from this resource group. slots: actionGroupName: path.actionGroupName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Insights/actionGroups/{actionGroupName}'].patch update: x-apievangelist-phrasing: intent: Update tags on an Azure Monitor action group effect: write questions: - Can I change the tags on an action group without redefining its receivers? - How do I enable or disable an action group via a patch? instructions: - text: Set tags {tags} on action group {actionGroupName}. slots: tags: requestBody.tags actionGroupName: path.actionGroupName - text: Patch action group {actionGroupName} properties to {properties}. slots: actionGroupName: path.actionGroupName properties: requestBody.properties method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.Insights/createNotifications'].post update: x-apievangelist-phrasing: intent: Send test notifications at subscription level effect: write questions: - How can I test that my alert receivers actually get notified, without an action group? - Can I send a test alert of a chosen type to email and webhook receivers across my subscription? instructions: - text: Send a subscription-level test notification of alert type {alertType} to email receivers {emailReceivers}. slots: alertType: requestBody.alertType emailReceivers: requestBody.emailReceivers - text: Fire a test {alertType} alert to webhook receivers {webhookReceivers} at subscription scope. slots: alertType: requestBody.alertType webhookReceivers: requestBody.webhookReceivers method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Insights/createNotifications'].post update: x-apievangelist-phrasing: intent: Send test notifications at resource group level effect: write questions: - Can I send test notifications scoped to a resource group? - How do I check SMS and voice receivers work for alerts in one resource group? instructions: - text: Send a resource-group-level test {alertType} notification to SMS receivers {smsReceivers}. slots: alertType: requestBody.alertType smsReceivers: requestBody.smsReceivers - text: Test {alertType} alerts for voice receivers {voiceReceivers} in this resource group. slots: alertType: requestBody.alertType voiceReceivers: requestBody.voiceReceivers method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Insights/actionGroups/{actionGroupName}/createNotifications'].post update: x-apievangelist-phrasing: intent: Send test notifications for one action group effect: write questions: - How do I send a test notification through an existing action group? - Can I verify one action group's receivers with a test alert of a specific type? instructions: - text: Send a test {alertType} notification through action group {actionGroupName}. slots: alertType: requestBody.alertType actionGroupName: path.actionGroupName - text: Test action group {actionGroupName} with {alertType} alerts to its Azure app push receivers {azureAppPushReceivers}. slots: actionGroupName: path.actionGroupName alertType: requestBody.alertType azureAppPushReceivers: requestBody.azureAppPushReceivers method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.Insights/notificationStatus/{notificationId}'].get update: x-apievangelist-phrasing: intent: Get subscription-level test notification results effect: read questions: - Did my subscription-level test notification reach every receiver? - Can I check the results of a test notification by its ID? instructions: - text: Get the subscription-level test notification status for {notificationId}. slots: notificationId: path.notificationId - text: Check delivery results of subscription test notification {notificationId}. slots: notificationId: path.notificationId method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Insights/notificationStatus/{notificationId}'].get update: x-apievangelist-phrasing: intent: Get resource group test notification results effect: read questions: - What happened to the test notification I sent at resource group level? - Which receivers failed in a resource-group-scoped test notification? instructions: - text: Get the resource-group-level test notification status for {notificationId}. slots: notificationId: path.notificationId - text: Show receiver outcomes for resource group test notification {notificationId}. slots: notificationId: path.notificationId method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Insights/actionGroups/{actionGroupName}/notificationStatus/{notificationId}'].get update: x-apievangelist-phrasing: intent: Get test notification results for an action group effect: read questions: - Did the test I sent through a specific action group succeed? - Can I see per-receiver results for an action group's test notification? instructions: - text: Get test notification {notificationId} results for action group {actionGroupName}. slots: notificationId: path.notificationId actionGroupName: path.actionGroupName - text: Check whether action group {actionGroupName} delivered test {notificationId}. slots: actionGroupName: path.actionGroupName notificationId: path.notificationId method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.Insights/actionGroups'].get update: x-apievangelist-phrasing: intent: List action groups in a subscription effect: read questions: - What action groups exist across my subscription? - Can I inventory all Azure Monitor action groups I own? instructions: - text: List all action groups in my subscription. - text: Show every Azure Monitor action group subscription-wide. method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Insights/actionGroups'].get update: x-apievangelist-phrasing: intent: List action groups in a resource group effect: read questions: - Which action groups are defined in one resource group? - Can I see only the action groups belonging to a resource group? instructions: - text: List the action groups in this resource group. - text: Show Azure Monitor action groups scoped to my resource group. method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Insights/actionGroups/{actionGroupName}/subscribe'].post update: x-apievangelist-phrasing: intent: Re-enable a receiver in an action group effect: write questions: - How do I re-enable an email receiver that unsubscribed from an action group? - Which receiver types can be switched from Disabled back to Enabled? instructions: - text: Enable receiver {receiverName} in action group {actionGroupName}. slots: receiverName: requestBody.receiverName actionGroupName: path.actionGroupName - text: Resubscribe the SMS receiver {receiverName} on {actionGroupName}. slots: receiverName: requestBody.receiverName actionGroupName: path.actionGroupName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Insights/activityLogAlerts/{activityLogAlertName}'].get update: x-apievangelist-phrasing: intent: Get an Activity Log Alert rule effect: read questions: - What conditions trigger one of my Activity Log Alert rules? - Can I see which action groups an activity log alert fires? instructions: - text: Get Activity Log Alert rule {activityLogAlertName}. slots: activityLogAlertName: path.activityLogAlertName - text: Show the conditions on activity log alert {activityLogAlertName}. slots: activityLogAlertName: path.activityLogAlertName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Insights/activityLogAlerts/{activityLogAlertName}'].put update: x-apievangelist-phrasing: intent: Create or update an Activity Log Alert rule effect: write questions: - How do I get alerted when someone deletes a resource via the activity log? - Can I redefine an existing activity log alert's conditions and actions? instructions: - text: Create Activity Log Alert rule {activityLogAlertName} with properties {properties}. slots: activityLogAlertName: path.activityLogAlertName properties: requestBody.properties - text: Replace activity log alert {activityLogAlertName} with a new definition. slots: activityLogAlertName: path.activityLogAlertName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Insights/activityLogAlerts/{activityLogAlertName}'].delete update: x-apievangelist-phrasing: intent: Delete an Activity Log Alert rule effect: destructive questions: - How do I remove an Activity Log Alert rule? - Can I delete an activity log alert without touching its action group? instructions: - text: Delete Activity Log Alert rule {activityLogAlertName}. slots: activityLogAlertName: path.activityLogAlertName - text: Remove the activity log alert {activityLogAlertName}. slots: activityLogAlertName: path.activityLogAlertName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Insights/activityLogAlerts/{activityLogAlertName}'].patch update: x-apievangelist-phrasing: intent: Enable, disable or retag an Activity Log Alert effect: write questions: - How do I temporarily disable an Activity Log Alert rule? - Can I update only the tags on an activity log alert? instructions: - text: Disable Activity Log Alert rule {activityLogAlertName} by setting properties {properties}. slots: activityLogAlertName: path.activityLogAlertName properties: requestBody.properties - text: Set tags {tags} on activity log alert {activityLogAlertName}. slots: tags: requestBody.tags activityLogAlertName: path.activityLogAlertName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.Insights/activityLogAlerts'].get update: x-apievangelist-phrasing: intent: List Activity Log Alert rules in a subscription effect: read questions: - What Activity Log Alert rules exist across my subscription? - Can I audit every activity log alert I have configured? instructions: - text: List all Activity Log Alert rules in my subscription. - text: Show every activity log alert subscription-wide. method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Insights/activityLogAlerts'].get update: x-apievangelist-phrasing: intent: List Activity Log Alert rules in a resource group effect: read questions: - Which Activity Log Alert rules live in a given resource group? - Can I list only the activity log alerts in one resource group? instructions: - text: List the Activity Log Alert rules in this resource group. - text: Show activity log alerts scoped to my resource group. method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.Addons/supportProviders/{providerName}/supportPlanTypes/{planTypeName}'].delete update: x-apievangelist-phrasing: intent: Cancel a Canonical support plan effect: destructive questions: - How do I cancel the Canonical support plan on my subscription? - Can I cancel a specific support plan type from a support provider? instructions: - text: Cancel the {planTypeName} support plan from {providerName} on subscription {subscriptionId}. slots: planTypeName: path.planTypeName providerName: path.providerName subscriptionId: path.subscriptionId - text: Remove Canonical support plan type {planTypeName}. slots: planTypeName: path.planTypeName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.ApiCenter/services'].get update: x-apievangelist-phrasing: intent: List API Center services in a subscription effect: read questions: - Which API Center services exist across my Azure subscription? - Can I inventory every API Center instance I own? instructions: - text: List all API Center services in my subscription. - text: Show every API Center instance subscription-wide. method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiCenter/services'].get update: x-apievangelist-phrasing: intent: List API Center services in a resource group effect: read questions: - What API Center services are in one resource group? - Can I narrow my API Center list to a single resource group? instructions: - text: List the API Center services in this resource group. - text: Show API Center instances scoped to my resource group. method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiCenter/services/{serviceName}'].get update: x-apievangelist-phrasing: intent: Get an API Center service effect: read questions: - What are the settings and data plane URL of my API Center service? - Can I check the provisioning state of an API Center instance? instructions: - text: Get API Center service {serviceName}. slots: serviceName: path.serviceName - text: Show the configuration of API Center instance {serviceName}. slots: serviceName: path.serviceName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiCenter/services/{serviceName}'].put update: x-apievangelist-phrasing: intent: Create or update an API Center service effect: write questions: - How do I create a new API Center to catalog my organization's APIs? - Can I give an API Center service a managed identity when creating it? instructions: - text: Create API Center service {serviceName} with managed identity {identity}. slots: serviceName: path.serviceName identity: requestBody.identity - text: Create or replace API Center {serviceName} with properties {properties}. slots: serviceName: path.serviceName properties: requestBody.properties method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiCenter/services/{serviceName}'].delete update: x-apievangelist-phrasing: intent: Delete an API Center service effect: destructive questions: - How do I delete an API Center instance? - Does removing an API Center service also remove its API inventory? instructions: - text: Delete API Center service {serviceName}. slots: serviceName: path.serviceName - text: Tear down the API Center instance named {serviceName}. slots: serviceName: path.serviceName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiCenter/services/{serviceName}'].patch update: x-apievangelist-phrasing: intent: Update an API Center service effect: write questions: - Can I patch settings on an existing API Center without recreating it? - How do I change properties of my API Center service in place? instructions: - text: Patch API Center service {serviceName} with properties {properties}. slots: serviceName: path.serviceName properties: requestBody.properties - text: Update the existing API Center {serviceName}. slots: serviceName: path.serviceName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Scom/managedInstances/{instanceName}'].get update: x-apievangelist-phrasing: intent: Get a SCOM managed instance effect: read questions: - What is the configuration of my SCOM Managed Instance? - Can I check how many servers a SCOM managed instance is running? instructions: - text: Get SCOM managed instance {instanceName}. slots: instanceName: path.instanceName - text: Show details of the SCOM monitoring instance {instanceName}. slots: instanceName: path.instanceName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Scom/managedInstances/{instanceName}/setServerCount'].post update: x-apievangelist-phrasing: intent: Scale a SCOM managed instance effect: write questions: - How do I add management servers to a SCOM Managed Instance? - Can I scale my SCOM instance down to fewer servers? instructions: - text: Scale SCOM managed instance {instanceName} to {serverCount} servers. slots: instanceName: path.instanceName serverCount: requestBody.serverCount - text: Set the server count on SCOM instance {instanceName}. slots: instanceName: path.instanceName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Scom/managedInstances/{instanceName}/patchServers'].post update: x-apievangelist-phrasing: intent: Update SCOM servers to the latest software effect: write questions: - How do I apply the latest SCOM software to my managed instance's servers? - Can I patch every server in a SCOM Managed Instance at once? instructions: - text: Patch the servers of SCOM managed instance {instanceName} to the latest SCOM build. slots: instanceName: path.instanceName - text: Update SCOM software on all servers in {instanceName}. slots: instanceName: path.instanceName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Scom/managedInstances/{instanceName}/linkLogAnalytics'].post update: x-apievangelist-phrasing: intent: Link a Log Analytics workspace to SCOM effect: write questions: - How do I send SCOM Managed Instance data into a Log Analytics workspace? - Can I choose which data types SCOM forwards to Log Analytics? instructions: - text: Link Log Analytics workspace {workspaceId} to SCOM instance {instanceName}. slots: workspaceId: requestBody.workspaceId instanceName: path.instanceName - text: Connect {instanceName} to workspace {workspaceId} sending data types {dataTypes}. slots: instanceName: path.instanceName workspaceId: requestBody.workspaceId dataTypes: requestBody.dataTypes method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Scom/managedInstances/{instanceName}/unlinkLogAnalytics'].post update: x-apievangelist-phrasing: intent: Unlink Log Analytics from a SCOM instance effect: destructive questions: - How do I stop my SCOM Managed Instance from sending data to Log Analytics? - Can I disconnect the Log Analytics workspace from SCOM? instructions: - text: Unlink the Log Analytics workspace from SCOM instance {instanceName}. slots: instanceName: path.instanceName - text: Disconnect Log Analytics from SCOM monitoring on {instanceName}. slots: instanceName: path.instanceName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Scom/managedInstances/{instanceName}/updateLogAnalytics'].post update: x-apievangelist-phrasing: intent: Change SCOM Log Analytics data types effect: write questions: - Can I change which data types SCOM sends to an already linked Log Analytics workspace? - How do I adjust the Log Analytics linking configuration on SCOM? instructions: - text: Update SCOM instance {instanceName} to forward data types {dataTypes} to Log Analytics. slots: instanceName: path.instanceName dataTypes: requestBody.dataTypes - text: Change the Log Analytics link settings on {instanceName}. slots: instanceName: path.instanceName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.HardwareSecurityModules/cloudHsmClusters/{cloudHsmClusterName}'].get update: x-apievangelist-phrasing: intent: Get a Cloud HSM cluster effect: read questions: - What is the state and SKU of my Cloud HSM cluster? - Can I look up one Cloud HSM cluster by name? instructions: - text: Get Cloud HSM cluster {cloudHsmClusterName}. slots: cloudHsmClusterName: path.cloudHsmClusterName - text: Show the provisioning state of HSM cluster {cloudHsmClusterName}. slots: cloudHsmClusterName: path.cloudHsmClusterName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.HardwareSecurityModules/cloudHsmClusters/{cloudHsmClusterName}'].put update: x-apievangelist-phrasing: intent: Create or update a Cloud HSM cluster effect: write questions: - How do I provision a new Cloud HSM cluster? - Can I pick the SKU and managed identity when creating a Cloud HSM cluster? instructions: - text: Create Cloud HSM cluster {cloudHsmClusterName} with SKU {sku}. slots: cloudHsmClusterName: path.cloudHsmClusterName sku: requestBody.sku - text: Create or replace HSM cluster {cloudHsmClusterName} using identity {identity}. slots: cloudHsmClusterName: path.cloudHsmClusterName identity: requestBody.identity method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.HardwareSecurityModules/cloudHsmClusters/{cloudHsmClusterName}'].delete update: x-apievangelist-phrasing: intent: Delete a Cloud HSM cluster effect: destructive questions: - How do I delete a Cloud HSM cluster I no longer need? - Is deleting a Cloud HSM cluster reversible? instructions: - text: Delete Cloud HSM cluster {cloudHsmClusterName}. slots: cloudHsmClusterName: path.cloudHsmClusterName - text: Decommission the HSM cluster {cloudHsmClusterName}. slots: cloudHsmClusterName: path.cloudHsmClusterName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.HardwareSecurityModules/cloudHsmClusters/{cloudHsmClusterName}'].patch update: x-apievangelist-phrasing: intent: Update a Cloud HSM cluster effect: write questions: - Can I change tags or identity on an existing Cloud HSM cluster? - How do I patch a Cloud HSM cluster without recreating it? instructions: - text: Set tags {tags} on Cloud HSM cluster {cloudHsmClusterName}. slots: tags: requestBody.tags cloudHsmClusterName: path.cloudHsmClusterName - text: Patch HSM cluster {cloudHsmClusterName} to use managed identity {identity}. slots: cloudHsmClusterName: path.cloudHsmClusterName identity: requestBody.identity method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.HardwareSecurityModules/cloudHsmClusters'].get update: x-apievangelist-phrasing: intent: List Cloud HSM clusters in a resource group effect: read questions: - Which Cloud HSM clusters are in a given resource group? - How do I page through Cloud HSM clusters in one resource group? instructions: - text: List Cloud HSM clusters in this resource group. - text: Get the next page of resource group HSM clusters using skip token {skiptoken}. slots: skiptoken: query.$skiptoken method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.HardwareSecurityModules/cloudHsmClusters'].get update: x-apievangelist-phrasing: intent: List Cloud HSM clusters in a subscription effect: read questions: - What Cloud HSM clusters do I have across my subscription? - Can I page through every HSM cluster I own subscription-wide? instructions: - text: List all Cloud HSM clusters in my subscription. - text: Continue the subscription-wide HSM cluster list from skip token {skiptoken}. slots: skiptoken: query.$skiptoken method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.HardwareSecurityModules/cloudHsmClusters/{cloudHsmClusterName}/privateLinkResources'].get update: x-apievangelist-phrasing: intent: List private link resources for a Cloud HSM cluster effect: read questions: - Which private link group IDs does a Cloud HSM cluster support? - What do I need to set up a private endpoint to my HSM cluster? instructions: - text: List private link resources supported by Cloud HSM cluster {cloudHsmClusterName}. slots: cloudHsmClusterName: path.cloudHsmClusterName - text: Show the private link group IDs for HSM cluster {cloudHsmClusterName}. slots: cloudHsmClusterName: path.cloudHsmClusterName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.HardwareSecurityModules/cloudHsmClusters/{cloudHsmClusterName}/privateEndpointConnections/{peConnectionName}'].get update: x-apievangelist-phrasing: intent: Get a Cloud HSM private endpoint connection effect: read questions: - Is the private endpoint connection to my Cloud HSM cluster approved? - Can I read one HSM private endpoint connection by name? instructions: - text: Get private endpoint connection {peConnectionName} on Cloud HSM cluster {cloudHsmClusterName}. slots: peConnectionName: path.peConnectionName cloudHsmClusterName: path.cloudHsmClusterName - text: Show the approval state of HSM connection {peConnectionName}. slots: peConnectionName: path.peConnectionName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.HardwareSecurityModules/cloudHsmClusters/{cloudHsmClusterName}/privateEndpointConnections/{peConnectionName}'].put update: x-apievangelist-phrasing: intent: Approve or update a Cloud HSM private endpoint effect: write questions: - How do I approve a pending private endpoint connection to my Cloud HSM cluster? - Can I reject a private endpoint request on an HSM cluster? instructions: - text: Set private endpoint connection {peConnectionName} on HSM cluster {cloudHsmClusterName} to {properties}. slots: peConnectionName: path.peConnectionName cloudHsmClusterName: path.cloudHsmClusterName properties: requestBody.properties - text: Approve HSM private endpoint connection {peConnectionName}. slots: peConnectionName: path.peConnectionName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.HardwareSecurityModules/cloudHsmClusters/{cloudHsmClusterName}/privateEndpointConnections/{peConnectionName}'].delete update: x-apievangelist-phrasing: intent: Delete a Cloud HSM private endpoint connection effect: destructive questions: - How do I remove a private endpoint connection from a Cloud HSM cluster? - Can I cut off a private endpoint's access to my HSM cluster? instructions: - text: Delete private endpoint connection {peConnectionName} from Cloud HSM cluster {cloudHsmClusterName}. slots: peConnectionName: path.peConnectionName cloudHsmClusterName: path.cloudHsmClusterName - text: Remove HSM private endpoint connection {peConnectionName}. slots: peConnectionName: path.peConnectionName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.HardwareSecurityModules/cloudHsmClusters/{cloudHsmClusterName}/privateEndpointConnections'].get update: x-apievangelist-phrasing: intent: List private endpoint connections on a Cloud HSM cluster effect: read questions: - Which private endpoints are connected to my Cloud HSM cluster? - Are there pending private endpoint requests on my HSM cluster? instructions: - text: List private endpoint connections on Cloud HSM cluster {cloudHsmClusterName}. slots: cloudHsmClusterName: path.cloudHsmClusterName - text: Show all private endpoints attached to HSM cluster {cloudHsmClusterName}. slots: cloudHsmClusterName: path.cloudHsmClusterName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.HealthBot/healthBots/{botName}'].get update: x-apievangelist-phrasing: intent: Get an Azure Health Bot effect: read questions: - What SKU and settings does my Azure Health Bot have? - Can I get the management portal link for a Health Bot? instructions: - text: Get Health Bot {botName} in resource group {resourceGroupName}. slots: botName: path.botName resourceGroupName: path.resourceGroupName - text: Show the configuration of Health Bot {botName} in subscription {subscriptionId}. slots: botName: path.botName subscriptionId: path.subscriptionId method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.HealthBot/healthBots/{botName}'].put update: x-apievangelist-phrasing: intent: Create an Azure Health Bot effect: write questions: - How do I create a new Azure Health Bot for patient triage? - Which SKU do I have to pick when creating a Health Bot? instructions: - text: Create Health Bot {botName} in {resourceGroupName} with SKU {sku} in {location}. slots: botName: path.botName resourceGroupName: path.resourceGroupName sku: requestBody.sku location: requestBody.location - text: Provision Health Bot {botName} in subscription {subscriptionId} tagged {tags}. slots: botName: path.botName subscriptionId: path.subscriptionId tags: requestBody.tags method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.HealthBot/healthBots/{botName}'].delete update: x-apievangelist-phrasing: intent: Delete an Azure Health Bot effect: destructive questions: - How do I delete a Health Bot I no longer use? - Can I remove a Health Bot resource from a resource group? instructions: - text: Delete Health Bot {botName} in resource group {resourceGroupName}. slots: botName: path.botName resourceGroupName: path.resourceGroupName - text: Remove Health Bot {botName} from subscription {subscriptionId}. slots: botName: path.botName subscriptionId: path.subscriptionId method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.HealthBot/healthBots/{botName}'].patch update: x-apievangelist-phrasing: intent: Update an Azure Health Bot effect: write questions: - Can I upgrade my Health Bot to a different SKU? - How do I change tags on an existing Health Bot? instructions: - text: Change Health Bot {botName} in {resourceGroupName} to SKU {sku}. slots: botName: path.botName resourceGroupName: path.resourceGroupName sku: requestBody.sku - text: Patch Health Bot {botName} with tags {tags}. slots: botName: path.botName tags: requestBody.tags - text: Patch Health Bot {botName} in {resourceGroupName} under subscription {subscriptionId}. slots: botName: path.botName resourceGroupName: path.resourceGroupName subscriptionId: path.subscriptionId method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.HealthBot/healthBots/{botName}/listSecrets'].post update: x-apievangelist-phrasing: intent: List secrets of an Azure Health Bot effect: read questions: - Where do I find the API secrets for my Health Bot? - Can I retrieve all the secrets a Health Bot uses? instructions: - text: List the secrets of Health Bot {botName} in {resourceGroupName}. slots: botName: path.botName resourceGroupName: path.resourceGroupName - text: Show all keys and secrets for Health Bot {botName}. slots: botName: path.botName - text: Retrieve secrets for Health Bot {botName} in subscription {subscriptionId}. slots: botName: path.botName subscriptionId: path.subscriptionId method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.HealthBot/healthBots/{botName}/regenerateApiJwtSecret'].post update: x-apievangelist-phrasing: intent: Regenerate a Health Bot's API JWT secret effect: destructive questions: - How do I rotate the API JWT secret on my Health Bot? - Will regenerating the Health Bot JWT secret break existing clients? instructions: - text: Regenerate the API JWT secret for Health Bot {botName} in {resourceGroupName}. slots: botName: path.botName resourceGroupName: path.resourceGroupName - text: Rotate the JWT signing secret on Health Bot {botName}. slots: botName: path.botName - text: Issue a new API JWT secret for Health Bot {botName} in subscription {subscriptionId}. slots: botName: path.botName subscriptionId: path.subscriptionId method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.HealthBot/healthBots'].get update: x-apievangelist-phrasing: intent: List Health Bots in a resource group effect: read questions: - Which Health Bots are in a particular resource group? - Can I list only the Health Bots belonging to one resource group? instructions: - text: List Health Bots in resource group {resourceGroupName}. slots: resourceGroupName: path.resourceGroupName - text: Show all Health Bot resources in {resourceGroupName} of subscription {subscriptionId}. slots: resourceGroupName: path.resourceGroupName subscriptionId: path.subscriptionId method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.HealthBot/healthBots'].get update: x-apievangelist-phrasing: intent: List Health Bots in a subscription effect: read questions: - What Health Bots do I have across my whole subscription? - Can I inventory every Health Bot subscription-wide? instructions: - text: List all Health Bots in subscription {subscriptionId}. slots: subscriptionId: path.subscriptionId - text: Show every Health Bot I own across the subscription. method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.OperationalInsights/queryPacks'].get update: x-apievangelist-phrasing: intent: List Log Analytics query packs in a subscription effect: read questions: - Which Log Analytics query packs exist across my subscription? - Can I inventory all saved query packs I own? instructions: - text: List all Log Analytics query packs in my subscription. - text: Show every query pack subscription-wide. method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.OperationalInsights/queryPacks'].get update: x-apievangelist-phrasing: intent: List Log Analytics query packs in a resource group effect: read questions: - What query packs are in one resource group? - Can I list only the Log Analytics query packs in a resource group? instructions: - text: List the Log Analytics query packs in this resource group. - text: Show query packs scoped to my resource group. method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.OperationalInsights/queryPacks/{queryPackName}'].get update: x-apievangelist-phrasing: intent: Get a Log Analytics query pack effect: read questions: - What is inside one of my Log Analytics query packs? - Can I look up a query pack by name? instructions: - text: Get Log Analytics query pack {queryPackName}. slots: queryPackName: path.queryPackName - text: Show the details of query pack {queryPackName}. slots: queryPackName: path.queryPackName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.OperationalInsights/queryPacks/{queryPackName}'].put update: x-apievangelist-phrasing: intent: Create or update a Log Analytics query pack effect: write questions: - How do I create a query pack to share saved Log Analytics queries with my team? - Can I redefine an existing query pack in one request? instructions: - text: Create query pack {queryPackName} in {location}. slots: queryPackName: path.queryPackName location: requestBody.location - text: Create or replace query pack {queryPackName} with properties {properties} and tags {tags}. slots: queryPackName: path.queryPackName properties: requestBody.properties tags: requestBody.tags method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.OperationalInsights/queryPacks/{queryPackName}'].delete update: x-apievangelist-phrasing: intent: Delete a Log Analytics query pack effect: destructive questions: - How do I delete a Log Analytics query pack? - Does removing a query pack delete the saved queries in it? instructions: - text: Delete Log Analytics query pack {queryPackName}. slots: queryPackName: path.queryPackName - text: Remove the query pack named {queryPackName}. slots: queryPackName: path.queryPackName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.OperationalInsights/queryPacks/{queryPackName}'].patch update: x-apievangelist-phrasing: intent: Update tags on a Log Analytics query pack effect: write questions: - Can I change only the tags on a query pack? - How do I retag a Log Analytics query pack without recreating it? instructions: - text: Set tags {tags} on query pack {queryPackName}. slots: tags: requestBody.tags queryPackName: path.queryPackName - text: Replace the tags on Log Analytics query pack {queryPackName}. slots: queryPackName: path.queryPackName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Media/mediaServices/{accountName}/streamingPolicies'].get update: x-apievangelist-phrasing: intent: List streaming policies in a Media Services account effect: read questions: - Which streaming policies are defined in my Media Services account? - Can I filter and sort Media Services streaming policies? instructions: - text: List streaming policies in Media Services account {accountName}. slots: accountName: path.accountName - text: Show the top {top} streaming policies in {accountName} ordered by {orderby}. slots: top: query.$top accountName: path.accountName orderby: query.$orderby - text: List streaming policies for {accountName} in {resourceGroupName}, subscription {subscriptionId}. slots: accountName: path.accountName resourceGroupName: path.resourceGroupName subscriptionId: path.subscriptionId method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Media/mediaServices/{accountName}/streamingPolicies/{streamingPolicyName}'].get update: x-apievangelist-phrasing: intent: Get a Media Services streaming policy effect: read questions: - What encryption and protocols does a streaming policy enable? - Can I read one streaming policy from my Media Services account? instructions: - text: Get streaming policy {streamingPolicyName} in account {accountName}. slots: streamingPolicyName: path.streamingPolicyName accountName: path.accountName - text: Show the protocols enabled by streaming policy {streamingPolicyName}. slots: streamingPolicyName: path.streamingPolicyName - text: Read streaming policy {streamingPolicyName} of {accountName} in {resourceGroupName}, subscription {subscriptionId}. slots: streamingPolicyName: path.streamingPolicyName accountName: path.accountName resourceGroupName: path.resourceGroupName subscriptionId: path.subscriptionId method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Media/mediaServices/{accountName}/streamingPolicies/{streamingPolicyName}'].put update: x-apievangelist-phrasing: intent: Create a Media Services streaming policy effect: write questions: - How do I create a streaming policy with DRM encryption for my videos? - Can I define a custom streaming policy in Media Services? instructions: - text: Create streaming policy {streamingPolicyName} in account {accountName} with {properties}. slots: streamingPolicyName: path.streamingPolicyName accountName: path.accountName properties: requestBody.properties - text: Add a new streaming policy {streamingPolicyName} to {accountName} in {resourceGroupName}. slots: streamingPolicyName: path.streamingPolicyName accountName: path.accountName resourceGroupName: path.resourceGroupName - text: Define streaming policy {streamingPolicyName} on {accountName} in subscription {subscriptionId}. slots: streamingPolicyName: path.streamingPolicyName accountName: path.accountName subscriptionId: path.subscriptionId method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Media/mediaServices/{accountName}/streamingPolicies/{streamingPolicyName}'].delete update: x-apievangelist-phrasing: intent: Delete a Media Services streaming policy effect: destructive questions: - How do I delete a streaming policy from Media Services? - Can I remove a custom streaming policy I no longer use? instructions: - text: Delete streaming policy {streamingPolicyName} from account {accountName}. slots: streamingPolicyName: path.streamingPolicyName accountName: path.accountName - text: Remove streaming policy {streamingPolicyName}. slots: streamingPolicyName: path.streamingPolicyName - text: Delete streaming policy {streamingPolicyName} of {accountName} in {resourceGroupName}, subscription {subscriptionId}. slots: streamingPolicyName: path.streamingPolicyName accountName: path.accountName resourceGroupName: path.resourceGroupName subscriptionId: path.subscriptionId method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Media/mediaServices/{accountName}/streamingLocators'].get update: x-apievangelist-phrasing: intent: List streaming locators in a Media Services account effect: read questions: - Which streaming locators exist in my Media Services account? - Can I filter streaming locators and limit how many are returned? instructions: - text: List streaming locators in Media Services account {accountName}. slots: accountName: path.accountName - text: Show streaming locators in {accountName} matching {filter}. slots: accountName: path.accountName filter: query.$filter - text: List streaming locators for {accountName} in {resourceGroupName}, subscription {subscriptionId}. slots: accountName: path.accountName resourceGroupName: path.resourceGroupName subscriptionId: path.subscriptionId method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Media/mediaServices/{accountName}/streamingLocators/{streamingLocatorName}'].get update: x-apievangelist-phrasing: intent: Get a Media Services streaming locator effect: read questions: - Which asset and streaming policy does a streaming locator point to? - Can I look up a streaming locator's start and end time? instructions: - text: Get streaming locator {streamingLocatorName} in account {accountName}. slots: streamingLocatorName: path.streamingLocatorName accountName: path.accountName - text: Show the asset linked to streaming locator {streamingLocatorName}. slots: streamingLocatorName: path.streamingLocatorName - text: Read streaming locator {streamingLocatorName} of {accountName} in {resourceGroupName}, subscription {subscriptionId}. slots: streamingLocatorName: path.streamingLocatorName accountName: path.accountName resourceGroupName: path.resourceGroupName subscriptionId: path.subscriptionId method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Media/mediaServices/{accountName}/streamingLocators/{streamingLocatorName}'].put update: x-apievangelist-phrasing: intent: Create a Media Services streaming locator effect: write questions: - How do I publish an asset for streaming by creating a locator? - Can I set a time window on a new streaming locator? instructions: - text: Create streaming locator {streamingLocatorName} in {accountName} with {properties}. slots: streamingLocatorName: path.streamingLocatorName accountName: path.accountName properties: requestBody.properties - text: Publish an asset by creating locator {streamingLocatorName} in account {accountName}. slots: streamingLocatorName: path.streamingLocatorName accountName: path.accountName - text: Create locator {streamingLocatorName} on {accountName} in {resourceGroupName}, subscription {subscriptionId}. slots: streamingLocatorName: path.streamingLocatorName accountName: path.accountName resourceGroupName: path.resourceGroupName subscriptionId: path.subscriptionId method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Media/mediaServices/{accountName}/streamingLocators/{streamingLocatorName}'].delete update: x-apievangelist-phrasing: intent: Delete a Media Services streaming locator effect: destructive questions: - How do I stop streaming an asset by removing its locator? - Can I delete a streaming locator without deleting the asset? instructions: - text: Delete streaming locator {streamingLocatorName} from account {accountName}. slots: streamingLocatorName: path.streamingLocatorName accountName: path.accountName - text: Unpublish by removing locator {streamingLocatorName}. slots: streamingLocatorName: path.streamingLocatorName - text: Delete locator {streamingLocatorName} of {accountName} in {resourceGroupName}, subscription {subscriptionId}. slots: streamingLocatorName: path.streamingLocatorName accountName: path.accountName resourceGroupName: path.resourceGroupName subscriptionId: path.subscriptionId method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Media/mediaServices/{accountName}/streamingLocators/{streamingLocatorName}/listContentKeys'].post update: x-apievangelist-phrasing: intent: List content keys used by a streaming locator effect: read questions: - Which content keys protect a given streaming locator? - Can I retrieve the encryption keys a locator uses? instructions: - text: List content keys for streaming locator {streamingLocatorName} in account {accountName}. slots: streamingLocatorName: path.streamingLocatorName accountName: path.accountName - text: Show the encryption keys behind locator {streamingLocatorName}. slots: streamingLocatorName: path.streamingLocatorName - text: Get content keys for locator {streamingLocatorName} on {accountName} in {resourceGroupName}, subscription {subscriptionId}. slots: streamingLocatorName: path.streamingLocatorName accountName: path.accountName resourceGroupName: path.resourceGroupName subscriptionId: path.subscriptionId method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Media/mediaServices/{accountName}/streamingLocators/{streamingLocatorName}/listPaths'].post update: x-apievangelist-phrasing: intent: List streaming and download paths for a locator effect: read questions: - What URLs can players use to stream from my streaming locator? - Can I get HLS and DASH paths for a published asset? instructions: - text: List the paths supported by streaming locator {streamingLocatorName} in account {accountName}. slots: streamingLocatorName: path.streamingLocatorName accountName: path.accountName - text: Get the playback paths for locator {streamingLocatorName}. slots: streamingLocatorName: path.streamingLocatorName - text: Get streaming URLs for locator {streamingLocatorName} on {accountName} in {resourceGroupName}, subscription {subscriptionId}. slots: streamingLocatorName: path.streamingLocatorName accountName: path.accountName resourceGroupName: path.resourceGroupName subscriptionId: path.subscriptionId method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourcegroups/{resourceGroupName}/providers/Microsoft.Migrate/projects'].get update: x-apievangelist-phrasing: intent: List Azure Migrate assessment projects in a group effect: read questions: - Which Azure Migrate assessment projects are in my resource group? - Can I list server assessment projects in a resource group? instructions: - text: List Azure Migrate assessment projects in resource group {resourceGroupName}. slots: resourceGroupName: path.resourceGroupName - text: Show all assessment projects under {resourceGroupName} in subscription {subscriptionId}. slots: resourceGroupName: path.resourceGroupName subscriptionId: path.subscriptionId method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourcegroups/{resourceGroupName}/providers/Microsoft.Migrate/projects/{projectName}'].get update: x-apievangelist-phrasing: intent: Get an Azure Migrate assessment project effect: read questions: - What are the details of one Azure Migrate assessment project? - Can I check the status of a migration assessment project by name? instructions: - text: Get Azure Migrate project {projectName} in {resourceGroupName}. slots: projectName: path.projectName resourceGroupName: path.resourceGroupName - text: Show assessment project {projectName}. slots: projectName: path.projectName - text: Fetch assessment project {projectName} in {resourceGroupName} under subscription {subscriptionId}. slots: projectName: path.projectName resourceGroupName: path.resourceGroupName subscriptionId: path.subscriptionId method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourcegroups/{resourceGroupName}/providers/Microsoft.Migrate/projects/{projectName}'].put update: x-apievangelist-phrasing: intent: Create or update an Azure Migrate project effect: write questions: - How do I start an Azure Migrate assessment project? - What happens if I create a Migrate project with a name that already exists? instructions: - text: Create Azure Migrate project {projectName} in {resourceGroupName} at {location}. slots: projectName: path.projectName resourceGroupName: path.resourceGroupName location: requestBody.location - text: Create or overwrite Migrate project {projectName} with properties {properties}. slots: projectName: path.projectName properties: requestBody.properties - text: Set up assessment project {projectName} in {resourceGroupName} for subscription {subscriptionId}. slots: projectName: path.projectName resourceGroupName: path.resourceGroupName subscriptionId: path.subscriptionId method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourcegroups/{resourceGroupName}/providers/Microsoft.Migrate/projects/{projectName}'].delete update: x-apievangelist-phrasing: intent: Delete an Azure Migrate assessment project effect: destructive questions: - How do I delete an Azure Migrate assessment project? - Is deleting a Migrate project that doesn't exist an error? instructions: - text: Delete Azure Migrate project {projectName} in {resourceGroupName}. slots: projectName: path.projectName resourceGroupName: path.resourceGroupName - text: Remove assessment project {projectName}. slots: projectName: path.projectName - text: Delete assessment project {projectName} in subscription {subscriptionId}. slots: projectName: path.projectName subscriptionId: path.subscriptionId method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourcegroups/{resourceGroupName}/providers/Microsoft.Migrate/projects/{projectName}'].patch update: x-apievangelist-phrasing: intent: Partially update an Azure Migrate project effect: write questions: - Can I update only the tags on an Azure Migrate project? - How do I patch settings on an existing assessment project? instructions: - text: Set tags {tags} on Azure Migrate project {projectName}. slots: tags: requestBody.tags projectName: path.projectName - text: Patch Migrate project {projectName} in {resourceGroupName} with {properties}. slots: projectName: path.projectName resourceGroupName: path.resourceGroupName properties: requestBody.properties - text: Patch assessment project {projectName} in {resourceGroupName} under subscription {subscriptionId}. slots: projectName: path.projectName resourceGroupName: path.resourceGroupName subscriptionId: path.subscriptionId method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourcegroups/{resourceGroupName}/providers/Microsoft.Migrate/projects/{projectName}/keys'].post update: x-apievangelist-phrasing: intent: Get Log Analytics keys for a Migrate project effect: read questions: - Where do I find the Log Analytics workspace ID and key for my Azure Migrate project? - Can I retrieve the shared keys needed to install dependency agents? instructions: - text: Get the shared keys for Azure Migrate project {projectName}. slots: projectName: path.projectName - text: Show the Log Analytics workspace ID and primary key for project {projectName} in {resourceGroupName}. slots: projectName: path.projectName resourceGroupName: path.resourceGroupName - text: Retrieve workspace keys for project {projectName} in {resourceGroupName}, subscription {subscriptionId}. slots: projectName: path.projectName resourceGroupName: path.resourceGroupName subscriptionId: path.subscriptionId method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Migrate/projects/{projectName}/machines'].get update: x-apievangelist-phrasing: intent: List discovered machines in a Migrate project effect: read questions: - Which on-premises machines has my Azure Migrate project discovered? - Can I list all servers in an assessment project? instructions: - text: List machines in Azure Migrate project {projectName}. slots: projectName: path.projectName - text: Show every discovered server in {projectName} under {resourceGroupName}. slots: projectName: path.projectName resourceGroupName: path.resourceGroupName - text: List discovered machines in {projectName} in {resourceGroupName}, subscription {subscriptionId}. slots: projectName: path.projectName resourceGroupName: path.resourceGroupName subscriptionId: path.subscriptionId method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Migrate/projects/{projectName}/machines/{machineName}'].get update: x-apievangelist-phrasing: intent: Get a discovered machine in a Migrate project effect: read questions: - What CPU, memory and disks did Azure Migrate discover on a specific server? - Can I look up one machine in my assessment project by name? instructions: - text: Get machine {machineName} in Azure Migrate project {projectName}. slots: machineName: path.machineName projectName: path.projectName - text: Show the discovered hardware for server {machineName}. slots: machineName: path.machineName - text: Get discovered machine {machineName} from project {projectName} in {resourceGroupName}, subscription {subscriptionId}. slots: machineName: path.machineName projectName: path.projectName resourceGroupName: path.resourceGroupName subscriptionId: path.subscriptionId method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Migrate/projects/{projectName}/groups'].get update: x-apievangelist-phrasing: intent: List machine groups in a Migrate project effect: read questions: - What machine groups have I created in my Azure Migrate project? - Can I list the assessment groups inside a project? instructions: - text: List groups in Azure Migrate project {projectName}. slots: projectName: path.projectName - text: Show all machine groups in {projectName} under {resourceGroupName}. slots: projectName: path.projectName resourceGroupName: path.resourceGroupName - text: List machine groups in {projectName} in {resourceGroupName}, subscription {subscriptionId}. slots: projectName: path.projectName resourceGroupName: path.resourceGroupName subscriptionId: path.subscriptionId method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Migrate/projects/{projectName}/groups/{groupName}'].get update: x-apievangelist-phrasing: intent: Get a machine group in a Migrate project effect: read questions: - Which machines belong to a specific Azure Migrate group? - Can I see the details of one assessment group? instructions: - text: Get group {groupName} in Azure Migrate project {projectName}. slots: groupName: path.groupName projectName: path.projectName - text: Show the machines in migration group {groupName}. slots: groupName: path.groupName - text: Get machine group {groupName} of project {projectName} in {resourceGroupName}, subscription {subscriptionId}. slots: groupName: path.groupName projectName: path.projectName resourceGroupName: path.resourceGroupName subscriptionId: path.subscriptionId method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Migrate/projects/{projectName}/groups/{groupName}'].put update: x-apievangelist-phrasing: intent: Create or update a machine group for assessment effect: write questions: - How do I group servers together for an Azure Migrate assessment? - Will creating a group with an existing name overwrite it? instructions: - text: Create group {groupName} in Azure Migrate project {projectName} with properties {properties}. slots: groupName: path.groupName projectName: path.projectName properties: requestBody.properties - text: Create or update migration group {groupName} containing the machines I list. slots: groupName: path.groupName - text: Create machine group {groupName} in project {projectName}, {resourceGroupName}, subscription {subscriptionId}. slots: groupName: path.groupName projectName: path.projectName resourceGroupName: path.resourceGroupName subscriptionId: path.subscriptionId method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Migrate/projects/{projectName}/groups/{groupName}'].delete update: x-apievangelist-phrasing: intent: Delete a machine group from a Migrate project effect: destructive questions: - How do I delete a group from my Azure Migrate project? - Do machines stay in the project after their group is deleted? instructions: - text: Delete group {groupName} from Azure Migrate project {projectName}. slots: groupName: path.groupName projectName: path.projectName - text: Remove migration group {groupName}. slots: groupName: path.groupName - text: Delete machine group {groupName} of project {projectName} in {resourceGroupName}, subscription {subscriptionId}. slots: groupName: path.groupName projectName: path.projectName resourceGroupName: path.resourceGroupName subscriptionId: path.subscriptionId method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Migrate/projects/{projectName}/groups/{groupName}/assessments'].get update: x-apievangelist-phrasing: intent: List assessments for a machine group effect: read questions: - Which assessments have been run for one machine group? - Can I list assessments for a specific group in Azure Migrate? instructions: - text: List assessments for group {groupName} in project {projectName}. slots: groupName: path.groupName projectName: path.projectName - text: Show assessments created for migration group {groupName}. slots: groupName: path.groupName - text: List group {groupName} assessments in project {projectName}, {resourceGroupName}, subscription {subscriptionId}. slots: groupName: path.groupName projectName: path.projectName resourceGroupName: path.resourceGroupName subscriptionId: path.subscriptionId method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Migrate/projects/{projectName}/assessments'].get update: x-apievangelist-phrasing: intent: List all assessments in a Migrate project effect: read questions: - What assessments exist across all groups in my Azure Migrate project? - Can I see every assessment in a project regardless of group? instructions: - text: List every assessment in Azure Migrate project {projectName}. slots: projectName: path.projectName - text: Show project-wide assessments in {projectName} under {resourceGroupName}. slots: projectName: path.projectName resourceGroupName: path.resourceGroupName - text: List all assessments of project {projectName} in {resourceGroupName}, subscription {subscriptionId}. slots: projectName: path.projectName resourceGroupName: path.resourceGroupName subscriptionId: path.subscriptionId method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Migrate/projects/{projectName}/groups/{groupName}/assessments/{assessmentName}'].get update: x-apievangelist-phrasing: intent: Get an Azure Migrate assessment effect: read questions: - What sizing and cost settings does one of my migration assessments use? - Can I look up an assessment by name within a group? instructions: - text: Get assessment {assessmentName} in group {groupName} of project {projectName}. slots: assessmentName: path.assessmentName groupName: path.groupName projectName: path.projectName - text: Show the settings of migration assessment {assessmentName}. slots: assessmentName: path.assessmentName - text: Get assessment {assessmentName} of group {groupName}, project {projectName}, {resourceGroupName}, subscription {subscriptionId}. slots: assessmentName: path.assessmentName groupName: path.groupName projectName: path.projectName resourceGroupName: path.resourceGroupName subscriptionId: path.subscriptionId method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Migrate/projects/{projectName}/groups/{groupName}/assessments/{assessmentName}'].put update: x-apievangelist-phrasing: intent: Create or update an Azure Migrate assessment effect: write questions: - How do I run a new migration assessment on a group of servers? - Can I change the target region or pricing on an existing assessment? instructions: - text: Create assessment {assessmentName} for group {groupName} in project {projectName} with properties {properties}. slots: assessmentName: path.assessmentName groupName: path.groupName projectName: path.projectName properties: requestBody.properties - text: Recreate migration assessment {assessmentName} with updated settings. slots: assessmentName: path.assessmentName - text: Run assessment {assessmentName} on group {groupName}, project {projectName}, {resourceGroupName}, subscription {subscriptionId}. slots: assessmentName: path.assessmentName groupName: path.groupName projectName: path.projectName resourceGroupName: path.resourceGroupName subscriptionId: path.subscriptionId method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Migrate/projects/{projectName}/groups/{groupName}/assessments/{assessmentName}'].delete update: x-apievangelist-phrasing: intent: Delete an Azure Migrate assessment effect: destructive questions: - How do I delete a migration assessment? - Does deleting an assessment remove machines from its group? instructions: - text: Delete assessment {assessmentName} from group {groupName} in project {projectName}. slots: assessmentName: path.assessmentName groupName: path.groupName projectName: path.projectName - text: Remove migration assessment {assessmentName}. slots: assessmentName: path.assessmentName - text: Delete assessment {assessmentName} of group {groupName}, project {projectName}, {resourceGroupName}, subscription {subscriptionId}. slots: assessmentName: path.assessmentName groupName: path.groupName projectName: path.projectName resourceGroupName: path.resourceGroupName subscriptionId: path.subscriptionId method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Migrate/projects/{projectName}/groups/{groupName}/assessments/{assessmentName}/downloadUrl'].post update: x-apievangelist-phrasing: intent: Get a download URL for an assessment report effect: read questions: - How do I download my Azure Migrate assessment as a report? - Can I get a link to export an assessment? instructions: - text: Get the report download URL for assessment {assessmentName} in group {groupName}. slots: assessmentName: path.assessmentName groupName: path.groupName - text: Give me a link to download the {assessmentName} assessment report from project {projectName}. slots: assessmentName: path.assessmentName projectName: path.projectName - text: Get report URL for {assessmentName} in group {groupName}, project {projectName}, {resourceGroupName}, subscription {subscriptionId}. slots: assessmentName: path.assessmentName groupName: path.groupName projectName: path.projectName resourceGroupName: path.resourceGroupName subscriptionId: path.subscriptionId method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Migrate/projects/{projectName}/groups/{groupName}/assessments/{assessmentName}/assessedMachines'].get update: x-apievangelist-phrasing: intent: List machines evaluated in an assessment effect: read questions: - Which machines were evaluated in a given migration assessment? - Can I see Azure readiness for every server in an assessment? instructions: - text: List assessed machines in assessment {assessmentName} of group {groupName}. slots: assessmentName: path.assessmentName groupName: path.groupName - text: Show every server evaluated by assessment {assessmentName} in project {projectName}. slots: assessmentName: path.assessmentName projectName: path.projectName - text: List servers in {assessmentName}, group {groupName}, project {projectName}, {resourceGroupName}, subscription {subscriptionId}. slots: assessmentName: path.assessmentName groupName: path.groupName projectName: path.projectName resourceGroupName: path.resourceGroupName subscriptionId: path.subscriptionId method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Migrate/projects/{projectName}/groups/{groupName}/assessments/{assessmentName}/assessedMachines/{assessedMachineName}'].get update: x-apievangelist-phrasing: intent: Get an assessed machine's size and cost effect: read questions: - What Azure VM size and monthly cost did an assessment recommend for one server? - Can I get the cost estimate for a single assessed machine? instructions: - text: Get assessed machine {assessedMachineName} in assessment {assessmentName}. slots: assessedMachineName: path.assessedMachineName assessmentName: path.assessmentName - text: Show the recommended size and cost estimate for {assessedMachineName}. slots: assessedMachineName: path.assessedMachineName - text: Get {assessedMachineName} from {assessmentName}, group {groupName}, project {projectName}, {resourceGroupName}, sub {subscriptionId}. slots: assessedMachineName: path.assessedMachineName assessmentName: path.assessmentName groupName: path.groupName projectName: path.projectName resourceGroupName: path.resourceGroupName subscriptionId: path.subscriptionId method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.Migrate/migrateProjects'].get update: x-apievangelist-phrasing: intent: List Migrate hub projects in a subscription effect: read questions: - Which Azure Migrate hub projects exist across my subscription? - Can I see every migrate project I own subscription-wide? instructions: - text: List all Azure Migrate hub projects in my subscription. - text: Show every migrateProjects resource subscription-wide. method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourcegroups/{resourceGroupName}/providers/Microsoft.Migrate/migrateProjects'].get update: x-apievangelist-phrasing: intent: List Migrate hub projects in a resource group effect: read questions: - What Azure Migrate hub projects are in one resource group? - Can I narrow the migrate project list to a single resource group? instructions: - text: List the Azure Migrate hub projects in this resource group. - text: Show migrateProjects resources scoped to my resource group. method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Quantum/workspaces/{workspaceName}'].get update: x-apievangelist-phrasing: intent: Get an Azure Quantum workspace effect: read questions: - What providers and storage are configured on my Azure Quantum workspace? - Can I look up a Quantum workspace's endpoint by name? instructions: - text: Get Azure Quantum workspace {workspaceName} in {resourceGroupName}. slots: workspaceName: path.workspaceName resourceGroupName: path.resourceGroupName - text: Show the configuration of Quantum workspace {workspaceName}. slots: workspaceName: path.workspaceName - text: Fetch Quantum workspace {workspaceName} in subscription {subscriptionId}. slots: workspaceName: path.workspaceName subscriptionId: path.subscriptionId method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Quantum/workspaces/{workspaceName}'].put update: x-apievangelist-phrasing: intent: Create or update an Azure Quantum workspace effect: write questions: - How do I create an Azure Quantum workspace? - Can I assign a managed identity to a Quantum workspace when creating it? instructions: - text: Create Quantum workspace {workspaceName} in {resourceGroupName} with properties {properties}. slots: workspaceName: path.workspaceName resourceGroupName: path.resourceGroupName properties: requestBody.properties - text: Create or replace Quantum workspace {workspaceName} using identity {identity}. slots: workspaceName: path.workspaceName identity: requestBody.identity - text: Provision Quantum workspace {workspaceName} in {resourceGroupName} for subscription {subscriptionId}. slots: workspaceName: path.workspaceName resourceGroupName: path.resourceGroupName subscriptionId: path.subscriptionId method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Quantum/workspaces/{workspaceName}'].delete update: x-apievangelist-phrasing: intent: Delete an Azure Quantum workspace effect: destructive questions: - How do I delete an Azure Quantum workspace? - Can I remove a Quantum workspace I no longer use? instructions: - text: Delete Quantum workspace {workspaceName} in {resourceGroupName}. slots: workspaceName: path.workspaceName resourceGroupName: path.resourceGroupName - text: Remove Azure Quantum workspace {workspaceName}. slots: workspaceName: path.workspaceName - text: Delete Quantum workspace {workspaceName} from subscription {subscriptionId}. slots: workspaceName: path.workspaceName subscriptionId: path.subscriptionId method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Quantum/workspaces/{workspaceName}'].patch update: x-apievangelist-phrasing: intent: Update tags on an Azure Quantum workspace effect: write questions: - Can I change only the tags on a Quantum workspace? - How do I label my Azure Quantum workspace with cost-center tags? instructions: - text: Set tags {tags} on Quantum workspace {workspaceName}. slots: tags: requestBody.tags workspaceName: path.workspaceName - text: Retag Azure Quantum workspace {workspaceName} in {resourceGroupName}. slots: workspaceName: path.workspaceName resourceGroupName: path.resourceGroupName - text: Update tags on Quantum workspace {workspaceName} in subscription {subscriptionId}. slots: workspaceName: path.workspaceName subscriptionId: path.subscriptionId method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.Quantum/workspaces'].get update: x-apievangelist-phrasing: intent: List Azure Quantum workspaces in a subscription effect: read questions: - Which Azure Quantum workspaces exist across my subscription? - Can I inventory all Quantum workspaces I own? instructions: - text: List all Quantum workspaces in subscription {subscriptionId}. slots: subscriptionId: path.subscriptionId - text: Show every Azure Quantum workspace subscription-wide. method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Quantum/workspaces'].get update: x-apievangelist-phrasing: intent: List Azure Quantum workspaces in a resource group effect: read questions: - What Quantum workspaces are in a particular resource group? - Can I list only the Azure Quantum workspaces in one resource group? instructions: - text: List Quantum workspaces in resource group {resourceGroupName}. slots: resourceGroupName: path.resourceGroupName - text: Show Azure Quantum workspaces under {resourceGroupName} in subscription {subscriptionId}. slots: resourceGroupName: path.resourceGroupName subscriptionId: path.subscriptionId method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.Quantum/locations/{locationName}/offerings'].get update: x-apievangelist-phrasing: intent: List Azure Quantum provider offerings in a region effect: read questions: - Which quantum hardware providers can I add to a workspace in a given region? - What Azure Quantum offerings and plans are available in my location? instructions: - text: List Azure Quantum provider offerings in {locationName}. slots: locationName: path.locationName - text: Show quantum offerings available to subscription {subscriptionId} in {locationName}. slots: subscriptionId: path.subscriptionId locationName: path.locationName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.Quantum/locations/{locationName}/checkNameAvailability'].post update: x-apievangelist-phrasing: intent: Check an Azure Quantum workspace name is free effect: read questions: - Is my chosen Azure Quantum workspace name available in a region? - Can I check a Quantum workspace name before creating it? instructions: - text: Check whether Quantum workspace name {name} is available in {locationName}. slots: name: requestBody.name locationName: path.locationName - text: Verify the {type} name {name} is unused for Azure Quantum. slots: type: requestBody.type name: requestBody.name - text: Check Quantum workspace name {name} in {locationName} for subscription {subscriptionId}. slots: name: requestBody.name locationName: path.locationName subscriptionId: path.subscriptionId method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Quantum/workspaces/{workspaceName}/jobs'].get update: x-apievangelist-phrasing: intent: List jobs in an Azure Quantum workspace effect: read questions: - What quantum jobs have been submitted to my workspace? - Can I see all jobs across a Quantum workspace, not just one session? instructions: - text: List all jobs in Quantum workspace {workspaceName}. slots: workspaceName: path.workspaceName - text: Show every quantum job in {workspaceName} under {resourceGroupName}. slots: workspaceName: path.workspaceName resourceGroupName: path.resourceGroupName - text: List quantum jobs in {workspaceName}, {resourceGroupName}, subscription {subscriptionId}. slots: workspaceName: path.workspaceName resourceGroupName: path.resourceGroupName subscriptionId: path.subscriptionId method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Quantum/workspaces/{workspaceName}/jobs/{jobId}'].get update: x-apievangelist-phrasing: intent: Get an Azure Quantum job effect: read questions: - Has my quantum job finished, and where are its results? - Can I check the cost estimate and status of one quantum job? instructions: - text: Get quantum job {jobId} in workspace {workspaceName}. slots: jobId: path.jobId workspaceName: path.workspaceName - text: Show the status and output URI of job {jobId}. slots: jobId: path.jobId - text: Fetch quantum job {jobId} from {workspaceName} in {resourceGroupName}, subscription {subscriptionId}. slots: jobId: path.jobId workspaceName: path.workspaceName resourceGroupName: path.resourceGroupName subscriptionId: path.subscriptionId method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Quantum/workspaces/{workspaceName}/jobs/{jobId}'].put update: x-apievangelist-phrasing: intent: Submit a job to an Azure Quantum workspace effect: write questions: - How do I submit a quantum program to a specific target? - What do I need to provide, like a container URI and provider, to create a quantum job? instructions: - text: Submit job {jobId} named {name} to target {target} from provider {providerId} in workspace {workspaceName}. slots: jobId: path.jobId name: requestBody.name target: requestBody.target providerId: requestBody.providerId workspaceName: path.workspaceName - text: Create quantum job {jobId} using input container {containerUri} inside session {sessionId}. slots: jobId: path.jobId containerUri: requestBody.containerUri sessionId: requestBody.sessionId - text: Submit quantum job {jobId} to {workspaceName} in {resourceGroupName}, subscription {subscriptionId}. slots: jobId: path.jobId workspaceName: path.workspaceName resourceGroupName: path.resourceGroupName subscriptionId: path.subscriptionId method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Quantum/workspaces/{workspaceName}/jobs/{jobId}'].delete update: x-apievangelist-phrasing: intent: Cancel an Azure Quantum job effect: destructive questions: - How do I cancel a quantum job that is still waiting in the queue? - Can I stop a running job in my Quantum workspace? instructions: - text: Cancel quantum job {jobId} in workspace {workspaceName}. slots: jobId: path.jobId workspaceName: path.workspaceName - text: Request cancellation of job {jobId}. slots: jobId: path.jobId - text: Cancel job {jobId} in Quantum workspace {workspaceName}, {resourceGroupName}, subscription {subscriptionId}. slots: jobId: path.jobId workspaceName: path.workspaceName resourceGroupName: path.resourceGroupName subscriptionId: path.subscriptionId method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Quantum/workspaces/{workspaceName}/jobs/{jobId}'].patch update: x-apievangelist-phrasing: intent: Update properties of an Azure Quantum job effect: write questions: - Can I change the name or tags of a quantum job after submitting it? - How do I patch properties on an existing quantum job? instructions: - text: Update properties of quantum job {jobId} in workspace {workspaceName}. slots: jobId: path.jobId workspaceName: path.workspaceName - text: Patch job {jobId} in {resourceGroupName}. slots: jobId: path.jobId resourceGroupName: path.resourceGroupName - text: Update quantum job {jobId} in {workspaceName}, subscription {subscriptionId}. slots: jobId: path.jobId workspaceName: path.workspaceName subscriptionId: path.subscriptionId method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Quantum/workspaces/{workspaceName}/providerStatus'].get update: x-apievangelist-phrasing: intent: List quantum providers and their status effect: read questions: - Which quantum providers in my workspace are online right now? - Can I see the status of each target a workspace can use? instructions: - text: List providers and their status in Quantum workspace {workspaceName}. slots: workspaceName: path.workspaceName - text: Show which quantum targets are available in {workspaceName}. slots: workspaceName: path.workspaceName - text: Show provider status for Quantum workspace {workspaceName} in {resourceGroupName}, subscription {subscriptionId}. slots: workspaceName: path.workspaceName resourceGroupName: path.resourceGroupName subscriptionId: path.subscriptionId method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Quantum/workspaces/{workspaceName}/quotas'].get update: x-apievangelist-phrasing: intent: List quotas for an Azure Quantum workspace effect: read questions: - How much of my quantum compute quota have I used? - What quota limits apply to my Quantum workspace? instructions: - text: List quotas for Quantum workspace {workspaceName}. slots: workspaceName: path.workspaceName - text: Show quota usage and limits in {workspaceName} under {resourceGroupName}. slots: workspaceName: path.workspaceName resourceGroupName: path.resourceGroupName - text: Get quantum quotas for {workspaceName} in subscription {subscriptionId}. slots: workspaceName: path.workspaceName subscriptionId: path.subscriptionId method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Quantum/workspaces/{workspaceName}/sessions'].get update: x-apievangelist-phrasing: intent: List sessions in an Azure Quantum workspace effect: read questions: - What quantum sessions exist in my workspace? - Can I see open and closed sessions for a Quantum workspace? instructions: - text: List sessions in Quantum workspace {workspaceName}. slots: workspaceName: path.workspaceName - text: Show all quantum sessions under {resourceGroupName} workspace {workspaceName}. slots: resourceGroupName: path.resourceGroupName workspaceName: path.workspaceName - text: List quantum sessions in {workspaceName} for subscription {subscriptionId}. slots: workspaceName: path.workspaceName subscriptionId: path.subscriptionId method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Quantum/workspaces/{workspaceName}/sessions/{sessionId}'].get update: x-apievangelist-phrasing: intent: Get an Azure Quantum session effect: read questions: - Is my quantum session still open, and which target is it using? - Can I look up one session by its id? instructions: - text: Get quantum session {sessionId} in workspace {workspaceName}. slots: sessionId: path.sessionId workspaceName: path.workspaceName - text: Show the status of session {sessionId}. slots: sessionId: path.sessionId - text: Fetch quantum session {sessionId} from {workspaceName} in {resourceGroupName}, subscription {subscriptionId}. slots: sessionId: path.sessionId workspaceName: path.workspaceName resourceGroupName: path.resourceGroupName subscriptionId: path.subscriptionId method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Quantum/workspaces/{workspaceName}/sessions/{sessionId}'].put update: x-apievangelist-phrasing: intent: Open a new Azure Quantum session effect: write questions: - How do I open a session to group several quantum jobs on one target? - What job failure policy can I set when opening a session? instructions: - text: Open session {sessionId} named {name} on target {target} from provider {providerId} in workspace {workspaceName}. slots: sessionId: path.sessionId name: requestBody.name target: requestBody.target providerId: requestBody.providerId workspaceName: path.workspaceName - text: Start quantum session {sessionId} with job failure policy {jobFailurePolicy}. slots: sessionId: path.sessionId jobFailurePolicy: requestBody.jobFailurePolicy - text: Open quantum session {sessionId} in {workspaceName}, {resourceGroupName}, subscription {subscriptionId}. slots: sessionId: path.sessionId workspaceName: path.workspaceName resourceGroupName: path.resourceGroupName subscriptionId: path.subscriptionId method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Quantum/workspaces/{workspaceName}/sessions/{sessionId}:close'].post update: x-apievangelist-phrasing: intent: Close an Azure Quantum session effect: destructive questions: - How do I close a quantum session once my jobs are done? - Can I end a session so no more jobs are accepted into it? instructions: - text: Close quantum session {sessionId} in workspace {workspaceName}. slots: sessionId: path.sessionId workspaceName: path.workspaceName - text: End session {sessionId}. slots: sessionId: path.sessionId - text: Close session {sessionId} in Quantum workspace {workspaceName}, {resourceGroupName}, subscription {subscriptionId}. slots: sessionId: path.sessionId workspaceName: path.workspaceName resourceGroupName: path.resourceGroupName subscriptionId: path.subscriptionId method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Quantum/workspaces/{workspaceName}/sessions/{sessionId}/jobs'].get update: x-apievangelist-phrasing: intent: List jobs in an Azure Quantum session effect: read questions: - Which jobs ran inside one quantum session? - Can I list only the jobs belonging to a specific session? instructions: - text: List jobs in quantum session {sessionId} of workspace {workspaceName}. slots: sessionId: path.sessionId workspaceName: path.workspaceName - text: Show the jobs submitted within session {sessionId}. slots: sessionId: path.sessionId - text: List jobs of session {sessionId} in {workspaceName}, {resourceGroupName}, subscription {subscriptionId}. slots: sessionId: path.sessionId workspaceName: path.workspaceName resourceGroupName: path.resourceGroupName subscriptionId: path.subscriptionId method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Quantum/workspaces/{workspaceName}/storage/sasUri'].post update: x-apievangelist-phrasing: intent: Get a SAS URL for Quantum workspace storage effect: read questions: - How do I get a SAS URL to upload quantum job input to workspace storage? - Can I get a SAS link for a specific blob in my Quantum workspace container? instructions: - text: Get a SAS URI for container {containerName} in Quantum workspace {workspaceName}. slots: containerName: requestBody.containerName workspaceName: path.workspaceName - text: Generate a SAS URL for blob {blobName} in container {containerName}. slots: blobName: requestBody.blobName containerName: requestBody.containerName - text: Get a SAS URL for {containerName} in Quantum workspace {workspaceName}, {resourceGroupName}, subscription {subscriptionId}. slots: containerName: requestBody.containerName workspaceName: path.workspaceName resourceGroupName: path.resourceGroupName subscriptionId: path.subscriptionId method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Quantum/workspaces/{workspaceName}/topLevelItems'].get update: x-apievangelist-phrasing: intent: List top-level jobs and sessions in a workspace effect: read questions: - Can I see jobs and sessions together at the top level of my Quantum workspace? - What standalone items, jobs not in a session plus sessions, does my workspace hold? instructions: - text: List top-level items in Quantum workspace {workspaceName}. slots: workspaceName: path.workspaceName - text: Show sessions and standalone jobs in {workspaceName} under {resourceGroupName}. slots: workspaceName: path.workspaceName resourceGroupName: path.resourceGroupName - text: List top-level quantum items in {workspaceName} for subscription {subscriptionId}. slots: workspaceName: path.workspaceName subscriptionId: path.subscriptionId method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ResourceGraph/queries/{resourceName}'].patch update: x-apievangelist-phrasing: intent: Update a saved Resource Graph query effect: write questions: - How do I change the text of a saved Azure Resource Graph query? - Can I retag a shared Resource Graph query? instructions: - text: Update saved Resource Graph query {resourceName} with properties {properties}. slots: resourceName: path.resourceName properties: requestBody.properties - text: Set tags {tags} on graph query {resourceName} in {resourceGroupName}. slots: tags: requestBody.tags resourceName: path.resourceName resourceGroupName: path.resourceGroupName - text: Patch Resource Graph query {resourceName} in subscription {subscriptionId}. slots: resourceName: path.resourceName subscriptionId: path.subscriptionId method: generated generated: '2026-09-26' - target: $.paths['/subscriptions'].get update: x-apievangelist-phrasing: intent: List all subscriptions for my tenant effect: read questions: - Which Azure subscriptions can I access in my tenant? - What subscription IDs do I have? instructions: - text: List all subscriptions for my tenant. - text: Show every Azure subscription I can use, with its state. - text: List my tenant's subscriptions using API version {apiVersion}. slots: apiVersion: query.api-version method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}'].get update: x-apievangelist-phrasing: intent: Get details of a subscription effect: read questions: - What is the state and display name of a given Azure subscription? - Can I check the spending limit and policies on one subscription? instructions: - text: Get details for subscription {subscriptionId}. slots: subscriptionId: path.subscriptionId - text: Show whether subscription {subscriptionId} is enabled. slots: subscriptionId: path.subscriptionId method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}'].put update: x-apievangelist-phrasing: intent: Create or update a subscription effect: write questions: - How do I create a new Azure subscription from a definition? - Can I update an existing subscription's definition? instructions: - text: Create or update subscription {subscriptionId} with definition {subscriptionDefinition}. slots: subscriptionId: path.subscriptionId subscriptionDefinition: body.subscriptionDefinition - text: Apply subscription definition {subscriptionDefinition} to {subscriptionId}. slots: subscriptionDefinition: body.subscriptionDefinition subscriptionId: path.subscriptionId method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}'].delete update: x-apievangelist-phrasing: intent: Delete a subscription effect: destructive questions: - How do I delete an Azure subscription? - Is deleting a subscription permanent? instructions: - text: Delete subscription {subscriptionId}. slots: subscriptionId: path.subscriptionId - text: Permanently remove Azure subscription {subscriptionId}. slots: subscriptionId: path.subscriptionId method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/tagNames'].get update: x-apievangelist-phrasing: intent: Summarize tag names used in a subscription effect: read questions: - Which tag names and values are in use across my subscription? - How many resources carry each tag in my subscription? instructions: - text: List tag names and values used in subscription {subscriptionId}. slots: subscriptionId: path.subscriptionId - text: Summarize tag usage across resources and resource groups in {subscriptionId}. slots: subscriptionId: path.subscriptionId method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Media/videoAnalyzers'].get update: x-apievangelist-phrasing: intent: List Video Analyzer accounts in a resource group effect: read questions: - Which Video Analyzer accounts are in my resource group? - Can I inventory my Azure Video Analyzer accounts? instructions: - text: List Video Analyzer accounts in this resource group. - text: Show every Video Analyzer account in my resource group. method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Media/videoAnalyzers/{accountName}'].get update: x-apievangelist-phrasing: intent: Get a Video Analyzer account effect: read questions: - What storage and endpoints does my Video Analyzer account use? - Can I look up one Video Analyzer account by name? instructions: - text: Get Video Analyzer account {accountName}. slots: accountName: path.accountName - text: Show the configuration of Video Analyzer {accountName}. slots: accountName: path.accountName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Media/videoAnalyzers/{accountName}'].put update: x-apievangelist-phrasing: intent: Create or update a Video Analyzer account effect: write questions: - How do I create a Video Analyzer account? - Can I attach a managed identity to a Video Analyzer account? instructions: - text: Create Video Analyzer account {accountName} with properties {properties}. slots: accountName: path.accountName properties: requestBody.properties - text: Create or replace Video Analyzer {accountName} using identity {identity}. slots: accountName: path.accountName identity: requestBody.identity method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Media/videoAnalyzers/{accountName}'].delete update: x-apievangelist-phrasing: intent: Delete a Video Analyzer account effect: destructive questions: - How do I delete a Video Analyzer account? - Can I remove a Video Analyzer account I no longer use? instructions: - text: Delete Video Analyzer account {accountName}. slots: accountName: path.accountName - text: Remove the Video Analyzer {accountName} from my resource group. slots: accountName: path.accountName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Media/videoAnalyzers/{accountName}'].patch update: x-apievangelist-phrasing: intent: Update a Video Analyzer account effect: write questions: - Can I change tags on an existing Video Analyzer account? - How do I patch a Video Analyzer account's identity? instructions: - text: Set tags {tags} on Video Analyzer account {accountName}. slots: tags: requestBody.tags accountName: path.accountName - text: Patch Video Analyzer {accountName} with properties {properties}. slots: accountName: path.accountName properties: requestBody.properties method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Media/videoAnalyzers/{accountName}/privateLinkResources'].get update: x-apievangelist-phrasing: intent: List private link group IDs for a Video Analyzer effect: read questions: - Which private link group IDs does my Video Analyzer account support? - What group IDs can I use for a private endpoint to Video Analyzer? instructions: - text: List private link group IDs for Video Analyzer account {accountName}. slots: accountName: path.accountName - text: Show private link resources on Video Analyzer {accountName}. slots: accountName: path.accountName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Media/videoAnalyzers/{accountName}/privateLinkResources/{name}'].get update: x-apievangelist-phrasing: intent: Get a private link group ID for a Video Analyzer effect: read questions: - What required members does a specific Video Analyzer private link group have? - Can I look up one private link group ID by name? instructions: - text: Get private link group {name} on Video Analyzer account {accountName}. slots: name: path.name accountName: path.accountName - text: Show the private link resource {name} for Video Analyzer. slots: name: path.name method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Media/videoAnalyzers/{accountName}/privateEndpointConnections'].get update: x-apievangelist-phrasing: intent: List Video Analyzer private endpoint connections effect: read questions: - Which private endpoints are connected to my Video Analyzer account? - Are there pending private endpoint requests on Video Analyzer? instructions: - text: List private endpoint connections on Video Analyzer account {accountName}. slots: accountName: path.accountName - text: Show all private endpoints attached to Video Analyzer {accountName}. slots: accountName: path.accountName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Media/videoAnalyzers/{accountName}/privateEndpointConnections/{name}'].get update: x-apievangelist-phrasing: intent: Get a Video Analyzer private endpoint connection effect: read questions: - Is a private endpoint connection to my Video Analyzer approved? - Can I read one Video Analyzer private endpoint connection? instructions: - text: Get private endpoint connection {name} on Video Analyzer account {accountName}. slots: name: path.name accountName: path.accountName - text: Show the state of Video Analyzer endpoint connection {name}. slots: name: path.name method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Media/videoAnalyzers/{accountName}/privateEndpointConnections/{name}'].put update: x-apievangelist-phrasing: intent: Update a Video Analyzer private endpoint state effect: write questions: - How do I approve a private endpoint on my Video Analyzer account? - Can I reject a pending Video Analyzer private endpoint connection? instructions: - text: Approve private endpoint connection {name} on Video Analyzer account {accountName}. slots: name: path.name accountName: path.accountName - text: Update the connection state of Video Analyzer endpoint {name}. slots: name: path.name method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Media/videoAnalyzers/{accountName}/privateEndpointConnections/{name}'].delete update: x-apievangelist-phrasing: intent: Delete a Video Analyzer private endpoint connection effect: destructive questions: - How do I remove a private endpoint connection from Video Analyzer? - Can I cut off a private endpoint's access to my Video Analyzer? instructions: - text: Delete private endpoint connection {name} from Video Analyzer account {accountName}. slots: name: path.name accountName: path.accountName - text: Remove Video Analyzer endpoint connection {name}. slots: name: path.name method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Media/videoAnalyzers/{accountName}/privateEndpointConnections/{name}/operationStatuses/{operationId}'].get update: x-apievangelist-phrasing: intent: Get status of a private endpoint connection operation effect: read questions: - Is my Video Analyzer private endpoint change still in progress? - Can I poll the status of a private endpoint connection operation? instructions: - text: Get the status of operation {operationId} on private endpoint connection {name} of account {accountName}. slots: operationId: path.operationId name: path.name accountName: path.accountName - text: Poll private endpoint operation {operationId} for connection {name}. slots: operationId: path.operationId name: path.name method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Media/videoAnalyzers/{accountName}/privateEndpointConnections/{name}/operationResults/{operationId}'].get update: x-apievangelist-phrasing: intent: Get result of a private endpoint connection operation effect: read questions: - What was the outcome of a Video Analyzer private endpoint operation? - Can I fetch the final result of a completed endpoint connection change? instructions: - text: Get the result of operation {operationId} on private endpoint connection {name} of account {accountName}. slots: operationId: path.operationId name: path.name accountName: path.accountName - text: Fetch the finished connection returned by endpoint operation {operationId}. slots: operationId: path.operationId method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.Media/locations/{locationName}/videoAnalyzerOperationStatuses/{operationId}'].get update: x-apievangelist-phrasing: intent: Get status of a Video Analyzer operation effect: read questions: - Is my long-running Video Analyzer account operation finished? - Can I poll a Video Analyzer operation status by region? instructions: - text: Get Video Analyzer operation status {operationId} in {locationName}. slots: operationId: path.operationId locationName: path.locationName - text: Poll account-level Video Analyzer operation {operationId}. slots: operationId: path.operationId method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.Media/locations/{locationName}/videoAnalyzerOperationResults/{operationId}'].get update: x-apievangelist-phrasing: intent: Get result of a Video Analyzer operation effect: read questions: - What did a completed Video Analyzer account operation return? - Can I fetch the outcome of a Video Analyzer operation in a region? instructions: - text: Get Video Analyzer operation result {operationId} in {locationName}. slots: operationId: path.operationId locationName: path.locationName - text: Fetch the final account returned by Video Analyzer operation {operationId}. slots: operationId: path.operationId method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.Media/locations/{locationName}/checkNameAvailability'].post update: x-apievangelist-phrasing: intent: Check a Video Analyzer name is available effect: read questions: - Is my Video Analyzer account name available in a region? - Can I check a Video Analyzer name before creating the account? instructions: - text: Check whether a Video Analyzer name is available in {locationName}. slots: locationName: path.locationName - text: Verify my Video Analyzer account name is unused in region {locationName}. slots: locationName: path.locationName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.Media/videoAnalyzers'].get update: x-apievangelist-phrasing: intent: List Video Analyzer accounts in a subscription effect: read questions: - Which Video Analyzer accounts exist across my whole subscription? - Can I see every Azure Video Analyzer account I own without picking a resource group? instructions: - text: List all my Video Analyzer accounts in this subscription. - text: Show every Video Analyzer account the subscription contains. method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Media/videoAnalyzers/{accountName}/videos'].get update: x-apievangelist-phrasing: intent: List videos in a Video Analyzer account effect: read questions: - What video resources have been created in my Video Analyzer account? - Can I cap how many videos come back when listing an analyzer account's videos? instructions: - text: List the videos in Video Analyzer account {account}. slots: account: path.accountName - text: Show the first {top} videos stored in analyzer account {account}. slots: top: query.$top account: path.accountName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Media/videoAnalyzers/{accountName}/videos/{videoName}'].get update: x-apievangelist-phrasing: intent: Get a video resource effect: read questions: - How can I look up the details of one video in my Video Analyzer account? - What does a single video resource's JSON representation contain? instructions: - text: Get video {video} from Video Analyzer account {account}. slots: video: path.videoName account: path.accountName - text: Show me the properties of the video named {video} in {account}. slots: video: path.videoName account: path.accountName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Media/videoAnalyzers/{accountName}/videos/{videoName}'].put update: x-apievangelist-phrasing: intent: Create or replace a video resource effect: write questions: - How do I create a new video resource in a Video Analyzer account? - Can one call both create a video and overwrite an existing one with the same name? instructions: - text: Create a video named {video} in Video Analyzer account {account}. slots: video: path.videoName account: path.accountName - text: Create or overwrite video {video} in {account} with properties {properties}. slots: video: path.videoName account: path.accountName properties: requestBody.properties method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Media/videoAnalyzers/{accountName}/videos/{videoName}'].delete update: x-apievangelist-phrasing: intent: Delete a video and its underlying data effect: destructive questions: - Is deleting a Video Analyzer video reversible, or is its recorded data gone for good? - Can I remove a video resource together with all the media stored behind it? instructions: - text: Delete video {video} and its data from Video Analyzer account {account}. slots: video: path.videoName account: path.accountName - text: Permanently remove the video {video} in {account}. slots: video: path.videoName account: path.accountName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Media/videoAnalyzers/{accountName}/videos/{videoName}'].patch update: x-apievangelist-phrasing: intent: Update properties of an existing video effect: write questions: - Can I change just a few properties of a video without resending the whole resource? - What's the way to patch the title or description of an existing analyzer video? instructions: - text: Patch video {video} in Video Analyzer account {account} with {properties}. slots: video: path.videoName account: path.accountName properties: requestBody.properties - text: Update only the changed fields of existing video {video} in {account}. slots: video: path.videoName account: path.accountName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Media/videoAnalyzers/{accountName}/videos/{videoName}/listContentToken'].post update: x-apievangelist-phrasing: intent: Generate a streaming token for video content effect: read questions: - How do I get a token to stream content from a video's content URLs? - Which call gives me an access token for playing back a Video Analyzer recording? instructions: - text: Generate a streaming content token for video {video} in account {account}. slots: video: path.videoName account: path.accountName - text: Get a playback token so I can access content URLs of {video}. slots: video: path.videoName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Media/videoAnalyzers/{accountName}/accessPolicies'].get update: x-apievangelist-phrasing: intent: List access policies in a Video Analyzer account effect: read questions: - What access policies are defined on my Video Analyzer account? - Can I limit the number of access policies returned for an analyzer account? instructions: - text: List the access policies on Video Analyzer account {account}. slots: account: path.accountName - text: Show the first {top} access policies in {account}. slots: top: query.$top account: path.accountName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Media/videoAnalyzers/{accountName}/accessPolicies/{accessPolicyName}'].get update: x-apievangelist-phrasing: intent: Get a Video Analyzer access policy effect: read questions: - Where can I see how one specific access policy on my analyzer account is configured? - What role and authentication settings does a named access policy hold? instructions: - text: Get access policy {policy} from Video Analyzer account {account}. slots: policy: path.accessPolicyName account: path.accountName - text: Show the configuration of access policy {policy} in {account}. slots: policy: path.accessPolicyName account: path.accountName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Media/videoAnalyzers/{accountName}/accessPolicies/{accessPolicyName}'].put update: x-apievangelist-phrasing: intent: Create or replace an access policy effect: write questions: - How can I add a new access policy to a Video Analyzer account? - Can I overwrite an existing analyzer access policy by recreating it with the same name? instructions: - text: Create access policy {policy} on Video Analyzer account {account}. slots: policy: path.accessPolicyName account: path.accountName - text: Create or replace access policy {policy} in {account} using {properties}. slots: policy: path.accessPolicyName account: path.accountName properties: requestBody.properties method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Media/videoAnalyzers/{accountName}/accessPolicies/{accessPolicyName}'].delete update: x-apievangelist-phrasing: intent: Delete a Video Analyzer access policy effect: destructive questions: - Can I remove an access policy I no longer need from my analyzer account? - What happens when I delete a Video Analyzer access policy by name? instructions: - text: Delete access policy {policy} from Video Analyzer account {account}. slots: policy: path.accessPolicyName account: path.accountName - text: Remove the {policy} access policy on {account}. slots: policy: path.accessPolicyName account: path.accountName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Media/videoAnalyzers/{accountName}/accessPolicies/{accessPolicyName}'].patch update: x-apievangelist-phrasing: intent: Update fields of an existing access policy effect: write questions: - Can I tweak one setting on an existing access policy without replacing it? - Which call partially updates a Video Analyzer access policy? instructions: - text: Patch access policy {policy} in account {account} with {properties}. slots: policy: path.accessPolicyName account: path.accountName properties: requestBody.properties - text: Update just the changed properties of access policy {policy} in {account}. slots: policy: path.accessPolicyName account: path.accountName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.AnalysisServices/skus'].get update: x-apievangelist-phrasing: intent: List SKUs available for new Analysis Services servers effect: read questions: - Which SKUs can I choose from when creating a new Analysis Services server? - What pricing tiers are eligible for Analysis Services in my subscription? instructions: - text: List eligible Analysis Services SKUs for subscription {subscription}. slots: subscription: path.subscriptionId - text: Show the SKUs I can use for a new Analysis Services server in {subscription}. slots: subscription: path.subscriptionId method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AzureDataTransfer/connections/{connectionName}/flows/{flowName}'].get update: x-apievangelist-phrasing: intent: Get a data transfer flow effect: read questions: - How do I check the settings and status of one flow on a Data Transfer connection? - What does a single Azure Data Transfer flow resource contain? instructions: - text: Get flow {flow} on Data Transfer connection {connection}. slots: flow: path.flowName connection: path.connectionName - text: Show the details of the {flow} flow in connection {connection}. slots: flow: path.flowName connection: path.connectionName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AzureDataTransfer/connections/{connectionName}/flows/{flowName}'].put update: x-apievangelist-phrasing: intent: Create or update a data transfer flow effect: write questions: - Can I set up a new flow on an existing Data Transfer connection? - Which call lets me attach a managed identity or plan when creating a transfer flow? instructions: - text: Create flow {flow} on Data Transfer connection {connection}. slots: flow: path.flowName connection: path.connectionName - text: Create or update flow {flow} in {connection} with properties {properties}. slots: flow: path.flowName connection: path.connectionName properties: requestBody.properties method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AzureDataTransfer/connections/{connectionName}/flows/{flowName}'].delete update: x-apievangelist-phrasing: intent: Delete a data transfer flow effect: destructive questions: - Can I delete a flow from a Data Transfer connection without deleting the connection? - What removes a single data transfer flow resource? instructions: - text: Delete flow {flow} from Data Transfer connection {connection}. slots: flow: path.flowName connection: path.connectionName - text: Remove the transfer flow {flow} under {connection}. slots: flow: path.flowName connection: path.connectionName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AzureDataTransfer/connections/{connectionName}/flows/{flowName}'].patch update: x-apievangelist-phrasing: intent: Update tags or identity on a transfer flow effect: write questions: - Can I change the tags on a data transfer flow after it's created? - Is it possible to update a flow's managed identity without recreating it? instructions: - text: Update the tags on flow {flow} in connection {connection} to {tags}. slots: flow: path.flowName connection: path.connectionName tags: requestBody.tags - text: Patch the identity of transfer flow {flow} on {connection}. slots: flow: path.flowName connection: path.connectionName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AzureDataTransfer/connections/{connectionName}/flows/{flowName}/enable'].post update: x-apievangelist-phrasing: intent: Enable a data transfer flow effect: write questions: - How do I turn a disabled data transfer flow back on? - Can I resume moving data through a flow I paused earlier? instructions: - text: Enable flow {flow} on Data Transfer connection {connection}. slots: flow: path.flowName connection: path.connectionName - text: Turn on the {flow} transfer flow in {connection}. slots: flow: path.flowName connection: path.connectionName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AzureDataTransfer/connections/{connectionName}/flows/{flowName}/disable'].post update: x-apievangelist-phrasing: intent: Disable a data transfer flow effect: write questions: - Can I pause a data transfer flow without deleting it? - What stops data from moving through a specific transfer flow? instructions: - text: Disable flow {flow} on Data Transfer connection {connection}. slots: flow: path.flowName connection: path.connectionName - text: Pause the {flow} transfer flow in {connection} by disabling it. slots: flow: path.flowName connection: path.connectionName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AzureDataTransfer/connections/{connectionName}/flows/{flowName}/link'].post update: x-apievangelist-phrasing: intent: Link a data transfer flow to its pending peer effect: write questions: - How do I link a transfer flow to the pending flow on the other side? - Can I record a status reason when linking a data transfer flow? instructions: - text: Link flow {flow} on connection {connection} to pending flow {pending_id}. slots: flow: path.flowName connection: path.connectionName pending_id: requestBody.id - text: Link transfer flow {flow} in {connection} to {pending_id} with reason {reason}. slots: flow: path.flowName connection: path.connectionName pending_id: requestBody.id reason: requestBody.statusReason method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AzureDataTransfer/connections/{connectionName}/flows'].get update: x-apievangelist-phrasing: intent: List flows in a data transfer connection effect: read questions: - What flows are configured on my Data Transfer connection? - Can I see every flow running under one transfer connection? instructions: - text: List the flows on Data Transfer connection {connection}. slots: connection: path.connectionName - text: Show all transfer flows belonging to connection {connection}. slots: connection: path.connectionName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AzureDataTransfer/connections/{connectionName}'].get update: x-apievangelist-phrasing: intent: Get a data transfer connection effect: read questions: - How can I inspect a single Data Transfer connection's properties? - What state is my Azure Data Transfer connection in right now? instructions: - text: Get Data Transfer connection {connection}. slots: connection: path.connectionName - text: Show the details and status of transfer connection {connection}. slots: connection: path.connectionName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AzureDataTransfer/connections/{connectionName}'].put update: x-apievangelist-phrasing: intent: Create or update a data transfer connection effect: write questions: - How do I create a new Data Transfer connection in a resource group? - Can I overwrite a transfer connection's properties by recreating it? instructions: - text: Create Data Transfer connection {connection}. slots: connection: path.connectionName - text: Create or update transfer connection {connection} with properties {properties}. slots: connection: path.connectionName properties: requestBody.properties method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AzureDataTransfer/connections/{connectionName}'].delete update: x-apievangelist-phrasing: intent: Delete a data transfer connection effect: destructive questions: - Can I delete a Data Transfer connection I no longer use? - What removes a transfer connection resource from my resource group? instructions: - text: Delete Data Transfer connection {connection}. slots: connection: path.connectionName - text: Remove the transfer connection named {connection}. slots: connection: path.connectionName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AzureDataTransfer/connections/{connectionName}'].patch update: x-apievangelist-phrasing: intent: Update tags on a data transfer connection effect: write questions: - Can I retag a Data Transfer connection without touching its configuration? - Which call only changes a transfer connection's tags? instructions: - text: Set the tags on Data Transfer connection {connection} to {tags}. slots: connection: path.connectionName tags: requestBody.tags - text: Update tags for transfer connection {connection}. slots: connection: path.connectionName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AzureDataTransfer/connections/{connectionName}/link'].post update: x-apievangelist-phrasing: intent: Link a connection to its pending connection effect: write questions: - How do I pair my Data Transfer connection with the pending connection on the other side? - Can I give a status reason when linking two transfer connections? instructions: - text: Link Data Transfer connection {connection} to pending connection {pending_id}. slots: connection: path.connectionName pending_id: requestBody.id - text: Link connection {connection} to {pending_id} noting reason {reason}. slots: connection: path.connectionName pending_id: requestBody.id reason: requestBody.statusReason method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AzureDataTransfer/connections/{connectionName}/listPendingConnections'].post update: x-apievangelist-phrasing: intent: List pending connections for a connection effect: read questions: - Which pending connections are waiting to be linked to my transfer connection? - Can I see connections on the other side that haven't been linked yet? instructions: - text: List pending connections for Data Transfer connection {connection}. slots: connection: path.connectionName - text: Show the not-yet-linked connections waiting on {connection}. slots: connection: path.connectionName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AzureDataTransfer/connections/{connectionName}/listPendingFlows'].post update: x-apievangelist-phrasing: intent: List pending flows for a connection effect: read questions: - What pending flows are waiting to be linked on my transfer connection? - Is there a way to see flows that exist on the other side but aren't linked yet? instructions: - text: List pending flows for Data Transfer connection {connection}. slots: connection: path.connectionName - text: Show unlinked flows waiting on transfer connection {connection}. slots: connection: path.connectionName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AzureDataTransfer/connections'].get update: x-apievangelist-phrasing: intent: List data transfer connections in a resource group effect: read questions: - What Data Transfer connections live in one of my resource groups? - Can I scope the list of transfer connections to a single resource group? instructions: - text: List the Data Transfer connections in my resource group. - text: Show transfer connections scoped to this resource group only. method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.AzureDataTransfer/connections'].get update: x-apievangelist-phrasing: intent: List data transfer connections in a subscription effect: read questions: - Which Data Transfer connections exist anywhere in my subscription? - Can I get every transfer connection across all resource groups at once? instructions: - text: List all Data Transfer connections across my subscription. - text: Show every transfer connection in the subscription regardless of resource group. method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AzureDataTransfer/pipelines/{pipelineName}'].get update: x-apievangelist-phrasing: intent: Get a data transfer pipeline effect: read questions: - How do I view the configuration of one Data Transfer pipeline? - What connections and settings does a given transfer pipeline have? instructions: - text: Get Data Transfer pipeline {pipeline}. slots: pipeline: path.pipelineName - text: Show the details of transfer pipeline {pipeline}. slots: pipeline: path.pipelineName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AzureDataTransfer/pipelines/{pipelineName}'].put update: x-apievangelist-phrasing: intent: Create or update a data transfer pipeline effect: write questions: - Can I create a new Data Transfer pipeline to broker cross-boundary transfers? - Which call creates a transfer pipeline or replaces its properties? instructions: - text: Create Data Transfer pipeline {pipeline}. slots: pipeline: path.pipelineName - text: Create or update transfer pipeline {pipeline} with properties {properties}. slots: pipeline: path.pipelineName properties: requestBody.properties method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AzureDataTransfer/pipelines/{pipelineName}'].delete update: x-apievangelist-phrasing: intent: Delete a data transfer pipeline effect: destructive questions: - Can I delete a Data Transfer pipeline that's no longer needed? - What removes a transfer pipeline resource entirely? instructions: - text: Delete Data Transfer pipeline {pipeline}. slots: pipeline: path.pipelineName - text: Remove the transfer pipeline named {pipeline}. slots: pipeline: path.pipelineName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AzureDataTransfer/pipelines/{pipelineName}'].patch update: x-apievangelist-phrasing: intent: Update a data transfer pipeline effect: write questions: - Can I change a transfer pipeline's properties or tags without recreating it? - Which call patches an existing Data Transfer pipeline? instructions: - text: Patch Data Transfer pipeline {pipeline} with properties {properties}. slots: pipeline: path.pipelineName properties: requestBody.properties - text: Set the tags on transfer pipeline {pipeline} to {tags}. slots: pipeline: path.pipelineName tags: requestBody.tags method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AzureDataTransfer/pipelines/{pipelineName}/approveConnection'].post update: x-apievangelist-phrasing: intent: Approve a connection in a transfer pipeline effect: write questions: - How do I approve a connection that's requesting to join my transfer pipeline? - Can I leave a status reason when approving a pipeline connection? instructions: - text: Approve connection {connection_id} in Data Transfer pipeline {pipeline}. slots: connection_id: requestBody.id pipeline: path.pipelineName - text: Approve {connection_id} on pipeline {pipeline} with reason {reason}. slots: connection_id: requestBody.id pipeline: path.pipelineName reason: requestBody.statusReason method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AzureDataTransfer/pipelines/{pipelineName}/rejectConnection'].post update: x-apievangelist-phrasing: intent: Reject a connection in a transfer pipeline effect: write questions: - Can I reject a connection request on my Data Transfer pipeline? - Is there a way to record why I turned down a pipeline connection? instructions: - text: Reject connection {connection_id} in Data Transfer pipeline {pipeline}. slots: connection_id: requestBody.id pipeline: path.pipelineName - text: Reject {connection_id} on pipeline {pipeline} giving reason {reason}. slots: connection_id: requestBody.id pipeline: path.pipelineName reason: requestBody.statusReason method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AzureDataTransfer/pipelines/{pipelineName}/listSchemas'].post update: x-apievangelist-phrasing: intent: List schemas for a connection in a pipeline effect: read questions: - What schemas are registered for a connection inside my transfer pipeline? - Can I filter a pipeline's schemas down to one connection? instructions: - text: List the schemas in Data Transfer pipeline {pipeline}. slots: pipeline: path.pipelineName - text: Show schemas for connection {connection_id} in pipeline {pipeline}. slots: connection_id: requestBody.connectionId pipeline: path.pipelineName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AzureDataTransfer/pipelines'].get update: x-apievangelist-phrasing: intent: List data transfer pipelines in a resource group effect: read questions: - What Data Transfer pipelines are in one of my resource groups? - Can I list transfer pipelines limited to a single resource group? instructions: - text: List the Data Transfer pipelines in my resource group. - text: Show transfer pipelines scoped to this resource group. method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.AzureDataTransfer/pipelines'].get update: x-apievangelist-phrasing: intent: List data transfer pipelines in a subscription effect: read questions: - Which Data Transfer pipelines exist across my entire subscription? - Can I see every transfer pipeline without choosing a resource group? instructions: - text: List all Data Transfer pipelines in my subscription. - text: Show every transfer pipeline across the subscription. method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AzureStackHCI/clusters/{clusterName}/updates/{updateName}/apply'].post update: x-apievangelist-phrasing: intent: Apply an update to an Azure Stack HCI cluster effect: write questions: - How do I install an available update on my Azure Stack HCI cluster? - Can I kick off a specific named update on an HCI cluster? instructions: - text: Apply update {update} to Stack HCI cluster {cluster}. slots: update: path.updateName cluster: path.clusterName - text: Start installing the {update} update on HCI cluster {cluster}. slots: update: path.updateName cluster: path.clusterName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AzureStackHCI/clusters/{clusterName}/updates'].get update: x-apievangelist-phrasing: intent: List updates for an Azure Stack HCI cluster effect: read questions: - What updates are available or installed for my Stack HCI cluster? - Can I see every update known to an HCI cluster? instructions: - text: List all updates for Stack HCI cluster {cluster}. slots: cluster: path.clusterName - text: Show the updates available to HCI cluster {cluster}. slots: cluster: path.clusterName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AzureStackHCI/clusters/{clusterName}/updates/{updateName}'].get update: x-apievangelist-phrasing: intent: Get an Azure Stack HCI cluster update effect: read questions: - How can I check the state of one specific update on my HCI cluster? - What details does a single Stack HCI update record hold? instructions: - text: Get update {update} for Stack HCI cluster {cluster}. slots: update: path.updateName cluster: path.clusterName - text: Show the status of the {update} update on HCI cluster {cluster}. slots: update: path.updateName cluster: path.clusterName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AzureStackHCI/clusters/{clusterName}/updates/{updateName}'].put update: x-apievangelist-phrasing: intent: Create or replace an HCI cluster update record effect: write questions: - Can I put an update resource with a location and properties onto an HCI cluster? - Which call writes a named update definition for a Stack HCI cluster? instructions: - text: Put update {update} on Stack HCI cluster {cluster}. slots: update: path.updateName cluster: path.clusterName - text: Create update record {update} for HCI cluster {cluster} in location {location}. slots: update: path.updateName cluster: path.clusterName location: requestBody.location method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AzureStackHCI/clusters/{clusterName}/updates/{updateName}'].delete update: x-apievangelist-phrasing: intent: Delete an HCI cluster update record effect: destructive questions: - Can I delete an update resource from my Stack HCI cluster? - What removes a named update entry on an HCI cluster? instructions: - text: Delete update {update} from Stack HCI cluster {cluster}. slots: update: path.updateName cluster: path.clusterName - text: Remove the {update} update record on HCI cluster {cluster}. slots: update: path.updateName cluster: path.clusterName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.BareMetalInfrastructure/bareMetalInstances/{azureBareMetalInstanceName}/start'].post update: x-apievangelist-phrasing: intent: Start a BareMetal instance effect: write questions: - How do I power on an AzureBareMetal instance? - Can I start a stopped BareMetal server through the API? instructions: - text: Start BareMetal instance {instance}. slots: instance: path.azureBareMetalInstanceName - text: Power on the AzureBareMetal server {instance}. slots: instance: path.azureBareMetalInstanceName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.BareMetalInfrastructure/bareMetalInstances/{azureBareMetalInstanceName}/restart'].post update: x-apievangelist-phrasing: intent: Restart a BareMetal instance effect: write questions: - Can I reboot an AzureBareMetal instance remotely? - What call restarts a BareMetal server that's already running? instructions: - text: Restart BareMetal instance {instance}. slots: instance: path.azureBareMetalInstanceName - text: Reboot the AzureBareMetal server {instance}. slots: instance: path.azureBareMetalInstanceName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.BareMetalInfrastructure/bareMetalInstances/{azureBareMetalInstanceName}/shutdown'].post update: x-apievangelist-phrasing: intent: Shut down a BareMetal instance effect: write questions: - How can I shut down an AzureBareMetal instance? - Is there an API to power off a BareMetal server gracefully? instructions: - text: Shut down BareMetal instance {instance}. slots: instance: path.azureBareMetalInstanceName - text: Power off the AzureBareMetal server {instance}. slots: instance: path.azureBareMetalInstanceName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.BareMetalInfrastructure/bareMetalInstances'].get update: x-apievangelist-phrasing: intent: List BareMetal instances in a resource group effect: read questions: - Which AzureBareMetal instances are in my resource group? - Can I see all my BareMetal servers for one resource group? instructions: - text: List the BareMetal instances in my resource group. - text: Show every AzureBareMetal server in this resource group. method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.Batch/locations/{locationName}/checkNameAvailability'].post update: x-apievangelist-phrasing: intent: Check if a Batch account name is available effect: read questions: - Is a particular Batch account name still free in a given region? - How do I find out whether I can use a name for a new Batch account? instructions: - text: Check whether Batch account name {name} is available in {region} for subscription {subscription}. slots: name: requestBody.name region: path.locationName subscription: path.subscriptionId - text: See if {name} of type {type} can be used as a Batch account name in {region} under {subscription}. slots: name: requestBody.name type: requestBody.type region: path.locationName subscription: path.subscriptionId method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Batch/batchAccounts/{accountName}/detectors'].get update: x-apievangelist-phrasing: intent: List diagnostic detectors for a Batch account effect: read questions: - What diagnostic detectors can I run against my Batch account? - Which detectors are available to troubleshoot a Batch account? instructions: - text: List detectors for Batch account {account} in resource group {rg} of subscription {subscription}. slots: account: path.accountName rg: path.resourceGroupName subscription: path.subscriptionId - text: Show the diagnostic detectors available on Batch account {account} in {rg} ({subscription}). slots: account: path.accountName rg: path.resourceGroupName subscription: path.subscriptionId method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Batch/batchAccounts/{accountName}/detectors/{detectorId}'].get update: x-apievangelist-phrasing: intent: Get a Batch account detector effect: read questions: - How do I read the details of one diagnostic detector on my Batch account? - What does a specific Batch detector report? instructions: - text: Get detector {detector} for Batch account {account} in {rg} of subscription {subscription}. slots: detector: path.detectorId account: path.accountName rg: path.resourceGroupName subscription: path.subscriptionId - text: Show what detector {detector} says about Batch account {account} in {rg} under {subscription}. slots: detector: path.detectorId account: path.accountName rg: path.resourceGroupName subscription: path.subscriptionId method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.PolicyInsights/checkPolicyRestrictions'].post update: x-apievangelist-phrasing: intent: Check Azure Policy restrictions at subscription scope effect: read questions: - What restrictions will Azure Policy put on a resource I plan to create in my subscription? - Can I preview which field values policy would deny before deploying at subscription level? instructions: - text: Check subscription-level policy restrictions for resource {resource}. slots: resource: requestBody.resourceDetails - text: Show what policy allows for {resource} in this subscription, including pending fields {fields}. slots: resource: requestBody.resourceDetails fields: requestBody.pendingFields method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.PolicyInsights/checkPolicyRestrictions'].post update: x-apievangelist-phrasing: intent: Check Azure Policy restrictions in a resource group effect: read questions: - Which policy restrictions apply to a resource I'm about to create in a specific resource group? - Can I evaluate policy limits scoped to one resource group rather than the whole subscription? instructions: - text: Check resource-group policy restrictions for resource {resource}. slots: resource: requestBody.resourceDetails - text: Preview resource group policy limits on {resource} with pending fields {fields}. slots: resource: requestBody.resourceDetails fields: requestBody.pendingFields method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.PolicyInsights/componentPolicyStates/{componentPolicyStatesResource}/queryResults'].post update: x-apievangelist-phrasing: intent: Query component policy states for a subscription effect: read questions: - What component-level policy compliance states exist across my subscription? - Can I filter subscription component policy states by time window and OData filter? instructions: - text: Query {resource} component policy states for subscription {subscription}. slots: resource: path.componentPolicyStatesResource subscription: path.subscriptionId - text: Query {resource} component policy states in {subscription} filtered by {filter}. slots: resource: path.componentPolicyStatesResource subscription: path.subscriptionId filter: query.$filter method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.PolicyInsights/componentPolicyStates/{componentPolicyStatesResource}/queryResults'].post update: x-apievangelist-phrasing: intent: Query component policy states for a resource group effect: read questions: - Which component policy states apply to resources in one resource group? - Can I get the top N non-compliant components in a single resource group? instructions: - text: Query {resource} component policy states for resource group {rg} in {subscription}. slots: resource: path.componentPolicyStatesResource rg: path.resourceGroupName subscription: path.subscriptionId - text: Get the top {top} component policy states in resource group {rg} of {subscription} as {resource}. slots: top: query.$top rg: path.resourceGroupName subscription: path.subscriptionId resource: path.componentPolicyStatesResource method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/providers/{authorizationNamespace}/policyDefinitions/{policyDefinitionName}/providers/Microsoft.PolicyInsights/componentPolicyStates/{componentPolicyStatesResource}/queryResults'].post update: x-apievangelist-phrasing: intent: Query component policy states for a policy definition effect: read questions: - What component compliance states does one subscription-level policy definition produce? - Can I see component policy states tied to a single policy definition? instructions: - text: Query {resource} component states for policy definition {definition} in namespace {namespace}, subscription {subscription}. slots: resource: path.componentPolicyStatesResource definition: path.policyDefinitionName namespace: path.authorizationNamespace subscription: path.subscriptionId - text: Show component policy states for definition {definition} ({namespace}) in {subscription} as {resource}. slots: definition: path.policyDefinitionName namespace: path.authorizationNamespace subscription: path.subscriptionId resource: path.componentPolicyStatesResource method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/providers/{authorizationNamespace}/policyAssignments/{policyAssignmentName}/providers/Microsoft.PolicyInsights/componentPolicyStates/{componentPolicyStatesResource}/queryResults'].post update: x-apievangelist-phrasing: intent: Query component states for a subscription policy assignment effect: read questions: - What component compliance results come from one policy assignment made at subscription level? - Can I query component policy states for a subscription-scoped assignment only? instructions: - text: Query {resource} component states for subscription assignment {assignment} in namespace {namespace}, subscription {subscription}. slots: resource: path.componentPolicyStatesResource assignment: path.policyAssignmentName namespace: path.authorizationNamespace subscription: path.subscriptionId - text: Show component policy states for subscription-level assignment {assignment} ({namespace}) in {subscription} as {resource}. slots: assignment: path.policyAssignmentName namespace: path.authorizationNamespace subscription: path.subscriptionId resource: path.componentPolicyStatesResource method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{authorizationNamespace}/policyAssignments/{policyAssignmentName}/providers/Microsoft.PolicyInsights/componentPolicyStates/{componentPolicyStatesResource}/queryResults'].post update: x-apievangelist-phrasing: intent: Query component states for a resource group assignment effect: read questions: - What component compliance states does a policy assigned to a resource group produce? - Can I narrow component policy state results to an assignment made in one resource group? instructions: - text: Query {resource} component states for resource-group assignment {assignment} ({namespace}) in {rg}, subscription {subscription}. slots: resource: path.componentPolicyStatesResource assignment: path.policyAssignmentName namespace: path.authorizationNamespace rg: path.resourceGroupName subscription: path.subscriptionId - text: Show component states for assignment {assignment} ({namespace}) scoped to resource group {rg} in {subscription}, as {resource}. slots: assignment: path.policyAssignmentName namespace: path.authorizationNamespace rg: path.resourceGroupName subscription: path.subscriptionId resource: path.componentPolicyStatesResource method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourcegroups/{resourceGroupName}/providers/Microsoft.Kubernetes/connectedClusters/{clusterName}'].get update: x-apievangelist-phrasing: intent: Get a connected Kubernetes cluster effect: read questions: - How do I view the identity and properties of an Arc-connected Kubernetes cluster? - What details does Azure keep about one of my connected clusters? instructions: - text: Get connected Kubernetes cluster {cluster}. slots: cluster: path.clusterName - text: Show the properties and identity of connected cluster {cluster}. slots: cluster: path.clusterName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourcegroups/{resourceGroupName}/providers/Microsoft.Kubernetes/connectedClusters/{clusterName}'].put update: x-apievangelist-phrasing: intent: Register a Kubernetes cluster with Azure Arc effect: write questions: - How do I register an existing Kubernetes cluster as a connected cluster in Azure Resource Manager? - Can I onboard a Kubernetes cluster to Arc with a managed identity? instructions: - text: Register Kubernetes cluster {cluster} as a connected cluster with identity {identity}. slots: cluster: path.clusterName identity: requestBody.identity - text: Create connected cluster {cluster} using properties {properties}. slots: cluster: path.clusterName properties: requestBody.properties method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourcegroups/{resourceGroupName}/providers/Microsoft.Kubernetes/connectedClusters/{clusterName}'].delete update: x-apievangelist-phrasing: intent: Delete a connected Kubernetes cluster effect: destructive questions: - Can I unregister a connected Kubernetes cluster from Azure Resource Manager? - What removes the tracked Arc resource for one of my clusters? instructions: - text: Delete connected cluster {cluster}. slots: cluster: path.clusterName - text: Unregister the connected Kubernetes cluster {cluster} from ARM. slots: cluster: path.clusterName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourcegroups/{resourceGroupName}/providers/Microsoft.Kubernetes/connectedClusters/{clusterName}'].patch update: x-apievangelist-phrasing: intent: Update a connected Kubernetes cluster effect: write questions: - Can I change the tags on an Arc-connected cluster without re-registering it? - Which properties of a connected cluster can I patch? instructions: - text: Update the tags on connected cluster {cluster} to {tags}. slots: cluster: path.clusterName tags: requestBody.tags - text: Patch connected Kubernetes cluster {cluster} with properties {properties}. slots: cluster: path.clusterName properties: requestBody.properties method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourcegroups/{resourceGroupName}/providers/Microsoft.Kubernetes/connectedClusters/{clusterName}/listClusterUserCredential'].post update: x-apievangelist-phrasing: intent: Get user credentials for a connected cluster effect: read questions: - How do I get a kubeconfig or user credentials for an Arc-connected cluster? - Can I fetch connected cluster credentials that go through the client proxy? instructions: - text: Get user credentials for connected cluster {cluster} using authentication method {method}. slots: cluster: path.clusterName method: requestBody.authenticationMethod - text: Fetch cluster user credentials for {cluster} with client proxy set to {proxy}. slots: cluster: path.clusterName proxy: requestBody.clientProxy method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourcegroups/{resourceGroupName}/providers/Microsoft.Kubernetes/connectedClusters'].get update: x-apievangelist-phrasing: intent: List connected clusters in a resource group effect: read questions: - Which Arc-connected Kubernetes clusters are registered in my resource group? - Can I list connected clusters for just one resource group? instructions: - text: List the connected Kubernetes clusters in my resource group. - text: Show Arc-registered clusters in this resource group. method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.Kubernetes/connectedClusters'].get update: x-apievangelist-phrasing: intent: List connected clusters in a subscription effect: read questions: - What connected Kubernetes clusters are registered anywhere in my subscription? - Can I enumerate every Arc cluster across all resource groups? instructions: - text: List all connected Kubernetes clusters in my subscription. - text: Show every Arc-registered cluster across the subscription. method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.ContainerInstance/containerGroups'].get update: x-apievangelist-phrasing: intent: List container groups in a subscription effect: read questions: - Which container groups are running across my whole subscription? - Can I see all Azure Container Instances groups without picking a resource group? instructions: - text: List all container groups in subscription {subscription}. slots: subscription: path.subscriptionId - text: Show every container instance group across {subscription}. slots: subscription: path.subscriptionId method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ContainerInstance/containerGroups'].get update: x-apievangelist-phrasing: intent: List container groups in a resource group effect: read questions: - What container groups exist in a particular resource group? - Can I list container instance groups scoped to one resource group? instructions: - text: List container groups in resource group {rg} of subscription {subscription}. slots: rg: path.resourceGroupName subscription: path.subscriptionId - text: Show the container instance groups inside {rg} under {subscription}. slots: rg: path.resourceGroupName subscription: path.subscriptionId method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ContainerInstance/containerGroups/{containerGroupName}'].get update: x-apievangelist-phrasing: intent: Get a container group effect: read questions: - How do I see the containers, IP and state of one container group? - What properties does a single container group return? instructions: - text: Get container group {group} in {rg} of subscription {subscription}. slots: group: path.containerGroupName rg: path.resourceGroupName subscription: path.subscriptionId - text: Show the configuration and status of container group {group} in {rg} ({subscription}). slots: group: path.containerGroupName rg: path.resourceGroupName subscription: path.subscriptionId method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ContainerInstance/containerGroups/{containerGroupName}'].put update: x-apievangelist-phrasing: intent: Create or update a container group effect: write questions: - How do I deploy a new container group with my own containers and settings? - Can I set availability zones and a managed identity when creating a container group? instructions: - text: Create container group {group} in {rg} of subscription {subscription} with properties {properties}. slots: group: path.containerGroupName rg: path.resourceGroupName subscription: path.subscriptionId properties: requestBody.properties - text: Deploy or update container group {group} in {rg} ({subscription}) at location {location}. slots: group: path.containerGroupName rg: path.resourceGroupName subscription: path.subscriptionId location: requestBody.location method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ContainerInstance/containerGroups/{containerGroupName}'].delete update: x-apievangelist-phrasing: intent: Delete a container group effect: destructive questions: - Can I delete a container group without deleting the storage or network it uses? - What tears down a container group and its containers? instructions: - text: Delete container group {group} in {rg} of subscription {subscription}. slots: group: path.containerGroupName rg: path.resourceGroupName subscription: path.subscriptionId - text: Remove the {group} container group from {rg} under {subscription}. slots: group: path.containerGroupName rg: path.resourceGroupName subscription: path.subscriptionId method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ContainerInstance/containerGroups/{containerGroupName}'].patch update: x-apievangelist-phrasing: intent: Update tags on a container group effect: write questions: - Can I change a container group's tags without redeploying it? - Which call updates only container group tags? instructions: - text: Set the tags on container group {group} in {rg} ({subscription}) to {tags}. slots: group: path.containerGroupName rg: path.resourceGroupName subscription: path.subscriptionId tags: requestBody.tags - text: Retag container group {group} in resource group {rg} of {subscription}. slots: group: path.containerGroupName rg: path.resourceGroupName subscription: path.subscriptionId method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ContainerInstance/containerGroups/{containerGroupName}/restart'].post update: x-apievangelist-phrasing: intent: Restart all containers in a container group effect: write questions: - How do I restart every container in a group and pick up updated images? - Can I restart a container group in place? instructions: - text: Restart container group {group} in {rg} of subscription {subscription}. slots: group: path.containerGroupName rg: path.resourceGroupName subscription: path.subscriptionId - text: Restart all containers in {group} ({rg}, {subscription}) in place. slots: group: path.containerGroupName rg: path.resourceGroupName subscription: path.subscriptionId method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ContainerInstance/containerGroups/{containerGroupName}/stop'].post update: x-apievangelist-phrasing: intent: Stop all containers in a container group effect: write questions: - Can I stop a container group so billing stops but the group isn't deleted? - What deallocates compute for every container in a group? instructions: - text: Stop container group {group} in {rg} of subscription {subscription}. slots: group: path.containerGroupName rg: path.resourceGroupName subscription: path.subscriptionId - text: Stop all containers in {group} ({rg}, {subscription}) to halt billing. slots: group: path.containerGroupName rg: path.resourceGroupName subscription: path.subscriptionId method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ContainerInstance/containerGroups/{containerGroupName}/start'].post update: x-apievangelist-phrasing: intent: Start all containers in a container group effect: write questions: - How do I start a stopped container group again? - Does starting a container group re-allocate compute and resume billing? instructions: - text: Start container group {group} in {rg} of subscription {subscription}. slots: group: path.containerGroupName rg: path.resourceGroupName subscription: path.subscriptionId - text: Start all containers in stopped group {group} ({rg}, {subscription}). slots: group: path.containerGroupName rg: path.resourceGroupName subscription: path.subscriptionId method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.ContainerInstance/locations/{location}/usages'].get update: x-apievangelist-phrasing: intent: Get container instance usage for a region effect: read questions: - How much of my Container Instances quota am I using in a region? - What are the current container usage counts and limits for a location? instructions: - text: Get Container Instances usage in {location} for subscription {subscription}. slots: location: path.location subscription: path.subscriptionId - text: Show container quota usage and limits in region {location} under {subscription}. slots: location: path.location subscription: path.subscriptionId method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ContainerInstance/containerGroups/{containerGroupName}/containers/{containerName}/logs'].get update: x-apievangelist-phrasing: intent: Get logs from a container instance effect: read questions: - How do I read the logs of one container inside a container group? - Can I fetch only the last few log lines with timestamps? instructions: - text: Get logs for container {container} in group {group}, resource group {rg}, subscription {subscription}. slots: container: path.containerName group: path.containerGroupName rg: path.resourceGroupName subscription: path.subscriptionId - text: Show the last {tail} log lines of container {container} in {group} ({rg}, {subscription}). slots: tail: query.tail container: path.containerName group: path.containerGroupName rg: path.resourceGroupName subscription: path.subscriptionId method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ContainerInstance/containerGroups/{containerGroupName}/containers/{containerName}/exec'].post update: x-apievangelist-phrasing: intent: Run a command inside a container instance effect: write questions: - Can I execute a shell command inside a running container instance? - How do I open an exec session with a specific terminal size in a container? instructions: - text: Execute {command} in container {container} of group {group}, resource group {rg}, subscription {subscription}. slots: command: requestBody.command container: path.containerName group: path.containerGroupName rg: path.resourceGroupName subscription: path.subscriptionId - text: Open an exec session in container {container} ({group}, {rg}, {subscription}). slots: container: path.containerName group: path.containerGroupName rg: path.resourceGroupName subscription: path.subscriptionId method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ContainerInstance/containerGroups/{containerGroupName}/containers/{containerName}/attach'].post update: x-apievangelist-phrasing: intent: Attach to a container instance's output effect: read questions: - Can I attach to the live output stream of a running container instance? - What gives me a connection to watch a container's stdout in real time? instructions: - text: Attach to the output of container {container} in group {group}, resource group {rg}, subscription {subscription}. slots: container: path.containerName group: path.containerGroupName rg: path.resourceGroupName subscription: path.subscriptionId - text: Stream live output from container {container} in {group} ({rg}, {subscription}). slots: container: path.containerName group: path.containerGroupName rg: path.resourceGroupName subscription: path.subscriptionId method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.ContainerInstance/locations/{location}/cachedImages'].get update: x-apievangelist-phrasing: intent: List cached container images in a region effect: read questions: - Which container images are cached in a region so my groups start faster? - What OS-specific images does Container Instances have cached for a location? instructions: - text: List cached container images in {location} for subscription {subscription}. slots: location: path.location subscription: path.subscriptionId - text: Show the pre-cached images in region {location} under {subscription}. slots: location: path.location subscription: path.subscriptionId method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.ContainerInstance/locations/{location}/capabilities'].get update: x-apievangelist-phrasing: intent: List container CPU, memory and GPU capabilities effect: read questions: - What CPU, memory and GPU sizes can a container group use in a given region? - Does a location support GPU containers? instructions: - text: List container capabilities in {location} for subscription {subscription}. slots: location: path.location subscription: path.subscriptionId - text: Show CPU, memory and GPU limits for containers in region {location} under {subscription}. slots: location: path.location subscription: path.subscriptionId method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ContainerInstance/containerGroups/{containerGroupName}/outboundNetworkDependenciesEndpoints'].get update: x-apievangelist-phrasing: intent: List outbound network dependencies of a container group effect: read questions: - Which outbound endpoints does my container group need so I can lock down the network? - What network dependencies should my firewall allow for a container group? instructions: - text: List outbound network dependencies for container group {group} in {rg} of subscription {subscription}. slots: group: path.containerGroupName rg: path.resourceGroupName subscription: path.subscriptionId - text: Show the endpoints container group {group} ({rg}, {subscription}) must reach outbound. slots: group: path.containerGroupName rg: path.resourceGroupName subscription: path.subscriptionId method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourcegroups/{resourceGroupName}/providers/Microsoft.Network/virtualNetworks/{virtualNetworkName}/subnets/{subnetName}/providers/Microsoft.ContainerInstance/serviceAssociationLinks/default'].delete update: x-apievangelist-phrasing: intent: Delete container group virtual network links effect: destructive questions: - How do I remove the container-instance service association link from a subnet? - Can I free a subnet that Container Instances still has linked without deleting the virtual network? instructions: - text: Delete the container instance association link on subnet {subnet} of network {vnet} in {rg}, subscription {subscription}. slots: subnet: path.subnetName vnet: path.virtualNetworkName rg: path.resourceGroupName subscription: path.subscriptionId - text: Unlink container groups from subnet {subnet} in virtual network {vnet} ({rg}, {subscription}). slots: subnet: path.subnetName vnet: path.virtualNetworkName rg: path.resourceGroupName subscription: path.subscriptionId method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.DocumentDB/cassandraClusters'].get update: x-apievangelist-phrasing: intent: List managed Cassandra clusters in a subscription effect: read questions: - Which managed Cassandra clusters do I have across the whole subscription? - Can I see all managed Apache Cassandra clusters without choosing a resource group? instructions: - text: List all managed Cassandra clusters in my subscription. - text: Show every managed Cassandra cluster across the subscription. method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DocumentDB/cassandraClusters'].get update: x-apievangelist-phrasing: intent: List managed Cassandra clusters in a resource group effect: read questions: - What managed Cassandra clusters live in one resource group? - Can I list Cassandra clusters for a single resource group? instructions: - text: List the managed Cassandra clusters in my resource group. - text: Show managed Cassandra clusters scoped to this resource group. method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DocumentDB/cassandraClusters/{clusterName}'].get update: x-apievangelist-phrasing: intent: Get a managed Cassandra cluster effect: read questions: - How do I look at the configuration of one managed Cassandra cluster? - What properties does a managed Cassandra cluster return? instructions: - text: Get managed Cassandra cluster {cluster}. slots: cluster: path.clusterName - text: Show the properties of Cassandra cluster {cluster}. slots: cluster: path.clusterName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DocumentDB/cassandraClusters/{clusterName}'].put update: x-apievangelist-phrasing: intent: Create or fully replace a managed Cassandra cluster effect: write questions: - How do I create a new managed Cassandra cluster? - When I update a Cassandra cluster this way, do I have to send every writable property? instructions: - text: Create managed Cassandra cluster {cluster} in {location}. slots: cluster: path.clusterName location: requestBody.location - text: Create or fully replace Cassandra cluster {cluster} with properties {properties}. slots: cluster: path.clusterName properties: requestBody.properties method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DocumentDB/cassandraClusters/{clusterName}'].delete update: x-apievangelist-phrasing: intent: Delete a managed Cassandra cluster effect: destructive questions: - Can I delete a managed Cassandra cluster I no longer need? - What permanently removes a managed Cassandra cluster? instructions: - text: Delete managed Cassandra cluster {cluster}. slots: cluster: path.clusterName - text: Remove the Cassandra cluster named {cluster}. slots: cluster: path.clusterName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DocumentDB/cassandraClusters/{clusterName}'].patch update: x-apievangelist-phrasing: intent: Update some properties of a Cassandra cluster effect: write questions: - Can I change just some properties of a managed Cassandra cluster? - Which call patches a Cassandra cluster's tags or identity? instructions: - text: Patch managed Cassandra cluster {cluster} with properties {properties}. slots: cluster: path.clusterName properties: requestBody.properties - text: Update the tags on Cassandra cluster {cluster} to {tags}. slots: cluster: path.clusterName tags: requestBody.tags method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DocumentDB/cassandraClusters/{clusterName}/invokeCommand'].post update: x-apievangelist-phrasing: intent: Run a nodetool command on a Cassandra host effect: write questions: - Can I run nodetool against a node in my managed Cassandra cluster and wait for the result? - How do I invoke a maintenance command synchronously on a Cassandra host? instructions: - text: Run {command} on host {host} of Cassandra cluster {cluster} and wait for output. slots: command: requestBody.command host: requestBody.host cluster: path.clusterName - text: Invoke {command} with arguments {arguments} on {host} in cluster {cluster} synchronously. slots: command: requestBody.command arguments: requestBody.arguments host: requestBody.host cluster: path.clusterName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DocumentDB/cassandraClusters/{clusterName}/invokeCommandAsync'].post update: x-apievangelist-phrasing: intent: Run a Cassandra maintenance command asynchronously effect: write questions: - Can I start a long nodetool command on a Cassandra host and check on it later? - Is there an asynchronous way to invoke Cassandra maintenance commands? instructions: - text: Start {command} asynchronously on host {host} of Cassandra cluster {cluster}. slots: command: requestBody.command host: requestBody.host cluster: path.clusterName - text: Queue async command {command} with arguments {arguments} on {host} in {cluster}. slots: command: requestBody.command arguments: requestBody.arguments host: requestBody.host cluster: path.clusterName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DocumentDB/cassandraClusters/{clusterName}/commands'].get update: x-apievangelist-phrasing: intent: List commands running on a Cassandra cluster effect: read questions: - Which commands are currently running on my Cassandra cluster? - Can I see the in-flight maintenance commands for a managed cluster? instructions: - text: List commands running on Cassandra cluster {cluster}. slots: cluster: path.clusterName - text: Show in-progress maintenance commands on {cluster}. slots: cluster: path.clusterName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DocumentDB/cassandraClusters/{clusterName}/commands/{commandId}'].get update: x-apievangelist-phrasing: intent: Get an async Cassandra command's result effect: read questions: - How do I check on a Cassandra command I started asynchronously? - What's the output of an async command by its ID? instructions: - text: Get async command {command_id} on Cassandra cluster {cluster}. slots: command_id: path.commandId cluster: path.clusterName - text: Show the status and output of command {command_id} in {cluster}. slots: command_id: path.commandId cluster: path.clusterName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DocumentDB/cassandraClusters/{clusterName}/backups'].get update: x-apievangelist-phrasing: intent: List restorable backups of a Cassandra cluster effect: read questions: - Which backups of my managed Cassandra cluster can I restore from? - Can I list the available restore points for a Cassandra cluster? instructions: - text: List restorable backups of Cassandra cluster {cluster}. slots: cluster: path.clusterName - text: Show backups available to restore for {cluster}. slots: cluster: path.clusterName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DocumentDB/cassandraClusters/{clusterName}/backups/{backupId}'].get update: x-apievangelist-phrasing: intent: Get a Cassandra cluster backup effect: read questions: - How do I see the details of one specific Cassandra backup? - When was a given Cassandra backup taken and is it restorable? instructions: - text: Get backup {backup} of Cassandra cluster {cluster}. slots: backup: path.backupId cluster: path.clusterName - text: Show the properties of backup {backup} for {cluster}. slots: backup: path.backupId cluster: path.clusterName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DocumentDB/cassandraClusters/{clusterName}/dataCenters'].get update: x-apievangelist-phrasing: intent: List data centers in a Cassandra cluster effect: read questions: - What data centers make up my managed Cassandra cluster? - Can I see every data center attached to one Cassandra cluster? instructions: - text: List the data centers in Cassandra cluster {cluster}. slots: cluster: path.clusterName - text: Show all data centers belonging to managed cluster {cluster}. slots: cluster: path.clusterName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DocumentDB/cassandraClusters/{clusterName}/dataCenters/{dataCenterName}'].get update: x-apievangelist-phrasing: intent: Get a Cassandra data center effect: read questions: - How do I view a single data center's configuration in my Cassandra cluster? - What settings does one Cassandra data center have? instructions: - text: Get data center {dc} in Cassandra cluster {cluster}. slots: dc: path.dataCenterName cluster: path.clusterName - text: Show the properties of Cassandra data center {dc} in {cluster}. slots: dc: path.dataCenterName cluster: path.clusterName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DocumentDB/cassandraClusters/{clusterName}/dataCenters/{dataCenterName}'].put update: x-apievangelist-phrasing: intent: Create or fully replace a Cassandra data center effect: write questions: - How do I add a new data center to a managed Cassandra cluster? - Does creating-or-updating a Cassandra data center overwrite all of its properties? instructions: - text: Add data center {dc} to Cassandra cluster {cluster}. slots: dc: path.dataCenterName cluster: path.clusterName - text: Create or fully replace data center {dc} in {cluster} with properties {properties}. slots: dc: path.dataCenterName cluster: path.clusterName properties: requestBody.properties method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DocumentDB/cassandraClusters/{clusterName}/dataCenters/{dataCenterName}'].delete update: x-apievangelist-phrasing: intent: Delete a Cassandra data center effect: destructive questions: - Can I remove one data center from a managed Cassandra cluster? - What deletes a Cassandra data center but leaves the cluster in place? instructions: - text: Delete data center {dc} from Cassandra cluster {cluster}. slots: dc: path.dataCenterName cluster: path.clusterName - text: Remove Cassandra data center {dc} in {cluster}. slots: dc: path.dataCenterName cluster: path.clusterName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DocumentDB/cassandraClusters/{clusterName}/dataCenters/{dataCenterName}'].patch update: x-apievangelist-phrasing: intent: Update some properties of a Cassandra data center effect: write questions: - Can I scale or tweak one Cassandra data center without resending all its settings? - Which call partially updates a data center in a managed cluster? instructions: - text: Patch data center {dc} in Cassandra cluster {cluster} with {properties}. slots: dc: path.dataCenterName cluster: path.clusterName properties: requestBody.properties - text: Update only changed settings of Cassandra data center {dc} in {cluster}. slots: dc: path.dataCenterName cluster: path.clusterName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DocumentDB/cassandraClusters/{clusterName}/deallocate'].post update: x-apievangelist-phrasing: intent: Deallocate a managed Cassandra cluster effect: write questions: - How can I deallocate my Cassandra cluster's host VMs to save cost? - Can I force a Cassandra cluster deallocation even if it's unhealthy? instructions: - text: Deallocate managed Cassandra cluster {cluster} and its data centers. slots: cluster: path.clusterName - text: Force-deallocate Cassandra cluster {cluster} with force flag {force}. slots: cluster: path.clusterName force: header.x-ms-force-deallocate method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DocumentDB/cassandraClusters/{clusterName}/start'].post update: x-apievangelist-phrasing: intent: Start a deallocated managed Cassandra cluster effect: write questions: - How do I bring a deallocated Cassandra cluster back online? - Does starting a managed Cassandra cluster also start its data centers' host VMs? instructions: - text: Start managed Cassandra cluster {cluster}. slots: cluster: path.clusterName - text: Power the host VMs of Cassandra cluster {cluster} back on. slots: cluster: path.clusterName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DocumentDB/cassandraClusters/{clusterName}/status'].get update: x-apievangelist-phrasing: intent: Get Cassandra node CPU, memory and disk usage effect: read questions: - What's the CPU, memory and disk usage on each node of my Cassandra cluster? - Can I check the health statistics of every Cassandra node at once? instructions: - text: Get node usage status for Cassandra cluster {cluster}. slots: cluster: path.clusterName - text: Show per-node CPU, memory and disk stats for {cluster}. slots: cluster: path.clusterName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.DocumentDB/throughputPools'].get update: x-apievangelist-phrasing: intent: List Cosmos DB throughput pools in a subscription effect: read questions: - Which Cosmos DB throughput pools exist in my subscription? - Can I list all shared throughput pools across resource groups? instructions: - text: List all Cosmos DB throughput pools in my subscription. - text: Show every throughput pool across the subscription. method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DocumentDB/throughputPools/{throughputPoolName}'].get update: x-apievangelist-phrasing: intent: Get a Cosmos DB throughput pool effect: read questions: - How do I view the configuration of a single Cosmos DB throughput pool? - What properties are set on one of my throughput pools? instructions: - text: Get Cosmos DB throughput pool {pool}. slots: pool: path.throughputPoolName - text: Show the properties of throughput pool {pool}. slots: pool: path.throughputPoolName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DocumentDB/throughputPools/{throughputPoolName}'].put update: x-apievangelist-phrasing: intent: Create or update a Cosmos DB throughput pool effect: write questions: - How do I create a throughput pool that Cosmos DB accounts can share? - Can I overwrite a throughput pool's full configuration in one call? instructions: - text: Create Cosmos DB throughput pool {pool}. slots: pool: path.throughputPoolName - text: Create or replace throughput pool {pool} with properties {properties}. slots: pool: path.throughputPoolName properties: requestBody.properties method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DocumentDB/throughputPools/{throughputPoolName}'].delete update: x-apievangelist-phrasing: intent: Delete a Cosmos DB throughput pool effect: destructive questions: - Can I delete a Cosmos DB throughput pool I no longer use? - What removes an entire throughput pool resource? instructions: - text: Delete Cosmos DB throughput pool {pool}. slots: pool: path.throughputPoolName - text: Remove the throughput pool named {pool}. slots: pool: path.throughputPoolName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DocumentDB/throughputPools/{throughputPoolName}'].patch update: x-apievangelist-phrasing: intent: Update a Cosmos DB throughput pool effect: write questions: - Can I adjust a throughput pool's properties without recreating it? - Which call is preferred for changing an existing throughput pool? instructions: - text: Patch Cosmos DB throughput pool {pool} with properties {properties}. slots: pool: path.throughputPoolName properties: requestBody.properties - text: Update just the changed settings on throughput pool {pool}. slots: pool: path.throughputPoolName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DocumentDB/throughputPools/{throughputPoolName}/throughputPoolAccounts'].get update: x-apievangelist-phrasing: intent: List accounts in a Cosmos DB throughput pool effect: read questions: - Which Cosmos DB accounts are drawing from a particular throughput pool? - Can I see every database account that belongs to one pool? instructions: - text: List the Cosmos DB accounts in throughput pool {pool}. slots: pool: path.throughputPoolName - text: Show member accounts of throughput pool {pool}. slots: pool: path.throughputPoolName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DocumentDB/throughputPools/{throughputPoolName}/throughputPoolAccounts/{throughputPoolAccountName}'].get update: x-apievangelist-phrasing: intent: Get an account's membership in a throughput pool effect: read questions: - How do I check one Cosmos DB account's membership in a throughput pool? - What details does a throughput pool keep for a member account? instructions: - text: Get pool account {pool_account} in throughput pool {pool}. slots: pool_account: path.throughputPoolAccountName pool: path.throughputPoolName - text: Show the membership record of {pool_account} in pool {pool}. slots: pool_account: path.throughputPoolAccountName pool: path.throughputPoolName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DocumentDB/throughputPools/{throughputPoolName}/throughputPoolAccounts/{throughputPoolAccountName}'].put update: x-apievangelist-phrasing: intent: Add a Cosmos DB account to a throughput pool effect: write questions: - How do I add a Cosmos DB account to a shared throughput pool? - Can I set properties on an account's pool membership when adding it? instructions: - text: Add Cosmos DB account {pool_account} to throughput pool {pool}. slots: pool_account: path.throughputPoolAccountName pool: path.throughputPoolName - text: Create pool membership {pool_account} in {pool} with properties {properties}. slots: pool_account: path.throughputPoolAccountName pool: path.throughputPoolName properties: requestBody.properties method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DocumentDB/throughputPools/{throughputPoolName}/throughputPoolAccounts/{throughputPoolAccountName}'].delete update: x-apievangelist-phrasing: intent: Remove a Cosmos DB account from a throughput pool effect: destructive questions: - Can I take a Cosmos DB account out of a throughput pool without deleting the pool? - What detaches a database account from shared pool throughput? instructions: - text: Remove Cosmos DB account {pool_account} from throughput pool {pool}. slots: pool_account: path.throughputPoolAccountName pool: path.throughputPoolName - text: Detach {pool_account} from pool {pool}. slots: pool_account: path.throughputPoolAccountName pool: path.throughputPoolName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataBox/locations/{location}/availableSkus'].post update: x-apievangelist-phrasing: intent: List available Data Box SKUs for a location effect: read questions: - Which Data Box devices can I order for a given country and transfer type? - Are import or export Data Box SKUs available in my location? instructions: - text: List Data Box SKUs for {transfer_type} in {country}, location {location}, resource group {rg}, subscription {subscription}. slots: transfer_type: requestBody.transferType country: requestBody.country location: path.location rg: path.resourceGroupName subscription: path.subscriptionId - text: Show available Data Box devices at {location} for {rg} in {subscription}. slots: location: path.location rg: path.resourceGroupName subscription: path.subscriptionId method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.DataBox/locations/{location}/validateAddress'].post update: x-apievangelist-phrasing: intent: Validate a Data Box shipping address (deprecated) effect: read questions: - Can I validate a shipping address for a Data Box order using the older address check? - Is the deprecated Data Box address validation still usable? instructions: - text: Validate shipping address {address} for a {device} Data Box at {location} in {subscription} using the deprecated check. slots: address: requestBody.shippingAddress device: requestBody.deviceType location: path.location subscription: path.subscriptionId - text: Run the legacy address validation for {device} at {location}, subscription {subscription}. slots: device: requestBody.deviceType location: path.location subscription: path.subscriptionId method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataBox/locations/{location}/validateInputs'].post update: x-apievangelist-phrasing: intent: Validate Data Box order inputs in a resource group effect: read questions: - Can I pre-validate a Data Box job before creating it in a specific resource group? - What checks run on my Data Box order details at resource group scope? instructions: - text: Validate Data Box job inputs {details} at {location} for resource group {rg} in {subscription}. slots: details: requestBody.individualRequestDetails location: path.location rg: path.resourceGroupName subscription: path.subscriptionId - text: Run resource-group pre-job Data Box validation at {location}, {rg}, {subscription}. slots: location: path.location rg: path.resourceGroupName subscription: path.subscriptionId method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.DataBox/locations/{location}/validateInputs'].post update: x-apievangelist-phrasing: intent: Validate Data Box order inputs for a subscription effect: read questions: - How do I run all pre-order validation for a Data Box job at subscription level? - Will my Data Box job details pass validation before I place the order? instructions: - text: Validate Data Box job inputs {details} at {location} for subscription {subscription}. slots: details: requestBody.individualRequestDetails location: path.location subscription: path.subscriptionId - text: Run subscription-wide pre-job Data Box checks at {location} for {subscription}. slots: location: path.location subscription: path.subscriptionId method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.DataBox/locations/{location}/regionConfiguration'].post update: x-apievangelist-phrasing: intent: Get Data Box region configuration for a subscription effect: read questions: - What pickup schedules and transport options does Data Box offer in a region? - Can I look up the datacenter address and device capabilities for a location at subscription level? instructions: - text: Get Data Box region configuration for {location} in subscription {subscription}. slots: location: path.location subscription: path.subscriptionId - text: Show Data Box schedule availability {schedule} at {location} for {subscription}. slots: schedule: requestBody.scheduleAvailabilityRequest location: path.location subscription: path.subscriptionId method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataBox/locations/{location}/regionConfiguration'].post update: x-apievangelist-phrasing: intent: Get Data Box region configuration for a resource group effect: read questions: - Which Data Box transport and scheduling options apply to my resource group in a region? - Can I fetch region configuration scoped to a resource group instead of the subscription? instructions: - text: Get Data Box region configuration for {location} in resource group {rg}, subscription {subscription}. slots: location: path.location rg: path.resourceGroupName subscription: path.subscriptionId - text: Show resource-group Data Box transport options {transport} at {location}, {rg}, {subscription}. slots: transport: requestBody.transportAvailabilityRequest location: path.location rg: path.resourceGroupName subscription: path.subscriptionId method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.DeviceUpdate/checknameavailability'].post update: x-apievangelist-phrasing: intent: Check a Device Update resource name effect: read questions: - Is the name I want for a Device Update account or instance available? - How can I verify a Device Update for IoT Hub name before creating the resource? instructions: - text: Check Device Update name availability in subscription {subscription}. slots: subscription: path.subscriptionId - text: Verify a Device Update resource name is free for {subscription}. slots: subscription: path.subscriptionId method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.DeviceUpdate/accounts'].get update: x-apievangelist-phrasing: intent: List Device Update accounts in a subscription effect: read questions: - Which Device Update accounts exist across my subscription? - Can I list every Device Update for IoT Hub account without picking a resource group? instructions: - text: List all Device Update accounts in subscription {subscription}. slots: subscription: path.subscriptionId - text: Show every Device Update account across {subscription}. slots: subscription: path.subscriptionId method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DeviceUpdate/accounts'].get update: x-apievangelist-phrasing: intent: List Device Update accounts in a resource group effect: read questions: - What Device Update accounts are in one resource group? - Can I scope Device Update account listings to a single resource group? instructions: - text: List Device Update accounts in resource group {rg} of subscription {subscription}. slots: rg: path.resourceGroupName subscription: path.subscriptionId - text: Show Device Update accounts inside {rg} under {subscription}. slots: rg: path.resourceGroupName subscription: path.subscriptionId method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DeviceUpdate/accounts/{accountName}'].get update: x-apievangelist-phrasing: intent: Get a Device Update account effect: read questions: - How do I see the details of one Device Update account? - What properties does a Device Update account return? instructions: - text: Get Device Update account {account} in {rg}, subscription {subscription}. slots: account: path.accountName rg: path.resourceGroupName subscription: path.subscriptionId - text: Show the configuration of Device Update account {account} ({rg}, {subscription}). slots: account: path.accountName rg: path.resourceGroupName subscription: path.subscriptionId method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DeviceUpdate/accounts/{accountName}'].put update: x-apievangelist-phrasing: intent: Create or update a Device Update account effect: write questions: - How do I create a Device Update for IoT Hub account? - Can I assign a managed identity when creating a Device Update account? instructions: - text: Create Device Update account {account} in {rg}, subscription {subscription}. slots: account: path.accountName rg: path.resourceGroupName subscription: path.subscriptionId - text: Create or update Device Update account {account} ({rg}, {subscription}) with identity {identity}. slots: account: path.accountName rg: path.resourceGroupName subscription: path.subscriptionId identity: requestBody.identity method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DeviceUpdate/accounts/{accountName}'].delete update: x-apievangelist-phrasing: intent: Delete a Device Update account effect: destructive questions: - Can I delete a Device Update account I'm done with? - What removes a Device Update account entirely? instructions: - text: Delete Device Update account {account} in {rg}, subscription {subscription}. slots: account: path.accountName rg: path.resourceGroupName subscription: path.subscriptionId - text: Remove the Device Update account {account} from {rg} ({subscription}). slots: account: path.accountName rg: path.resourceGroupName subscription: path.subscriptionId method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DeviceUpdate/accounts/{accountName}'].patch update: x-apievangelist-phrasing: intent: Update a Device Update account's tags or identity effect: write questions: - Can I change the tags on a Device Update account after creating it? - Which Device Update account settings are patchable? instructions: - text: Set the tags on Device Update account {account} ({rg}, {subscription}) to {tags}. slots: account: path.accountName rg: path.resourceGroupName subscription: path.subscriptionId tags: requestBody.tags - text: Patch the identity on Device Update account {account} in {rg}, {subscription}. slots: account: path.accountName rg: path.resourceGroupName subscription: path.subscriptionId method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DeviceUpdate/accounts/{accountName}'].head update: x-apievangelist-phrasing: intent: Check whether a Device Update account exists effect: read questions: - Is there a quick way to test if a Device Update account exists without fetching it? - Does a Device Update account with a given name already exist in my resource group? instructions: - text: Check whether Device Update account {account} exists in {rg}, subscription {subscription}. slots: account: path.accountName rg: path.resourceGroupName subscription: path.subscriptionId - text: Confirm existence of Device Update account {account} ({rg}, {subscription}). slots: account: path.accountName rg: path.resourceGroupName subscription: path.subscriptionId method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DeviceUpdate/accounts/{accountName}/instances'].get update: x-apievangelist-phrasing: intent: List instances in a Device Update account effect: read questions: - What Device Update instances belong to my account? - Can I see every instance under one Device Update account? instructions: - text: List instances in Device Update account {account} ({rg}, {subscription}). slots: account: path.accountName rg: path.resourceGroupName subscription: path.subscriptionId - text: Show all instances of Device Update account {account} in {rg} under {subscription}. slots: account: path.accountName rg: path.resourceGroupName subscription: path.subscriptionId method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DeviceUpdate/accounts/{accountName}/instances/{instanceName}'].get update: x-apievangelist-phrasing: intent: Get a Device Update instance effect: read questions: - How do I look at one Device Update instance's configuration? - What properties does a given Device Update instance have? instructions: - text: Get instance {instance} in Device Update account {account} ({rg}, {subscription}). slots: instance: path.instanceName account: path.accountName rg: path.resourceGroupName subscription: path.subscriptionId - text: Show details of Device Update instance {instance} under {account}, {rg}, {subscription}. slots: instance: path.instanceName account: path.accountName rg: path.resourceGroupName subscription: path.subscriptionId method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DeviceUpdate/accounts/{accountName}/instances/{instanceName}'].put update: x-apievangelist-phrasing: intent: Create or update a Device Update instance effect: write questions: - How do I create a Device Update instance linked to my IoT hub? - Can I replace a Device Update instance's properties in one call? instructions: - text: Create instance {instance} in Device Update account {account} ({rg}, {subscription}) with {properties}. slots: instance: path.instanceName account: path.accountName rg: path.resourceGroupName subscription: path.subscriptionId properties: requestBody.properties - text: Create or update Device Update instance {instance} under {account} in {rg}, {subscription}. slots: instance: path.instanceName account: path.accountName rg: path.resourceGroupName subscription: path.subscriptionId method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DeviceUpdate/accounts/{accountName}/instances/{instanceName}'].delete update: x-apievangelist-phrasing: intent: Delete a Device Update instance effect: destructive questions: - Can I delete one instance without deleting its Device Update account? - What removes a Device Update instance? instructions: - text: Delete instance {instance} from Device Update account {account} ({rg}, {subscription}). slots: instance: path.instanceName account: path.accountName rg: path.resourceGroupName subscription: path.subscriptionId - text: Remove Device Update instance {instance} under {account} in {rg}, {subscription}. slots: instance: path.instanceName account: path.accountName rg: path.resourceGroupName subscription: path.subscriptionId method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DeviceUpdate/accounts/{accountName}/instances/{instanceName}'].patch update: x-apievangelist-phrasing: intent: Update tags on a Device Update instance effect: write questions: - Can I change only the tags on a Device Update instance? - Which call retags a Device Update instance? instructions: - text: Set tags {tags} on instance {instance} of Device Update account {account} ({rg}, {subscription}). slots: tags: requestBody.tags instance: path.instanceName account: path.accountName rg: path.resourceGroupName subscription: path.subscriptionId - text: Retag Device Update instance {instance} under {account} in {rg}, {subscription}. slots: instance: path.instanceName account: path.accountName rg: path.resourceGroupName subscription: path.subscriptionId method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DeviceUpdate/accounts/{accountName}/instances/{instanceName}'].head update: x-apievangelist-phrasing: intent: Check whether a Device Update instance exists effect: read questions: - Can I test if a Device Update instance exists without downloading it? - Does an instance with this name already exist under my Device Update account? instructions: - text: Check whether instance {instance} exists in Device Update account {account} ({rg}, {subscription}). slots: instance: path.instanceName account: path.accountName rg: path.resourceGroupName subscription: path.subscriptionId - text: Confirm Device Update instance {instance} exists under {account}, {rg}, {subscription}. slots: instance: path.instanceName account: path.accountName rg: path.resourceGroupName subscription: path.subscriptionId method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DeviceUpdate/accounts/{accountName}/privateEndpointConnectionProxies/{privateEndpointConnectionProxyId}/validate'].post update: x-apievangelist-phrasing: intent: Validate a Device Update private endpoint proxy effect: read questions: - Is there an internal call that validates a private endpoint connection proxy on a Device Update account? - What does the internal-only private endpoint proxy validation check? instructions: - text: Validate private endpoint connection proxy {proxy} on Device Update account {account} ({rg}, {subscription}). slots: proxy: path.privateEndpointConnectionProxyId account: path.accountName rg: path.resourceGroupName subscription: path.subscriptionId - text: Run the internal validation for endpoint proxy {proxy} under {account} in {rg}, {subscription}. slots: proxy: path.privateEndpointConnectionProxyId account: path.accountName rg: path.resourceGroupName subscription: path.subscriptionId method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DeviceUpdate/accounts/{accountName}/privateEndpointConnectionProxies/{privateEndpointConnectionProxyId}/updatePrivateEndpointProperties'].post update: x-apievangelist-phrasing: intent: Update a private endpoint in a Device Update proxy effect: write questions: - Can I update the private endpoint held in a Device Update connection proxy? - Which internal call changes private endpoint properties like the VNet traffic tag? instructions: - text: Update private endpoint properties in proxy {proxy} of Device Update account {account} ({rg}, {subscription}). slots: proxy: path.privateEndpointConnectionProxyId account: path.accountName rg: path.resourceGroupName subscription: path.subscriptionId - text: Set VNet traffic tag {tag} on the endpoint in proxy {proxy}, account {account}, {rg}, {subscription}. slots: tag: requestBody.vnetTrafficTag proxy: path.privateEndpointConnectionProxyId account: path.accountName rg: path.resourceGroupName subscription: path.subscriptionId method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.Network/getDnsResourceReference'].post update: x-apievangelist-phrasing: intent: Find DNS records that reference target resources effect: read questions: - Which DNS records point at a given set of Azure resources? - Can I look up DNS references by target resource ID before deleting something? instructions: - text: Find DNS records referencing target resources {targets}. slots: targets: requestBody.properties - text: Show which DNS records point at my resources. method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.GraphServices/accounts'].get update: x-apievangelist-phrasing: intent: List Graph Services accounts in a resource group effect: read questions: - What Microsoft Graph Services billing accounts are in a resource group? - Can I list Graph Services accounts for one resource group only? instructions: - text: List the Graph Services accounts in my resource group. - text: Show Graph Services account resources in this resource group. method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.GraphServices/accounts'].get update: x-apievangelist-phrasing: intent: List Graph Services accounts in a subscription effect: read questions: - Which Graph Services accounts belong to my subscription? - Can I see all Graph Services accounts across resource groups? instructions: - text: List all Graph Services accounts in my subscription. - text: Show every Graph Services account across the subscription. method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.GraphServices/accounts/{resourceName}'].get update: x-apievangelist-phrasing: intent: Get a Graph Services account effect: read questions: - How do I read one Graph Services account resource? - What properties does my Graph Services account carry? instructions: - text: Get Graph Services account {account}. slots: account: path.resourceName - text: Show the properties of Graph Services account {account}. slots: account: path.resourceName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.GraphServices/accounts/{resourceName}'].put update: x-apievangelist-phrasing: intent: Create or update a Graph Services account effect: write questions: - How do I create a Graph Services account to bill metered Graph APIs? - Which properties are required to create a Graph Services account? instructions: - text: Create Graph Services account {account} with properties {properties}. slots: account: path.resourceName properties: requestBody.properties - text: Create or update Graph Services account {account} in {location}. slots: account: path.resourceName location: requestBody.location method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.GraphServices/accounts/{resourceName}'].delete update: x-apievangelist-phrasing: intent: Delete a Graph Services account effect: destructive questions: - Can I delete a Graph Services account I'm no longer billing through? - What removes a Graph Services account resource? instructions: - text: Delete Graph Services account {account}. slots: account: path.resourceName - text: Remove the Graph Services account named {account}. slots: account: path.resourceName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.GraphServices/accounts/{resourceName}'].patch update: x-apievangelist-phrasing: intent: Update tags on a Graph Services account effect: write questions: - Can I update the tags on a Graph Services account? - Which call patches a Graph Services account's details? instructions: - text: Set the tags on Graph Services account {account} to {tags}. slots: account: path.resourceName tags: requestBody.tags - text: Update Graph Services account {account} details. slots: account: path.resourceName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourcegroups/{resourceGroupName}/providers/microsoft.insights/guestDiagnosticSettings/{diagnosticSettingsName}'].patch update: x-apievangelist-phrasing: intent: Update guest diagnostic settings effect: write questions: - How do I change a guest diagnostic settings resource's configuration or tags? - Can I patch the data sources collected by guest diagnostics? instructions: - text: Update guest diagnostic settings {settings} with properties {properties}. slots: settings: path.diagnosticSettingsName properties: requestBody.properties - text: Set the tags on guest diagnostic settings {settings} to {tags}. slots: settings: path.diagnosticSettingsName tags: requestBody.tags method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/providers/microsoft.insights/guestDiagnosticSettings'].get update: x-apievangelist-phrasing: intent: List guest diagnostic settings in a subscription effect: read questions: - What guest diagnostic settings exist across my subscription? - Can I see all VM guest diagnostics configurations without a resource group? instructions: - text: List all guest diagnostic settings in my subscription. - text: Show every guest diagnostics setting across the subscription. method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/microsoft.insights/guestDiagnosticSettings'].get update: x-apievangelist-phrasing: intent: List guest diagnostic settings in a resource group effect: read questions: - Which guest diagnostic settings are defined in one resource group? - Can I scope the guest diagnostics listing to a resource group? instructions: - text: List the guest diagnostic settings in my resource group. - text: Show guest diagnostics settings scoped to this resource group. method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/providers/microsoft.insights/guestDiagnosticSettingsAssociations'].get update: x-apievangelist-phrasing: intent: List guest diagnostic setting associations in a subscription effect: read questions: - Which resources are associated with guest diagnostic settings across my subscription? - Can I list every guest diagnostics association subscription-wide? instructions: - text: List which resources are linked to guest diagnostics settings subscription-wide. - text: Show every guest diagnostics association across the subscription. method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/microsoft.insights/guestDiagnosticSettingsAssociations'].get update: x-apievangelist-phrasing: intent: List guest diagnostic associations in a resource group effect: read questions: - What guest diagnostic settings associations exist in one resource group? - Can I narrow guest diagnostics associations to a resource group? instructions: - text: List guest diagnostic settings associations in my resource group. - text: Show guest diagnostics associations scoped to this resource group. method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.HDInsight/clusterpools/{clusterPoolName}'].get update: x-apievangelist-phrasing: intent: Get an HDInsight cluster pool effect: read questions: - How do I view one HDInsight on AKS cluster pool? - What configuration does my HDInsight cluster pool have? instructions: - text: Get HDInsight cluster pool {pool}. slots: pool: path.clusterPoolName - text: Show the configuration of cluster pool {pool}. slots: pool: path.clusterPoolName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.HDInsight/clusterpools/{clusterPoolName}'].put update: x-apievangelist-phrasing: intent: Create or update an HDInsight cluster pool effect: write questions: - How do I create a new HDInsight on AKS cluster pool? - Can I overwrite a cluster pool's properties by recreating it? instructions: - text: Create HDInsight cluster pool {pool}. slots: pool: path.clusterPoolName - text: Create or update cluster pool {pool} with properties {properties}. slots: pool: path.clusterPoolName properties: requestBody.properties method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.HDInsight/clusterpools/{clusterPoolName}'].delete update: x-apievangelist-phrasing: intent: Delete an HDInsight cluster pool effect: destructive questions: - Can I delete an HDInsight cluster pool I no longer need? - What removes a whole HDInsight on AKS cluster pool? instructions: - text: Delete HDInsight cluster pool {pool}. slots: pool: path.clusterPoolName - text: Remove the cluster pool named {pool}. slots: pool: path.clusterPoolName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.HDInsight/clusterpools/{clusterPoolName}'].patch update: x-apievangelist-phrasing: intent: Update tags on an HDInsight cluster pool effect: write questions: - Can I change only the tags of an HDInsight cluster pool? - Which call retags an existing cluster pool? instructions: - text: Set the tags on HDInsight cluster pool {pool} to {tags}. slots: pool: path.clusterPoolName tags: requestBody.tags - text: Retag cluster pool {pool}. slots: pool: path.clusterPoolName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.HDInsight/clusterpools'].get update: x-apievangelist-phrasing: intent: List HDInsight cluster pools in a subscription effect: read questions: - Which HDInsight cluster pools exist across my subscription? - Can I list every cluster pool without picking a resource group? instructions: - text: List all HDInsight cluster pools in my subscription. - text: Show every cluster pool across the subscription. method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.HDInsight/clusterpools'].get update: x-apievangelist-phrasing: intent: List HDInsight cluster pools in a resource group effect: read questions: - What HDInsight cluster pools are in one of my resource groups? - Can I list cluster pools for a single resource group? instructions: - text: List the HDInsight cluster pools in my resource group. - text: Show cluster pools scoped to this resource group. method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.HDInsight/clusterpools/{clusterPoolName}/clusters'].get update: x-apievangelist-phrasing: intent: List clusters in an HDInsight cluster pool effect: read questions: - Which HDInsight clusters are running inside a given cluster pool? - Can I see every cluster that belongs to one pool? instructions: - text: List the clusters in HDInsight cluster pool {pool}. slots: pool: path.clusterPoolName - text: Show all clusters running in pool {pool}. slots: pool: path.clusterPoolName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.HDInsight/clusterpools/{clusterPoolName}/clusters/{clusterName}/resize'].post update: x-apievangelist-phrasing: intent: Resize an HDInsight cluster effect: write questions: - How do I change the worker node count of an HDInsight on AKS cluster? - Can I scale a cluster in a pool up or down? instructions: - text: Resize cluster {cluster} in pool {pool}. slots: cluster: path.clusterName pool: path.clusterPoolName - text: Resize HDInsight cluster {cluster} in {pool} using {properties}. slots: cluster: path.clusterName pool: path.clusterPoolName properties: requestBody.properties method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.HDInsight/clusterpools/{clusterPoolName}/clusters/{clusterName}'].get update: x-apievangelist-phrasing: intent: Get an HDInsight cluster in a pool effect: read questions: - How do I read one HDInsight cluster's configuration within its pool? - What cluster type and version is a specific HDInsight cluster running? instructions: - text: Get HDInsight cluster {cluster} in pool {pool}. slots: cluster: path.clusterName pool: path.clusterPoolName - text: Show the properties of cluster {cluster} under cluster pool {pool}. slots: cluster: path.clusterName pool: path.clusterPoolName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.HDInsight/clusterpools/{clusterPoolName}/clusters/{clusterName}'].put update: x-apievangelist-phrasing: intent: Create an HDInsight cluster in a pool effect: write questions: - How do I create a new HDInsight on AKS cluster inside an existing pool? - What properties are needed to spin up a cluster in a cluster pool? instructions: - text: Create HDInsight cluster {cluster} in pool {pool}. slots: cluster: path.clusterName pool: path.clusterPoolName - text: Create cluster {cluster} in pool {pool} with properties {properties}. slots: cluster: path.clusterName pool: path.clusterPoolName properties: requestBody.properties method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.HDInsight/clusterpools/{clusterPoolName}/clusters/{clusterName}'].delete update: x-apievangelist-phrasing: intent: Delete an HDInsight cluster from a pool effect: destructive questions: - Can I delete a single cluster but keep its cluster pool? - What removes an HDInsight on AKS cluster? instructions: - text: Delete HDInsight cluster {cluster} from pool {pool}. slots: cluster: path.clusterName pool: path.clusterPoolName - text: Remove cluster {cluster} in cluster pool {pool}. slots: cluster: path.clusterName pool: path.clusterPoolName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.HDInsight/clusterpools/{clusterPoolName}/clusters/{clusterName}'].patch update: x-apievangelist-phrasing: intent: Update an existing HDInsight cluster effect: write questions: - Can I change configuration on a running HDInsight cluster in a pool? - Which call patches an HDInsight on AKS cluster's properties? instructions: - text: Update HDInsight cluster {cluster} in pool {pool} with {properties}. slots: cluster: path.clusterName pool: path.clusterPoolName properties: requestBody.properties - text: Patch the settings of cluster {cluster} under {pool}. slots: cluster: path.clusterName pool: path.clusterPoolName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.HDInsight/clusterpools/{clusterPoolName}/clusters/{clusterName}/runJob'].post update: x-apievangelist-phrasing: intent: Run a job on an HDInsight cluster effect: write questions: - How do I submit or control a job on an HDInsight on AKS cluster? - Can I trigger a job action on my cluster through the API? instructions: - text: Run a job on cluster {cluster} in pool {pool} with {job}. slots: cluster: path.clusterName pool: path.clusterPoolName job: requestBody.properties - text: Submit job {job} to HDInsight cluster {cluster} in {pool}. slots: job: requestBody.properties cluster: path.clusterName pool: path.clusterPoolName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.HDInsight/clusterpools/{clusterPoolName}/clusters/{clusterName}/jobs'].get update: x-apievangelist-phrasing: intent: List jobs on an HDInsight cluster effect: read questions: - Which jobs are on my HDInsight on AKS cluster? - Can I see the status of jobs running on a cluster? instructions: - text: List jobs on HDInsight cluster {cluster} in pool {pool}. slots: cluster: path.clusterName pool: path.clusterPoolName - text: Show the jobs and their states on cluster {cluster} in {pool}. slots: cluster: path.clusterName pool: path.clusterPoolName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.HDInsight/clusterpools/{clusterPoolName}/clusters/{clusterName}/serviceConfigs'].get update: x-apievangelist-phrasing: intent: List service configs of an HDInsight cluster effect: read questions: - What configuration is each service on my HDInsight cluster running with? - Can I dump the config files of all services in a cluster? instructions: - text: List service configs for HDInsight cluster {cluster} in pool {pool}. slots: cluster: path.clusterName pool: path.clusterPoolName - text: Show the config dump of every service on {cluster} in {pool}. slots: cluster: path.clusterName pool: path.clusterPoolName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.HDInsight/locations/{location}/checkNameAvailability'].post update: x-apievangelist-phrasing: intent: Check an HDInsight resource name effect: read questions: - Is a name available for a new HDInsight cluster pool in a location? - Can I verify an HDInsight on AKS resource name before creating it? instructions: - text: Check whether HDInsight name {name} is available in region {location}. slots: name: requestBody.name location: path.location - text: Check availability of {name} for resource type {type} in HDInsight. slots: name: requestBody.name type: requestBody.type method: generated generated: '2026-10-01' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.HDInsight/clusterpools/{clusterPoolName}/clusters/{clusterName}/instanceViews'].get update: x-apievangelist-phrasing: intent: List instance views of an HDInsight cluster effect: read questions: - What instance views does my HDInsight cluster expose? - Can I list all instance view records for a cluster in a pool? instructions: - text: List instance views for HDInsight cluster {cluster} in pool {pool}. slots: cluster: path.clusterName pool: path.clusterPoolName - text: Show all instance view entries of {cluster} under {pool}. slots: cluster: path.clusterName pool: path.clusterPoolName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.HDInsight/clusterpools/{clusterPoolName}/clusters/{clusterName}/instanceViews/default'].get update: x-apievangelist-phrasing: intent: Get the status of an HDInsight cluster instance effect: read questions: - Is my HDInsight cluster instance healthy right now? - What's the current running status of a cluster's default instance view? instructions: - text: Get the default instance status of cluster {cluster} in pool {pool}. slots: cluster: path.clusterName pool: path.clusterPoolName - text: Check the running state of HDInsight cluster {cluster} in {pool}. slots: cluster: path.clusterName pool: path.clusterPoolName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.HDInsight/locations/{location}/availableClusterPoolVersions'].get update: x-apievangelist-phrasing: intent: List available HDInsight cluster pool versions effect: read questions: - Which cluster pool versions can I deploy in a region? - Which versions are offered for new HDInsight cluster pools? instructions: - text: List available HDInsight cluster pool versions for region {location}. slots: location: path.location - text: Show the cluster pool versions I can pick in this location. method: generated generated: '2026-10-01' - target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.HDInsight/locations/{location}/availableClusterVersions'].get update: x-apievangelist-phrasing: intent: List available HDInsight cluster versions effect: read questions: - What HDInsight cluster versions and types are offered in a region? - Which cluster versions can a newly created HDInsight cluster use? instructions: - text: List the HDInsight cluster versions (not pool versions) offered in region {location}. slots: location: path.location - text: Show cluster types and versions supported in this location. method: generated generated: '2026-10-01' - target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.HealthBot/checkNameAvailability'].post update: x-apievangelist-phrasing: intent: Check if a Health Bot name is available effect: read questions: - Is the name I want for a Health Bot free to use? - How do I verify a Health Bot name before creating the bot? instructions: - text: Check whether Health Bot name {name} is available in subscription {subscription}. slots: name: requestBody.name subscription: path.subscriptionId - text: Verify {name} of type {type} can be used for a Health Bot in {subscription}. slots: name: requestBody.name type: requestBody.type subscription: path.subscriptionId method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.HybridCompute/privateLinkScopes'].get update: x-apievangelist-phrasing: intent: List Arc private link scopes in a subscription effect: read questions: - Which Azure Arc private link scopes exist across my subscription? - Can I see all Arc PrivateLinkScopes without choosing a resource group? instructions: - text: List all Azure Arc private link scopes in my subscription. - text: Show every Arc PrivateLinkScope across the subscription. method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.HybridCompute/privateLinkScopes'].get update: x-apievangelist-phrasing: intent: List Arc private link scopes in a resource group effect: read questions: - What Arc private link scopes are in one resource group? - Can I list PrivateLinkScopes for Arc servers in a single resource group? instructions: - text: List the Azure Arc private link scopes in my resource group. - text: Show Arc PrivateLinkScopes scoped to this resource group. method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.HybridCompute/privateLinkScopes/{scopeName}'].get update: x-apievangelist-phrasing: intent: Get an Arc private link scope effect: read questions: - How do I view one Azure Arc private link scope? - What settings does my Arc PrivateLinkScope carry? instructions: - text: Get Azure Arc private link scope {scope}. slots: scope: path.scopeName - text: Show the settings of Arc PrivateLinkScope {scope}. slots: scope: path.scopeName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.HybridCompute/privateLinkScopes/{scopeName}'].put update: x-apievangelist-phrasing: intent: Create or update an Arc private link scope effect: write questions: - How do I create a private link scope for Arc-enabled servers? - Can I set a location and properties when creating an Arc PrivateLinkScope? instructions: - text: Create Azure Arc private link scope {scope} in {location}. slots: scope: path.scopeName location: requestBody.location - text: Create or update Arc PrivateLinkScope {scope} with properties {properties}. slots: scope: path.scopeName properties: requestBody.properties method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.HybridCompute/privateLinkScopes/{scopeName}'].delete update: x-apievangelist-phrasing: intent: Delete an Arc private link scope effect: destructive questions: - Can I delete an Azure Arc private link scope? - What removes an Arc PrivateLinkScope resource? instructions: - text: Delete Azure Arc private link scope {scope}. slots: scope: path.scopeName - text: Remove the Arc PrivateLinkScope named {scope}. slots: scope: path.scopeName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.HybridCompute/privateLinkScopes/{scopeName}'].patch update: x-apievangelist-phrasing: intent: Update tags on an Arc private link scope effect: write questions: - Can I change only the tags on an Arc private link scope? - Which call retags an Arc PrivateLinkScope without touching other fields? instructions: - text: Set the tags on Azure Arc private link scope {scope} to {tags}. slots: scope: path.scopeName tags: requestBody.tags - text: Retag Arc PrivateLinkScope {scope}. slots: scope: path.scopeName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.HybridCompute/locations/{location}/privateLinkScopes/{privateLinkScopeId}'].get update: x-apievangelist-phrasing: intent: Get validation details of an Arc private link scope effect: read questions: - How do I get the validation details for an Arc private link scope by its ID? - What connection details does Azure use to validate a PrivateLinkScope in a location? instructions: - text: Get validation details for Arc private link scope {scope_id} in {location}. slots: scope_id: path.privateLinkScopeId location: path.location - text: Show PrivateLinkScope {scope_id} validation info for region {location}. slots: scope_id: path.privateLinkScopeId location: path.location method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.HybridCompute/machines/{machineName}/privateLinkScopes/current'].get update: x-apievangelist-phrasing: intent: Get private link scope validation for an Arc machine effect: read questions: - Which private link scope is an Arc-enabled machine currently using? - Can I see the PrivateLinkScope validation details for one server? instructions: - text: Get private link scope validation details for Arc machine {machine}. slots: machine: path.machineName - text: Show the current PrivateLinkScope of machine {machine}. slots: machine: path.machineName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.HybridContainerService/virtualNetworks/{virtualNetworksName}'].get update: x-apievangelist-phrasing: intent: Get a Hybrid AKS virtual network effect: read questions: - How do I view a Hybrid AKS virtual network's configuration? - What settings does my AKS hybrid virtual network have? instructions: - text: Get Hybrid AKS virtual network {vnet}. slots: vnet: path.virtualNetworksName - text: Show the properties of AKS hybrid virtual network {vnet}. slots: vnet: path.virtualNetworksName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.HybridContainerService/virtualNetworks/{virtualNetworksName}'].put update: x-apievangelist-phrasing: intent: Create or update a Hybrid AKS virtual network effect: write questions: - How do I create a virtual network for Hybrid AKS on a custom location? - Can I set the extended location when creating an AKS hybrid network? instructions: - text: Create Hybrid AKS virtual network {vnet} with properties {properties}. slots: vnet: path.virtualNetworksName properties: requestBody.properties - text: Put AKS hybrid virtual network {vnet} on extended location {extended_location}. slots: vnet: path.virtualNetworksName extended_location: requestBody.extendedLocation method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.HybridContainerService/virtualNetworks/{virtualNetworksName}'].delete update: x-apievangelist-phrasing: intent: Delete a Hybrid AKS virtual network effect: destructive questions: - Can I delete a Hybrid AKS virtual network? - What removes an AKS hybrid virtual network resource? instructions: - text: Delete Hybrid AKS virtual network {vnet}. slots: vnet: path.virtualNetworksName - text: Remove the AKS hybrid virtual network {vnet}. slots: vnet: path.virtualNetworksName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.HybridContainerService/virtualNetworks/{virtualNetworksName}'].patch update: x-apievangelist-phrasing: intent: Update tags on a Hybrid AKS virtual network effect: write questions: - Can I change the tags of a Hybrid AKS virtual network? - Which call patches an AKS hybrid virtual network? instructions: - text: Set the tags on Hybrid AKS virtual network {vnet} to {tags}. slots: vnet: path.virtualNetworksName tags: requestBody.tags - text: Patch AKS hybrid virtual network {vnet}. slots: vnet: path.virtualNetworksName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.HybridContainerService/virtualNetworks'].get update: x-apievangelist-phrasing: intent: List Hybrid AKS virtual networks in a resource group effect: read questions: - Which Hybrid AKS virtual networks are in one resource group? - Can I list AKS hybrid networks for a single resource group? instructions: - text: List the Hybrid AKS virtual networks in my resource group. - text: Show AKS hybrid virtual networks scoped to this resource group. method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.HybridContainerService/virtualNetworks'].get update: x-apievangelist-phrasing: intent: List Hybrid AKS virtual networks in a subscription effect: read questions: - What Hybrid AKS virtual networks exist across my subscription? - Can I see all AKS hybrid networks without picking a resource group? instructions: - text: List all Hybrid AKS virtual networks in my subscription. - text: Show every AKS hybrid virtual network across the subscription. method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.Kusto/skus'].get update: x-apievangelist-phrasing: intent: List SKUs available for Data Explorer clusters effect: read questions: - Which SKUs can I use for an Azure Data Explorer (Kusto) cluster? - What Kusto cluster sizes are eligible in my subscription? instructions: - text: List eligible Kusto cluster SKUs for subscription {subscription}. slots: subscription: path.subscriptionId - text: Show the Data Explorer SKUs available to {subscription}. slots: subscription: path.subscriptionId method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.ManagedIdentity/userAssignedIdentities'].get update: x-apievangelist-phrasing: intent: List user-assigned identities in a subscription effect: read questions: - Which user-assigned managed identities exist across my subscription? - Can I list every user-assigned identity without choosing a resource group? instructions: - text: List all user-assigned identities in subscription {subscription}. slots: subscription: path.subscriptionId - text: Show every user-assigned managed identity across {subscription}. slots: subscription: path.subscriptionId method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities'].get update: x-apievangelist-phrasing: intent: List user-assigned identities in a resource group effect: read questions: - What user-assigned managed identities are in one resource group? - Can I scope the list of user-assigned identities to a resource group? instructions: - text: List user-assigned identities in resource group {rg} of subscription {subscription}. slots: rg: path.resourceGroupName subscription: path.subscriptionId - text: Show managed identities created in {rg} under {subscription}. slots: rg: path.resourceGroupName subscription: path.subscriptionId method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{resourceName}/listAssociatedResources'].post update: x-apievangelist-phrasing: intent: List resources associated with a managed identity effect: read questions: - Which Azure resources are using a particular user-assigned identity? - Can I filter and page through resources tied to a managed identity? instructions: - text: List resources associated with identity {identity} in {rg}, subscription {subscription}. slots: identity: path.resourceName rg: path.resourceGroupName subscription: path.subscriptionId - text: Show resources using identity {identity} ({rg}, {subscription}) filtered by {filter}. slots: identity: path.resourceName rg: path.resourceGroupName subscription: path.subscriptionId filter: query.$filter method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{resourceName}'].get update: x-apievangelist-phrasing: intent: Get a user-assigned identity effect: read questions: - How do I read a user-assigned identity's client ID and principal ID? - What details does one managed identity return? instructions: - text: Get user-assigned identity {identity} in {rg}, subscription {subscription}. slots: identity: path.resourceName rg: path.resourceGroupName subscription: path.subscriptionId - text: Show the client and principal IDs of identity {identity} ({rg}, {subscription}). slots: identity: path.resourceName rg: path.resourceGroupName subscription: path.subscriptionId method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{resourceName}'].put update: x-apievangelist-phrasing: intent: Create or update a user-assigned identity effect: write questions: - How do I create a new user-assigned managed identity? - Can I recreate an identity with new properties in the same resource group? instructions: - text: Create user-assigned identity {identity} in {rg}, subscription {subscription}. slots: identity: path.resourceName rg: path.resourceGroupName subscription: path.subscriptionId - text: Create or update identity {identity} in {rg} ({subscription}) with properties {properties}. slots: identity: path.resourceName rg: path.resourceGroupName subscription: path.subscriptionId properties: requestBody.properties method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{resourceName}'].delete update: x-apievangelist-phrasing: intent: Delete a user-assigned identity effect: destructive questions: - Can I delete a user-assigned managed identity? - What happens to resources when I remove the identity they use? instructions: - text: Delete user-assigned identity {identity} in {rg}, subscription {subscription}. slots: identity: path.resourceName rg: path.resourceGroupName subscription: path.subscriptionId - text: Remove managed identity {identity} from {rg} ({subscription}). slots: identity: path.resourceName rg: path.resourceGroupName subscription: path.subscriptionId method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{resourceName}'].patch update: x-apievangelist-phrasing: intent: Update a user-assigned identity effect: write questions: - Can I change the tags or location of an existing user-assigned identity? - Which call patches a managed identity without recreating it? instructions: - text: Set tags {tags} on user-assigned identity {identity} in {rg}, subscription {subscription}. slots: tags: requestBody.tags identity: path.resourceName rg: path.resourceGroupName subscription: path.subscriptionId - text: Patch managed identity {identity} in {rg} ({subscription}). slots: identity: path.resourceName rg: path.resourceGroupName subscription: path.subscriptionId method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{resourceName}/federatedIdentityCredentials'].get update: x-apievangelist-phrasing: intent: List federated credentials on a managed identity effect: read questions: - Which federated identity credentials are attached to my user-assigned managed identity? - Can I page through a long list of federated credentials on one identity with a skip token? instructions: - text: List the federated identity credentials on identity {identity} in resource group {resource_group} of subscription {subscription}. slots: identity: path.resourceName resource_group: path.resourceGroupName subscription: path.subscriptionId - text: Show only the first {top} federated credentials trusted by managed identity {identity}. slots: top: query.$top identity: path.resourceName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{resourceName}/federatedIdentityCredentials/{federatedIdentityCredentialResourceName}'].get update: x-apievangelist-phrasing: intent: Get one federated identity credential effect: read questions: - Can I look up a single federated identity credential by its name on a managed identity? - What settings does one specific federated credential on my user-assigned identity hold? instructions: - text: Get federated credential {credential} on identity {identity} in resource group {resource_group}, subscription {subscription}. slots: credential: path.federatedIdentityCredentialResourceName identity: path.resourceName resource_group: path.resourceGroupName subscription: path.subscriptionId - text: Show me the details of the {credential} federated credential. slots: credential: path.federatedIdentityCredentialResourceName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{resourceName}/federatedIdentityCredentials/{federatedIdentityCredentialResourceName}'].put update: x-apievangelist-phrasing: intent: Add or change a federated identity credential effect: write questions: - How do I add a federated identity credential to a user-assigned managed identity? - Can I overwrite an existing federated credential on my identity with new settings? instructions: - text: Create federated credential {credential} on managed identity {identity} in resource group {resource_group} under subscription {subscription}. slots: credential: path.federatedIdentityCredentialResourceName identity: path.resourceName resource_group: path.resourceGroupName subscription: path.subscriptionId - text: Set the properties of federated credential {credential} on identity {identity} to {properties}. slots: credential: path.federatedIdentityCredentialResourceName identity: path.resourceName properties: requestBody.properties method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{resourceName}/federatedIdentityCredentials/{federatedIdentityCredentialResourceName}'].delete update: x-apievangelist-phrasing: intent: Remove a federated identity credential effect: destructive questions: - Can I revoke a federated credential so an external workload no longer signs in as my managed identity? - What happens when I delete a federated identity credential from a user-assigned identity? instructions: - text: Delete federated credential {credential} from identity {identity} in resource group {resource_group}, subscription {subscription}. slots: credential: path.federatedIdentityCredentialResourceName identity: path.resourceName resource_group: path.resourceGroupName subscription: path.subscriptionId - text: Remove the {credential} federated credential from my managed identity {identity}. slots: credential: path.federatedIdentityCredentialResourceName identity: path.resourceName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.MarketplaceOrdering/offerTypes/{offerType}/publishers/{publisherId}/offers/{offerId}/plans/{planId}/agreements/current'].get update: x-apievangelist-phrasing: intent: Read the current marketplace terms for a plan effect: read questions: - Where can I read the current Azure Marketplace terms for a publisher's offer and plan? - Have I already accepted the marketplace terms for this virtual machine offer type? instructions: - text: Get the current marketplace terms for offer type {offer_type}, publisher {publisher}, offer {offer}, plan {plan} in subscription {subscription}. slots: offer_type: path.offerType publisher: path.publisherId offer: path.offerId plan: path.planId subscription: path.subscriptionId - text: Show the terms I must accept before deploying plan {plan} of offer {offer} by {publisher}. slots: plan: path.planId offer: path.offerId publisher: path.publisherId method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.MarketplaceOrdering/offerTypes/{offerType}/publishers/{publisherId}/offers/{offerId}/plans/{planId}/agreements/current'].put update: x-apievangelist-phrasing: intent: Save acceptance of marketplace terms effect: write questions: - How do I accept Azure Marketplace terms programmatically before deploying an image? - Can I save updated marketplace terms for a specific offer type and plan? instructions: - text: Save the marketplace terms for offer type {offer_type}, publisher {publisher}, offer {offer}, plan {plan} in subscription {subscription}. slots: offer_type: path.offerType publisher: path.publisherId offer: path.offerId plan: path.planId subscription: path.subscriptionId - text: Store terms {properties} as current for plan {plan} of offer {offer}. slots: properties: requestBody.properties plan: path.planId offer: path.offerId method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.MarketplaceOrdering/agreements/{publisherId}/offers/{offerId}/plans/{planId}/sign'].post update: x-apievangelist-phrasing: intent: Sign a marketplace agreement effect: write questions: - Can I sign the marketplace agreement for a publisher's plan through the API? - What does signing marketplace terms for an offer do for my subscription? instructions: - text: Sign the marketplace terms for publisher {publisher}, offer {offer}, plan {plan} in subscription {subscription}. slots: publisher: path.publisherId offer: path.offerId plan: path.planId subscription: path.subscriptionId - text: Sign the agreement for plan {plan} of the {offer} offer. slots: plan: path.planId offer: path.offerId method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.MarketplaceOrdering/agreements/{publisherId}/offers/{offerId}/plans/{planId}/cancel'].post update: x-apievangelist-phrasing: intent: Cancel a signed marketplace agreement effect: destructive questions: - Is there a way to cancel marketplace terms I previously signed for a plan? - Can I withdraw my subscription's acceptance of a publisher's offer terms? instructions: - text: Cancel the marketplace terms for publisher {publisher}, offer {offer}, plan {plan} in subscription {subscription}. slots: publisher: path.publisherId offer: path.offerId plan: path.planId subscription: path.subscriptionId - text: Revoke my signed agreement for plan {plan} of offer {offer}. slots: plan: path.planId offer: path.offerId method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.MarketplaceOrdering/agreements/{publisherId}/offers/{offerId}/plans/{planId}'].get update: x-apievangelist-phrasing: intent: Get my marketplace agreement for a plan effect: read questions: - Can I check the signed agreement status for one publisher, offer and plan? - Does my subscription hold an agreement for this particular marketplace plan? instructions: - text: Get the marketplace agreement on file for publisher {publisher}, offer {offer}, plan {plan} in subscription {subscription}. slots: publisher: path.publisherId offer: path.offerId plan: path.planId subscription: path.subscriptionId - text: Check whether plan {plan} of offer {offer} already has an agreement record. slots: plan: path.planId offer: path.offerId method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.MarketplaceOrdering/agreements'].get update: x-apievangelist-phrasing: intent: List marketplace agreements in a subscription effect: read questions: - Which Azure Marketplace agreements has my subscription signed? - Can I see every marketplace agreement held across one subscription? instructions: - text: List all marketplace agreements in subscription {subscription}. slots: subscription: path.subscriptionId - text: Show every marketplace agreement my subscription holds. method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.Media/CheckNameAvailability'].post update: x-apievangelist-phrasing: intent: Check if a Media Services account name is free effect: read questions: - Is the Media Services account name I want still globally available? - Why does a Media Services name have to be unique across all of Azure? instructions: - text: Check whether Media Services name {name} of type {type} is available in subscription {subscription}. slots: name: requestBody.name type: requestBody.type subscription: path.subscriptionId - text: Test if {name} can be used as a new Media Services account name. slots: name: requestBody.name method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Media/mediaservices'].get update: x-apievangelist-phrasing: intent: List Media Services accounts in a resource group effect: read questions: - What Media Services accounts exist in one of my resource groups? - Can I enumerate every media service under a resource group? instructions: - text: List the Media Services accounts in resource group {resource_group} of subscription {subscription}. slots: resource_group: path.resourceGroupName subscription: path.subscriptionId - text: Show all media services in resource group {resource_group}. slots: resource_group: path.resourceGroupName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Media/mediaservices/{mediaServiceName}'].get update: x-apievangelist-phrasing: intent: Get a Media Services account effect: read questions: - Can I fetch the configuration of one Media Services account by name? - What storage and settings does my media service currently have? instructions: - text: Get Media Services account {media_service} in resource group {resource_group}, subscription {subscription}. slots: media_service: path.mediaServiceName resource_group: path.resourceGroupName subscription: path.subscriptionId - text: Show the details of media service {media_service}. slots: media_service: path.mediaServiceName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Media/mediaservices/{mediaServiceName}'].put update: x-apievangelist-phrasing: intent: Create a Media Services account effect: write questions: - How do I create a new Media Services account in a resource group? - Which region and tags can I set when I first create a media service? instructions: - text: Create Media Services account {media_service} in resource group {resource_group} of subscription {subscription}. slots: media_service: path.mediaServiceName resource_group: path.resourceGroupName subscription: path.subscriptionId - text: Create media service {media_service} in location {location} with tags {tags}. slots: media_service: path.mediaServiceName location: requestBody.location tags: requestBody.tags method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Media/mediaservices/{mediaServiceName}'].delete update: x-apievangelist-phrasing: intent: Delete a Media Services account effect: destructive questions: - Can I delete a Media Services account I no longer use? - What gets removed when I delete a media service from a resource group? instructions: - text: Delete Media Services account {media_service} from resource group {resource_group} in subscription {subscription}. slots: media_service: path.mediaServiceName resource_group: path.resourceGroupName subscription: path.subscriptionId - text: Remove media service {media_service} permanently. slots: media_service: path.mediaServiceName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Media/mediaservices/{mediaServiceName}'].patch update: x-apievangelist-phrasing: intent: Update an existing Media Services account effect: write questions: - Can I change the tags or properties on an existing Media Services account? - Is it possible to patch a media service without recreating it? instructions: - text: Update Media Services account {media_service} in resource group {resource_group}, subscription {subscription}. slots: media_service: path.mediaServiceName resource_group: path.resourceGroupName subscription: path.subscriptionId - text: Change the tags on existing media service {media_service} to {tags}. slots: media_service: path.mediaServiceName tags: requestBody.tags method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Media/mediaservices/{mediaServiceName}/regenerateKey'].post update: x-apievangelist-phrasing: intent: Regenerate a Media Services access key effect: write questions: - How do I rotate the primary or secondary key of a Media Services account? - Can I regenerate just the secondary key of my media service? instructions: - text: Regenerate the {key_type} key for media service {media_service} in resource group {resource_group}, subscription {subscription}. slots: key_type: requestBody.keyType media_service: path.mediaServiceName resource_group: path.resourceGroupName subscription: path.subscriptionId - text: Rotate the {key_type} access key of media service {media_service}. slots: key_type: requestBody.keyType media_service: path.mediaServiceName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Media/mediaservices/{mediaServiceName}/listKeys'].post update: x-apievangelist-phrasing: intent: List the access keys of a Media Services account effect: read questions: - Where do I find the primary and secondary keys for my Media Services account? - Can I retrieve the current access keys of a media service? instructions: - text: List the keys for media service {media_service} in resource group {resource_group}, subscription {subscription}. slots: media_service: path.mediaServiceName resource_group: path.resourceGroupName subscription: path.subscriptionId - text: Show me the current access keys of media service {media_service}. slots: media_service: path.mediaServiceName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Media/mediaservices/{mediaServiceName}/syncStorageKeys'].post update: x-apievangelist-phrasing: intent: Sync storage keys for a Media Services account effect: write questions: - My storage account keys changed; how do I resync them with my Media Services account? - Can I make a media service pick up rotated keys for its attached storage account? instructions: - text: Synchronize storage account {storage_account} keys with media service {media_service} in resource group {resource_group}, subscription {subscription}. slots: storage_account: requestBody.id media_service: path.mediaServiceName resource_group: path.resourceGroupName subscription: path.subscriptionId - text: Resync the storage keys of media service {media_service}. slots: media_service: path.mediaServiceName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.KubernetesConfiguration/privateLinkScopes'].get update: x-apievangelist-phrasing: intent: List Azure Arc private link scopes in a subscription effect: read questions: - Which Azure Arc Kubernetes configuration private link scopes exist across my whole subscription? - Can I see all Arc private link scopes subscription-wide rather than per resource group? instructions: - text: List every Azure Arc Kubernetes configuration private link scope in my subscription. - text: Show all Arc private link scopes across the subscription. method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.KubernetesConfiguration/privateLinkScopes'].get update: x-apievangelist-phrasing: intent: List Azure Arc private link scopes in a resource group effect: read questions: - What Azure Arc Kubernetes configuration private link scopes are in a single resource group? - Can I narrow the Arc private link scope list down to one resource group? instructions: - text: List the Azure Arc Kubernetes configuration private link scopes in my resource group. - text: Show the Arc private link scopes defined in this resource group only. method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.KubernetesConfiguration/privateLinkScopes/{scopeName}'].get update: x-apievangelist-phrasing: intent: Get an Azure Arc private link scope effect: read questions: - Can I look up one Azure Arc Kubernetes configuration private link scope by name? - What settings does my Arc private link scope have? instructions: - text: Get Azure Arc Kubernetes configuration private link scope {scope}. slots: scope: path.scopeName - text: Show the details of Arc private link scope {scope}. slots: scope: path.scopeName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.KubernetesConfiguration/privateLinkScopes/{scopeName}'].put update: x-apievangelist-phrasing: intent: Create or update an Azure Arc private link scope effect: write questions: - How do I create a private link scope for Azure Arc Kubernetes configuration? - Can I change the properties of an existing Arc private link scope with a full update? instructions: - text: Create Azure Arc Kubernetes configuration private link scope {scope}. slots: scope: path.scopeName - text: Set the properties of Arc private link scope {scope} to {properties}. slots: scope: path.scopeName properties: requestBody.properties method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.KubernetesConfiguration/privateLinkScopes/{scopeName}'].delete update: x-apievangelist-phrasing: intent: Delete an Azure Arc private link scope effect: destructive questions: - Can I delete an Azure Arc Kubernetes configuration private link scope I no longer need? - What happens to private connectivity when I remove an Arc private link scope? instructions: - text: Delete Azure Arc Kubernetes configuration private link scope {scope}. slots: scope: path.scopeName - text: Remove Arc private link scope {scope}. slots: scope: path.scopeName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.KubernetesConfiguration/privateLinkScopes/{scopeName}'].patch update: x-apievangelist-phrasing: intent: Update tags on an Azure Arc private link scope effect: write questions: - Can I change only the tags on an Azure Arc Kubernetes configuration private link scope? - Is there a lightweight way to retag an Arc private link scope without a full update? instructions: - text: Set tags {tags} on Azure Arc Kubernetes configuration private link scope {scope}. slots: tags: requestBody.tags scope: path.scopeName - text: Retag Arc private link scope {scope} with {tags}. slots: scope: path.scopeName tags: requestBody.tags method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.SecurityDevOps/azureDevOpsConnectors'].get update: x-apievangelist-phrasing: intent: List Azure DevOps connectors in a resource group effect: read questions: - Which Azure DevOps connectors for security DevOps are set up in my resource group? - Can I list Azure DevOps connectors for just one resource group? instructions: - text: List the Azure DevOps connectors in my resource group. - text: Show every Azure DevOps security connector in this resource group. method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.SecurityDevOps/azureDevOpsConnectors/{azureDevOpsConnectorName}'].get update: x-apievangelist-phrasing: intent: Get an Azure DevOps connector effect: read questions: - Can I view the configuration of one Azure DevOps connector by name? - What is the provisioning state of my Azure DevOps security connector? instructions: - text: Get Azure DevOps connector {connector}. slots: connector: path.azureDevOpsConnectorName - text: Show the settings of Azure DevOps connector {connector}. slots: connector: path.azureDevOpsConnectorName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.SecurityDevOps/azureDevOpsConnectors/{azureDevOpsConnectorName}'].put update: x-apievangelist-phrasing: intent: Create or replace an Azure DevOps connector effect: write questions: - How do I connect an Azure DevOps organization to security DevOps with a new connector? - Can I replace the full definition of an Azure DevOps connector in one call? instructions: - text: Create Azure DevOps connector {connector}. slots: connector: path.azureDevOpsConnectorName - text: Create or replace Azure DevOps connector {connector} with properties {properties}. slots: connector: path.azureDevOpsConnectorName properties: requestBody.properties method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.SecurityDevOps/azureDevOpsConnectors/{azureDevOpsConnectorName}'].delete update: x-apievangelist-phrasing: intent: Delete an Azure DevOps connector effect: destructive questions: - Can I disconnect Azure DevOps by deleting its security connector? - What stops being scanned when I remove an Azure DevOps connector? instructions: - text: Delete Azure DevOps connector {connector}. slots: connector: path.azureDevOpsConnectorName - text: Remove the {connector} Azure DevOps connector. slots: connector: path.azureDevOpsConnectorName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.SecurityDevOps/azureDevOpsConnectors/{azureDevOpsConnectorName}'].patch update: x-apievangelist-phrasing: intent: Patch an Azure DevOps connector effect: write questions: - Can I patch just a few properties on an existing Azure DevOps connector? - Is there a partial update for an Azure DevOps security connector? instructions: - text: Patch Azure DevOps connector {connector} with {properties}. slots: connector: path.azureDevOpsConnectorName properties: requestBody.properties - text: Apply a partial update to existing Azure DevOps connector {connector}. slots: connector: path.azureDevOpsConnectorName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.SecurityDevOps/azureDevOpsConnectors/{azureDevOpsConnectorName}/repos'].get update: x-apievangelist-phrasing: intent: List all repos behind an Azure DevOps connector effect: read questions: - Which repositories across all orgs and projects does my Azure DevOps connector see? - Can I get every Azure DevOps repo under a connector in one list? instructions: - text: List every repo onboarded through Azure DevOps connector {connector}. slots: connector: path.azureDevOpsConnectorName - text: Show all Azure DevOps repositories reachable by connector {connector}, across orgs. slots: connector: path.azureDevOpsConnectorName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.SecurityDevOps/azureDevOpsConnectors/{azureDevOpsConnectorName}/stats'].get update: x-apievangelist-phrasing: intent: Get stats for an Azure DevOps connector effect: read questions: - How many orgs, projects and repos is my Azure DevOps connector covering? - Where can I see summary statistics for an Azure DevOps connector? instructions: - text: Get the stats for Azure DevOps connector {connector}. slots: connector: path.azureDevOpsConnectorName - text: Show onboarding statistics of Azure DevOps connector {connector}. slots: connector: path.azureDevOpsConnectorName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.SecurityDevOps/azureDevOpsConnectors/{azureDevOpsConnectorName}/orgs'].get update: x-apievangelist-phrasing: intent: List Azure DevOps orgs under a connector effect: read questions: - Which Azure DevOps organizations are attached to my connector? - Can I list the orgs a security DevOps connector has onboarded? instructions: - text: List the Azure DevOps orgs under connector {connector}. slots: connector: path.azureDevOpsConnectorName - text: Show every organization onboarded by Azure DevOps connector {connector}. slots: connector: path.azureDevOpsConnectorName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.SecurityDevOps/azureDevOpsConnectors/{azureDevOpsConnectorName}/orgs/{azureDevOpsOrgName}'].get update: x-apievangelist-phrasing: intent: Get an Azure DevOps org on a connector effect: read questions: - Can I view one Azure DevOps organization's settings on my connector? - What state is a single onboarded Azure DevOps org in? instructions: - text: Get Azure DevOps org {org} on connector {connector}. slots: org: path.azureDevOpsOrgName connector: path.azureDevOpsConnectorName - text: Show the details of organization {org} under Azure DevOps connector {connector}. slots: org: path.azureDevOpsOrgName connector: path.azureDevOpsConnectorName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.SecurityDevOps/azureDevOpsConnectors/{azureDevOpsConnectorName}/orgs/{azureDevOpsOrgName}'].put update: x-apievangelist-phrasing: intent: Onboard or replace an Azure DevOps org effect: write questions: - How do I onboard an Azure DevOps organization onto an existing connector? - Can I fully replace the configuration of an org on my Azure DevOps connector? instructions: - text: Onboard Azure DevOps org {org} to connector {connector}. slots: org: path.azureDevOpsOrgName connector: path.azureDevOpsConnectorName - text: Create or replace org {org} on Azure DevOps connector {connector} with properties {properties}. slots: org: path.azureDevOpsOrgName connector: path.azureDevOpsConnectorName properties: requestBody.properties method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.SecurityDevOps/azureDevOpsConnectors/{azureDevOpsConnectorName}/orgs/{azureDevOpsOrgName}'].patch update: x-apievangelist-phrasing: intent: Patch an Azure DevOps org on a connector effect: write questions: - Can I change a single setting on an already onboarded Azure DevOps org? - Is a partial update supported for an Azure DevOps organization under a connector? instructions: - text: Patch Azure DevOps org {org} on connector {connector} with {properties}. slots: org: path.azureDevOpsOrgName connector: path.azureDevOpsConnectorName properties: requestBody.properties - text: Apply a partial update to onboarded organization {org} of connector {connector}. slots: org: path.azureDevOpsOrgName connector: path.azureDevOpsConnectorName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.SecurityDevOps/azureDevOpsConnectors/{azureDevOpsConnectorName}/orgs/{azureDevOpsOrgName}/projects'].get update: x-apievangelist-phrasing: intent: List projects in an Azure DevOps org effect: read questions: - Which Azure DevOps projects in an organization are onboarded to my connector? - Can I list the projects of one Azure DevOps org through its connector? instructions: - text: List the projects in Azure DevOps org {org} on connector {connector}. slots: org: path.azureDevOpsOrgName connector: path.azureDevOpsConnectorName - text: Show every onboarded project of organization {org}. slots: org: path.azureDevOpsOrgName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.SecurityDevOps/azureDevOpsConnectors/{azureDevOpsConnectorName}/orgs/{azureDevOpsOrgName}/projects/{azureDevOpsProjectName}'].get update: x-apievangelist-phrasing: intent: Get an Azure DevOps project effect: read questions: - Can I look up a single onboarded Azure DevOps project? - What does the connector record for one Azure DevOps project look like? instructions: - text: Get Azure DevOps project {project} in org {org} on connector {connector}. slots: project: path.azureDevOpsProjectName org: path.azureDevOpsOrgName connector: path.azureDevOpsConnectorName - text: Show the details of project {project} in organization {org}. slots: project: path.azureDevOpsProjectName org: path.azureDevOpsOrgName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.SecurityDevOps/azureDevOpsConnectors/{azureDevOpsConnectorName}/orgs/{azureDevOpsOrgName}/projects/{azureDevOpsProjectName}'].put update: x-apievangelist-phrasing: intent: Onboard or replace an Azure DevOps project effect: write questions: - How do I onboard a specific Azure DevOps project under an org on my connector? - Can I overwrite the whole configuration of an onboarded Azure DevOps project? instructions: - text: Onboard Azure DevOps project {project} in org {org} on connector {connector}. slots: project: path.azureDevOpsProjectName org: path.azureDevOpsOrgName connector: path.azureDevOpsConnectorName - text: Create or replace project {project} of org {org} with properties {properties}. slots: project: path.azureDevOpsProjectName org: path.azureDevOpsOrgName properties: requestBody.properties method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.SecurityDevOps/azureDevOpsConnectors/{azureDevOpsConnectorName}/orgs/{azureDevOpsOrgName}/projects/{azureDevOpsProjectName}'].patch update: x-apievangelist-phrasing: intent: Patch an Azure DevOps project effect: write questions: - Can I tweak one property of an onboarded Azure DevOps project without replacing it? - Does the connector support partial updates to Azure DevOps projects? instructions: - text: Patch Azure DevOps project {project} in org {org} on connector {connector} with {properties}. slots: project: path.azureDevOpsProjectName org: path.azureDevOpsOrgName connector: path.azureDevOpsConnectorName properties: requestBody.properties - text: Apply a partial update to onboarded project {project}. slots: project: path.azureDevOpsProjectName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.SecurityDevOps/azureDevOpsConnectors/{azureDevOpsConnectorName}/orgs/{azureDevOpsOrgName}/projects/{azureDevOpsProjectName}/repos'].get update: x-apievangelist-phrasing: intent: List repos in an Azure DevOps project effect: read questions: - Which repositories inside one Azure DevOps project are onboarded? - Can I list the repos of a single project rather than the whole connector? instructions: - text: List the repos in Azure DevOps project {project}, org {org}, connector {connector}. slots: project: path.azureDevOpsProjectName org: path.azureDevOpsOrgName connector: path.azureDevOpsConnectorName - text: Show the repositories of project {project} only. slots: project: path.azureDevOpsProjectName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.SecurityDevOps/azureDevOpsConnectors/{azureDevOpsConnectorName}/orgs/{azureDevOpsOrgName}/projects/{azureDevOpsProjectName}/repos/{azureDevOpsRepoName}'].get update: x-apievangelist-phrasing: intent: Get an Azure DevOps repo effect: read questions: - Can I look up one onboarded Azure DevOps repository by name? - What does the security connector know about a single Azure DevOps repo? instructions: - text: Get Azure DevOps repo {repo} in project {project}, org {org}, connector {connector}. slots: repo: path.azureDevOpsRepoName project: path.azureDevOpsProjectName org: path.azureDevOpsOrgName connector: path.azureDevOpsConnectorName - text: Show the details of repository {repo} in project {project}. slots: repo: path.azureDevOpsRepoName project: path.azureDevOpsProjectName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.SecurityDevOps/azureDevOpsConnectors/{azureDevOpsConnectorName}/orgs/{azureDevOpsOrgName}/projects/{azureDevOpsProjectName}/repos/{azureDevOpsRepoName}'].put update: x-apievangelist-phrasing: intent: Onboard or replace an Azure DevOps repo effect: write questions: - How do I onboard an individual Azure DevOps repository to my connector? - Can I replace the whole configuration of an onboarded Azure DevOps repo? instructions: - text: Onboard Azure DevOps repo {repo} in project {project}, org {org}, connector {connector}. slots: repo: path.azureDevOpsRepoName project: path.azureDevOpsProjectName org: path.azureDevOpsOrgName connector: path.azureDevOpsConnectorName - text: Create or replace repository {repo} of project {project} with properties {properties}. slots: repo: path.azureDevOpsRepoName project: path.azureDevOpsProjectName properties: requestBody.properties method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.SecurityDevOps/azureDevOpsConnectors/{azureDevOpsConnectorName}/orgs/{azureDevOpsOrgName}/projects/{azureDevOpsProjectName}/repos/{azureDevOpsRepoName}'].patch update: x-apievangelist-phrasing: intent: Patch an Azure DevOps repo effect: write questions: - Can I change a single property of an onboarded Azure DevOps repository? - Is there a partial update for one repo under my Azure DevOps connector? instructions: - text: Patch Azure DevOps repo {repo} in project {project}, org {org}, connector {connector} with {properties}. slots: repo: path.azureDevOpsRepoName project: path.azureDevOpsProjectName org: path.azureDevOpsOrgName connector: path.azureDevOpsConnectorName properties: requestBody.properties - text: Apply a partial update to onboarded repository {repo}. slots: repo: path.azureDevOpsRepoName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.SecurityDevOps/gitHubConnectors'].get update: x-apievangelist-phrasing: intent: List gitHubConnector resources in a resource group effect: read questions: - Which gitHubConnector resources for security DevOps are in my resource group? - Can I list code-hosting connectors of the gitHubConnectors type for one resource group? instructions: - text: List the gitHubConnectors in my resource group. - text: Show every gitHubConnector defined in this resource group. method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.SecurityDevOps/gitHubConnectors/{gitHubConnectorName}'].get update: x-apievangelist-phrasing: intent: Get a gitHubConnector effect: read questions: - Can I view the configuration of one gitHubConnector by name? - What provisioning state is my gitHubConnector in? instructions: - text: Get gitHubConnector {connector}. slots: connector: path.gitHubConnectorName - text: Show the settings of gitHubConnector {connector}. slots: connector: path.gitHubConnectorName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.SecurityDevOps/gitHubConnectors/{gitHubConnectorName}'].put update: x-apievangelist-phrasing: intent: Create or replace a gitHubConnector effect: write questions: - How do I set up a new gitHubConnector for security DevOps? - Can I overwrite the full definition of an existing gitHubConnector? instructions: - text: Create gitHubConnector {connector}. slots: connector: path.gitHubConnectorName - text: Create or replace gitHubConnector {connector} with properties {properties}. slots: connector: path.gitHubConnectorName properties: requestBody.properties method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.SecurityDevOps/gitHubConnectors/{gitHubConnectorName}'].delete update: x-apievangelist-phrasing: intent: Delete a gitHubConnector effect: destructive questions: - Can I delete a gitHubConnector to stop onboarding its repositories? - What goes away when a gitHubConnector is removed? instructions: - text: Delete gitHubConnector {connector}. slots: connector: path.gitHubConnectorName - text: Remove the {connector} gitHubConnector. slots: connector: path.gitHubConnectorName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.SecurityDevOps/gitHubConnectors/{gitHubConnectorName}'].patch update: x-apievangelist-phrasing: intent: Patch a gitHubConnector effect: write questions: - Can I patch only a few properties on an existing gitHubConnector? - Does a gitHubConnector support partial updates? instructions: - text: Patch gitHubConnector {connector} with {properties}. slots: connector: path.gitHubConnectorName properties: requestBody.properties - text: Apply a partial update to existing gitHubConnector {connector}. slots: connector: path.gitHubConnectorName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.SecurityDevOps/gitHubConnectors/{gitHubConnectorName}/repos'].get update: x-apievangelist-phrasing: intent: List all repos behind a gitHubConnector effect: read questions: - Which repositories across every owner does my gitHubConnector see? - Can I get all repos of a gitHubConnector in one list regardless of owner? instructions: - text: List every repo onboarded through gitHubConnector {connector}. slots: connector: path.gitHubConnectorName - text: Show all repositories reachable by gitHubConnector {connector}, across owners. slots: connector: path.gitHubConnectorName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.SecurityDevOps/gitHubConnectors/{gitHubConnectorName}/stats'].get update: x-apievangelist-phrasing: intent: Get stats for a gitHubConnector effect: read questions: - How many owners and repos is my gitHubConnector covering? - Where do I see summary statistics for a gitHubConnector? instructions: - text: Get the stats for gitHubConnector {connector}. slots: connector: path.gitHubConnectorName - text: Show onboarding statistics of gitHubConnector {connector}. slots: connector: path.gitHubConnectorName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.SecurityDevOps/gitHubConnectors/{gitHubConnectorName}/owners'].get update: x-apievangelist-phrasing: intent: List owners under a gitHubConnector effect: read questions: - Which gitHubOwner accounts are attached to my connector? - Can I list the owners a gitHubConnector has onboarded? instructions: - text: List the gitHubOwners under connector {connector}. slots: connector: path.gitHubConnectorName - text: Show every owner onboarded by gitHubConnector {connector}. slots: connector: path.gitHubConnectorName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.SecurityDevOps/gitHubConnectors/{gitHubConnectorName}/owners/{gitHubOwnerName}'].get update: x-apievangelist-phrasing: intent: Get an owner on a gitHubConnector effect: read questions: - Can I view one gitHubOwner's settings on my connector? - What state is a single onboarded gitHubOwner in? instructions: - text: Get gitHubOwner {owner} on connector {connector}. slots: owner: path.gitHubOwnerName connector: path.gitHubConnectorName - text: Show the details of owner {owner} under gitHubConnector {connector}. slots: owner: path.gitHubOwnerName connector: path.gitHubConnectorName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.SecurityDevOps/gitHubConnectors/{gitHubConnectorName}/owners/{gitHubOwnerName}'].put update: x-apievangelist-phrasing: intent: Onboard or replace an owner on a gitHubConnector effect: write questions: - How do I onboard a new owner account onto an existing gitHubConnector? - Can I fully replace the configuration of a gitHubOwner? instructions: - text: Onboard gitHubOwner {owner} to connector {connector}. slots: owner: path.gitHubOwnerName connector: path.gitHubConnectorName - text: Create or replace owner {owner} on gitHubConnector {connector} with properties {properties}. slots: owner: path.gitHubOwnerName connector: path.gitHubConnectorName properties: requestBody.properties method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.SecurityDevOps/gitHubConnectors/{gitHubConnectorName}/owners/{gitHubOwnerName}'].patch update: x-apievangelist-phrasing: intent: Patch an owner on a gitHubConnector effect: write questions: - Can I change a single setting on an already onboarded gitHubOwner? - Is a partial update supported for an owner under a gitHubConnector? instructions: - text: Patch gitHubOwner {owner} on connector {connector} with {properties}. slots: owner: path.gitHubOwnerName connector: path.gitHubConnectorName properties: requestBody.properties - text: Apply a partial update to onboarded owner {owner} of gitHubConnector {connector}. slots: owner: path.gitHubOwnerName connector: path.gitHubConnectorName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.SecurityDevOps/gitHubConnectors/{gitHubConnectorName}/owners/{gitHubOwnerName}/repos'].get update: x-apievangelist-phrasing: intent: List repos of one owner on a gitHubConnector effect: read questions: - Which repositories of one gitHubOwner are onboarded? - Can I list repos for a single owner rather than the whole gitHubConnector? instructions: - text: List the gitHubRepos of owner {owner} on connector {connector}. slots: owner: path.gitHubOwnerName connector: path.gitHubConnectorName - text: Show the repositories belonging to owner {owner} only. slots: owner: path.gitHubOwnerName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.SecurityDevOps/gitHubConnectors/{gitHubConnectorName}/owners/{gitHubOwnerName}/repos/{gitHubRepoName}'].get update: x-apievangelist-phrasing: intent: Get a repo on a gitHubConnector effect: read questions: - Can I look up one onboarded gitHubRepo by name? - What does the security connector record about a single gitHubRepo? instructions: - text: Get gitHubRepo {repo} of owner {owner} on connector {connector}. slots: repo: path.gitHubRepoName owner: path.gitHubOwnerName connector: path.gitHubConnectorName - text: Show the details of repository {repo} owned by {owner}. slots: repo: path.gitHubRepoName owner: path.gitHubOwnerName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.SecurityDevOps/gitHubConnectors/{gitHubConnectorName}/owners/{gitHubOwnerName}/repos/{gitHubRepoName}'].put update: x-apievangelist-phrasing: intent: Onboard or replace a repo on a gitHubConnector effect: write questions: - How do I onboard an individual repository under a gitHubOwner? - Can I replace the whole configuration of an onboarded gitHubRepo? instructions: - text: Onboard gitHubRepo {repo} of owner {owner} on connector {connector}. slots: repo: path.gitHubRepoName owner: path.gitHubOwnerName connector: path.gitHubConnectorName - text: Create or replace repository {repo} of owner {owner} with properties {properties}. slots: repo: path.gitHubRepoName owner: path.gitHubOwnerName properties: requestBody.properties method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.SecurityDevOps/gitHubConnectors/{gitHubConnectorName}/owners/{gitHubOwnerName}/repos/{gitHubRepoName}'].patch update: x-apievangelist-phrasing: intent: Patch a repo on a gitHubConnector effect: write questions: - Can I change one property of an onboarded gitHubRepo without replacing it? - Is there a partial update for a single repo under my gitHubConnector? instructions: - text: Patch gitHubRepo {repo} of owner {owner} on connector {connector} with {properties}. slots: repo: path.gitHubRepoName owner: path.gitHubOwnerName connector: path.gitHubConnectorName properties: requestBody.properties - text: Apply a partial update to onboarded gitHubRepo {repo}. slots: repo: path.gitHubRepoName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.SecurityDevOps/gitHubConnectors'].get update: x-apievangelist-phrasing: intent: List gitHubConnectors across a subscription effect: read questions: - Which gitHubConnectors exist anywhere in my subscription? - Can I list gitHubConnectors subscription-wide instead of by resource group? instructions: - text: List every gitHubConnector across my subscription. - text: Show all gitHubConnectors in the whole subscription. method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.SecurityDevOps/azureDevOpsConnectors'].get update: x-apievangelist-phrasing: intent: List Azure DevOps connectors across a subscription effect: read questions: - Which Azure DevOps connectors exist anywhere in my subscription? - Can I list Azure DevOps connectors subscription-wide instead of by resource group? instructions: - text: List every Azure DevOps connector across my subscription. - text: Show all Azure DevOps connectors in the whole subscription. method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourcegroups/{resourceGroupName}/providers/Microsoft.ServiceLinker/locations/{location}/connectors'].get update: x-apievangelist-phrasing: intent: List Service Connector links at a location effect: read questions: - Which Service Connector links configure target services for resources at a location? - Can I see the connectors created during resource provisioning in my subscription? instructions: - text: List the Service Connector connectors in subscription {subscription}. slots: subscription: path.subscriptionId - text: Show every service linker connection defined at location {location}. slots: location: path.location method: generated generated: '2026-10-01' - target: $.paths['/subscriptions/{subscriptionId}/resourcegroups/{resourceGroupName}/providers/Microsoft.ServiceLinker/locations/{location}/connectors/{connectorName}'].get update: x-apievangelist-phrasing: intent: Get a Service Connector link effect: read questions: - Can I look up one Service Connector link by its name? - What does the configuration of a specific service linker connector contain? instructions: - text: Get Service Connector {connector} in subscription {subscription}. slots: connector: path.connectorName subscription: path.subscriptionId - text: Show the configuration of service linker connector {connector} at location {location}. slots: connector: path.connectorName location: path.location method: generated generated: '2026-10-01' - target: $.paths['/subscriptions/{subscriptionId}/resourcegroups/{resourceGroupName}/providers/Microsoft.ServiceLinker/locations/{location}/connectors/{connectorName}'].put update: x-apievangelist-phrasing: intent: Create or update a Service Connector link effect: write questions: - How do I create a Service Connector link that wires a resource to a target service? - Can I change the properties of an existing service linker connector? instructions: - text: Create Service Connector {connector} in subscription {subscription} with properties {properties}. slots: connector: path.connectorName subscription: path.subscriptionId properties: requestBody.properties - text: Update service linker connector {connector} at location {location} to use properties {properties}. slots: connector: path.connectorName location: path.location properties: requestBody.properties method: generated generated: '2026-10-01' - target: $.paths['/subscriptions/{subscriptionId}/providers/microsoft.insights/privateLinkScopes'].get update: x-apievangelist-phrasing: intent: List Azure Monitor private link scopes in a subscription effect: read questions: - Which Azure Monitor private link scopes exist across my entire subscription? - Can I list every Monitor private link scope subscription-wide? instructions: - text: List all Azure Monitor private link scopes in my subscription. - text: Show every Monitor private link scope across the subscription. method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/microsoft.insights/privateLinkScopes'].get update: x-apievangelist-phrasing: intent: List Azure Monitor private link scopes in a resource group effect: read questions: - What Azure Monitor private link scopes are in one resource group? - Can I narrow the Monitor private link scope list to a single resource group? instructions: - text: List the Azure Monitor private link scopes in my resource group. - text: Show the Monitor private link scopes defined in this resource group only. method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/microsoft.insights/privateLinkScopes/{scopeName}'].get update: x-apievangelist-phrasing: intent: Get an Azure Monitor private link scope effect: read questions: - Can I fetch one Azure Monitor private link scope by name? - What configuration does my Monitor private link scope currently have? instructions: - text: Get Azure Monitor private link scope {scope}. slots: scope: path.scopeName - text: Show the details of Monitor private link scope {scope}. slots: scope: path.scopeName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/microsoft.insights/privateLinkScopes/{scopeName}'].put update: x-apievangelist-phrasing: intent: Create or update an Azure Monitor private link scope effect: write questions: - How do I create a private link scope for Azure Monitor? - Can I change an Azure Monitor private link scope's InstrumentationKey or AppId on update? instructions: - text: Create Azure Monitor private link scope {scope} with properties {properties}. slots: scope: path.scopeName properties: requestBody.properties - text: Update the properties of Monitor private link scope {scope} to {properties}. slots: scope: path.scopeName properties: requestBody.properties method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/microsoft.insights/privateLinkScopes/{scopeName}'].delete update: x-apievangelist-phrasing: intent: Delete an Azure Monitor private link scope effect: destructive questions: - Can I delete an Azure Monitor private link scope I no longer use? - What happens to private monitoring traffic when a Monitor private link scope is removed? instructions: - text: Delete Azure Monitor private link scope {scope}. slots: scope: path.scopeName - text: Remove Monitor private link scope {scope}. slots: scope: path.scopeName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/microsoft.insights/privateLinkScopes/{scopeName}'].patch update: x-apievangelist-phrasing: intent: Update tags on an Azure Monitor private link scope effect: write questions: - Can I change only the tags on an Azure Monitor private link scope? - Is there a tags-only update for a Monitor private link scope? instructions: - text: Set tags {tags} on Azure Monitor private link scope {scope}. slots: tags: requestBody.tags scope: path.scopeName - text: Retag Monitor private link scope {scope} with {tags}. slots: scope: path.scopeName tags: requestBody.tags method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.NetworkCloud/bareMetalMachines'].get update: x-apievangelist-phrasing: intent: List bare metal machines in a subscription effect: read questions: - Which Network Cloud bare metal machines exist across my whole subscription? - Can I see every bare metal machine subscription-wide? instructions: - text: List all bare metal machines in my subscription. - text: Show every Network Cloud bare metal machine across the subscription. method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.NetworkCloud/cloudServicesNetworks'].get update: x-apievangelist-phrasing: intent: List cloud services networks in a subscription effect: read questions: - What cloud services networks are defined across my subscription? - Can I list Network Cloud cloud services networks subscription-wide? instructions: - text: List all cloud services networks in my subscription. - text: Show every cloud services network across the subscription. method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.NetworkCloud/clusterManagers'].get update: x-apievangelist-phrasing: intent: List cluster managers in a subscription effect: read questions: - Which Network Cloud cluster managers exist in my subscription? - Can I see all cluster managers across every resource group? instructions: - text: List all cluster managers in my subscription. - text: Show every Network Cloud cluster manager subscription-wide. method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.NetworkCloud/clusters'].get update: x-apievangelist-phrasing: intent: List Network Cloud clusters in a subscription effect: read questions: - What Network Cloud clusters are deployed across my subscription? - Can I list every on-premises Network Cloud cluster subscription-wide? instructions: - text: List all Network Cloud clusters in my subscription. - text: Show every Network Cloud cluster across the whole subscription. method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.NetworkCloud/kubernetesClusters'].get update: x-apievangelist-phrasing: intent: List Network Cloud Kubernetes clusters in a subscription effect: read questions: - Which Network Cloud Kubernetes clusters are running across my subscription? - Can I see all Kubernetes clusters on Network Cloud subscription-wide? instructions: - text: Enumerate all Kubernetes clusters that my subscription runs on Network Cloud. - text: Show every Kubernetes cluster on Network Cloud across the subscription. method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.NetworkCloud/l2Networks'].get update: x-apievangelist-phrasing: intent: List L2 networks in a subscription effect: read questions: - What layer 2 networks exist across my subscription? - Can I list every L2 network subscription-wide? instructions: - text: List all L2 networks in my subscription. - text: Show every layer 2 network across the subscription. method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.NetworkCloud/l3Networks'].get update: x-apievangelist-phrasing: intent: List L3 networks in a subscription effect: read questions: - What layer 3 networks exist across my subscription? - Can I list every L3 network subscription-wide? instructions: - text: List all L3 networks in my subscription. - text: Show every layer 3 network across the subscription. method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.NetworkCloud/rackSkus'].get update: x-apievangelist-phrasing: intent: List available rack SKUs effect: read questions: - Which rack SKUs are available to my subscription for Network Cloud? - What rack hardware SKUs can I choose from? instructions: - text: List the rack SKUs available in my subscription. - text: Show every Network Cloud rack SKU I can use. method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.NetworkCloud/rackSkus/{rackSkuName}'].get update: x-apievangelist-phrasing: intent: Get a rack SKU effect: read questions: - Can I see the properties of one specific rack SKU? - What hardware does a given Network Cloud rack SKU describe? instructions: - text: Get rack SKU {rack_sku}. slots: rack_sku: path.rackSkuName - text: Show the properties of rack SKU {rack_sku}. slots: rack_sku: path.rackSkuName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.NetworkCloud/racks'].get update: x-apievangelist-phrasing: intent: List racks in a subscription effect: read questions: - What Network Cloud racks exist across my subscription? - Can I list every rack subscription-wide rather than per resource group? instructions: - text: List all racks in my subscription. - text: Show every Network Cloud rack across the subscription. method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.NetworkCloud/storageAppliances'].get update: x-apievangelist-phrasing: intent: List storage appliances in a subscription effect: read questions: - Which storage appliances are registered across my subscription? - Can I list every Network Cloud storage appliance subscription-wide? instructions: - text: List all storage appliances in my subscription. - text: Show every Network Cloud storage appliance across the subscription. method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.NetworkCloud/trunkedNetworks'].get update: x-apievangelist-phrasing: intent: List trunked networks in a subscription effect: read questions: - What trunked networks exist across my subscription? - Can I list every trunked network subscription-wide? instructions: - text: List all trunked networks in my subscription. - text: Show every Network Cloud trunked network across the subscription. method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.NetworkCloud/virtualMachines'].get update: x-apievangelist-phrasing: intent: List Network Cloud virtual machines in a subscription effect: read questions: - Which Network Cloud virtual machines are running across my subscription? - Can I list every Network Cloud VM subscription-wide? instructions: - text: List all Network Cloud virtual machines in my subscription. - text: Show every Network Cloud VM across the whole subscription. method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.NetworkCloud/volumes'].get update: x-apievangelist-phrasing: intent: List Network Cloud volumes in a subscription effect: read questions: - What Network Cloud volumes exist across my subscription? - Can I list every storage volume subscription-wide? instructions: - text: List all Network Cloud volumes in my subscription. - text: Show every Network Cloud volume across the subscription. method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.NetworkCloud/bareMetalMachines'].get update: x-apievangelist-phrasing: intent: List bare metal machines in a resource group effect: read questions: - Which bare metal machines are in one of my resource groups? - Can I narrow the bare metal machine list to a single resource group? instructions: - text: List the bare metal machines in my resource group. - text: Show bare metal machines belonging to this resource group only. method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.NetworkCloud/bareMetalMachines/{bareMetalMachineName}'].get update: x-apievangelist-phrasing: intent: Get a bare metal machine effect: read questions: - Can I check the properties and state of one bare metal machine? - What does a specific Network Cloud bare metal machine report? instructions: - text: Get bare metal machine {machine}. slots: machine: path.bareMetalMachineName - text: Show the properties of bare metal machine {machine}. slots: machine: path.bareMetalMachineName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.NetworkCloud/bareMetalMachines/{bareMetalMachineName}'].put update: x-apievangelist-phrasing: intent: Create or update a bare metal machine record effect: write questions: - Can I create a bare metal machine myself, or is its lifecycle managed by the system? - Why are my requests to create a bare metal machine rejected? instructions: - text: Create bare metal machine {machine} at extended location {extended_location} with properties {properties}. slots: machine: path.bareMetalMachineName extended_location: requestBody.extendedLocation properties: requestBody.properties - text: Replace the definition of bare metal machine {machine}. slots: machine: path.bareMetalMachineName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.NetworkCloud/bareMetalMachines/{bareMetalMachineName}'].delete update: x-apievangelist-phrasing: intent: Delete a bare metal machine record effect: destructive questions: - Can I delete a bare metal machine resource, given the system manages its lifecycle? - What happens if I try to remove a Network Cloud bare metal machine directly? instructions: - text: Delete bare metal machine {machine}. slots: machine: path.bareMetalMachineName - text: Remove the {machine} bare metal machine resource. slots: machine: path.bareMetalMachineName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.NetworkCloud/bareMetalMachines/{bareMetalMachineName}'].patch update: x-apievangelist-phrasing: intent: Patch a bare metal machine's properties or tags effect: write questions: - Can I update tags on a bare metal machine without touching its other properties? - Is it possible to patch a bare metal machine's properties in place? instructions: - text: Set tags {tags} on bare metal machine {machine}. slots: tags: requestBody.tags machine: path.bareMetalMachineName - text: Patch bare metal machine {machine} with properties {properties}. slots: machine: path.bareMetalMachineName properties: requestBody.properties method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.NetworkCloud/bareMetalMachines/{bareMetalMachineName}/cordon'].post update: x-apievangelist-phrasing: intent: Cordon a bare metal machine's Kubernetes node effect: write questions: - How do I cordon the Kubernetes node on a bare metal machine before maintenance? - Can I evacuate workloads while cordoning a bare metal machine? instructions: - text: Cordon bare metal machine {machine}. slots: machine: path.bareMetalMachineName - text: Cordon bare metal machine {machine} and set evacuate to {evacuate}. slots: machine: path.bareMetalMachineName evacuate: requestBody.evacuate method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.NetworkCloud/bareMetalMachines/{bareMetalMachineName}/powerOff'].post update: x-apievangelist-phrasing: intent: Power off a bare metal machine effect: write questions: - How do I power off a bare metal machine? - Can I skip the graceful shutdown when powering off a bare metal machine? instructions: - text: Power off bare metal machine {machine}. slots: machine: path.bareMetalMachineName - text: Power off bare metal machine {machine} with skip shutdown set to {skip_shutdown}. slots: machine: path.bareMetalMachineName skip_shutdown: requestBody.skipShutdown method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.NetworkCloud/bareMetalMachines/{bareMetalMachineName}/reimage'].post update: x-apievangelist-phrasing: intent: Reimage a bare metal machine effect: destructive questions: - Can I reimage a bare metal machine to reinstall its operating system? - What does reimaging a Network Cloud bare metal machine do to what is on it? instructions: - text: Reimage bare metal machine {machine}. slots: machine: path.bareMetalMachineName - text: Wipe and reimage the {machine} bare metal server. slots: machine: path.bareMetalMachineName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.NetworkCloud/bareMetalMachines/{bareMetalMachineName}/replace'].post update: x-apievangelist-phrasing: intent: Replace a bare metal machine's hardware effect: write questions: - How do I register replacement hardware for a failed bare metal machine? - Which details, such as serial number and BMC MAC address, do I supply when replacing a bare metal machine? instructions: - text: Replace bare metal machine {machine} with new hardware serial number {serial}. slots: machine: path.bareMetalMachineName serial: requestBody.serialNumber - text: Replace bare metal machine {machine} using BMC MAC {bmc_mac} and boot MAC {boot_mac}. slots: machine: path.bareMetalMachineName bmc_mac: requestBody.bmcMacAddress boot_mac: requestBody.bootMacAddress method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.NetworkCloud/bareMetalMachines/{bareMetalMachineName}/restart'].post update: x-apievangelist-phrasing: intent: Restart a bare metal machine effect: write questions: - How do I reboot a bare metal machine? - Can I restart a Network Cloud bare metal server remotely? instructions: - text: Restart bare metal machine {machine}. slots: machine: path.bareMetalMachineName - text: Reboot the {machine} bare metal server. slots: machine: path.bareMetalMachineName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.NetworkCloud/bareMetalMachines/{bareMetalMachineName}/runCommand'].post update: x-apievangelist-phrasing: intent: Run a script on a bare metal machine effect: write questions: - Can I run my own script on a bare metal machine and collect the exit code? - Where do the results of a script run on a bare metal machine end up? instructions: - text: Run script {script} on bare metal machine {machine} with a time limit of {limit_seconds} seconds. slots: script: requestBody.script machine: path.bareMetalMachineName limit_seconds: requestBody.limitTimeSeconds - text: Run script {script} on machine {machine} passing arguments {arguments}. slots: script: requestBody.script machine: path.bareMetalMachineName arguments: requestBody.arguments method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.NetworkCloud/bareMetalMachines/{bareMetalMachineName}/runDataExtracts'].post update: x-apievangelist-phrasing: intent: Run data extractions on a bare metal machine effect: write questions: - How do I pull diagnostic data extracts off a bare metal machine? - Can I run several data extraction commands on a bare metal machine at once? instructions: - text: Run data extracts {commands} on bare metal machine {machine} within {limit_seconds} seconds. slots: commands: requestBody.commands machine: path.bareMetalMachineName limit_seconds: requestBody.limitTimeSeconds - text: Extract diagnostic data from bare metal machine {machine} using commands {commands}. slots: machine: path.bareMetalMachineName commands: requestBody.commands method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.NetworkCloud/bareMetalMachines/{bareMetalMachineName}/runReadCommands'].post update: x-apievangelist-phrasing: intent: Run read-only commands on a bare metal machine effect: read questions: - Can I run only read-only commands on a bare metal machine to inspect it safely? - What limits apply to read-only command runs on a bare metal machine? instructions: - text: Run read-only commands {commands} on bare metal machine {machine} with a {limit_seconds}-second limit. slots: commands: requestBody.commands machine: path.bareMetalMachineName limit_seconds: requestBody.limitTimeSeconds - text: Inspect bare metal machine {machine} by running read-only commands {commands}. slots: machine: path.bareMetalMachineName commands: requestBody.commands method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.NetworkCloud/bareMetalMachines/{bareMetalMachineName}/start'].post update: x-apievangelist-phrasing: intent: Start a bare metal machine effect: write questions: - How do I power on a bare metal machine that is off? - Can I start a stopped Network Cloud bare metal machine? instructions: - text: Start bare metal machine {machine}. slots: machine: path.bareMetalMachineName - text: Power on the {machine} bare metal server. slots: machine: path.bareMetalMachineName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.NetworkCloud/bareMetalMachines/{bareMetalMachineName}/uncordon'].post update: x-apievangelist-phrasing: intent: Uncordon a bare metal machine's Kubernetes node effect: write questions: - How do I make a cordoned bare metal machine schedulable again? - Can I uncordon a bare metal machine's Kubernetes node after maintenance? instructions: - text: Uncordon bare metal machine {machine}. slots: machine: path.bareMetalMachineName - text: Return bare metal machine {machine} to scheduling by uncordoning its node. slots: machine: path.bareMetalMachineName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.NetworkCloud/cloudServicesNetworks'].get update: x-apievangelist-phrasing: intent: List cloud services networks in a resource group effect: read questions: - Which cloud services networks are in one of my resource groups? - Can I narrow cloud services networks to a single resource group? instructions: - text: List the cloud services networks in my resource group. - text: Show cloud services networks belonging to this resource group only. method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.NetworkCloud/cloudServicesNetworks/{cloudServicesNetworkName}'].get update: x-apievangelist-phrasing: intent: Get a cloud services network effect: read questions: - Can I see the properties of one cloud services network? - What does a specific Network Cloud cloud services network contain? instructions: - text: Get cloud services network {network}. slots: network: path.cloudServicesNetworkName - text: Show the properties of cloud services network {network}. slots: network: path.cloudServicesNetworkName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.NetworkCloud/cloudServicesNetworks/{cloudServicesNetworkName}'].put update: x-apievangelist-phrasing: intent: Create or update a cloud services network effect: write questions: - How do I create a cloud services network at a Network Cloud extended location? - Can I replace the properties of an existing cloud services network? instructions: - text: Create cloud services network {network} at extended location {extended_location}. slots: network: path.cloudServicesNetworkName extended_location: requestBody.extendedLocation - text: Create or replace cloud services network {network} with properties {properties}. slots: network: path.cloudServicesNetworkName properties: requestBody.properties method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.NetworkCloud/cloudServicesNetworks/{cloudServicesNetworkName}'].delete update: x-apievangelist-phrasing: intent: Delete a cloud services network effect: destructive questions: - Can I delete a cloud services network I no longer need? - What is removed when a Network Cloud cloud services network is deleted? instructions: - text: Delete cloud services network {network}. slots: network: path.cloudServicesNetworkName - text: Remove the {network} cloud services network. slots: network: path.cloudServicesNetworkName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.NetworkCloud/cloudServicesNetworks/{cloudServicesNetworkName}'].patch update: x-apievangelist-phrasing: intent: Patch a cloud services network's properties or tags effect: write questions: - Can I update tags on a cloud services network independently of its properties? - Is it possible to patch a cloud services network in place? instructions: - text: Set tags {tags} on cloud services network {network}. slots: tags: requestBody.tags network: path.cloudServicesNetworkName - text: Patch cloud services network {network} with properties {properties}. slots: network: path.cloudServicesNetworkName properties: requestBody.properties method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.NetworkCloud/clusterManagers'].get update: x-apievangelist-phrasing: intent: List cluster managers in a resource group effect: read questions: - Which cluster managers are in one of my resource groups? - Can I narrow the cluster manager list to a single resource group? instructions: - text: List the cluster managers in my resource group. - text: Show cluster managers belonging to this resource group only. method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.NetworkCloud/clusterManagers/{clusterManagerName}'].get update: x-apievangelist-phrasing: intent: Get a cluster manager effect: read questions: - Can I see the properties of one Network Cloud cluster manager? - What state is a specific cluster manager in? instructions: - text: Get cluster manager {manager}. slots: manager: path.clusterManagerName - text: Show the properties of cluster manager {manager}. slots: manager: path.clusterManagerName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.NetworkCloud/clusterManagers/{clusterManagerName}'].put update: x-apievangelist-phrasing: intent: Create or update a cluster manager effect: write questions: - How do I create a Network Cloud cluster manager? - Can I replace the properties of a cluster manager that already exists? instructions: - text: Create cluster manager {manager} with properties {properties}. slots: manager: path.clusterManagerName properties: requestBody.properties - text: Create or replace the definition of cluster manager {manager}. slots: manager: path.clusterManagerName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.NetworkCloud/clusterManagers/{clusterManagerName}'].delete update: x-apievangelist-phrasing: intent: Delete a cluster manager effect: destructive questions: - Can I delete a Network Cloud cluster manager? - What happens when a cluster manager is removed? instructions: - text: Delete cluster manager {manager}. slots: manager: path.clusterManagerName - text: Remove the {manager} cluster manager. slots: manager: path.clusterManagerName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.NetworkCloud/clusterManagers/{clusterManagerName}'].patch update: x-apievangelist-phrasing: intent: Update tags on a cluster manager effect: write questions: - Can I change the tags on a cluster manager? - Is there a patch operation to retag a Network Cloud cluster manager? instructions: - text: Set tags {tags} on cluster manager {manager}. slots: tags: requestBody.tags manager: path.clusterManagerName - text: Retag cluster manager {manager} with {tags}. slots: manager: path.clusterManagerName tags: requestBody.tags method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.NetworkCloud/clusters'].get update: x-apievangelist-phrasing: intent: List Network Cloud clusters in a resource group effect: read questions: - Which Network Cloud clusters are in one of my resource groups? - Can I narrow the Network Cloud cluster list to one resource group? instructions: - text: List the Network Cloud clusters in my resource group. - text: Show Network Cloud clusters belonging to this resource group only. method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.NetworkCloud/clusters/{clusterName}'].get update: x-apievangelist-phrasing: intent: Get a Network Cloud cluster effect: read questions: - Can I see the properties and status of one Network Cloud cluster? - What does a specific Network Cloud cluster report about itself? instructions: - text: Get Network Cloud cluster {cluster}. slots: cluster: path.clusterName - text: Show the properties of cluster {cluster}. slots: cluster: path.clusterName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.NetworkCloud/clusters/{clusterName}'].put update: x-apievangelist-phrasing: intent: Create or update a Network Cloud cluster effect: write questions: - How do I define a new Network Cloud cluster with its rack configuration? - Can I replace the properties of an existing Network Cloud cluster? instructions: - text: Create Network Cloud cluster {cluster} at extended location {extended_location} with properties {properties}. slots: cluster: path.clusterName extended_location: requestBody.extendedLocation properties: requestBody.properties - text: Define Network Cloud cluster {cluster} from scratch or overwrite it entirely. slots: cluster: path.clusterName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.NetworkCloud/clusters/{clusterName}'].delete update: x-apievangelist-phrasing: intent: Delete a Network Cloud cluster effect: destructive questions: - Is it possible to tear down an entire Network Cloud cluster? - What is lost when a Network Cloud cluster is deleted? instructions: - text: Delete Network Cloud cluster {cluster}. slots: cluster: path.clusterName - text: Remove the {cluster} Network Cloud cluster. slots: cluster: path.clusterName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.NetworkCloud/clusters/{clusterName}'].patch update: x-apievangelist-phrasing: intent: Patch a Network Cloud cluster's properties or tags effect: write questions: - Can I update tags on a Network Cloud cluster separately from its properties? - Is it possible to patch a Network Cloud cluster in place? instructions: - text: Set tags {tags} on Network Cloud cluster {cluster}. slots: tags: requestBody.tags cluster: path.clusterName - text: Patch cluster {cluster} with properties {properties}. slots: cluster: path.clusterName properties: requestBody.properties method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.NetworkCloud/clusters/{clusterName}/bareMetalMachineKeySets'].get update: x-apievangelist-phrasing: intent: List bare metal machine key sets for a cluster effect: read questions: - Which bare metal machine key sets are defined on my cluster? - Can I see every key set used for bare metal machine access on a cluster? instructions: - text: List the bare metal machine key sets for cluster {cluster}. slots: cluster: path.clusterName - text: Show every machine key set on Network Cloud cluster {cluster}. slots: cluster: path.clusterName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.NetworkCloud/clusters/{clusterName}/bareMetalMachineKeySets/{bareMetalMachineKeySetName}'].get update: x-apievangelist-phrasing: intent: Get a bare metal machine key set effect: read questions: - Can I view one bare metal machine key set on a cluster? - What access does a specific bare metal machine key set define? instructions: - text: Get bare metal machine key set {key_set} on cluster {cluster}. slots: key_set: path.bareMetalMachineKeySetName cluster: path.clusterName - text: Show the details of machine key set {key_set}. slots: key_set: path.bareMetalMachineKeySetName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.NetworkCloud/clusters/{clusterName}/bareMetalMachineKeySets/{bareMetalMachineKeySetName}'].put update: x-apievangelist-phrasing: intent: Create or update a bare metal machine key set effect: write questions: - How do I grant access to a cluster's bare metal machines with a key set? - Can I replace an existing bare metal machine key set on a cluster? instructions: - text: Create bare metal machine key set {key_set} on cluster {cluster} with properties {properties}. slots: key_set: path.bareMetalMachineKeySetName cluster: path.clusterName properties: requestBody.properties - text: Create machine key set {key_set} on cluster {cluster} at extended location {extended_location}. slots: key_set: path.bareMetalMachineKeySetName cluster: path.clusterName extended_location: requestBody.extendedLocation method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.NetworkCloud/clusters/{clusterName}/bareMetalMachineKeySets/{bareMetalMachineKeySetName}'].delete update: x-apievangelist-phrasing: intent: Delete a bare metal machine key set effect: destructive questions: - Can I delete a bare metal machine key set to revoke that access? - What happens to access when a machine key set is removed from a cluster? instructions: - text: Delete bare metal machine key set {key_set} from cluster {cluster}. slots: key_set: path.bareMetalMachineKeySetName cluster: path.clusterName - text: Remove machine key set {key_set}. slots: key_set: path.bareMetalMachineKeySetName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.NetworkCloud/clusters/{clusterName}/bareMetalMachineKeySets/{bareMetalMachineKeySetName}'].patch update: x-apievangelist-phrasing: intent: Patch a bare metal machine key set effect: write questions: - Can I update the properties or tags of a bare metal machine key set in place? - Is it possible to retag a machine key set without changing its keys? instructions: - text: Patch bare metal machine key set {key_set} on cluster {cluster} with properties {properties}. slots: key_set: path.bareMetalMachineKeySetName cluster: path.clusterName properties: requestBody.properties - text: Set tags {tags} on machine key set {key_set}. slots: tags: requestBody.tags key_set: path.bareMetalMachineKeySetName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.NetworkCloud/clusters/{clusterName}/bmcKeySets'].get update: x-apievangelist-phrasing: intent: List BMC key sets for a cluster effect: read questions: - Which baseboard management controller key sets are defined on my cluster? - Can I list the BMC key sets of a Network Cloud cluster? instructions: - text: List the BMC key sets for cluster {cluster}. slots: cluster: path.clusterName - text: Show every baseboard management controller key set on cluster {cluster}. slots: cluster: path.clusterName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.NetworkCloud/clusters/{clusterName}/bmcKeySets/{bmcKeySetName}'].get update: x-apievangelist-phrasing: intent: Get a BMC key set effect: read questions: - Can I view one baseboard management controller key set on a cluster? - What access does a specific BMC key set define? instructions: - text: Get BMC key set {bmc_key_set} on cluster {cluster}. slots: bmc_key_set: path.bmcKeySetName cluster: path.clusterName - text: Show the details of baseboard management controller key set {bmc_key_set}. slots: bmc_key_set: path.bmcKeySetName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.NetworkCloud/clusters/{clusterName}/bmcKeySets/{bmcKeySetName}'].put update: x-apievangelist-phrasing: intent: Create or update a BMC key set effect: write questions: - How do I grant baseboard management controller access with a BMC key set? - Can I replace an existing BMC key set on my cluster? instructions: - text: Create BMC key set {bmc_key_set} on cluster {cluster} with properties {properties}. slots: bmc_key_set: path.bmcKeySetName cluster: path.clusterName properties: requestBody.properties - text: Create baseboard management controller key set {bmc_key_set} on cluster {cluster} at extended location {extended_location}. slots: bmc_key_set: path.bmcKeySetName cluster: path.clusterName extended_location: requestBody.extendedLocation method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.NetworkCloud/clusters/{clusterName}/bmcKeySets/{bmcKeySetName}'].delete update: x-apievangelist-phrasing: intent: Delete a BMC key set effect: destructive questions: - Can I delete a BMC key set to revoke baseboard management controller access? - What happens when a baseboard management controller key set is removed? instructions: - text: Delete BMC key set {bmc_key_set} from cluster {cluster}. slots: bmc_key_set: path.bmcKeySetName cluster: path.clusterName - text: Remove baseboard management controller key set {bmc_key_set}. slots: bmc_key_set: path.bmcKeySetName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.NetworkCloud/clusters/{clusterName}/bmcKeySets/{bmcKeySetName}'].patch update: x-apievangelist-phrasing: intent: Patch a BMC key set effect: write questions: - Can I update the properties or tags of a BMC key set in place? - Is it possible to retag a baseboard management controller key set? instructions: - text: Patch BMC key set {bmc_key_set} on cluster {cluster} with properties {properties}. slots: bmc_key_set: path.bmcKeySetName cluster: path.clusterName properties: requestBody.properties - text: Set tags {tags} on baseboard management controller key set {bmc_key_set}. slots: tags: requestBody.tags bmc_key_set: path.bmcKeySetName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.NetworkCloud/clusters/{clusterName}/deploy'].post update: x-apievangelist-phrasing: intent: Deploy a Network Cloud cluster effect: write questions: - How do I deploy a Network Cloud cluster using the rack configuration I gave at creation? - Can I skip validations for specific machines when deploying a cluster? instructions: - text: Deploy Network Cloud cluster {cluster}. slots: cluster: path.clusterName - text: Deploy cluster {cluster} skipping validations for machines {machines}. slots: cluster: path.clusterName machines: requestBody.skipValidationsForMachines method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.NetworkCloud/clusters/{clusterName}/metricsConfigurations'].get update: x-apievangelist-phrasing: intent: List metrics configurations for a cluster effect: read questions: - Which metrics configurations are set on my Network Cloud cluster? - Can I list the metrics collection settings of a cluster? instructions: - text: List the metrics configurations for cluster {cluster}. slots: cluster: path.clusterName - text: Show every metrics configuration on Network Cloud cluster {cluster}. slots: cluster: path.clusterName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.NetworkCloud/clusters/{clusterName}/metricsConfigurations/{metricsConfigurationName}'].get update: x-apievangelist-phrasing: intent: Get a cluster metrics configuration effect: read questions: - Can I view one metrics configuration on a cluster? - What does a specific cluster metrics configuration collect? instructions: - text: Get metrics configuration {metrics_config} on cluster {cluster}. slots: metrics_config: path.metricsConfigurationName cluster: path.clusterName - text: Show the details of metrics configuration {metrics_config}. slots: metrics_config: path.metricsConfigurationName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.NetworkCloud/clusters/{clusterName}/metricsConfigurations/{metricsConfigurationName}'].put update: x-apievangelist-phrasing: intent: Create or update a cluster metrics configuration effect: write questions: - How do I add a metrics configuration to a Network Cloud cluster? - Can I replace an existing metrics configuration on my cluster? instructions: - text: Create metrics configuration {metrics_config} on cluster {cluster} with properties {properties}. slots: metrics_config: path.metricsConfigurationName cluster: path.clusterName properties: requestBody.properties - text: Create metrics configuration {metrics_config} on cluster {cluster} at extended location {extended_location}. slots: metrics_config: path.metricsConfigurationName cluster: path.clusterName extended_location: requestBody.extendedLocation method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.NetworkCloud/clusters/{clusterName}/metricsConfigurations/{metricsConfigurationName}'].delete update: x-apievangelist-phrasing: intent: Delete a cluster metrics configuration effect: destructive questions: - Can I delete a metrics configuration from my cluster? - What stops being collected when a cluster metrics configuration is removed? instructions: - text: Delete metrics configuration {metrics_config} from cluster {cluster}. slots: metrics_config: path.metricsConfigurationName cluster: path.clusterName - text: Remove the {metrics_config} metrics configuration. slots: metrics_config: path.metricsConfigurationName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.NetworkCloud/clusters/{clusterName}/metricsConfigurations/{metricsConfigurationName}'].patch update: x-apievangelist-phrasing: intent: Patch a cluster metrics configuration effect: write questions: - Can I update a cluster metrics configuration's properties or tags in place? - Is it possible to retag a metrics configuration without replacing it? instructions: - text: Patch metrics configuration {metrics_config} on cluster {cluster} with properties {properties}. slots: metrics_config: path.metricsConfigurationName cluster: path.clusterName properties: requestBody.properties - text: Set tags {tags} on metrics configuration {metrics_config}. slots: tags: requestBody.tags metrics_config: path.metricsConfigurationName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.NetworkCloud/clusters/{clusterName}/scanRuntime'].post update: x-apievangelist-phrasing: intent: Run a runtime protection scan on a cluster effect: write questions: - How do I trigger a runtime protection scan on a Network Cloud cluster? - Can a cluster scan detect and remediate issues according to its configuration? instructions: - text: Run a runtime protection scan on cluster {cluster}. slots: cluster: path.clusterName - text: Scan cluster {cluster} for runtime issues with scan activity {scan_activity}. slots: cluster: path.clusterName scan_activity: requestBody.scanActivity method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.NetworkCloud/clusters/{clusterName}/updateVersion'].post update: x-apievangelist-phrasing: intent: Upgrade a Network Cloud cluster version effect: write questions: - How do I upgrade a Network Cloud cluster to a newer supported version? - Can I choose which target version a cluster updates to? instructions: - text: Update cluster {cluster} to version {target_version}. slots: cluster: path.clusterName target_version: requestBody.targetClusterVersion - text: Upgrade Network Cloud cluster {cluster} to target version {target_version}. slots: cluster: path.clusterName target_version: requestBody.targetClusterVersion method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.NetworkCloud/kubernetesClusters'].get update: x-apievangelist-phrasing: intent: List Network Cloud Kubernetes clusters in a resource group effect: read questions: - Which Kubernetes clusters hosted on Network Cloud sit in one of my resource groups? - Can I narrow the Kubernetes cluster list to a single resource group? instructions: - text: List the Kubernetes clusters hosted on Network Cloud in my resource group. - text: Show Kubernetes clusters belonging to this resource group only. method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.NetworkCloud/kubernetesClusters/{kubernetesClusterName}'].get update: x-apievangelist-phrasing: intent: Get a Network Cloud Kubernetes cluster effect: read questions: - Can I see the properties of one Network Cloud Kubernetes cluster? - What configuration does a specific Kubernetes cluster on Network Cloud have? instructions: - text: Get Kubernetes cluster {k8s_cluster}. slots: k8s_cluster: path.kubernetesClusterName - text: Show the properties of Network Cloud Kubernetes cluster {k8s_cluster}. slots: k8s_cluster: path.kubernetesClusterName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.NetworkCloud/kubernetesClusters/{kubernetesClusterName}'].put update: x-apievangelist-phrasing: intent: Create or update a Network Cloud Kubernetes cluster effect: write questions: - How do I create a Kubernetes cluster on Network Cloud? - Can I overwrite a Kubernetes cluster's full configuration on Network Cloud? instructions: - text: Create Kubernetes cluster {k8s_cluster} at extended location {extended_location} with properties {properties}. slots: k8s_cluster: path.kubernetesClusterName extended_location: requestBody.extendedLocation properties: requestBody.properties - text: Overwrite Kubernetes cluster {k8s_cluster} with a new definition. slots: k8s_cluster: path.kubernetesClusterName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.NetworkCloud/kubernetesClusters/{kubernetesClusterName}'].delete update: x-apievangelist-phrasing: intent: Delete a Network Cloud Kubernetes cluster effect: destructive questions: - Can I delete a Kubernetes cluster running on Network Cloud? - What happens to workloads when a Network Cloud Kubernetes cluster is deleted? instructions: - text: Delete Kubernetes cluster {k8s_cluster}. slots: k8s_cluster: path.kubernetesClusterName - text: Remove the {k8s_cluster} Network Cloud Kubernetes cluster. slots: k8s_cluster: path.kubernetesClusterName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.NetworkCloud/kubernetesClusters/{kubernetesClusterName}'].patch update: x-apievangelist-phrasing: intent: Patch a Network Cloud Kubernetes cluster effect: write questions: - Can I update tags on a Network Cloud Kubernetes cluster independently of its properties? - Is it possible to patch a Kubernetes cluster's properties in place? instructions: - text: Set tags {tags} on Kubernetes cluster {k8s_cluster}. slots: tags: requestBody.tags k8s_cluster: path.kubernetesClusterName - text: Patch Kubernetes cluster {k8s_cluster} with properties {properties}. slots: k8s_cluster: path.kubernetesClusterName properties: requestBody.properties method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.NetworkCloud/kubernetesClusters/{kubernetesClusterName}/agentPools'].get update: x-apievangelist-phrasing: intent: List agent pools of a Kubernetes cluster effect: read questions: - Which agent pools does my Network Cloud Kubernetes cluster have? - Can I list the node pools of a Kubernetes cluster? instructions: - text: List the agent pools of Kubernetes cluster {k8s_cluster}. slots: k8s_cluster: path.kubernetesClusterName - text: Show every agent pool in Network Cloud Kubernetes cluster {k8s_cluster}. slots: k8s_cluster: path.kubernetesClusterName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.NetworkCloud/kubernetesClusters/{kubernetesClusterName}/agentPools/{agentPoolName}'].get update: x-apievangelist-phrasing: intent: Get a Kubernetes cluster agent pool effect: read questions: - Can I view the properties of one agent pool in my Kubernetes cluster? - What configuration does a specific agent pool have? instructions: - text: Get agent pool {pool} in Kubernetes cluster {k8s_cluster}. slots: pool: path.agentPoolName k8s_cluster: path.kubernetesClusterName - text: Show the details of agent pool {pool}. slots: pool: path.agentPoolName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.NetworkCloud/kubernetesClusters/{kubernetesClusterName}/agentPools/{agentPoolName}'].put update: x-apievangelist-phrasing: intent: Create or update a Kubernetes cluster agent pool effect: write questions: - How do I add an agent pool to a Network Cloud Kubernetes cluster? - Can I replace the properties of an existing agent pool? instructions: - text: Create agent pool {pool} in Kubernetes cluster {k8s_cluster} with properties {properties}. slots: pool: path.agentPoolName k8s_cluster: path.kubernetesClusterName properties: requestBody.properties - text: Create or replace the definition of agent pool {pool} on cluster {k8s_cluster}. slots: pool: path.agentPoolName k8s_cluster: path.kubernetesClusterName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.NetworkCloud/kubernetesClusters/{kubernetesClusterName}/agentPools/{agentPoolName}'].delete update: x-apievangelist-phrasing: intent: Delete a Kubernetes cluster agent pool effect: destructive questions: - Can I remove an agent pool from my Kubernetes cluster? - What happens to nodes when an agent pool is deleted? instructions: - text: Delete agent pool {pool} from Kubernetes cluster {k8s_cluster}. slots: pool: path.agentPoolName k8s_cluster: path.kubernetesClusterName - text: Remove the {pool} agent pool. slots: pool: path.agentPoolName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.NetworkCloud/kubernetesClusters/{kubernetesClusterName}/agentPools/{agentPoolName}'].patch update: x-apievangelist-phrasing: intent: Patch a Kubernetes cluster agent pool effect: write questions: - Can I update an agent pool's properties or tags without replacing it? - Is it possible to retag an agent pool on a Network Cloud Kubernetes cluster? instructions: - text: Patch agent pool {pool} in Kubernetes cluster {k8s_cluster} with properties {properties}. slots: pool: path.agentPoolName k8s_cluster: path.kubernetesClusterName properties: requestBody.properties - text: Set tags {tags} on agent pool {pool}. slots: tags: requestBody.tags pool: path.agentPoolName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.NetworkCloud/kubernetesClusters/{kubernetesClusterName}/restartNode'].post update: x-apievangelist-phrasing: intent: Restart a node in a Kubernetes cluster effect: write questions: - How do I restart a single node of a Network Cloud Kubernetes cluster? - Can I reboot one specific Kubernetes node by name? instructions: - text: Restart node {node} in Kubernetes cluster {k8s_cluster}. slots: node: requestBody.nodeName k8s_cluster: path.kubernetesClusterName - text: Reboot Kubernetes node {node} of cluster {k8s_cluster}. slots: node: requestBody.nodeName k8s_cluster: path.kubernetesClusterName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.NetworkCloud/l2Networks'].get update: x-apievangelist-phrasing: intent: List L2 networks in a resource group effect: read questions: - Which layer 2 networks are in one of my resource groups? - Can I narrow the L2 network list to a single resource group? instructions: - text: List the L2 networks in my resource group. - text: Show layer 2 networks belonging to this resource group only. method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.NetworkCloud/l2Networks/{l2NetworkName}'].get update: x-apievangelist-phrasing: intent: Get an L2 network effect: read questions: - Can I see the properties of one layer 2 network? - What does a specific L2 network's configuration look like? instructions: - text: Get L2 network {l2_network}. slots: l2_network: path.l2NetworkName - text: Show the properties of layer 2 network {l2_network}. slots: l2_network: path.l2NetworkName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.NetworkCloud/l2Networks/{l2NetworkName}'].put update: x-apievangelist-phrasing: intent: Create or update an L2 network effect: write questions: - How do I create a layer 2 network on Network Cloud? - Can I replace the properties of an existing L2 network? instructions: - text: Create L2 network {l2_network} at extended location {extended_location} with properties {properties}. slots: l2_network: path.l2NetworkName extended_location: requestBody.extendedLocation properties: requestBody.properties - text: Create or replace layer 2 network {l2_network}. slots: l2_network: path.l2NetworkName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.NetworkCloud/l2Networks/{l2NetworkName}'].delete update: x-apievangelist-phrasing: intent: Delete an L2 network effect: destructive questions: - Can I delete a layer 2 network? - What gets removed when an L2 network is deleted? instructions: - text: Delete L2 network {l2_network}. slots: l2_network: path.l2NetworkName - text: Remove the {l2_network} layer 2 network. slots: l2_network: path.l2NetworkName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.NetworkCloud/l2Networks/{l2NetworkName}'].patch update: x-apievangelist-phrasing: intent: Update tags on an L2 network effect: write questions: - Can I change the tags on a layer 2 network? - Is a patch to an L2 network limited to its tags? instructions: - text: Set tags {tags} on L2 network {l2_network}. slots: tags: requestBody.tags l2_network: path.l2NetworkName - text: Retag layer 2 network {l2_network} with {tags}. slots: l2_network: path.l2NetworkName tags: requestBody.tags method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.NetworkCloud/l3Networks'].get update: x-apievangelist-phrasing: intent: List L3 networks in a resource group effect: read questions: - Which layer 3 networks are in one of my resource groups? - Can I narrow the L3 network list to a single resource group? instructions: - text: List the L3 networks in my resource group. - text: Show layer 3 networks belonging to this resource group only. method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.NetworkCloud/l3Networks/{l3NetworkName}'].get update: x-apievangelist-phrasing: intent: Get an L3 network effect: read questions: - Can I see the properties of one layer 3 network? - What does a specific L3 network's configuration look like? instructions: - text: Get L3 network {l3_network}. slots: l3_network: path.l3NetworkName - text: Show the properties of layer 3 network {l3_network}. slots: l3_network: path.l3NetworkName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.NetworkCloud/l3Networks/{l3NetworkName}'].put update: x-apievangelist-phrasing: intent: Create or update an L3 network effect: write questions: - How do I create a layer 3 network on Network Cloud? - Can I replace the properties of an existing L3 network? instructions: - text: Create L3 network {l3_network} at extended location {extended_location} with properties {properties}. slots: l3_network: path.l3NetworkName extended_location: requestBody.extendedLocation properties: requestBody.properties - text: Create or replace layer 3 network {l3_network}. slots: l3_network: path.l3NetworkName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.NetworkCloud/l3Networks/{l3NetworkName}'].delete update: x-apievangelist-phrasing: intent: Delete an L3 network effect: destructive questions: - Can I delete a layer 3 network? - What gets removed when an L3 network is deleted? instructions: - text: Delete L3 network {l3_network}. slots: l3_network: path.l3NetworkName - text: Remove the {l3_network} layer 3 network. slots: l3_network: path.l3NetworkName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.NetworkCloud/l3Networks/{l3NetworkName}'].patch update: x-apievangelist-phrasing: intent: Update tags on an L3 network effect: write questions: - Can I change the tags on a layer 3 network? - Is a patch to an L3 network limited to its tags? instructions: - text: Set tags {tags} on L3 network {l3_network}. slots: tags: requestBody.tags l3_network: path.l3NetworkName - text: Retag layer 3 network {l3_network} with {tags}. slots: l3_network: path.l3NetworkName tags: requestBody.tags method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.NetworkCloud/racks'].get update: x-apievangelist-phrasing: intent: List racks in a resource group effect: read questions: - Which Network Cloud racks are in one of my resource groups? - Can I narrow the rack list to a single resource group? instructions: - text: List the racks in my resource group. - text: Show racks belonging to this resource group only. method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.NetworkCloud/racks/{rackName}'].get update: x-apievangelist-phrasing: intent: Get a rack effect: read questions: - Can I see the properties of one Network Cloud rack? - What does a specific rack report about itself? instructions: - text: Get rack {rack}. slots: rack: path.rackName - text: Show the properties of rack {rack}. slots: rack: path.rackName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.NetworkCloud/racks/{rackName}'].put update: x-apievangelist-phrasing: intent: Create or update a rack record effect: write questions: - Can I create a rack myself, or does the system manage its lifecycle? - Why are my requests to create or replace a Network Cloud rack rejected? instructions: - text: Create rack {rack} at extended location {extended_location} with properties {properties}. slots: rack: path.rackName extended_location: requestBody.extendedLocation properties: requestBody.properties - text: Replace the definition of rack {rack}. slots: rack: path.rackName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.NetworkCloud/racks/{rackName}'].delete update: x-apievangelist-phrasing: intent: Delete a rack record effect: destructive questions: - Can I delete a rack resource when its lifecycle is system managed? - What happens if I try to remove a Network Cloud rack directly? instructions: - text: Delete rack {rack}. slots: rack: path.rackName - text: Remove the {rack} rack resource. slots: rack: path.rackName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.NetworkCloud/racks/{rackName}'].patch update: x-apievangelist-phrasing: intent: Patch a rack's properties or tags effect: write questions: - Can I update tags on a rack independently of its properties? - Is it possible to patch a rack in place? instructions: - text: Set tags {tags} on rack {rack}. slots: tags: requestBody.tags rack: path.rackName - text: Patch rack {rack} with properties {properties}. slots: rack: path.rackName properties: requestBody.properties method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.NetworkCloud/storageAppliances'].get update: x-apievangelist-phrasing: intent: List storage appliances in a resource group effect: read questions: - Which storage appliances are in one of my resource groups? - Can I narrow the storage appliance list to a single resource group? instructions: - text: List the storage appliances in my resource group. - text: Show storage appliances belonging to this resource group only. method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.NetworkCloud/storageAppliances/{storageApplianceName}'].get update: x-apievangelist-phrasing: intent: Get a storage appliance effect: read questions: - Can I see the properties of one Network Cloud storage appliance? - What does a specific storage appliance report? instructions: - text: Get storage appliance {appliance}. slots: appliance: path.storageApplianceName - text: Show the properties of storage appliance {appliance}. slots: appliance: path.storageApplianceName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.NetworkCloud/storageAppliances/{storageApplianceName}'].put update: x-apievangelist-phrasing: intent: Create or update a storage appliance record effect: write questions: - Can I create a storage appliance myself, or is its lifecycle system managed? - Why are my requests to create a Network Cloud storage appliance rejected? instructions: - text: Create storage appliance {appliance} at extended location {extended_location} with properties {properties}. slots: appliance: path.storageApplianceName extended_location: requestBody.extendedLocation properties: requestBody.properties - text: Replace the definition of storage appliance {appliance}. slots: appliance: path.storageApplianceName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.NetworkCloud/storageAppliances/{storageApplianceName}'].delete update: x-apievangelist-phrasing: intent: Delete a storage appliance record effect: destructive questions: - Can I delete a storage appliance resource when the system manages its lifecycle? - What happens if I try to remove a Network Cloud storage appliance directly? instructions: - text: Delete storage appliance {appliance}. slots: appliance: path.storageApplianceName - text: Remove the {appliance} storage appliance resource. slots: appliance: path.storageApplianceName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.NetworkCloud/storageAppliances/{storageApplianceName}'].patch update: x-apievangelist-phrasing: intent: Patch a storage appliance's properties or tags effect: write questions: - Can I update tags on a storage appliance independently of its properties? - Is it possible to patch a storage appliance in place? instructions: - text: Set tags {tags} on storage appliance {appliance}. slots: tags: requestBody.tags appliance: path.storageApplianceName - text: Patch storage appliance {appliance} with properties {properties}. slots: appliance: path.storageApplianceName properties: requestBody.properties method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.NetworkCloud/storageAppliances/{storageApplianceName}/disableRemoteVendorManagement'].post update: x-apievangelist-phrasing: intent: Disable remote vendor management of a storage appliance effect: write questions: - How do I turn off remote vendor management on a storage appliance? - Can I stop the hardware vendor from managing my storage appliance remotely? instructions: - text: Disable remote vendor management on storage appliance {appliance}. slots: appliance: path.storageApplianceName - text: Turn off vendor remote access for storage appliance {appliance}. slots: appliance: path.storageApplianceName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.NetworkCloud/storageAppliances/{storageApplianceName}/enableRemoteVendorManagement'].post update: x-apievangelist-phrasing: intent: Enable remote vendor management of a storage appliance effect: write questions: - How do I enable remote vendor management on a storage appliance? - Can I specify which support endpoints the vendor may use for remote management? instructions: - text: Enable remote vendor management on storage appliance {appliance}. slots: appliance: path.storageApplianceName - text: Allow vendor management of storage appliance {appliance} through support endpoints {endpoints}. slots: appliance: path.storageApplianceName endpoints: requestBody.supportEndpoints method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.NetworkCloud/trunkedNetworks'].get update: x-apievangelist-phrasing: intent: List trunked networks in a resource group effect: read questions: - Which trunked networks are in one of my resource groups? - Can I narrow the trunked network list to a single resource group? instructions: - text: List the trunked networks in my resource group. - text: Show trunked networks belonging to this resource group only. method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.NetworkCloud/trunkedNetworks/{trunkedNetworkName}'].get update: x-apievangelist-phrasing: intent: Get a trunked network effect: read questions: - Can I see the properties of one trunked network? - What does a specific trunked network's configuration look like? instructions: - text: Get trunked network {trunked_network}. slots: trunked_network: path.trunkedNetworkName - text: Show the properties of trunked network {trunked_network}. slots: trunked_network: path.trunkedNetworkName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.NetworkCloud/trunkedNetworks/{trunkedNetworkName}'].put update: x-apievangelist-phrasing: intent: Create or update a trunked network effect: write questions: - How do I create a trunked network on Network Cloud? - Can I replace the properties of an existing trunked network? instructions: - text: Create trunked network {trunked_network} at extended location {extended_location} with properties {properties}. slots: trunked_network: path.trunkedNetworkName extended_location: requestBody.extendedLocation properties: requestBody.properties - text: Create or replace trunked network {trunked_network}. slots: trunked_network: path.trunkedNetworkName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.NetworkCloud/trunkedNetworks/{trunkedNetworkName}'].delete update: x-apievangelist-phrasing: intent: Delete a trunked network effect: destructive questions: - Can I delete a trunked network? - What gets removed when a trunked network is deleted? instructions: - text: Delete trunked network {trunked_network}. slots: trunked_network: path.trunkedNetworkName - text: Remove the {trunked_network} trunked network. slots: trunked_network: path.trunkedNetworkName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.NetworkCloud/trunkedNetworks/{trunkedNetworkName}'].patch update: x-apievangelist-phrasing: intent: Update tags on a trunked network effect: write questions: - Can I change the tags on a trunked network? - Is a patch to a trunked network limited to its tags? instructions: - text: Set tags {tags} on trunked network {trunked_network}. slots: tags: requestBody.tags trunked_network: path.trunkedNetworkName - text: Retag trunked network {trunked_network} with {tags}. slots: trunked_network: path.trunkedNetworkName tags: requestBody.tags method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.NetworkCloud/virtualMachines'].get update: x-apievangelist-phrasing: intent: List Network Cloud virtual machines in a resource group effect: read questions: - Which Network Cloud virtual machines are in one of my resource groups? - Can I narrow the Network Cloud VM list to a single resource group? instructions: - text: List the Network Cloud virtual machines in my resource group. - text: Show Network Cloud VMs belonging to this resource group only. method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.NetworkCloud/virtualMachines/{virtualMachineName}'].get update: x-apievangelist-phrasing: intent: Get a Network Cloud virtual machine effect: read questions: - Can I see the properties of one Network Cloud virtual machine? - What state is a specific Network Cloud VM in? instructions: - text: Get Network Cloud virtual machine {vm}. slots: vm: path.virtualMachineName - text: Show the properties of VM {vm}. slots: vm: path.virtualMachineName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.NetworkCloud/virtualMachines/{virtualMachineName}'].put update: x-apievangelist-phrasing: intent: Create or update a Network Cloud virtual machine effect: write questions: - How do I create a virtual machine on Network Cloud? - Can I replace the properties of an existing Network Cloud VM? instructions: - text: Create virtual machine {vm} at extended location {extended_location} with properties {properties}. slots: vm: path.virtualMachineName extended_location: requestBody.extendedLocation properties: requestBody.properties - text: Create or replace the definition of Network Cloud VM {vm}. slots: vm: path.virtualMachineName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.NetworkCloud/virtualMachines/{virtualMachineName}'].delete update: x-apievangelist-phrasing: intent: Delete a Network Cloud virtual machine effect: destructive questions: - Can I delete a Network Cloud virtual machine? - What is lost when a Network Cloud VM is deleted? instructions: - text: Delete Network Cloud virtual machine {vm}. slots: vm: path.virtualMachineName - text: Remove the {vm} Network Cloud VM. slots: vm: path.virtualMachineName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.NetworkCloud/virtualMachines/{virtualMachineName}'].patch update: x-apievangelist-phrasing: intent: Patch a Network Cloud virtual machine effect: write questions: - Can I retag a Network Cloud VM without touching its other settings? - Is it possible to patch a Network Cloud virtual machine in place? instructions: - text: Set tags {tags} on Network Cloud virtual machine {vm}. slots: tags: requestBody.tags vm: path.virtualMachineName - text: Patch Network Cloud VM {vm} with properties {properties}. slots: vm: path.virtualMachineName properties: requestBody.properties method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.NetworkCloud/virtualMachines/{virtualMachineName}/consoles'].get update: x-apievangelist-phrasing: intent: List consoles of a virtual machine effect: read questions: - Which consoles are defined for my Network Cloud virtual machine? - Can I list the console access resources of a VM? instructions: - text: List the consoles of virtual machine {vm}. slots: vm: path.virtualMachineName - text: Show every console on Network Cloud VM {vm}. slots: vm: path.virtualMachineName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.NetworkCloud/virtualMachines/{virtualMachineName}/consoles/{consoleName}'].get update: x-apievangelist-phrasing: intent: Get a virtual machine console effect: read questions: - Can I view the properties of one virtual machine console? - What configuration does a specific VM console have? instructions: - text: Get console {console} of virtual machine {vm}. slots: console: path.consoleName vm: path.virtualMachineName - text: Show the details of VM console {console}. slots: console: path.consoleName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.NetworkCloud/virtualMachines/{virtualMachineName}/consoles/{consoleName}'].put update: x-apievangelist-phrasing: intent: Create or update a virtual machine console effect: write questions: - How do I create a console for a Network Cloud virtual machine? - Can I replace an existing console on a VM? instructions: - text: Create console {console} on virtual machine {vm} with properties {properties}. slots: console: path.consoleName vm: path.virtualMachineName properties: requestBody.properties - text: Create VM console {console} on {vm} at extended location {extended_location}. slots: console: path.consoleName vm: path.virtualMachineName extended_location: requestBody.extendedLocation method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.NetworkCloud/virtualMachines/{virtualMachineName}/consoles/{consoleName}'].delete update: x-apievangelist-phrasing: intent: Delete a virtual machine console effect: destructive questions: - Can I delete a console from my virtual machine? - What happens to console access when a VM console is removed? instructions: - text: Delete console {console} from virtual machine {vm}. slots: console: path.consoleName vm: path.virtualMachineName - text: Remove the {console} VM console. slots: console: path.consoleName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.NetworkCloud/virtualMachines/{virtualMachineName}/consoles/{consoleName}'].patch update: x-apievangelist-phrasing: intent: Patch a virtual machine console effect: write questions: - Can I update a VM console's properties or tags without replacing it? - Is it possible to retag a virtual machine console? instructions: - text: Patch console {console} of virtual machine {vm} with properties {properties}. slots: console: path.consoleName vm: path.virtualMachineName properties: requestBody.properties - text: Set tags {tags} on VM console {console}. slots: tags: requestBody.tags console: path.consoleName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.NetworkCloud/virtualMachines/{virtualMachineName}/powerOff'].post update: x-apievangelist-phrasing: intent: Power off a Network Cloud virtual machine effect: write questions: - How do I power off a Network Cloud virtual machine? - Can I skip the graceful shutdown when powering off a Network Cloud VM? instructions: - text: Power off Network Cloud virtual machine {vm}. slots: vm: path.virtualMachineName - text: Power off VM {vm} with skip shutdown set to {skip_shutdown}. slots: vm: path.virtualMachineName skip_shutdown: requestBody.skipShutdown method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.NetworkCloud/virtualMachines/{virtualMachineName}/reimage'].post update: x-apievangelist-phrasing: intent: Reimage a Network Cloud virtual machine effect: destructive questions: - Can I reimage a Network Cloud virtual machine back to its image? - What does reimaging a Network Cloud VM do to its disk contents? instructions: - text: Reimage Network Cloud virtual machine {vm}. slots: vm: path.virtualMachineName - text: Wipe and reimage VM {vm}. slots: vm: path.virtualMachineName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.NetworkCloud/virtualMachines/{virtualMachineName}/restart'].post update: x-apievangelist-phrasing: intent: Restart a Network Cloud virtual machine effect: write questions: - How do I reboot a Network Cloud virtual machine? - Can I restart a Network Cloud VM remotely? instructions: - text: Restart Network Cloud virtual machine {vm}. slots: vm: path.virtualMachineName - text: Reboot VM {vm}. slots: vm: path.virtualMachineName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.NetworkCloud/virtualMachines/{virtualMachineName}/start'].post update: x-apievangelist-phrasing: intent: Start a Network Cloud virtual machine effect: write questions: - How do I power on a stopped Network Cloud virtual machine? - Can I start a Network Cloud VM that is powered off? instructions: - text: Start Network Cloud virtual machine {vm}. slots: vm: path.virtualMachineName - text: Power on VM {vm}. slots: vm: path.virtualMachineName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.NetworkCloud/volumes'].get update: x-apievangelist-phrasing: intent: List Network Cloud volumes in a resource group effect: read questions: - Which Network Cloud volumes are in one of my resource groups? - Can I narrow the volume list to a single resource group? instructions: - text: List the Network Cloud volumes in my resource group. - text: Show volumes belonging to this resource group only. method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.NetworkCloud/volumes/{volumeName}'].get update: x-apievangelist-phrasing: intent: Get a Network Cloud volume effect: read questions: - Can I see the properties of one Network Cloud volume? - What does a specific Network Cloud volume's configuration contain? instructions: - text: Get Network Cloud volume {volume}. slots: volume: path.volumeName - text: Show the properties of volume {volume}. slots: volume: path.volumeName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.NetworkCloud/volumes/{volumeName}'].put update: x-apievangelist-phrasing: intent: Create or update a Network Cloud volume effect: write questions: - How do I create a storage volume on Network Cloud? - Can I replace the properties of an existing Network Cloud volume? instructions: - text: Create volume {volume} at extended location {extended_location} with properties {properties}. slots: volume: path.volumeName extended_location: requestBody.extendedLocation properties: requestBody.properties - text: Create or replace Network Cloud volume {volume}. slots: volume: path.volumeName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.NetworkCloud/volumes/{volumeName}'].delete update: x-apievangelist-phrasing: intent: Delete a Network Cloud volume effect: destructive questions: - Can I delete a Network Cloud volume? - What data is lost when a Network Cloud volume is deleted? instructions: - text: Delete Network Cloud volume {volume}. slots: volume: path.volumeName - text: Remove the {volume} volume. slots: volume: path.volumeName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.NetworkCloud/volumes/{volumeName}'].patch update: x-apievangelist-phrasing: intent: Update tags on a Network Cloud volume effect: write questions: - Can I change the tags on an Azure Operator Nexus Network Cloud volume without recreating it? - What happens to the existing tags when I patch a Network Cloud volume? instructions: - text: Replace the tags on Network Cloud volume {volume} with {tags}. slots: volume: path.volumeName tags: requestBody.tags - text: Retag the Network Cloud storage volume {volume}. slots: volume: path.volumeName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.Network/locations/{location}/CheckDnsNameAvailability'].get update: x-apievangelist-phrasing: intent: Check if a cloudapp.net DNS label is free effect: read questions: - Is a given DNS label still available in the cloudapp.net zone for my region? - How can I find out if someone already took my cloudapp.net domain name prefix? instructions: - text: Check whether DNS label {label} is available in {location} for subscription {subscription}. slots: label: query.domainNameLabel location: path.location subscription: path.subscriptionId - text: See if the cloudapp.net name {label} is free in region {location} under subscription {subscription}. slots: label: query.domainNameLabel location: path.location subscription: path.subscriptionId method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.Network/locations/{location}/perimeterAssociableResourceTypes'].get update: x-apievangelist-phrasing: intent: List resource types a network security perimeter supports effect: read questions: - Which resource types can be associated with a network security perimeter? - What services are onboarded to NSP in a particular Azure region? instructions: - text: List the resource types that can join a network security perimeter in {location}. slots: location: path.location - text: Show NSP-associable resource types available in region {location}. slots: location: path.location method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.OpenEnergyPlatform/energyServices/{resourceName}'].delete update: x-apievangelist-phrasing: intent: Delete an Energy Data Services instance effect: destructive questions: - Can I delete an OEP energy services resource I no longer need? - What does it take to tear down an Open Energy Platform instance? instructions: - text: Delete the energy services resource {resource}. slots: resource: path.resourceName - text: Remove Open Energy Platform instance {resource} permanently. slots: resource: path.resourceName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.OpenEnergyPlatform/energyServices/{resourceName}'].patch update: x-apievangelist-phrasing: intent: Update tags on an Energy Data Services instance effect: write questions: - Can I update tags on an existing Open Energy Platform energy services resource? - What fields can be patched on an OEP energy services instance? instructions: - text: Set the tags on energy services resource {resource} to {tags}. slots: resource: path.resourceName tags: requestBody.tags - text: Patch the Open Energy Platform instance {resource} with new tags. slots: resource: path.resourceName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/providers/PaloAltoNetworks.Cloudngfw/listSupportInfo'].post update: x-apievangelist-phrasing: intent: Get support info for Cloud NGFW by Palo Alto Networks effect: read questions: - Where do I find support details for the Palo Alto Networks Cloud NGFW service on my subscription? - What support information does Cloud NGFW return for my subscription? instructions: - text: Fetch the Cloud NGFW support information for my subscription. - text: Show Palo Alto Networks Cloud NGFW support contact details. method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.PolicyInsights/policyEvents/{policyEventsResource}/queryResults'].post update: x-apievangelist-phrasing: intent: Query policy events across a subscription effect: read questions: - How do I see every policy evaluation event across my whole subscription? - Can I filter subscription-wide policy events by a time window? instructions: - text: Query policy events for subscription {subscription} using events resource {events_resource}. slots: subscription: path.subscriptionId events_resource: path.policyEventsResource - text: Show subscription {subscription} policy events from {from} to {to} (events resource {events_resource}). slots: subscription: path.subscriptionId from: query.$from to: query.$to events_resource: path.policyEventsResource - text: Return the top {top} policy events in subscription {subscription} matching {filter} via {events_resource}. slots: top: query.$top subscription: path.subscriptionId filter: query.$filter events_resource: path.policyEventsResource method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.PolicyInsights/policyEvents/{policyEventsResource}/queryResults'].post update: x-apievangelist-phrasing: intent: Query policy events in a resource group effect: read questions: - Which policy events were raised for resources inside one resource group? - Can I sort resource-group policy events by timestamp? instructions: - text: Query policy events in resource group {group} of subscription {subscription} with events resource {events_resource}. slots: group: path.resourceGroupName subscription: path.subscriptionId events_resource: path.policyEventsResource - text: List resource group {group} policy events ordered by {orderby} (subscription {subscription}, resource {events_resource}). slots: group: path.resourceGroupName orderby: query.$orderby subscription: path.subscriptionId events_resource: path.policyEventsResource method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/providers/{authorizationNamespace}/policySetDefinitions/{policySetDefinitionName}/providers/Microsoft.PolicyInsights/policyEvents/{policyEventsResource}/queryResults'].post update: x-apievangelist-phrasing: intent: Query policy events for a policy set definition effect: read questions: - What policy events came from a specific initiative (policy set definition)? - Can I see evaluation events tied to one policy set definition in my subscription? instructions: - text: Query policy events for policy set definition {set} in namespace {namespace}, subscription {subscription}, events resource {events_resource}. slots: set: path.policySetDefinitionName namespace: path.authorizationNamespace subscription: path.subscriptionId events_resource: path.policyEventsResource - text: Show initiative {set} policy events since {from} ({namespace}, {subscription}, {events_resource}). slots: set: path.policySetDefinitionName from: query.$from namespace: path.authorizationNamespace subscription: path.subscriptionId events_resource: path.policyEventsResource method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/providers/{authorizationNamespace}/policyDefinitions/{policyDefinitionName}/providers/Microsoft.PolicyInsights/policyEvents/{policyEventsResource}/queryResults'].post update: x-apievangelist-phrasing: intent: Query policy events for a single policy definition effect: read questions: - Which evaluation events were produced by one specific policy definition? - Can I pull events for a single policy definition rather than an initiative? instructions: - text: Pull evaluation events of the single policy rule {definition} under {namespace} in {subscription} via {events_resource}. slots: definition: path.policyDefinitionName namespace: path.authorizationNamespace subscription: path.subscriptionId events_resource: path.policyEventsResource - text: List policy definition {definition} events filtered by {filter} ({namespace}, {subscription}, {events_resource}). slots: definition: path.policyDefinitionName filter: query.$filter namespace: path.authorizationNamespace subscription: path.subscriptionId events_resource: path.policyEventsResource method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/providers/{authorizationNamespace}/policyAssignments/{policyAssignmentName}/providers/Microsoft.PolicyInsights/policyEvents/{policyEventsResource}/queryResults'].post update: x-apievangelist-phrasing: intent: Query events for a subscription-level policy assignment effect: read questions: - What events did a policy assignment scoped to my subscription generate? - Can I check evaluation events for one subscription-level assignment? instructions: - text: Query events for subscription-level policy assignment {assignment} ({namespace}, subscription {subscription}, events resource {events_resource}). slots: assignment: path.policyAssignmentName namespace: path.authorizationNamespace subscription: path.subscriptionId events_resource: path.policyEventsResource - text: Show events from assignment {assignment} at subscription {subscription} between {from} and {to} ({namespace}, {events_resource}). slots: assignment: path.policyAssignmentName subscription: path.subscriptionId from: query.$from to: query.$to namespace: path.authorizationNamespace events_resource: path.policyEventsResource method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourcegroups/{resourceGroupName}/providers/{authorizationNamespace}/policyAssignments/{policyAssignmentName}/providers/Microsoft.PolicyInsights/policyEvents/{policyEventsResource}/queryResults'].post update: x-apievangelist-phrasing: intent: Query events for a resource-group policy assignment effect: read questions: - What events did a policy assignment made at resource group scope produce? - Can I page through events for an assignment attached to one resource group? instructions: - text: Query events for resource-group assignment {assignment} in group {group} ({namespace}, subscription {subscription}, events resource {events_resource}). slots: assignment: path.policyAssignmentName group: path.resourceGroupName namespace: path.authorizationNamespace subscription: path.subscriptionId events_resource: path.policyEventsResource - text: Continue resource-group assignment {assignment} events in {group} from skip token {skiptoken} ({namespace}, {subscription}, {events_resource}). slots: assignment: path.policyAssignmentName group: path.resourceGroupName skiptoken: query.$skiptoken namespace: path.authorizationNamespace subscription: path.subscriptionId events_resource: path.policyEventsResource method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.PolicyInsights/policyStates/{policyStatesResource}/queryResults'].post update: x-apievangelist-phrasing: intent: Query compliance states across a subscription effect: read questions: - How do I see which resources in my subscription are non-compliant with policy? - Can I get the latest policy compliance state for every resource in a subscription? instructions: - text: Query policy compliance states for subscription {subscription} using states resource {states_resource}. slots: subscription: path.subscriptionId states_resource: path.policyStatesResource - text: List non-compliant resource states in subscription {subscription} matching {filter} via {states_resource}. slots: subscription: path.subscriptionId filter: query.$filter states_resource: path.policyStatesResource method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.PolicyInsights/policyStates/{policyStatesSummaryResource}/summarize'].post update: x-apievangelist-phrasing: intent: Summarize policy compliance for a subscription effect: read questions: - Can I get a compliance summary with counts of non-compliant resources for my subscription? - What does the policy compliance rollup look like for a whole subscription? instructions: - text: Summarize policy compliance for subscription {subscription} using summary resource {summary_resource}. slots: subscription: path.subscriptionId summary_resource: path.policyStatesSummaryResource - text: Give me a subscription {subscription} compliance summary for {from} to {to} ({summary_resource}). slots: subscription: path.subscriptionId from: query.$from to: query.$to summary_resource: path.policyStatesSummaryResource method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.PolicyInsights/policyStates/{policyStatesResource}/queryResults'].post update: x-apievangelist-phrasing: intent: Query compliance states in a resource group effect: read questions: - Which resources in a single resource group are out of compliance? - Can I choose which columns come back when querying resource group compliance states? instructions: - text: Query compliance states for resource group {group} in subscription {subscription} with states resource {states_resource}. slots: group: path.resourceGroupName subscription: path.subscriptionId states_resource: path.policyStatesResource - text: List compliance records in group {group} selecting {select} ({subscription}, {states_resource}). slots: group: path.resourceGroupName select: query.$select subscription: path.subscriptionId states_resource: path.policyStatesResource method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.PolicyInsights/policyStates/{policyStatesSummaryResource}/summarize'].post update: x-apievangelist-phrasing: intent: Summarize policy compliance for a resource group effect: read questions: - How compliant is one resource group overall with its assigned policies? - Can I get non-compliance counts rolled up for just one resource group? instructions: - text: Summarize compliance for resource group {group} in subscription {subscription} using {summary_resource}. slots: group: path.resourceGroupName subscription: path.subscriptionId summary_resource: path.policyStatesSummaryResource - text: Roll up the compliance picture of group {group} for the top {top} policies ({subscription}, {summary_resource}). slots: group: path.resourceGroupName top: query.$top subscription: path.subscriptionId summary_resource: path.policyStatesSummaryResource method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/providers/{authorizationNamespace}/policySetDefinitions/{policySetDefinitionName}/providers/Microsoft.PolicyInsights/policyStates/{policyStatesResource}/queryResults'].post update: x-apievangelist-phrasing: intent: Query compliance states for a policy set definition effect: read questions: - Which resources fail a particular initiative (policy set definition)? - Can I list per-resource compliance for one policy set definition? instructions: - text: Query compliance states for policy set definition {set} ({namespace}, subscription {subscription}, states resource {states_resource}). slots: set: path.policySetDefinitionName namespace: path.authorizationNamespace subscription: path.subscriptionId states_resource: path.policyStatesResource - text: List resources evaluated against initiative {set} ordered by {orderby} ({namespace}, {subscription}, {states_resource}). slots: set: path.policySetDefinitionName orderby: query.$orderby namespace: path.authorizationNamespace subscription: path.subscriptionId states_resource: path.policyStatesResource method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/providers/{authorizationNamespace}/policySetDefinitions/{policySetDefinitionName}/providers/Microsoft.PolicyInsights/policyStates/{policyStatesSummaryResource}/summarize'].post update: x-apievangelist-phrasing: intent: Summarize compliance for a policy set definition effect: read questions: - What is the overall compliance summary for one initiative? - Can I see how many resources are non-compliant with a policy set definition? instructions: - text: Summarize compliance for initiative {set} ({namespace}, subscription {subscription}, summary resource {summary_resource}). slots: set: path.policySetDefinitionName namespace: path.authorizationNamespace subscription: path.subscriptionId summary_resource: path.policyStatesSummaryResource - text: Produce a compliance rollup for policy set definition {set} filtered by {filter} ({namespace}, {subscription}, {summary_resource}). slots: set: path.policySetDefinitionName filter: query.$filter namespace: path.authorizationNamespace subscription: path.subscriptionId summary_resource: path.policyStatesSummaryResource method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/providers/{authorizationNamespace}/policyDefinitions/{policyDefinitionName}/providers/Microsoft.PolicyInsights/policyStates/{policyStatesResource}/queryResults'].post update: x-apievangelist-phrasing: intent: Query compliance states for a policy definition effect: read questions: - Which resources are violating one specific policy definition? - Can I apply an aggregation when querying states for a single policy definition? instructions: - text: Fetch per-resource compliance against the single policy rule {definition} ({namespace}, {subscription}, {states_resource}). slots: definition: path.policyDefinitionName namespace: path.authorizationNamespace subscription: path.subscriptionId states_resource: path.policyStatesResource - text: Aggregate policy definition {definition} states with {apply} ({namespace}, {subscription}, {states_resource}). slots: definition: path.policyDefinitionName apply: query.$apply namespace: path.authorizationNamespace subscription: path.subscriptionId states_resource: path.policyStatesResource method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/providers/{authorizationNamespace}/policyDefinitions/{policyDefinitionName}/providers/Microsoft.PolicyInsights/policyStates/{policyStatesSummaryResource}/summarize'].post update: x-apievangelist-phrasing: intent: Summarize compliance for a policy definition effect: read questions: - What is the compliance summary for one policy definition across my subscription? - Can I get non-compliant counts for a single policy rule rather than an initiative? instructions: - text: Summarize compliance for policy definition {definition} ({namespace}, subscription {subscription}, summary resource {summary_resource}). slots: definition: path.policyDefinitionName namespace: path.authorizationNamespace subscription: path.subscriptionId summary_resource: path.policyStatesSummaryResource - text: Roll up how resources score against definition {definition} since {from} ({namespace}, {subscription}, {summary_resource}). slots: definition: path.policyDefinitionName from: query.$from namespace: path.authorizationNamespace subscription: path.subscriptionId summary_resource: path.policyStatesSummaryResource method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/providers/{authorizationNamespace}/policyAssignments/{policyAssignmentName}/providers/Microsoft.PolicyInsights/policyStates/{policyStatesResource}/queryResults'].post update: x-apievangelist-phrasing: intent: Query compliance states for a subscription assignment effect: read questions: - Which resources are non-compliant under one subscription-level policy assignment? - Can I list compliance records for a single assignment made at subscription scope? instructions: - text: Query compliance states for subscription-level assignment {assignment} ({namespace}, subscription {subscription}, states resource {states_resource}). slots: assignment: path.policyAssignmentName namespace: path.authorizationNamespace subscription: path.subscriptionId states_resource: path.policyStatesResource - text: List the first {top} resources evaluated by assignment {assignment} in subscription {subscription} ({namespace}, {states_resource}). slots: top: query.$top assignment: path.policyAssignmentName subscription: path.subscriptionId namespace: path.authorizationNamespace states_resource: path.policyStatesResource method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/providers/{authorizationNamespace}/policyAssignments/{policyAssignmentName}/providers/Microsoft.PolicyInsights/policyStates/{policyStatesSummaryResource}/summarize'].post update: x-apievangelist-phrasing: intent: Summarize compliance for a subscription assignment effect: read questions: - How compliant are resources under one subscription-scoped policy assignment? - Can I get a non-compliance rollup for a single assignment at subscription level? instructions: - text: Summarize compliance for subscription-level assignment {assignment} ({namespace}, subscription {subscription}, summary resource {summary_resource}). slots: assignment: path.policyAssignmentName namespace: path.authorizationNamespace subscription: path.subscriptionId summary_resource: path.policyStatesSummaryResource - text: Give a compliance summary of assignment {assignment} up to {to} ({namespace}, {subscription}, {summary_resource}). slots: assignment: path.policyAssignmentName to: query.$to namespace: path.authorizationNamespace subscription: path.subscriptionId summary_resource: path.policyStatesSummaryResource method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourcegroups/{resourceGroupName}/providers/{authorizationNamespace}/policyAssignments/{policyAssignmentName}/providers/Microsoft.PolicyInsights/policyStates/{policyStatesResource}/queryResults'].post update: x-apievangelist-phrasing: intent: Query compliance states for a resource-group assignment effect: read questions: - Which resources fail a policy assignment that was made at resource group scope? - Can I pull compliance records for one assignment attached to a resource group? instructions: - text: Query compliance states for resource-group assignment {assignment} in {group} ({namespace}, subscription {subscription}, states resource {states_resource}). slots: assignment: path.policyAssignmentName group: path.resourceGroupName namespace: path.authorizationNamespace subscription: path.subscriptionId states_resource: path.policyStatesResource - text: List compliance of group {group} resources under assignment {assignment} filtered by {filter} ({namespace}, {subscription}, {states_resource}). slots: group: path.resourceGroupName assignment: path.policyAssignmentName filter: query.$filter namespace: path.authorizationNamespace subscription: path.subscriptionId states_resource: path.policyStatesResource method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourcegroups/{resourceGroupName}/providers/{authorizationNamespace}/policyAssignments/{policyAssignmentName}/providers/Microsoft.PolicyInsights/policyStates/{policyStatesSummaryResource}/summarize'].post update: x-apievangelist-phrasing: intent: Summarize compliance for a resource-group assignment effect: read questions: - What is the compliance rollup for a policy assignment scoped to one resource group? - Can I count non-compliant resources for a resource-group-level assignment? instructions: - text: Summarize compliance for resource-group assignment {assignment} in {group} ({namespace}, subscription {subscription}, summary resource {summary_resource}). slots: assignment: path.policyAssignmentName group: path.resourceGroupName namespace: path.authorizationNamespace subscription: path.subscriptionId summary_resource: path.policyStatesSummaryResource - text: Roll up compliance for group-scoped assignment {assignment} in {group} from {from} ({namespace}, {subscription}, {summary_resource}). slots: assignment: path.policyAssignmentName group: path.resourceGroupName from: query.$from namespace: path.authorizationNamespace subscription: path.subscriptionId summary_resource: path.policyStatesSummaryResource method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.PolicyInsights/policyTrackedResources/{policyTrackedResourcesResource}/queryResults'].post update: x-apievangelist-phrasing: intent: Query policy-tracked resources in a subscription effect: read questions: - Which resources in my subscription are tracked by policy (for example deployIfNotExists deployments)? - Can I filter tracked resources for a subscription? instructions: - text: Query policy-tracked resources for subscription {subscription} using tracked resource {tracked}. slots: subscription: path.subscriptionId tracked: path.policyTrackedResourcesResource - text: List the top {top} policy-tracked resources in subscription {subscription} matching {filter} ({tracked}). slots: top: query.$top subscription: path.subscriptionId filter: query.$filter tracked: path.policyTrackedResourcesResource method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.PolicyInsights/policyTrackedResources/{policyTrackedResourcesResource}/queryResults'].post update: x-apievangelist-phrasing: intent: Query policy-tracked resources in a resource group effect: read questions: - Which resources in one resource group does policy track? - Can I limit the number of tracked resources returned for a resource group? instructions: - text: Query policy-tracked resources in resource group {group}, subscription {subscription}, tracked resource {tracked}. slots: group: path.resourceGroupName subscription: path.subscriptionId tracked: path.policyTrackedResourcesResource - text: Show tracked resources for group {group} filtered by {filter} ({subscription}, {tracked}). slots: group: path.resourceGroupName filter: query.$filter subscription: path.subscriptionId tracked: path.policyTrackedResourcesResource method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.PowerBIDedicated/skus'].get update: x-apievangelist-phrasing: intent: List Power BI Embedded capacity SKUs effect: read questions: - Which SKUs can I choose for a Power BI Dedicated capacity? - What capacity sizes are eligible for Power BI Dedicated in my subscription? instructions: - text: List eligible Power BI Dedicated SKUs for subscription {subscription}. slots: subscription: path.subscriptionId - text: Show the Power BI capacity tiers available to subscription {subscription}. slots: subscription: path.subscriptionId method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.RecommendationsService/checkNameAvailability'].post update: x-apievangelist-phrasing: intent: Check a Recommendations account name effect: read questions: - Is my intended Intelligent Recommendations account name valid and unused? - Can I verify a RecommendationsService account name before creating it? instructions: - text: Check whether a RecommendationsService account name is available. - text: Validate the Intelligent Recommendations account name I plan to use. method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.RecommendationsService/accounts'].get update: x-apievangelist-phrasing: intent: List Recommendations accounts in a subscription effect: read questions: - Which Intelligent Recommendations accounts exist across my subscription? - What RecommendationsService accounts do I have subscription-wide? instructions: - text: List all RecommendationsService accounts in my subscription. - text: Show every Intelligent Recommendations account across the subscription. method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.RecommendationsService/accounts'].get update: x-apievangelist-phrasing: intent: List Recommendations accounts in a resource group effect: read questions: - Which Intelligent Recommendations accounts live in one resource group? - Can I scope the RecommendationsService account list to a single resource group? instructions: - text: List the RecommendationsService accounts in this resource group. - text: Show Intelligent Recommendations accounts for the current resource group only. method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.RecommendationsService/accounts/{accountName}'].get update: x-apievangelist-phrasing: intent: Get a Recommendations account effect: read questions: - How do I look up the details of one Intelligent Recommendations account? - What configuration does a specific RecommendationsService account have? instructions: - text: Get RecommendationsService account {account}. slots: account: path.accountName - text: Show the settings of Intelligent Recommendations account {account}. slots: account: path.accountName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.RecommendationsService/accounts/{accountName}'].put update: x-apievangelist-phrasing: intent: Create or replace a Recommendations account effect: write questions: - How do I create a new Intelligent Recommendations account? - Can I set a managed identity when provisioning a RecommendationsService account? instructions: - text: Create RecommendationsService account {account} with properties {properties}. slots: account: path.accountName properties: requestBody.properties - text: Provision Intelligent Recommendations account {account} using identity {identity}. slots: account: path.accountName identity: requestBody.identity method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.RecommendationsService/accounts/{accountName}'].delete update: x-apievangelist-phrasing: intent: Delete a Recommendations account effect: destructive questions: - Can I remove an Intelligent Recommendations account I no longer use? - What happens when a RecommendationsService account is deleted? instructions: - text: Delete RecommendationsService account {account}. slots: account: path.accountName - text: Tear down Intelligent Recommendations account {account}. slots: account: path.accountName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.RecommendationsService/accounts/{accountName}'].patch update: x-apievangelist-phrasing: intent: Update a Recommendations account effect: write questions: - Can I change tags or identity on an existing Intelligent Recommendations account? - What fields of a RecommendationsService account can be patched? instructions: - text: Update tags on RecommendationsService account {account} to {tags}. slots: account: path.accountName tags: requestBody.tags - text: Patch the properties of Intelligent Recommendations account {account} with {properties}. slots: account: path.accountName properties: requestBody.properties method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.RecommendationsService/accounts/{accountName}/status'].post update: x-apievangelist-phrasing: intent: Get a Recommendations account's status effect: read questions: - Is my Intelligent Recommendations account healthy and ready? - How can I check the status of a RecommendationsService account? instructions: - text: Get the status of RecommendationsService account {account}. slots: account: path.accountName - text: Check whether Intelligent Recommendations account {account} is up. slots: account: path.accountName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.RecommendationsService/accounts/{accountName}/modeling'].get update: x-apievangelist-phrasing: intent: List modeling resources in a Recommendations account effect: read questions: - Which recommendation models are defined under an Intelligent Recommendations account? - Can I list every modeling resource attached to one account? instructions: - text: List modeling resources in RecommendationsService account {account}. slots: account: path.accountName - text: Show all recommendation models for account {account}. slots: account: path.accountName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.RecommendationsService/accounts/{accountName}/modeling/{modelingName}'].get update: x-apievangelist-phrasing: intent: Get a recommendations modeling resource effect: read questions: - How do I inspect a single modeling resource in Intelligent Recommendations? - What settings does one recommendation model have? instructions: - text: Get modeling resource {modeling} in account {account}. slots: modeling: path.modelingName account: path.accountName - text: Show the configuration of recommendation model {modeling} under {account}. slots: modeling: path.modelingName account: path.accountName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.RecommendationsService/accounts/{accountName}/modeling/{modelingName}'].put update: x-apievangelist-phrasing: intent: Create or replace a recommendations model effect: write questions: - How do I add a new modeling resource to an Intelligent Recommendations account? - Can I overwrite an existing recommendation model definition in one call? instructions: - text: Create modeling resource {modeling} in account {account} with properties {properties}. slots: modeling: path.modelingName account: path.accountName properties: requestBody.properties - text: Define recommendation model {modeling} for account {account}. slots: modeling: path.modelingName account: path.accountName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.RecommendationsService/accounts/{accountName}/modeling/{modelingName}'].delete update: x-apievangelist-phrasing: intent: Delete a recommendations model effect: destructive questions: - Can I remove a modeling resource from my Intelligent Recommendations account? - What is lost when a recommendation model is deleted? instructions: - text: Delete modeling resource {modeling} from account {account}. slots: modeling: path.modelingName account: path.accountName - text: Remove recommendation model {modeling} under {account}. slots: modeling: path.modelingName account: path.accountName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.RecommendationsService/accounts/{accountName}/modeling/{modelingName}'].patch update: x-apievangelist-phrasing: intent: Update a recommendations model effect: write questions: - Can I tweak tags or properties of an existing modeling resource without replacing it? - Which parts of a recommendation model can I patch? instructions: - text: Patch modeling resource {modeling} in account {account} with tags {tags}. slots: modeling: path.modelingName account: path.accountName tags: requestBody.tags - text: Change the properties of recommendation model {modeling} under {account} to {properties}. slots: modeling: path.modelingName account: path.accountName properties: requestBody.properties method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.RecommendationsService/accounts/{accountName}/serviceEndpoints'].get update: x-apievangelist-phrasing: intent: List service endpoints of a Recommendations account effect: read questions: - Which serving endpoints exist for an Intelligent Recommendations account? - Can I list every ServiceEndpoint under one RecommendationsService account? instructions: - text: List service endpoints in RecommendationsService account {account}. slots: account: path.accountName - text: Show all serving endpoints attached to account {account}. slots: account: path.accountName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.RecommendationsService/accounts/{accountName}/serviceEndpoints/{serviceEndpointName}'].get update: x-apievangelist-phrasing: intent: Get a Recommendations service endpoint effect: read questions: - How do I see the details of one recommendations serving endpoint? - What region and settings does a specific ServiceEndpoint use? instructions: - text: Get service endpoint {endpoint} in account {account}. slots: endpoint: path.serviceEndpointName account: path.accountName - text: Show serving endpoint {endpoint} configuration under {account}. slots: endpoint: path.serviceEndpointName account: path.accountName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.RecommendationsService/accounts/{accountName}/serviceEndpoints/{serviceEndpointName}'].put update: x-apievangelist-phrasing: intent: Create or replace a Recommendations service endpoint effect: write questions: - How do I stand up a new serving endpoint for Intelligent Recommendations? - Can I recreate a ServiceEndpoint with new properties in a single request? instructions: - text: Create service endpoint {endpoint} in account {account} with properties {properties}. slots: endpoint: path.serviceEndpointName account: path.accountName properties: requestBody.properties - text: Provision serving endpoint {endpoint} for account {account}. slots: endpoint: path.serviceEndpointName account: path.accountName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.RecommendationsService/accounts/{accountName}/serviceEndpoints/{serviceEndpointName}'].delete update: x-apievangelist-phrasing: intent: Delete a Recommendations service endpoint effect: destructive questions: - Can I remove a serving endpoint from an Intelligent Recommendations account? - What happens to traffic when a ServiceEndpoint is deleted? instructions: - text: Delete service endpoint {endpoint} from account {account}. slots: endpoint: path.serviceEndpointName account: path.accountName - text: Remove serving endpoint {endpoint} under {account}. slots: endpoint: path.serviceEndpointName account: path.accountName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.RecommendationsService/accounts/{accountName}/serviceEndpoints/{serviceEndpointName}'].patch update: x-apievangelist-phrasing: intent: Update tags on a Recommendations service endpoint effect: write questions: - Can I retag a recommendations serving endpoint in place? - What can I patch on an existing ServiceEndpoint? instructions: - text: Set tags {tags} on service endpoint {endpoint} in account {account}. slots: tags: requestBody.tags endpoint: path.serviceEndpointName account: path.accountName - text: Retag serving endpoint {endpoint} under {account}. slots: endpoint: path.serviceEndpointName account: path.accountName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.PolicyInsights/remediations/{remediationName}/listDeployments'].post update: x-apievangelist-phrasing: intent: List deployments of a subscription remediation effect: read questions: - Which resource deployments did a subscription-scope policy remediation run? - Can I cap how many remediation deployments come back? instructions: - text: List deployments for remediation {remediation} in subscription {subscription}. slots: remediation: path.remediationName subscription: path.subscriptionId - text: Show the first {top} deployments run by subscription remediation {remediation} ({subscription}). slots: top: query.$top remediation: path.remediationName subscription: path.subscriptionId method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.PolicyInsights/remediations/{remediationName}/cancel'].post update: x-apievangelist-phrasing: intent: Cancel a subscription-scope remediation effect: destructive questions: - Can I stop a policy remediation that is running across my subscription? - What happens to in-flight deployments when I cancel a subscription remediation? instructions: - text: Cancel remediation {remediation} in subscription {subscription}. slots: remediation: path.remediationName subscription: path.subscriptionId - text: Halt the subscription-level policy remediation {remediation} for {subscription}. slots: remediation: path.remediationName subscription: path.subscriptionId method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.PolicyInsights/remediations'].get update: x-apievangelist-phrasing: intent: List remediations in a subscription effect: read questions: - What policy remediations exist at my subscription? - Can I filter subscription remediations by state or policy assignment? instructions: - text: List policy remediations for subscription {subscription}. slots: subscription: path.subscriptionId - text: Show subscription {subscription} remediations matching {filter}. slots: subscription: path.subscriptionId filter: query.$filter method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.PolicyInsights/remediations/{remediationName}'].get update: x-apievangelist-phrasing: intent: Get a subscription-scope remediation effect: read questions: - How do I check the progress of one remediation at subscription scope? - What state is a given subscription-level remediation in? instructions: - text: Get remediation {remediation} in subscription {subscription}. slots: remediation: path.remediationName subscription: path.subscriptionId - text: Show the status of subscription remediation {remediation} ({subscription}). slots: remediation: path.remediationName subscription: path.subscriptionId method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.PolicyInsights/remediations/{remediationName}'].put update: x-apievangelist-phrasing: intent: Create a remediation at subscription scope effect: write questions: - How do I start a policy remediation that fixes non-compliant resources across my subscription? - Can I point a subscription remediation at a particular policy assignment? instructions: - text: Create remediation {remediation} in subscription {subscription} with properties {properties}. slots: remediation: path.remediationName subscription: path.subscriptionId properties: requestBody.properties - text: Launch subscription-wide remediation {remediation} for {subscription}. slots: remediation: path.remediationName subscription: path.subscriptionId method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.PolicyInsights/remediations/{remediationName}'].delete update: x-apievangelist-phrasing: intent: Delete a subscription-scope remediation effect: destructive questions: - Can I delete a remediation record at subscription scope? - Is removing a subscription-level remediation reversible? instructions: - text: Delete remediation {remediation} from subscription {subscription}. slots: remediation: path.remediationName subscription: path.subscriptionId - text: Remove subscription-scope remediation {remediation} in {subscription}. slots: remediation: path.remediationName subscription: path.subscriptionId method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.PolicyInsights/remediations/{remediationName}/listDeployments'].post update: x-apievangelist-phrasing: intent: List deployments of a resource-group remediation effect: read questions: - Which deployments did a remediation in one resource group perform? - Can I see per-resource deployment results for a resource group remediation? instructions: - text: List deployments for remediation {remediation} in resource group {group}, subscription {subscription}. slots: remediation: path.remediationName group: path.resourceGroupName subscription: path.subscriptionId - text: Show the top {top} deployments from group {group} remediation {remediation} ({subscription}). slots: top: query.$top group: path.resourceGroupName remediation: path.remediationName subscription: path.subscriptionId method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.PolicyInsights/remediations/{remediationName}/cancel'].post update: x-apievangelist-phrasing: intent: Cancel a resource-group remediation effect: destructive questions: - Can I stop a policy remediation running inside one resource group? - What does cancelling a resource group remediation do to pending deployments? instructions: - text: Cancel remediation {remediation} in resource group {group}, subscription {subscription}. slots: remediation: path.remediationName group: path.resourceGroupName subscription: path.subscriptionId - text: Stop the group-scoped remediation {remediation} in {group} ({subscription}). slots: remediation: path.remediationName group: path.resourceGroupName subscription: path.subscriptionId method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.PolicyInsights/remediations'].get update: x-apievangelist-phrasing: intent: List remediations in a resource group effect: read questions: - Which policy remediations were created in one resource group? - Can I filter remediations within a resource group? instructions: - text: List policy remediations in resource group {group}, subscription {subscription}. slots: group: path.resourceGroupName subscription: path.subscriptionId - text: Show group {group} remediations matching {filter} ({subscription}). slots: group: path.resourceGroupName filter: query.$filter subscription: path.subscriptionId method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.PolicyInsights/remediations/{remediationName}'].get update: x-apievangelist-phrasing: intent: Get a resource-group remediation effect: read questions: - How do I check one remediation that was created in a resource group? - What provisioning state is a resource group remediation in? instructions: - text: Get remediation {remediation} in resource group {group}, subscription {subscription}. slots: remediation: path.remediationName group: path.resourceGroupName subscription: path.subscriptionId - text: Show details of group-level remediation {remediation} in {group} ({subscription}). slots: remediation: path.remediationName group: path.resourceGroupName subscription: path.subscriptionId method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.PolicyInsights/remediations/{remediationName}'].put update: x-apievangelist-phrasing: intent: Create a remediation in a resource group effect: write questions: - How do I remediate non-compliant resources in just one resource group? - Can I scope a new remediation to a single resource group? instructions: - text: Create remediation {remediation} in resource group {group}, subscription {subscription}, with properties {properties}. slots: remediation: path.remediationName group: path.resourceGroupName subscription: path.subscriptionId properties: requestBody.properties - text: Start a group-scoped remediation {remediation} in {group} ({subscription}). slots: remediation: path.remediationName group: path.resourceGroupName subscription: path.subscriptionId method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.PolicyInsights/remediations/{remediationName}'].delete update: x-apievangelist-phrasing: intent: Delete a resource-group remediation effect: destructive questions: - Can I delete a remediation that belongs to a resource group? - What gets removed when I delete a resource group remediation? instructions: - text: Delete remediation {remediation} from resource group {group}, subscription {subscription}. slots: remediation: path.remediationName group: path.resourceGroupName subscription: path.subscriptionId - text: Remove group-scoped remediation {remediation} in {group} ({subscription}). slots: remediation: path.remediationName group: path.resourceGroupName subscription: path.subscriptionId method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.Migrate/moveCollections'].get update: x-apievangelist-phrasing: intent: List Resource Mover move collections in a subscription effect: read questions: - Which Resource Mover move collections exist in my subscription? - Can I see all region-move collections across a subscription? instructions: - text: List move collections in subscription {subscription}. slots: subscription: path.subscriptionId - text: Show every Resource Mover collection for subscription {subscription}. slots: subscription: path.subscriptionId method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Migrate/moveCollections'].get update: x-apievangelist-phrasing: intent: List move collections in a resource group effect: read questions: - Which Resource Mover collections are stored in one resource group? - Can I narrow move collections down to a single resource group? instructions: - text: List move collections in resource group {group}, subscription {subscription}. slots: group: path.resourceGroupName subscription: path.subscriptionId - text: Show Resource Mover collections kept in group {group} ({subscription}). slots: group: path.resourceGroupName subscription: path.subscriptionId method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Migrate/moveCollections/{moveCollectionName}/requiredFor'].get update: x-apievangelist-phrasing: intent: List move resources that depend on a resource effect: read questions: - Which move resources in a collection require a given ARM resource? - Can I find what depends on a resource before removing it from a move collection? instructions: - text: List move resources in collection {collection} that require source {source} (group {group}, subscription {subscription}). slots: collection: path.moveCollectionName source: query.sourceId group: path.resourceGroupName subscription: path.subscriptionId - text: Find dependents of ARM resource {source} in move collection {collection} ({group}, {subscription}). slots: source: query.sourceId collection: path.moveCollectionName group: path.resourceGroupName subscription: path.subscriptionId method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/tagNames/{tagName}/tagValues/{tagValue}'].put update: x-apievangelist-phrasing: intent: Add a predefined tag value effect: write questions: - How do I add an allowed value to an existing predefined tag name? - What is the maximum length of a predefined tag value? instructions: - text: Add value {value} to predefined tag {tag} in subscription {subscription}. slots: value: path.tagValue tag: path.tagName subscription: path.subscriptionId - text: Register {value} as a predefined value of tag name {tag} ({subscription}). slots: value: path.tagValue tag: path.tagName subscription: path.subscriptionId method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/tagNames/{tagName}/tagValues/{tagValue}'].delete update: x-apievangelist-phrasing: intent: Delete a predefined tag value effect: destructive questions: - Can I remove a value from a predefined tag name's list? - Why would deleting a predefined tag value fail if resources still use it? instructions: - text: Delete value {value} from predefined tag {tag} in subscription {subscription}. slots: value: path.tagValue tag: path.tagName subscription: path.subscriptionId - text: Drop predefined tag value {value} under tag name {tag} ({subscription}). slots: value: path.tagValue tag: path.tagName subscription: path.subscriptionId method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/tagNames/{tagName}'].put update: x-apievangelist-phrasing: intent: Add a predefined tag name effect: write questions: - How do I add a new predefined tag name to my subscription? - Are predefined tag names case-insensitive, and how long can they be? instructions: - text: Create predefined tag name {tag} in subscription {subscription}. slots: tag: path.tagName subscription: path.subscriptionId - text: Add {tag} to the subscription's list of predefined tag names ({subscription}). slots: tag: path.tagName subscription: path.subscriptionId method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/tagNames/{tagName}'].delete update: x-apievangelist-phrasing: intent: Delete a predefined tag name effect: destructive questions: - Can I remove a predefined tag name that no resources use anymore? - What must be true before a predefined tag name can be deleted? instructions: - text: Delete predefined tag name {tag} from subscription {subscription}. slots: tag: path.tagName subscription: path.subscriptionId - text: Remove the tag name {tag} from the predefined list in {subscription}. slots: tag: path.tagName subscription: path.subscriptionId method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ServiceFabricMesh/applications/{applicationName}/services'].get update: x-apievangelist-phrasing: intent: List services of a Service Fabric Mesh application effect: read questions: - Which services run inside a Service Fabric Mesh application? - Can I see runtime properties for every service of a Mesh app? instructions: - text: List services of Mesh application {application} in resource group {group}, subscription {subscription}. slots: application: path.applicationName group: path.resourceGroupName subscription: path.subscriptionId - text: Show all Service Fabric Mesh services under app {application} ({group}, {subscription}). slots: application: path.applicationName group: path.resourceGroupName subscription: path.subscriptionId method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ServiceFabricMesh/applications/{applicationName}/services/{serviceName}'].get update: x-apievangelist-phrasing: intent: Get a Service Fabric Mesh service effect: read questions: - How do I inspect one service inside a Service Fabric Mesh application? - What properties does a single Mesh service report? instructions: - text: Get Mesh service {service} of application {application} in {group}, subscription {subscription}. slots: service: path.serviceName application: path.applicationName group: path.resourceGroupName subscription: path.subscriptionId - text: Show the properties of Service Fabric Mesh service {service} in app {application} ({group}, {subscription}). slots: service: path.serviceName application: path.applicationName group: path.resourceGroupName subscription: path.subscriptionId method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Search/searchServices/{searchServiceName}'].get update: x-apievangelist-phrasing: intent: Get an Azure AI Search service effect: read questions: - How do I look up one search service's SKU and settings? - What does a specific Azure AI Search service's configuration look like? instructions: - text: Get search service {search_service} in resource group {group}, subscription {subscription}. slots: search_service: path.searchServiceName group: path.resourceGroupName subscription: path.subscriptionId - text: Show details of AI Search service {search_service} ({group}, {subscription}). slots: search_service: path.searchServiceName group: path.resourceGroupName subscription: path.subscriptionId method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Search/searchServices/{searchServiceName}'].put update: x-apievangelist-phrasing: intent: Create or replace a search service effect: write questions: - How do I provision a new Azure AI Search service in a resource group? - Does recreating an existing search service overwrite all its properties? instructions: - text: Create search service {search_service} in {group}, subscription {subscription}, with SKU {sku}. slots: search_service: path.searchServiceName group: path.resourceGroupName subscription: path.subscriptionId sku: requestBody.sku - text: Provision AI Search service {search_service} in resource group {group} ({subscription}) with properties {properties}. slots: search_service: path.searchServiceName group: path.resourceGroupName subscription: path.subscriptionId properties: requestBody.properties method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Search/searchServices/{searchServiceName}'].delete update: x-apievangelist-phrasing: intent: Delete a search service effect: destructive questions: - Can I delete an Azure AI Search service along with its associated resources? - What gets removed when a search service is deleted? instructions: - text: Delete search service {search_service} in resource group {group}, subscription {subscription}. slots: search_service: path.searchServiceName group: path.resourceGroupName subscription: path.subscriptionId - text: Tear down AI Search service {search_service} ({group}, {subscription}). slots: search_service: path.searchServiceName group: path.resourceGroupName subscription: path.subscriptionId method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Search/searchServices/{searchServiceName}'].patch update: x-apievangelist-phrasing: intent: Update an existing search service effect: write questions: - Can I change replicas, tags or identity on a search service without recreating it? - What can I patch on an existing Azure AI Search service? instructions: - text: Update search service {search_service} in {group}, subscription {subscription}, with tags {tags}. slots: search_service: path.searchServiceName group: path.resourceGroupName subscription: path.subscriptionId tags: requestBody.tags - text: Patch the properties of AI Search service {search_service} to {properties} ({group}, {subscription}). slots: search_service: path.searchServiceName properties: requestBody.properties group: path.resourceGroupName subscription: path.subscriptionId method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Search/searchServices'].get update: x-apievangelist-phrasing: intent: List search services in a resource group effect: read questions: - Which Azure AI Search services are in one resource group? - Can I list search services scoped to a single resource group? instructions: - text: List search services in resource group {group}, subscription {subscription}. slots: group: path.resourceGroupName subscription: path.subscriptionId - text: Show every AI Search service inside group {group} ({subscription}). slots: group: path.resourceGroupName subscription: path.subscriptionId method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.Search/searchServices'].get update: x-apievangelist-phrasing: intent: List search services in a subscription effect: read questions: - Which Azure AI Search services do I have across my entire subscription? - How many search services exist subscription-wide? instructions: - text: List all search services in subscription {subscription}. slots: subscription: path.subscriptionId - text: Show every AI Search service across subscription {subscription}. slots: subscription: path.subscriptionId method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.Search/checkNameAvailability'].post update: x-apievangelist-phrasing: intent: Check if a search service name is free effect: read questions: - Is my chosen search service name globally available? - Why must Azure AI Search service names be globally unique? instructions: - text: Check whether search service name {name} is available in subscription {subscription} (type {type}). slots: name: requestBody.name subscription: path.subscriptionId type: requestBody.type - text: Verify the AI Search name {name} of type {type} is unused ({subscription}). slots: name: requestBody.name type: requestBody.type subscription: path.subscriptionId method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.Subscriptions.Admin/updateEncryption'].post update: x-apievangelist-phrasing: intent: Update Azure Stack Hub subscription encryption effect: write questions: - How do I update the encryption settings of the Azure Stack Hub subscriptions service? - Can an operator rotate subscription service encryption as an admin? instructions: - text: Update the encryption settings for admin subscription {subscription}. slots: subscription: path.subscriptionId - text: Refresh subscriptions-service encryption under {subscription}. slots: subscription: path.subscriptionId method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.Subscriptions.Admin/restoreData'].post update: x-apievangelist-phrasing: intent: Restore subscriptions service data effect: write questions: - Can an Azure Stack Hub operator restore the subscriptions service data? - When would I trigger a data restore for the subscriptions admin service? instructions: - text: Restore subscriptions service data for admin subscription {subscription}. slots: subscription: path.subscriptionId - text: Kick off a subscriptions data restore under {subscription}. slots: subscription: path.subscriptionId method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.Subscriptions.Admin/checkIdentityHealth'].post update: x-apievangelist-phrasing: intent: Check subscriptions service identity health effect: read questions: - Is identity healthy for the Azure Stack Hub subscriptions service? - How can an operator verify the subscriptions admin identity is working? instructions: - text: Check identity health for admin subscription {subscription}. slots: subscription: path.subscriptionId - text: Run the subscriptions service identity health check on {subscription}. slots: subscription: path.subscriptionId method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.Subscriptions.Admin/moveSubscriptions'].post update: x-apievangelist-phrasing: intent: Move user subscriptions between offers effect: write questions: - How do I move user subscriptions between delegated provider offers? - Can an operator reassign tenant subscriptions to a different delegated offer? instructions: - text: Move subscriptions per definition {definition} under admin subscription {subscription}. slots: definition: body.moveSubscriptionsDefinition subscription: path.subscriptionId - text: Transfer user subscriptions to another delegated provider offer using {definition} ({subscription}). slots: definition: body.moveSubscriptionsDefinition subscription: path.subscriptionId method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.Subscriptions.Admin/validateMoveSubscriptions'].post update: x-apievangelist-phrasing: intent: Validate a subscription move between offers effect: read questions: - Can I dry-run moving user subscriptions between delegated provider offers? - Will my planned subscription move pass validation? instructions: - text: Validate subscription move {definition} under admin subscription {subscription}. slots: definition: body.moveSubscriptionsDefinition subscription: path.subscriptionId - text: Check that the delegated-offer move {definition} is allowed before running it ({subscription}). slots: definition: body.moveSubscriptionsDefinition subscription: path.subscriptionId method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.Subscriptions.Admin/subscriptions'].get update: x-apievangelist-phrasing: intent: List user subscriptions as an operator effect: read questions: - As an Azure Stack Hub operator, how do I list all user subscriptions? - Can I filter the admin subscription list? instructions: - text: List user subscriptions visible to admin subscription {subscription}. slots: subscription: path.subscriptionId - text: Show operator-managed subscriptions matching {filter} ({subscription}). slots: filter: query.$filter subscription: path.subscriptionId method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.Subscriptions.Admin/checkNameAvailability'].post update: x-apievangelist-phrasing: intent: Check a subscription name as an operator effect: read questions: - Is a user subscription name available on Azure Stack Hub? - Can an operator validate a subscription name before creating it? instructions: - text: Check subscription name availability using {definition} under admin subscription {subscription}. slots: definition: body.nameAvailabilityDefinition subscription: path.subscriptionId - text: Verify the proposed user subscription name in {definition} is free ({subscription}). slots: definition: body.nameAvailabilityDefinition subscription: path.subscriptionId method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.Subscriptions.Admin/subscriptions/{targetSubscriptionId}'].get update: x-apievangelist-phrasing: intent: Get a user subscription as an operator effect: read questions: - How does an operator look up one tenant's subscription? - What offer and state does a specific user subscription have? instructions: - text: Get user subscription {target} via admin subscription {subscription}. slots: target: path.targetSubscriptionId subscription: path.subscriptionId - text: Show operator details of subscription {target} ({subscription}). slots: target: path.targetSubscriptionId subscription: path.subscriptionId method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.Subscriptions.Admin/subscriptions/{targetSubscriptionId}'].put update: x-apievangelist-phrasing: intent: Create or update a user subscription effect: write questions: - How does an Azure Stack Hub operator create a subscription for a tenant? - Can I change the offer on an existing user subscription as admin? instructions: - text: Create or update user subscription {target} with definition {definition} under {subscription}. slots: target: path.targetSubscriptionId definition: body.subscriptionDefinition subscription: path.subscriptionId - text: Provision tenant subscription {target} from {definition} ({subscription}). slots: target: path.targetSubscriptionId definition: body.subscriptionDefinition subscription: path.subscriptionId method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.Subscriptions.Admin/subscriptions/{targetSubscriptionId}'].delete update: x-apievangelist-phrasing: intent: Delete a user subscription as an operator effect: destructive questions: - Can an operator delete a tenant's subscription? - What happens to resources when an admin removes a user subscription? instructions: - text: Delete user subscription {target} via admin subscription {subscription}. slots: target: path.targetSubscriptionId subscription: path.subscriptionId - text: Remove tenant subscription {target} ({subscription}). slots: target: path.targetSubscriptionId subscription: path.subscriptionId method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Synapse/workspaces/{workspaceName}/managedIdentitySqlControlSettings/default'].get update: x-apievangelist-phrasing: intent: Get Synapse managed identity SQL control settings effect: read questions: - Does my Synapse workspace managed identity have SQL control permissions granted? - Where can I check the managed identity SQL control setting of a Synapse workspace? instructions: - text: Get managed identity SQL control settings for Synapse workspace {workspace}. slots: workspace: path.workspaceName - text: Show whether workspace {workspace} grants SQL control to its managed identity. slots: workspace: path.workspaceName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Synapse/workspaces/{workspaceName}/managedIdentitySqlControlSettings/default'].put update: x-apievangelist-phrasing: intent: Set Synapse managed identity SQL control effect: write questions: - How do I grant SQL control to a Synapse workspace's managed identity? - Can I turn off managed identity SQL control on a Synapse workspace? instructions: - text: Set the Synapse managed identity SQL control settings to {settings}. slots: settings: requestBody.properties - text: Enable SQL control for the managed identity of Synapse workspace {workspaceName}. slots: workspaceName: path.workspaceName method: generated generated: '2026-10-01' - target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.Syntex/documentProcessors'].get update: x-apievangelist-phrasing: intent: List Syntex document processors in a subscription effect: read questions: - Which Syntex document processors exist in my subscription? - Can I see every document processor subscription-wide? instructions: - text: List all Syntex document processors in my subscription. - text: Show document processors across the whole subscription. method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Syntex/documentProcessors'].get update: x-apievangelist-phrasing: intent: List document processors in a resource group effect: read questions: - Which Syntex document processors are in one resource group? - Can I scope the document processor list to a resource group? instructions: - text: List Syntex document processors in this resource group. - text: Show document processors for the current resource group only. method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Syntex/documentProcessors/{processorName}'].get update: x-apievangelist-phrasing: intent: Get a Syntex document processor effect: read questions: - How do I view one Syntex document processor's settings? - What configuration does a specific document processor have? instructions: - text: Get Syntex document processor {processor}. slots: processor: path.processorName - text: Show details of document processor {processor}. slots: processor: path.processorName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Syntex/documentProcessors/{processorName}'].put update: x-apievangelist-phrasing: intent: Create a Syntex document processor effect: write questions: - How do I create a new Syntex document processor resource? - What properties are needed to register a document processor? instructions: - text: Create Syntex document processor {processor} with properties {properties}. slots: processor: path.processorName properties: requestBody.properties - text: Register a new document processor named {processor}. slots: processor: path.processorName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Syntex/documentProcessors/{processorName}'].delete update: x-apievangelist-phrasing: intent: Delete a Syntex document processor effect: destructive questions: - Can I delete a Syntex document processor I no longer need? - Is removing a document processor resource permanent? instructions: - text: Delete Syntex document processor {processor}. slots: processor: path.processorName - text: Remove document processor {processor}. slots: processor: path.processorName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Syntex/documentProcessors/{processorName}'].patch update: x-apievangelist-phrasing: intent: Update a Syntex document processor effect: write questions: - Can I change tags or properties on an existing document processor? - What fields can I patch on a Syntex document processor? instructions: - text: Update tags on Syntex document processor {processor} to {tags}. slots: processor: path.processorName tags: requestBody.tags - text: Patch document processor {processor} properties with {properties}. slots: processor: path.processorName properties: requestBody.properties method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualWans/{VirtualWANName}'].get update: x-apievangelist-phrasing: intent: Get a Virtual WAN effect: read questions: - How do I retrieve the details of one Virtual WAN? - What hubs and settings does a specific Virtual WAN have? instructions: - text: Get Virtual WAN {wan} in resource group {group}. slots: wan: path.VirtualWANName group: path.resourceGroupName - text: Show configuration of Virtual WAN {wan} ({group}). slots: wan: path.VirtualWANName group: path.resourceGroupName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualWans/{VirtualWANName}'].put update: x-apievangelist-phrasing: intent: Create or update a Virtual WAN effect: write questions: - How do I create a new Virtual WAN in a resource group? - Can I update an existing Virtual WAN with the same call used to create it? instructions: - text: Create Virtual WAN {wan} in resource group {group} with properties {properties}. slots: wan: path.VirtualWANName group: path.resourceGroupName properties: requestBody.properties - text: Update Virtual WAN {wan} in {group}. slots: wan: path.VirtualWANName group: path.resourceGroupName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualWans/{VirtualWANName}'].delete update: x-apievangelist-phrasing: intent: Delete a Virtual WAN effect: destructive questions: - Can I delete a Virtual WAN I no longer use? - What must be removed before a Virtual WAN can be deleted? instructions: - text: Delete Virtual WAN {wan} in resource group {group}. slots: wan: path.VirtualWANName group: path.resourceGroupName - text: Remove the Virtual WAN {wan} from {group}. slots: wan: path.VirtualWANName group: path.resourceGroupName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualWans'].get update: x-apievangelist-phrasing: intent: List Virtual WANs in a resource group effect: read questions: - Which Virtual WANs are defined in one resource group? - Can I list Virtual WANs for a specific resource group? instructions: - text: List Virtual WANs in resource group {group}. slots: group: path.resourceGroupName - text: Show every Virtual WAN inside {group}. slots: group: path.resourceGroupName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.Network/virtualWans'].get update: x-apievangelist-phrasing: intent: List Virtual WANs in a subscription effect: read questions: - Which Virtual WANs exist across my whole subscription? - How many Virtual WANs do I have subscription-wide? instructions: - text: List all Virtual WANs in my subscription. - text: Show every Virtual WAN across the subscription. method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/vpnSites/{vpnSiteName}'].get update: x-apievangelist-phrasing: intent: Get a VPN site effect: read questions: - How do I see the details of one VPN site in Virtual WAN? - What address space and device info does a VPN site hold? instructions: - text: Get VPN site {site} in resource group {group}. slots: site: path.vpnSiteName group: path.resourceGroupName - text: Show the configuration of VPN site {site} ({group}). slots: site: path.vpnSiteName group: path.resourceGroupName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/vpnSites/{vpnSiteName}'].put update: x-apievangelist-phrasing: intent: Create or update a VPN site effect: write questions: - How do I register a branch office as a VPN site? - Can I change a VPN site's properties with the create call? instructions: - text: Create VPN site {site} in resource group {group} with properties {properties}. slots: site: path.vpnSiteName group: path.resourceGroupName properties: requestBody.properties - text: Update VPN site {site} in {group}. slots: site: path.vpnSiteName group: path.resourceGroupName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/vpnSites/{vpnSiteName}'].delete update: x-apievangelist-phrasing: intent: Delete a VPN site effect: destructive questions: - Can I remove a VPN site that a branch no longer uses? - Is deleting a VPN site reversible? instructions: - text: Delete VPN site {site} in resource group {group}. slots: site: path.vpnSiteName group: path.resourceGroupName - text: Remove branch VPN site {site} from {group}. slots: site: path.vpnSiteName group: path.resourceGroupName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/vpnSites'].get update: x-apievangelist-phrasing: intent: List VPN sites in a resource group effect: read questions: - Which VPN sites are defined in one resource group? - Can I scope the VPN site list to a single resource group? instructions: - text: List VPN sites in resource group {group}. slots: group: path.resourceGroupName - text: Show every branch VPN site inside {group}. slots: group: path.resourceGroupName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/vpnSites/{vpnSiteName}/vpnSiteLinks/{vpnSiteLinkName}'].get update: x-apievangelist-phrasing: intent: Get a VPN site link effect: read questions: - How do I look up one link of a VPN site? - What IP address and BGP settings does a VPN site link have? instructions: - text: Get link {link} of VPN site {site} in resource group {group}. slots: link: path.vpnSiteLinkName site: path.vpnSiteName group: path.resourceGroupName - text: Show VPN site link {link} on {site} ({group}). slots: link: path.vpnSiteLinkName site: path.vpnSiteName group: path.resourceGroupName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/vpnSites/{vpnSiteName}/vpnSiteLinks'].get update: x-apievangelist-phrasing: intent: List links of a VPN site effect: read questions: - Which links belong to a given VPN site? - Can I see all ISP links configured on one VPN site? instructions: - text: List links of VPN site {site} in resource group {group}. slots: site: path.vpnSiteName group: path.resourceGroupName - text: Show every VPN site link configured on {site} ({group}). slots: site: path.vpnSiteName group: path.resourceGroupName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.Network/vpnSites'].get update: x-apievangelist-phrasing: intent: List VPN sites in a subscription effect: read questions: - Which VPN sites exist across my subscription? - How many branch VPN sites do I have subscription-wide? instructions: - text: List all VPN sites in my subscription. - text: Show every VPN site across the subscription. method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualWans/{virtualWANName}/vpnConfiguration'].post update: x-apievangelist-phrasing: intent: Download VPN site configurations effect: write questions: - How do I get the device configuration file for my VPN sites? - Can I have VPN site configurations written to a blob SAS URL? instructions: - text: Download configuration for VPN sites {sites} on Virtual WAN {wan} in {group} to SAS URL {sas_url}. slots: sites: requestBody.vpnSites wan: path.virtualWANName group: path.resourceGroupName sas_url: requestBody.outputBlobSasUrl - text: Write the VPN site configs for WAN {wan} ({group}) to blob {sas_url}. slots: wan: path.virtualWANName group: path.resourceGroupName sas_url: requestBody.outputBlobSasUrl method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualWans/{virtualWANName}/supportedSecurityProviders'].get update: x-apievangelist-phrasing: intent: List security providers for a Virtual WAN effect: read questions: - Which third-party security providers can I use with my Virtual WAN? - What security partner providers does a Virtual WAN support? instructions: - text: List supported security providers for Virtual WAN {wan} in {group}. slots: wan: path.virtualWANName group: path.resourceGroupName - text: Show the security partner options for WAN {wan} ({group}). slots: wan: path.virtualWANName group: path.resourceGroupName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/vpnServerConfigurations/{vpnServerConfigurationName}'].get update: x-apievangelist-phrasing: intent: Get a VPN server configuration effect: read questions: - How do I look up a VPN server configuration for point-to-site users? - What authentication settings does one VpnServerConfiguration use? instructions: - text: Get VPN server configuration {config} in resource group {group}. slots: config: path.vpnServerConfigurationName group: path.resourceGroupName - text: Show details of VpnServerConfiguration {config} ({group}). slots: config: path.vpnServerConfigurationName group: path.resourceGroupName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/vpnServerConfigurations/{vpnServerConfigurationName}'].put update: x-apievangelist-phrasing: intent: Create or update a VPN server configuration effect: write questions: - How do I create a VPN server configuration for point-to-site clients? - Can I change protocols on an existing VpnServerConfiguration? instructions: - text: Create VPN server configuration {config} in {group} with properties {properties}. slots: config: path.vpnServerConfigurationName group: path.resourceGroupName properties: requestBody.properties - text: Update VpnServerConfiguration {config} in resource group {group}. slots: config: path.vpnServerConfigurationName group: path.resourceGroupName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/vpnServerConfigurations/{vpnServerConfigurationName}'].delete update: x-apievangelist-phrasing: intent: Delete a VPN server configuration effect: destructive questions: - Can I delete a VPN server configuration that no gateway uses? - What happens to P2S users when a VpnServerConfiguration is deleted? instructions: - text: Delete VPN server configuration {config} in resource group {group}. slots: config: path.vpnServerConfigurationName group: path.resourceGroupName - text: Remove VpnServerConfiguration {config} from {group}. slots: config: path.vpnServerConfigurationName group: path.resourceGroupName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/vpnServerConfigurations'].get update: x-apievangelist-phrasing: intent: List VPN server configurations in a resource group effect: read questions: - Which VPN server configurations are in one resource group? - Can I list P2S server configs for a single resource group? instructions: - text: List VPN server configurations in resource group {group}. slots: group: path.resourceGroupName - text: Show every VpnServerConfiguration inside {group}. slots: group: path.resourceGroupName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/vpnServerConfigurations/{vpnServerConfigurationName}/configurationPolicyGroups/{configurationPolicyGroupName}'].get update: x-apievangelist-phrasing: intent: Get a VPN configuration policy group effect: read questions: - How do I inspect one configuration policy group of a VPN server configuration? - What member rules does a ConfigurationPolicyGroup define? instructions: - text: Get policy group {policy_group} of VPN server configuration {config} in {group}. slots: policy_group: path.configurationPolicyGroupName config: path.vpnServerConfigurationName group: path.resourceGroupName - text: Show configuration policy group {policy_group} on {config} ({group}). slots: policy_group: path.configurationPolicyGroupName config: path.vpnServerConfigurationName group: path.resourceGroupName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/vpnServerConfigurations/{vpnServerConfigurationName}/configurationPolicyGroups/{configurationPolicyGroupName}'].put update: x-apievangelist-phrasing: intent: Create or update a VPN configuration policy group effect: write questions: - How do I add a configuration policy group to a VPN server configuration? - Can I change the priority or members of an existing policy group? instructions: - text: Create policy group {policy_group} on VPN server configuration {config} in {group} with properties {properties}. slots: policy_group: path.configurationPolicyGroupName config: path.vpnServerConfigurationName group: path.resourceGroupName properties: requestBody.properties - text: Update configuration policy group {policy_group} for {config} ({group}). slots: policy_group: path.configurationPolicyGroupName config: path.vpnServerConfigurationName group: path.resourceGroupName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/vpnServerConfigurations/{vpnServerConfigurationName}/configurationPolicyGroups/{configurationPolicyGroupName}'].delete update: x-apievangelist-phrasing: intent: Delete a VPN configuration policy group effect: destructive questions: - Can I remove a configuration policy group from a VPN server configuration? - What happens to users matched by a policy group once it is deleted? instructions: - text: Delete policy group {policy_group} from VPN server configuration {config} in {group}. slots: policy_group: path.configurationPolicyGroupName config: path.vpnServerConfigurationName group: path.resourceGroupName - text: Remove configuration policy group {policy_group} on {config} ({group}). slots: policy_group: path.configurationPolicyGroupName config: path.vpnServerConfigurationName group: path.resourceGroupName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/vpnServerConfigurations/{vpnServerConfigurationName}/configurationPolicyGroups'].get update: x-apievangelist-phrasing: intent: List policy groups of a VPN server configuration effect: read questions: - Which configuration policy groups belong to a VPN server configuration? - Can I list every policy group defined on one P2S server config? instructions: - text: List configuration policy groups of VPN server configuration {config} in {group}. slots: config: path.vpnServerConfigurationName group: path.resourceGroupName - text: Show all policy groups attached to {config} ({group}). slots: config: path.vpnServerConfigurationName group: path.resourceGroupName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.Network/vpnServerConfigurations'].get update: x-apievangelist-phrasing: intent: List VPN server configurations in a subscription effect: read questions: - Which VPN server configurations exist across my subscription? - How many P2S server configurations do I have subscription-wide? instructions: - text: List all VPN server configurations in my subscription. - text: Show every VpnServerConfiguration across the subscription. method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualHubs/{virtualHubName}'].get update: x-apievangelist-phrasing: intent: Get a virtual hub effect: read questions: - Can I pull up one virtual hub's full configuration? - What address prefix and routing settings does a virtual hub have? instructions: - text: Get virtual hub {hub} in resource group {group}. slots: hub: path.virtualHubName group: path.resourceGroupName - text: Show the configuration of virtual hub {hub} ({group}). slots: hub: path.virtualHubName group: path.resourceGroupName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualHubs/{virtualHubName}'].put update: x-apievangelist-phrasing: intent: Create or update a virtual hub effect: write questions: - How do I create a new hub inside my Virtual WAN? - Can I set the hub kind when creating a virtual hub? instructions: - text: Create virtual hub {hub} in resource group {group} with properties {properties}. slots: hub: path.virtualHubName group: path.resourceGroupName properties: requestBody.properties - text: Create or update hub {hub} in {group} as kind {kind}. slots: hub: path.virtualHubName group: path.resourceGroupName kind: requestBody.kind method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualHubs/{virtualHubName}'].delete update: x-apievangelist-phrasing: intent: Delete a virtual hub effect: destructive questions: - Can I delete a Virtual WAN hub I no longer need? - What connections must be removed before deleting a virtual hub? instructions: - text: Delete virtual hub {hub} in resource group {group}. slots: hub: path.virtualHubName group: path.resourceGroupName - text: Remove the WAN hub {hub} from {group}. slots: hub: path.virtualHubName group: path.resourceGroupName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualHubs'].get update: x-apievangelist-phrasing: intent: List virtual hubs in a resource group effect: read questions: - Which virtual hubs live in one resource group? - Can I list Virtual WAN hubs for a single resource group? instructions: - text: List virtual hubs in resource group {group}. slots: group: path.resourceGroupName - text: Show every WAN hub inside {group}. slots: group: path.resourceGroupName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.Network/virtualHubs'].get update: x-apievangelist-phrasing: intent: List virtual hubs in a subscription effect: read questions: - Which virtual hubs exist across my whole subscription? - How many Virtual WAN hubs do I run subscription-wide? instructions: - text: List all virtual hubs in my subscription. - text: Show every WAN hub across the subscription. method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualHubs/{virtualHubName}/routeMaps/{routeMapName}'].get update: x-apievangelist-phrasing: intent: Get a hub route map effect: read questions: - How do I inspect a route map on a virtual hub? - What rules does a particular RouteMap apply? instructions: - text: Get route map {route_map} on virtual hub {hub} in {group}. slots: route_map: path.routeMapName hub: path.virtualHubName group: path.resourceGroupName - text: Show the RouteMap {route_map} rules for hub {hub} ({group}). slots: route_map: path.routeMapName hub: path.virtualHubName group: path.resourceGroupName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualHubs/{virtualHubName}/routeMaps/{routeMapName}'].put update: x-apievangelist-phrasing: intent: Create or update a hub route map effect: write questions: - How do I add a route map to a virtual hub to modify advertised routes? - Can I edit an existing RouteMap's rules in place? instructions: - text: Create route map {route_map} on hub {hub} in {group} with properties {properties}. slots: route_map: path.routeMapName hub: path.virtualHubName group: path.resourceGroupName properties: requestBody.properties - text: Update RouteMap {route_map} for virtual hub {hub} ({group}). slots: route_map: path.routeMapName hub: path.virtualHubName group: path.resourceGroupName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualHubs/{virtualHubName}/routeMaps/{routeMapName}'].delete update: x-apievangelist-phrasing: intent: Delete a hub route map effect: destructive questions: - Can I delete a route map from a virtual hub? - What happens to route modifications when a RouteMap is removed? instructions: - text: Delete route map {route_map} from virtual hub {hub} in {group}. slots: route_map: path.routeMapName hub: path.virtualHubName group: path.resourceGroupName - text: Remove RouteMap {route_map} on hub {hub} ({group}). slots: route_map: path.routeMapName hub: path.virtualHubName group: path.resourceGroupName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualHubs/{virtualHubName}/routeMaps'].get update: x-apievangelist-phrasing: intent: List route maps on a virtual hub effect: read questions: - Which route maps are configured on a virtual hub? - Can I see all RouteMaps attached to one hub? instructions: - text: List route maps on virtual hub {hub} in {group}. slots: hub: path.virtualHubName group: path.resourceGroupName - text: Show every RouteMap defined for hub {hub} ({group}). slots: hub: path.virtualHubName group: path.resourceGroupName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualHubs/{virtualHubName}/hubVirtualNetworkConnections/{connectionName}'].get update: x-apievangelist-phrasing: intent: Get a hub-to-VNet connection effect: read questions: - How do I check one virtual network connection on a hub? - What routing configuration does a hub VNet connection use? instructions: - text: Get hub virtual network connection {connection} on hub {hub} in {group}. slots: connection: path.connectionName hub: path.virtualHubName group: path.resourceGroupName - text: Show VNet connection {connection} attached to hub {hub} ({group}). slots: connection: path.connectionName hub: path.virtualHubName group: path.resourceGroupName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualHubs/{virtualHubName}/hubVirtualNetworkConnections/{connectionName}'].put update: x-apievangelist-phrasing: intent: Connect a VNet to a virtual hub effect: write questions: - How do I connect a spoke virtual network to my Virtual WAN hub? - Can I change routing on an existing hub VNet connection? instructions: - text: Connect a virtual network to hub {hub} in {group} as connection {connection} with properties {properties}. slots: hub: path.virtualHubName group: path.resourceGroupName connection: path.connectionName properties: requestBody.properties - text: Update hub VNet connection {connection} on {hub} ({group}). slots: connection: path.connectionName hub: path.virtualHubName group: path.resourceGroupName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualHubs/{virtualHubName}/hubVirtualNetworkConnections/{connectionName}'].delete update: x-apievangelist-phrasing: intent: Disconnect a VNet from a virtual hub effect: destructive questions: - Can I detach a virtual network from a Virtual WAN hub? - What traffic breaks when a hub VNet connection is deleted? instructions: - text: Delete hub virtual network connection {connection} on hub {hub} in {group}. slots: connection: path.connectionName hub: path.virtualHubName group: path.resourceGroupName - text: Disconnect VNet connection {connection} from hub {hub} ({group}). slots: connection: path.connectionName hub: path.virtualHubName group: path.resourceGroupName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualHubs/{virtualHubName}/hubVirtualNetworkConnections'].get update: x-apievangelist-phrasing: intent: List VNet connections on a virtual hub effect: read questions: - Which virtual networks are connected to a given hub? - Can I list every spoke VNet connection on one hub? instructions: - text: List virtual network connections on hub {hub} in {group}. slots: hub: path.virtualHubName group: path.resourceGroupName - text: Show all spoke VNets attached to hub {hub} ({group}). slots: hub: path.virtualHubName group: path.resourceGroupName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/vpnGateways/{gatewayName}'].get update: x-apievangelist-phrasing: intent: Get a Virtual WAN VPN gateway effect: read questions: - How do I see the details of a site-to-site VPN gateway in a hub? - What scale units and BGP settings does a Virtual WAN VPN gateway use? instructions: - text: Get VPN gateway {gateway} in resource group {group}. slots: gateway: path.gatewayName group: path.resourceGroupName - text: Show site-to-site gateway {gateway} configuration ({group}). slots: gateway: path.gatewayName group: path.resourceGroupName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/vpnGateways/{gatewayName}'].put update: x-apievangelist-phrasing: intent: Create or update a Virtual WAN VPN gateway effect: write questions: - How do I deploy a site-to-site VPN gateway into a virtual hub? - Can I resize an existing Virtual WAN VPN gateway? instructions: - text: Create VPN gateway {gateway} in {group} with properties {properties}. slots: gateway: path.gatewayName group: path.resourceGroupName properties: requestBody.properties - text: Update site-to-site VPN gateway {gateway} in resource group {group}. slots: gateway: path.gatewayName group: path.resourceGroupName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/vpnGateways/{gatewayName}'].delete update: x-apievangelist-phrasing: intent: Delete a Virtual WAN VPN gateway effect: destructive questions: - Can I delete a site-to-site VPN gateway from my hub? - Which branch tunnels drop when a Virtual WAN VPN gateway is deleted? instructions: - text: Delete VPN gateway {gateway} in resource group {group}. slots: gateway: path.gatewayName group: path.resourceGroupName - text: Remove site-to-site gateway {gateway} from {group}. slots: gateway: path.gatewayName group: path.resourceGroupName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/vpnGateways'].get update: x-apievangelist-phrasing: intent: List VPN gateways in a resource group effect: read questions: - Which site-to-site VPN gateways are in one resource group? - Can I list Virtual WAN VPN gateways scoped to a resource group? instructions: - text: List VPN gateways in resource group {group}. slots: group: path.resourceGroupName - text: Show every S2S VPN gateway inside {group}. slots: group: path.resourceGroupName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.Network/vpnGateways'].get update: x-apievangelist-phrasing: intent: List VPN gateways in a subscription effect: read questions: - Which Virtual WAN VPN gateways exist across my subscription? - How many site-to-site gateways do I have subscription-wide? instructions: - text: List all Virtual WAN VPN gateways in my subscription. - text: Show every S2S VPN gateway across the subscription. method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/vpnGateways/{gatewayName}/vpnConnections/{connectionName}'].get update: x-apievangelist-phrasing: intent: Get a VPN connection on a gateway effect: read questions: - How do I check one site-to-site VPN connection on a hub gateway? - What shared key and IPsec policy does a VPN connection use? instructions: - text: Get VPN connection {connection} on gateway {gateway} in {group}. slots: connection: path.connectionName gateway: path.gatewayName group: path.resourceGroupName - text: Show branch VPN connection {connection} for gateway {gateway} ({group}). slots: connection: path.connectionName gateway: path.gatewayName group: path.resourceGroupName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/vpnGateways/{gatewayName}/vpnConnections/{connectionName}'].put update: x-apievangelist-phrasing: intent: Create or update a VPN connection effect: write questions: - How do I connect a VPN site to a scalable Virtual WAN VPN gateway? - Can I change the IPsec settings of an existing VPN connection? instructions: - text: Create VPN connection {connection} on gateway {gateway} in {group} with properties {properties}. slots: connection: path.connectionName gateway: path.gatewayName group: path.resourceGroupName properties: requestBody.properties - text: Update branch VPN connection {connection} on {gateway} ({group}). slots: connection: path.connectionName gateway: path.gatewayName group: path.resourceGroupName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/vpnGateways/{gatewayName}/vpnConnections/{connectionName}'].delete update: x-apievangelist-phrasing: intent: Delete a VPN connection effect: destructive questions: - Can I remove a site-to-site VPN connection from a hub gateway? - Does deleting a VPN connection tear down the branch tunnel immediately? instructions: - text: Delete VPN connection {connection} on gateway {gateway} in {group}. slots: connection: path.connectionName gateway: path.gatewayName group: path.resourceGroupName - text: Remove branch tunnel connection {connection} from {gateway} ({group}). slots: connection: path.connectionName gateway: path.gatewayName group: path.resourceGroupName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/vpnGateways/{gatewayName}/vpnConnections/{connectionName}/vpnLinkConnections/{linkConnectionName}'].get update: x-apievangelist-phrasing: intent: Get a VPN site link connection effect: read questions: - How do I view one link connection inside a VPN connection? - What status and bandwidth does a VPN site link connection report? instructions: - text: Get link connection {link_connection} of VPN connection {connection} on gateway {gateway} in {group}. slots: link_connection: path.linkConnectionName connection: path.connectionName gateway: path.gatewayName group: path.resourceGroupName - text: Show site link connection {link_connection} under {connection} ({gateway}, {group}). slots: link_connection: path.linkConnectionName connection: path.connectionName gateway: path.gatewayName group: path.resourceGroupName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/vpnGateways/{gatewayName}/vpnConnections/{connectionName}/vpnLinkConnections/{linkConnectionName}/getikesas'].post update: x-apievangelist-phrasing: intent: Get IKE security associations for a link effect: read questions: - How do I troubleshoot IKE security associations on a VPN site link connection? - Can I see the IKE SAs negotiated for one branch link? instructions: - text: List IKE security associations for link connection {link_connection} on {connection}, gateway {gateway}, group {group}. slots: link_connection: path.linkConnectionName connection: path.connectionName gateway: path.gatewayName group: path.resourceGroupName - text: Pull IKE SAs of site link {link_connection} ({connection}, {gateway}, {group}). slots: link_connection: path.linkConnectionName connection: path.connectionName gateway: path.gatewayName group: path.resourceGroupName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/vpnGateways/{gatewayName}/vpnConnections/{vpnConnectionName}/startpacketcapture'].post update: x-apievangelist-phrasing: intent: Start packet capture on a VPN connection effect: write questions: - How do I start a packet capture on a Virtual WAN VPN connection? - Can I capture packets on only certain link connections with a filter? instructions: - text: Start packet capture on VPN connection {connection} of gateway {gateway} in {group}. slots: connection: path.vpnConnectionName gateway: path.gatewayName group: path.resourceGroupName - text: Begin capturing packets on {connection} ({gateway}, {group}) for links {links} using filter {filter}. slots: connection: path.vpnConnectionName gateway: path.gatewayName group: path.resourceGroupName links: requestBody.linkConnectionNames filter: requestBody.filterData method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/vpnGateways/{gatewayName}/vpnConnections/{vpnConnectionName}/stoppacketcapture'].post update: x-apievangelist-phrasing: intent: Stop packet capture on a VPN connection effect: write questions: - How do I stop a running packet capture and save it to storage? - Where does the capture file go when I stop a VPN connection packet capture? instructions: - text: Stop packet capture on VPN connection {connection} of gateway {gateway} in {group} and upload to {sas_url}. slots: connection: path.vpnConnectionName gateway: path.gatewayName group: path.resourceGroupName sas_url: requestBody.sasUrl - text: End the capture on {connection} ({gateway}, {group}). slots: connection: path.vpnConnectionName gateway: path.gatewayName group: path.resourceGroupName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/vpnGateways/{gatewayName}/vpnConnections'].get update: x-apievangelist-phrasing: intent: List VPN connections on a gateway effect: read questions: - Which site-to-site connections are attached to a Virtual WAN VPN gateway? - Can I list every branch connection on one gateway? instructions: - text: List VPN connections on gateway {gateway} in {group}. slots: gateway: path.gatewayName group: path.resourceGroupName - text: Show all branch tunnels terminating on {gateway} ({group}). slots: gateway: path.gatewayName group: path.resourceGroupName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/vpnGateways/{gatewayName}/vpnConnections/{connectionName}/vpnLinkConnections'].get update: x-apievangelist-phrasing: intent: List link connections of a VPN connection effect: read questions: - Which site link connections make up one VPN connection? - Can I list every ISP link connection under a VPN connection? instructions: - text: List link connections of VPN connection {connection} on gateway {gateway} in {group}. slots: connection: path.connectionName gateway: path.gatewayName group: path.resourceGroupName - text: Show every site link connection inside {connection} ({gateway}, {group}). slots: connection: path.connectionName gateway: path.gatewayName group: path.resourceGroupName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/vpnGateways/{gatewayName}/natRules/{natRuleName}'].get update: x-apievangelist-phrasing: intent: Get a VPN gateway NAT rule effect: read questions: - How do I inspect a NAT rule on a Virtual WAN VPN gateway? - What mappings does a specific gateway NAT rule define? instructions: - text: Get NAT rule {nat_rule} on gateway {gateway} in {group}. slots: nat_rule: path.natRuleName gateway: path.gatewayName group: path.resourceGroupName - text: Show the mappings of NAT rule {nat_rule} for {gateway} ({group}). slots: nat_rule: path.natRuleName gateway: path.gatewayName group: path.resourceGroupName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/vpnGateways/{gatewayName}/natRules/{natRuleName}'].put update: x-apievangelist-phrasing: intent: Create or update a VPN gateway NAT rule effect: write questions: - How do I add a NAT rule to handle overlapping address spaces on a VPN gateway? - Can I change an existing gateway NAT rule's mappings? instructions: - text: Create NAT rule {nat_rule} on gateway {gateway} in {group} with properties {properties}. slots: nat_rule: path.natRuleName gateway: path.gatewayName group: path.resourceGroupName properties: requestBody.properties - text: Update gateway NAT rule {nat_rule} on {gateway} ({group}). slots: nat_rule: path.natRuleName gateway: path.gatewayName group: path.resourceGroupName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/vpnGateways/{gatewayName}/natRules/{natRuleName}'].delete update: x-apievangelist-phrasing: intent: Delete a VPN gateway NAT rule effect: destructive questions: - Can I remove a NAT rule from a VPN gateway? - What happens to translated traffic when a gateway NAT rule is deleted? instructions: - text: Delete NAT rule {nat_rule} from gateway {gateway} in {group}. slots: nat_rule: path.natRuleName gateway: path.gatewayName group: path.resourceGroupName - text: Remove gateway NAT rule {nat_rule} on {gateway} ({group}). slots: nat_rule: path.natRuleName gateway: path.gatewayName group: path.resourceGroupName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/vpnGateways/{gatewayName}/natRules'].get update: x-apievangelist-phrasing: intent: List NAT rules on a VPN gateway effect: read questions: - Which NAT rules are configured on a Virtual WAN VPN gateway? - Can I list every NAT rule for one gateway? instructions: - text: List NAT rules on gateway {gateway} in {group}. slots: gateway: path.gatewayName group: path.resourceGroupName - text: Show all address translation rules for {gateway} ({group}). slots: gateway: path.gatewayName group: path.resourceGroupName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/p2svpnGateways/{gatewayName}'].get update: x-apievangelist-phrasing: intent: Get a point-to-site VPN gateway effect: read questions: - How do I see the details of a point-to-site gateway in my hub? - What client address pool does a P2S VPN gateway use? instructions: - text: Get point-to-site gateway {gateway} in resource group {group}. slots: gateway: path.gatewayName group: path.resourceGroupName - text: Show P2S VPN gateway {gateway} configuration ({group}). slots: gateway: path.gatewayName group: path.resourceGroupName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/p2svpnGateways/{gatewayName}'].put update: x-apievangelist-phrasing: intent: Create or update a point-to-site VPN gateway effect: write questions: - How do I deploy a point-to-site VPN gateway for remote users in a virtual hub? - Can I change scale units on an existing P2S gateway? instructions: - text: Create point-to-site gateway {gateway} in {group} with properties {properties}. slots: gateway: path.gatewayName group: path.resourceGroupName properties: requestBody.properties - text: Update P2S VPN gateway {gateway} in resource group {group}. slots: gateway: path.gatewayName group: path.resourceGroupName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/p2svpnGateways/{gatewayName}'].delete update: x-apievangelist-phrasing: intent: Delete a point-to-site VPN gateway effect: destructive questions: - Can I tear down the point-to-site gateway serving remote users? - Do remote users get disconnected when a P2S gateway is deleted? instructions: - text: Delete point-to-site gateway {gateway} in resource group {group}. slots: gateway: path.gatewayName group: path.resourceGroupName - text: Remove P2S VPN gateway {gateway} from {group}. slots: gateway: path.gatewayName group: path.resourceGroupName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/p2svpnGateways'].get update: x-apievangelist-phrasing: intent: List point-to-site gateways in a resource group effect: read questions: - Which remote-user (P2S) gateways sit in one resource group? - Can I list P2S gateways for a single resource group? instructions: - text: List point-to-site gateways in resource group {group}. slots: group: path.resourceGroupName - text: Show every P2S VPN gateway inside {group}. slots: group: path.resourceGroupName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.Network/p2svpnGateways'].get update: x-apievangelist-phrasing: intent: List point-to-site gateways in a subscription effect: read questions: - Which point-to-site VPN gateways exist across my subscription? - How many P2S gateways do I run subscription-wide? instructions: - text: List all point-to-site VPN gateways in my subscription. - text: Show every P2S gateway across the subscription. method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualWans/{virtualWANName}/vpnServerConfigurations'].post update: x-apievangelist-phrasing: intent: List VPN server configs tied to a Virtual WAN effect: read questions: - Which VPN server configurations are associated with my Virtual WAN? - Can I see the P2S server configs a particular WAN uses? instructions: - text: List VPN server configurations associated with Virtual WAN {wan} in {group}. slots: wan: path.virtualWANName group: path.resourceGroupName - text: Show the VpnServerConfigurations linked to WAN {wan} ({group}). slots: wan: path.virtualWANName group: path.resourceGroupName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualWans/{virtualWANName}/GenerateVpnProfile'].post update: x-apievangelist-phrasing: intent: Generate a P2S VPN client profile effect: write questions: - How do I generate a VPN client profile for point-to-site users on Virtual WAN? - Can I choose the authentication method when generating a P2S VPN profile? instructions: - text: Generate a VPN profile for WAN {wan} in {group} using server configuration {config_id}. slots: wan: path.virtualWANName group: path.resourceGroupName config_id: requestBody.vpnServerConfigurationResourceId - text: Create a P2S client profile for WAN {wan} ({group}) with authentication {auth}. slots: wan: path.virtualWANName group: path.resourceGroupName auth: requestBody.authenticationMethod method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualHubs/{virtualHubName}/routeTables/{routeTableName}'].get update: x-apievangelist-phrasing: intent: Get a V2 hub route table effect: read questions: - How do I inspect a VirtualHubRouteTableV2 on my hub? - What routes and attached connections does a V2 hub route table hold? instructions: - text: Get V2 route table {route_table} on hub {hub} in {group}. slots: route_table: path.routeTableName hub: path.virtualHubName group: path.resourceGroupName - text: Show VirtualHubRouteTableV2 {route_table} for hub {hub} ({group}). slots: route_table: path.routeTableName hub: path.virtualHubName group: path.resourceGroupName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualHubs/{virtualHubName}/routeTables/{routeTableName}'].put update: x-apievangelist-phrasing: intent: Create or update a V2 hub route table effect: write questions: - How do I create a VirtualHubRouteTableV2 on a virtual hub? - Can I edit routes on an existing V2 hub route table? instructions: - text: Create V2 route table {route_table} on hub {hub} in {group} with properties {properties}. slots: route_table: path.routeTableName hub: path.virtualHubName group: path.resourceGroupName properties: requestBody.properties - text: Update VirtualHubRouteTableV2 {route_table} on {hub} ({group}). slots: route_table: path.routeTableName hub: path.virtualHubName group: path.resourceGroupName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualHubs/{virtualHubName}/routeTables/{routeTableName}'].delete update: x-apievangelist-phrasing: intent: Delete a V2 hub route table effect: destructive questions: - Can I delete a VirtualHubRouteTableV2 from a hub? - What happens to routing when a V2 hub route table is removed? instructions: - text: Delete V2 route table {route_table} from hub {hub} in {group}. slots: route_table: path.routeTableName hub: path.virtualHubName group: path.resourceGroupName - text: Remove VirtualHubRouteTableV2 {route_table} on {hub} ({group}). slots: route_table: path.routeTableName hub: path.virtualHubName group: path.resourceGroupName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualHubs/{virtualHubName}/routeTables'].get update: x-apievangelist-phrasing: intent: List V2 hub route tables effect: read questions: - Which VirtualHubRouteTableV2 resources exist on a hub? - Can I list every V2 route table for one virtual hub? instructions: - text: List V2 route tables on hub {hub} in {group}. slots: hub: path.virtualHubName group: path.resourceGroupName - text: Show all VirtualHubRouteTableV2 entries for {hub} ({group}). slots: hub: path.virtualHubName group: path.resourceGroupName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/networkVirtualAppliances/{networkVirtualApplianceName}/networkVirtualApplianceConnections/{connectionName}'].get update: x-apievangelist-phrasing: intent: Get an NVA connection effect: read questions: - How do I check one connection on a network virtual appliance? - What routing does a specific NVA connection use? instructions: - text: Get NVA connection {connection} on appliance {nva} in {group}. slots: connection: path.connectionName nva: path.networkVirtualApplianceName group: path.resourceGroupName - text: Show network virtual appliance connection {connection} for {nva} ({group}). slots: connection: path.connectionName nva: path.networkVirtualApplianceName group: path.resourceGroupName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/networkVirtualAppliances/{networkVirtualApplianceName}/networkVirtualApplianceConnections/{connectionName}'].put update: x-apievangelist-phrasing: intent: Create or update an NVA connection effect: write questions: - How do I create a connection to a network virtual appliance in my hub? - Can I update routing on an existing NVA connection? instructions: - text: Create NVA connection {connection} on appliance {nva} in {group} with properties {properties}. slots: connection: path.connectionName nva: path.networkVirtualApplianceName group: path.resourceGroupName properties: requestBody.properties - text: Update network virtual appliance connection {connection} for {nva} ({group}). slots: connection: path.connectionName nva: path.networkVirtualApplianceName group: path.resourceGroupName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/networkVirtualAppliances/{networkVirtualApplianceName}/networkVirtualApplianceConnections/{connectionName}'].delete update: x-apievangelist-phrasing: intent: Delete an NVA connection effect: destructive questions: - Can I remove a connection from a network virtual appliance? - What traffic is affected when an NVA connection is deleted? instructions: - text: Delete NVA connection {connection} from appliance {nva} in {group}. slots: connection: path.connectionName nva: path.networkVirtualApplianceName group: path.resourceGroupName - text: Remove network virtual appliance connection {connection} on {nva} ({group}). slots: connection: path.connectionName nva: path.networkVirtualApplianceName group: path.resourceGroupName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/networkVirtualAppliances/{networkVirtualApplianceName}/networkVirtualApplianceConnections'].get update: x-apievangelist-phrasing: intent: List connections of an NVA effect: read questions: - Which connections exist under a network virtual appliance? - Can I list every NVA connection for one appliance? instructions: - text: List connections of network virtual appliance {nva} in {group}. slots: nva: path.networkVirtualApplianceName group: path.resourceGroupName - text: Show all NVA connections for appliance {nva} ({group}). slots: nva: path.networkVirtualApplianceName group: path.resourceGroupName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualHubs/{virtualHubName}/bgpConnections/{connectionName}'].get update: x-apievangelist-phrasing: intent: Get a hub BGP connection effect: read questions: - How do I inspect a BGP peering connection on a virtual hub? - What peer ASN and IP does a hub BGP connection use? instructions: - text: Get BGP connection {connection} on hub {hub} in {group}. slots: connection: path.connectionName hub: path.virtualHubName group: path.resourceGroupName - text: Show hub BGP peering {connection} for {hub} ({group}). slots: connection: path.connectionName hub: path.virtualHubName group: path.resourceGroupName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualHubs/{virtualHubName}/bgpConnections/{connectionName}'].put update: x-apievangelist-phrasing: intent: Create or update a hub BGP connection effect: write questions: - How do I peer a virtual hub with an NVA over BGP? - Can I change the peer ASN of an existing hub BGP connection? instructions: - text: Create BGP connection {connection} on hub {hub} in {group} with properties {properties}. slots: connection: path.connectionName hub: path.virtualHubName group: path.resourceGroupName properties: requestBody.properties - text: Update hub BGP peering {connection} on {hub} ({group}). slots: connection: path.connectionName hub: path.virtualHubName group: path.resourceGroupName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualHubs/{virtualHubName}/bgpConnections/{connectionName}'].delete update: x-apievangelist-phrasing: intent: Delete a hub BGP connection effect: destructive questions: - Can I remove a BGP peering from a virtual hub? - What routes stop being exchanged when a hub BGP connection is deleted? instructions: - text: Delete BGP connection {connection} from hub {hub} in {group}. slots: connection: path.connectionName hub: path.virtualHubName group: path.resourceGroupName - text: Remove hub BGP peering {connection} on {hub} ({group}). slots: connection: path.connectionName hub: path.virtualHubName group: path.resourceGroupName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualHubs/{virtualHubName}/bgpConnections'].get update: x-apievangelist-phrasing: intent: List BGP connections on a virtual hub effect: read questions: - Which BGP peerings are configured on a virtual hub? - Can I list every BGP connection for one hub? instructions: - text: List BGP connections on hub {hub} in {group}. slots: hub: path.virtualHubName group: path.resourceGroupName - text: Show all BGP peers of virtual hub {hub} ({group}). slots: hub: path.virtualHubName group: path.resourceGroupName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualHubs/{hubName}/bgpConnections/{connectionName}/learnedRoutes'].post update: x-apievangelist-phrasing: intent: List routes learned by a hub BGP connection effect: read questions: - What routes has my hub learned from a BGP peer? - Can I verify which prefixes a hub BGP connection received? instructions: - text: List routes learned by BGP connection {connection} on hub {hub_name} in {group}. slots: connection: path.connectionName hub_name: path.hubName group: path.resourceGroupName - text: Show prefixes received from peer {connection} on {hub_name} ({group}). slots: connection: path.connectionName hub_name: path.hubName group: path.resourceGroupName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualHubs/{hubName}/bgpConnections/{connectionName}/advertisedRoutes'].post update: x-apievangelist-phrasing: intent: List routes advertised to a BGP peer effect: read questions: - Which routes is my virtual hub advertising to a BGP peer? - Can I check what prefixes a hub sends over one BGP connection? instructions: - text: List routes advertised over BGP connection {connection} on hub {hub_name} in {group}. slots: connection: path.connectionName hub_name: path.hubName group: path.resourceGroupName - text: Show prefixes the hub {hub_name} is sending to peer {connection} ({group}). slots: connection: path.connectionName hub_name: path.hubName group: path.resourceGroupName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualHubs/{virtualHubName}/ipConfigurations/{ipConfigName}'].get update: x-apievangelist-phrasing: intent: Get a virtual hub IP configuration effect: read questions: - How do I look up an IP configuration on a virtual hub? - What subnet and private IP does a hub IP configuration use? instructions: - text: Get IP configuration {ip_config} on hub {hub} in {group}. slots: ip_config: path.ipConfigName hub: path.virtualHubName group: path.resourceGroupName - text: Show hub IP configuration {ip_config} for {hub} ({group}). slots: ip_config: path.ipConfigName hub: path.virtualHubName group: path.resourceGroupName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualHubs/{virtualHubName}/ipConfigurations/{ipConfigName}'].put update: x-apievangelist-phrasing: intent: Create or update a virtual hub IP configuration effect: write questions: - How do I add an IP configuration to a virtual hub? - Can I change the subnet of an existing hub IP configuration? instructions: - text: Create IP configuration {ip_config} on hub {hub} in {group} with properties {properties}. slots: ip_config: path.ipConfigName hub: path.virtualHubName group: path.resourceGroupName properties: requestBody.properties - text: Update hub IP configuration {ip_config} on {hub} ({group}). slots: ip_config: path.ipConfigName hub: path.virtualHubName group: path.resourceGroupName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualHubs/{virtualHubName}/ipConfigurations/{ipConfigName}'].delete update: x-apievangelist-phrasing: intent: Delete a virtual hub IP configuration effect: destructive questions: - Can I remove an IP configuration from a virtual hub? - What breaks when a hub IP configuration is deleted? instructions: - text: Delete IP configuration {ip_config} from hub {hub} in {group}. slots: ip_config: path.ipConfigName hub: path.virtualHubName group: path.resourceGroupName - text: Remove hub IP configuration {ip_config} on {hub} ({group}). slots: ip_config: path.ipConfigName hub: path.virtualHubName group: path.resourceGroupName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualHubs/{virtualHubName}/ipConfigurations'].get update: x-apievangelist-phrasing: intent: List IP configurations of a virtual hub effect: read questions: - Which IP configurations does a virtual hub have? - Can I list every hub IP configuration at once? instructions: - text: List IP configurations on hub {hub} in {group}. slots: hub: path.virtualHubName group: path.resourceGroupName - text: Show all IP configs attached to virtual hub {hub} ({group}). slots: hub: path.virtualHubName group: path.resourceGroupName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualHubs/{virtualHubName}/hubRouteTables/{routeTableName}'].get update: x-apievangelist-phrasing: intent: Get a hub route table effect: read questions: - How do I view a route table on my virtual hub? - What static routes and labels does a hub route table have? instructions: - text: Fetch custom labeled route table {route_table} from virtual hub {hub} ({group}). slots: route_table: path.routeTableName hub: path.virtualHubName group: path.resourceGroupName - text: Show routes and labels of hub route table {route_table} for {hub} ({group}). slots: route_table: path.routeTableName hub: path.virtualHubName group: path.resourceGroupName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualHubs/{virtualHubName}/hubRouteTables/{routeTableName}'].put update: x-apievangelist-phrasing: intent: Create or update a hub route table effect: write questions: - How do I create a custom route table on a virtual hub? - Can I add static routes or labels to an existing hub route table? instructions: - text: Add a custom labeled route table {route_table} with static routes {properties} to {hub} ({group}). slots: route_table: path.routeTableName hub: path.virtualHubName group: path.resourceGroupName properties: requestBody.properties - text: Update the labeled hub route table {route_table} on {hub} ({group}). slots: route_table: path.routeTableName hub: path.virtualHubName group: path.resourceGroupName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualHubs/{virtualHubName}/hubRouteTables/{routeTableName}'].delete update: x-apievangelist-phrasing: intent: Delete a hub route table effect: destructive questions: - Can I delete a custom route table from a virtual hub? - What happens to associated connections when a hub route table is deleted? instructions: - text: Drop the custom route table {route_table} and its labels from {hub} ({group}). slots: route_table: path.routeTableName hub: path.virtualHubName group: path.resourceGroupName - text: Remove the labeled hub route table {route_table} on {hub} ({group}). slots: route_table: path.routeTableName hub: path.virtualHubName group: path.resourceGroupName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualHubs/{virtualHubName}/hubRouteTables'].get update: x-apievangelist-phrasing: intent: List hub route tables effect: read questions: - Which route tables are defined on a virtual hub? - Can I list every custom hub route table with its labels? instructions: - text: Enumerate custom route tables with labels on {hub} ({group}). slots: hub: path.virtualHubName group: path.resourceGroupName - text: Show every labeled route table for virtual hub {hub} ({group}). slots: hub: path.virtualHubName group: path.resourceGroupName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualHubs/{virtualHubName}/effectiveRoutes'].post update: x-apievangelist-phrasing: intent: Get effective routes of a virtual hub effect: read questions: - What are the effective routes actually in use on my virtual hub? - Can I see effective routes for a specific connection or resource on a hub? instructions: - text: Get effective routes for virtual hub {hub} in {group}. slots: hub: path.virtualHubName group: path.resourceGroupName - text: Show effective hub routes for resource {resource_id} on {hub} ({group}). slots: resource_id: requestBody.resourceId hub: path.virtualHubName group: path.resourceGroupName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualHubs/{virtualHubName}/inboundRoutes'].post update: x-apievangelist-phrasing: intent: Get inbound routes on a hub connection effect: read questions: - Which routes come into my virtual hub over a particular connection? - Can I check inbound routes by connection type on a hub? instructions: - text: Get inbound routes on hub {hub} in {group} for connection {connection_uri}. slots: hub: path.virtualHubName group: path.resourceGroupName connection_uri: requestBody.resourceUri - text: Show routes arriving at {hub} ({group}) over {connection_uri} of type {connection_type}. slots: hub: path.virtualHubName group: path.resourceGroupName connection_uri: requestBody.resourceUri connection_type: requestBody.connectionType method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualHubs/{virtualHubName}/outboundRoutes'].post update: x-apievangelist-phrasing: intent: Get outbound routes on a hub connection effect: read questions: - Which routes does my virtual hub send out over a particular connection? - Can I verify outbound route propagation for one hub connection? instructions: - text: Get outbound routes on hub {hub} in {group} for connection {connection_uri}. slots: hub: path.virtualHubName group: path.resourceGroupName connection_uri: requestBody.resourceUri - text: Show routes leaving {hub} ({group}) toward {connection_uri} of type {connection_type}. slots: hub: path.virtualHubName group: path.resourceGroupName connection_uri: requestBody.resourceUri connection_type: requestBody.connectionType method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualHubs/{virtualHubName}/routingIntent/{routingIntentName}'].get update: x-apievangelist-phrasing: intent: Get a hub routing intent effect: read questions: - How do I see the routing intent configured on a secured virtual hub? - What routing policies does a hub's RoutingIntent contain? instructions: - text: Get routing intent {intent} on hub {hub} in {group}. slots: intent: path.routingIntentName hub: path.virtualHubName group: path.resourceGroupName - text: Show the RoutingIntent policies {intent} for hub {hub} ({group}). slots: intent: path.routingIntentName hub: path.virtualHubName group: path.resourceGroupName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualHubs/{virtualHubName}/routingIntent/{routingIntentName}'].put update: x-apievangelist-phrasing: intent: Create or update a hub routing intent effect: write questions: - How do I send internet and private traffic through a firewall with routing intent? - Can I change routing policies on an existing RoutingIntent? instructions: - text: Create routing intent {intent} on hub {hub} in {group} with properties {properties}. slots: intent: path.routingIntentName hub: path.virtualHubName group: path.resourceGroupName properties: requestBody.properties - text: Update RoutingIntent {intent} for hub {hub} ({group}). slots: intent: path.routingIntentName hub: path.virtualHubName group: path.resourceGroupName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualHubs/{virtualHubName}/routingIntent/{routingIntentName}'].delete update: x-apievangelist-phrasing: intent: Delete a hub routing intent effect: destructive questions: - Can I remove routing intent from a virtual hub? - What happens to firewall-steered traffic when a RoutingIntent is deleted? instructions: - text: Delete routing intent {intent} from hub {hub} in {group}. slots: intent: path.routingIntentName hub: path.virtualHubName group: path.resourceGroupName - text: Remove RoutingIntent {intent} on {hub} ({group}). slots: intent: path.routingIntentName hub: path.virtualHubName group: path.resourceGroupName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualHubs/{virtualHubName}/routingIntent'].get update: x-apievangelist-phrasing: intent: List routing intents on a virtual hub effect: read questions: - Which routing intent resources exist on a hub? - Can I list every RoutingIntent child of one virtual hub? instructions: - text: List routing intents on hub {hub} in {group}. slots: hub: path.virtualHubName group: path.resourceGroupName - text: Show all RoutingIntent resources under {hub} ({group}). slots: hub: path.virtualHubName group: path.resourceGroupName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{providerName}/{resourceCollectionName}/{resourceName}/providers/Microsoft.WorkloadMonitor/monitors'].get update: x-apievangelist-phrasing: intent: List workload health monitors for a resource effect: read questions: - Which health monitors does Workload Monitor run against one of my resources? - Can I filter or expand the health monitor list for a resource? instructions: - text: List health monitors for {provider}/{collection}/{resource} in group {group}, subscription {subscription}. slots: provider: path.providerName collection: path.resourceCollectionName resource: path.resourceName group: path.resourceGroupName subscription: path.subscriptionId - text: Show {resource} health monitors matching {filter} ({provider}, {collection}, {group}, {subscription}). slots: resource: path.resourceName filter: query.$filter provider: path.providerName collection: path.resourceCollectionName group: path.resourceGroupName subscription: path.subscriptionId method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{providerName}/{resourceCollectionName}/{resourceName}/providers/Microsoft.WorkloadMonitor/monitors/{monitorId}'].get update: x-apievangelist-phrasing: intent: Get a workload health monitor effect: read questions: - How do I check the current state of one health monitor on a resource? - What does a single Workload Monitor health monitor report? instructions: - text: Get health monitor {monitor} on {provider}/{collection}/{resource} in {group}, subscription {subscription}. slots: monitor: path.monitorId provider: path.providerName collection: path.resourceCollectionName resource: path.resourceName group: path.resourceGroupName subscription: path.subscriptionId - text: Show monitor {monitor} with {expand} expanded for {resource} ({provider}, {collection}, {group}, {subscription}). slots: monitor: path.monitorId expand: query.$expand resource: path.resourceName provider: path.providerName collection: path.resourceCollectionName group: path.resourceGroupName subscription: path.subscriptionId method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{providerName}/{resourceCollectionName}/{resourceName}/providers/Microsoft.WorkloadMonitor/monitors/{monitorId}/history'].get update: x-apievangelist-phrasing: intent: List state history of a health monitor effect: read questions: - How has a health monitor's state changed over time? - Can I limit monitor state history to a start and end timestamp? instructions: - text: List state changes of monitor {monitor} on {provider}/{collection}/{resource} in {group}, subscription {subscription}. slots: monitor: path.monitorId provider: path.providerName collection: path.resourceCollectionName resource: path.resourceName group: path.resourceGroupName subscription: path.subscriptionId - text: Show monitor {monitor} history from {start} to {end} for {resource} ({provider}, {collection}, {group}, {subscription}). slots: monitor: path.monitorId start: query.startTimestampUtc end: query.endTimestampUtc resource: path.resourceName provider: path.providerName collection: path.resourceCollectionName group: path.resourceGroupName subscription: path.subscriptionId method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{providerName}/{resourceCollectionName}/{resourceName}/providers/Microsoft.WorkloadMonitor/monitors/{monitorId}/history/{timestampUnix}'].get update: x-apievangelist-phrasing: intent: Get one health monitor state change effect: read questions: - What exactly changed at a specific point in a health monitor's history? - Can I fetch a single monitor state change by its timestamp? instructions: - text: Get state change at {timestamp} for monitor {monitor} on {provider}/{collection}/{resource} in {group}, subscription {subscription}. slots: timestamp: path.timestampUnix monitor: path.monitorId provider: path.providerName collection: path.resourceCollectionName resource: path.resourceName group: path.resourceGroupName subscription: path.subscriptionId - text: Show the monitor {monitor} transition recorded at {timestamp} for {resource} ({provider}, {collection}, {group}, {subscription}). slots: monitor: path.monitorId timestamp: path.timestampUnix resource: path.resourceName provider: path.providerName collection: path.resourceCollectionName group: path.resourceGroupName subscription: path.subscriptionId method: generated generated: '2026-09-26'