# 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 DataProtectionBackupClient Resource Guards…
  version: 1.0.0
extends: openapi/microsoft-azure-resourceguards-api-openapi.yml
actions:
- target: $.info
  update:
    x-apievangelist-phrasing:
      method: generated
      generated: '2026-09-26'
      generator: build-phrasing.py
      label: Generated by API Evangelist
      operations: 18
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.DataProtection/resourceGuards'].get
  update:
    x-apievangelist-phrasing:
      intent: List resource guards across a subscription
      effect: read
      questions:
      - Which backup resource guards exist anywhere in my Azure subscription?
      - Can I see all my Data Protection resource guards without choosing a resource group?
      instructions:
      - text: List every resource guard in my subscription.
      - text: Show all Data Protection resource guards I have across my subscription.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataProtection/resourceGuards'].get
  update:
    x-apievangelist-phrasing:
      intent: List resource guards in a resource group
      effect: read
      questions:
      - What resource guards are deployed in one particular resource group?
      - Can I limit the resource guard list to a single resource group?
      instructions:
      - text: List the resource guards in the resource group I'm working in.
      - text: Show which resource guards are scoped to my current resource group, not the whole subscription.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataProtection/resourceGuards/{resourceGuardsName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a resource guard
      effect: read
      questions:
      - How do I look up the configuration of one resource guard?
      - Which critical operations does a given resource guard protect?
      instructions:
      - text: Get resource guard {resourceGuardsName} and its protected operations.
        slots:
          resourceGuardsName: path.resourceGuardsName
      - text: Show me the details of resource guard {resourceGuardsName}.
        slots:
          resourceGuardsName: path.resourceGuardsName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataProtection/resourceGuards/{resourceGuardsName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create or update a resource guard
      effect: write
      questions:
      - How do I create a resource guard to protect critical backup operations?
      - Can I replace a resource guard's whole definition, including its location and properties?
      instructions:
      - text: Create resource guard {resourceGuardsName}, located in {location}.
        slots:
          resourceGuardsName: path.resourceGuardsName
          location: requestBody.location
      - text: Create or overwrite resource guard {resourceGuardsName} with properties {properties}.
        slots:
          resourceGuardsName: path.resourceGuardsName
          properties: requestBody.properties
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataProtection/resourceGuards/{resourceGuardsName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a resource guard
      effect: destructive
      questions:
      - How do I remove a resource guard I no longer need?
      - Can I delete a resource guard from its resource group?
      instructions:
      - text: Delete resource guard {resourceGuardsName}.
        slots:
          resourceGuardsName: path.resourceGuardsName
      - text: Remove resource guard {resourceGuardsName} entirely.
        slots:
          resourceGuardsName: path.resourceGuardsName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataProtection/resourceGuards/{resourceGuardsName}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update tags on a resource guard
      effect: write
      questions:
      - Can I change only the tags on an existing resource guard?
      - What can I patch on a resource guard without recreating it?
      instructions:
      - text: Set the tags on resource guard {resourceGuardsName} to {tags}.
        slots:
          resourceGuardsName: path.resourceGuardsName
          tags: requestBody.tags
      - text: Patch tags {tags} onto resource guard {resourceGuardsName}.
        slots:
          tags: requestBody.tags
          resourceGuardsName: path.resourceGuardsName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataProtection/resourceGuards/{resourceGuardsName}/disableSoftDeleteRequests'].get
  update:
    x-apievangelist-phrasing:
      intent: List disable-soft-delete requests on a resource guard
      effect: read
      questions:
      - Which requests to disable soft delete are guarded by my resource guard?
      - Can I see all the disable soft delete operation requests a resource guard protects?
      instructions:
      - text: List the disable soft delete requests for resource guard {resourceGuardsName}.
        slots:
          resourceGuardsName: path.resourceGuardsName
      - text: Show all soft-delete-disable request objects under guard {resourceGuardsName}.
        slots:
          resourceGuardsName: path.resourceGuardsName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataProtection/resourceGuards/{resourceGuardsName}/deleteResourceGuardProxyRequests'].get
  update:
    x-apievangelist-phrasing:
      intent: List delete-guard-proxy requests on a resource guard
      effect: read
      questions:
      - Which requests to delete a resource guard proxy are protected by this guard?
      - Can I list every resource guard proxy deletion request object?
      instructions:
      - text: List the delete resource guard proxy requests for guard {resourceGuardsName}.
        slots:
          resourceGuardsName: path.resourceGuardsName
      - text: Show all proxy-deletion request objects protected by guard {resourceGuardsName}.
        slots:
          resourceGuardsName: path.resourceGuardsName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataProtection/resourceGuards/{resourceGuardsName}/getBackupSecurityPINRequests'].get
  update:
    x-apievangelist-phrasing:
      intent: List backup security PIN requests on a resource guard
      effect: read
      questions:
      - Which backup security PIN requests does my resource guard cover?
      - Can I list every get-backup-security-PIN request object for a guard?
      instructions:
      - text: List the backup security PIN requests for resource guard {resourceGuardsName}.
        slots:
          resourceGuardsName: path.resourceGuardsName
      - text: Show all security PIN request objects guarded by {resourceGuardsName}.
        slots:
          resourceGuardsName: path.resourceGuardsName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataProtection/resourceGuards/{resourceGuardsName}/deleteProtectedItemRequests'].get
  update:
    x-apievangelist-phrasing:
      intent: List delete-protected-item requests on a resource guard
      effect: read
      questions:
      - Which requests to delete a protected backup item does my resource guard govern?
      - Can I list all the protected item deletion request objects for a guard?
      instructions:
      - text: List the delete protected item requests for resource guard {resourceGuardsName}.
        slots:
          resourceGuardsName: path.resourceGuardsName
      - text: Show all protected-item deletion request objects under guard {resourceGuardsName}.
        slots:
          resourceGuardsName: path.resourceGuardsName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataProtection/resourceGuards/{resourceGuardsName}/updateProtectionPolicyRequests'].get
  update:
    x-apievangelist-phrasing:
      intent: List update-protection-policy requests on a resource guard
      effect: read
      questions:
      - Which backup policy change requests are protected by my resource guard?
      - Can I list every update protection policy request object for a guard?
      instructions:
      - text: List the update protection policy requests for resource guard {resourceGuardsName}.
        slots:
          resourceGuardsName: path.resourceGuardsName
      - text: Show all policy-update request objects guarded by {resourceGuardsName}.
        slots:
          resourceGuardsName: path.resourceGuardsName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataProtection/resourceGuards/{resourceGuardsName}/updateProtectedItemRequests'].get
  update:
    x-apievangelist-phrasing:
      intent: List update-protected-item requests on a resource guard
      effect: read
      questions:
      - Which requests to modify a protected backup item does my guard cover?
      - Can I list every update protected item request object for a resource guard?
      instructions:
      - text: List the update protected item requests for resource guard {resourceGuardsName}.
        slots:
          resourceGuardsName: path.resourceGuardsName
      - text: Show all protected-item modification request objects under guard {resourceGuardsName}.
        slots:
          resourceGuardsName: path.resourceGuardsName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataProtection/resourceGuards/{resourceGuardsName}/disableSoftDeleteRequests/{requestName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one disable-soft-delete request on a resource guard
      effect: read
      questions:
      - How do I look up a single named disable soft delete request on a resource guard?
      - What does one specific soft-delete-disable request object contain?
      instructions:
      - text: Get disable soft delete request {requestName} on resource guard {resourceGuardsName}.
        slots:
          requestName: path.requestName
          resourceGuardsName: path.resourceGuardsName
      - text: Show the soft-delete-disable request named {requestName} for guard {resourceGuardsName}.
        slots:
          requestName: path.requestName
          resourceGuardsName: path.resourceGuardsName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataProtection/resourceGuards/{resourceGuardsName}/deleteResourceGuardProxyRequests/{requestName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one delete-guard-proxy request on a resource guard
      effect: read
      questions:
      - How can I fetch a single named resource guard proxy deletion request?
      - What is inside one specific delete-guard-proxy request object?
      instructions:
      - text: Get delete resource guard proxy request {requestName} on guard {resourceGuardsName}.
        slots:
          requestName: path.requestName
          resourceGuardsName: path.resourceGuardsName
      - text: Show the proxy-deletion request named {requestName} for guard {resourceGuardsName}.
        slots:
          requestName: path.requestName
          resourceGuardsName: path.resourceGuardsName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataProtection/resourceGuards/{resourceGuardsName}/getBackupSecurityPINRequests/{requestName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one backup security PIN request on a resource guard
      effect: read
      questions:
      - Can I retrieve a single named backup security PIN request from a guard?
      - What details does one specific security PIN request object hold?
      instructions:
      - text: Get backup security PIN request {requestName} on resource guard {resourceGuardsName}.
        slots:
          requestName: path.requestName
          resourceGuardsName: path.resourceGuardsName
      - text: Show the security PIN request named {requestName} for guard {resourceGuardsName}.
        slots:
          requestName: path.requestName
          resourceGuardsName: path.resourceGuardsName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataProtection/resourceGuards/{resourceGuardsName}/deleteProtectedItemRequests/{requestName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one delete-protected-item request on a resource guard
      effect: read
      questions:
      - Can I look up one named protected item deletion request on a guard?
      - What does a single delete-protected-item request object show?
      instructions:
      - text: Get delete protected item request {requestName} on resource guard {resourceGuardsName}.
        slots:
          requestName: path.requestName
          resourceGuardsName: path.resourceGuardsName
      - text: Show the protected-item deletion request named {requestName} for guard {resourceGuardsName}.
        slots:
          requestName: path.requestName
          resourceGuardsName: path.resourceGuardsName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataProtection/resourceGuards/{resourceGuardsName}/updateProtectionPolicyRequests/{requestName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one update-protection-policy request on a guard
      effect: read
      questions:
      - Can I fetch a single named backup policy change request from a resource guard?
      - What does one specific update protection policy request object contain?
      instructions:
      - text: Get update protection policy request {requestName} on resource guard {resourceGuardsName}.
        slots:
          requestName: path.requestName
          resourceGuardsName: path.resourceGuardsName
      - text: Show the policy-update request named {requestName} for guard {resourceGuardsName}.
        slots:
          requestName: path.requestName
          resourceGuardsName: path.resourceGuardsName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataProtection/resourceGuards/{resourceGuardsName}/updateProtectedItemRequests/{requestName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one update-protected-item request on a resource guard
      effect: read
      questions:
      - Can I look up one named request to modify a protected item on a guard?
      - What details are in a single update protected item request object?
      instructions:
      - text: Get update protected item request {requestName} on resource guard {resourceGuardsName}.
        slots:
          requestName: path.requestName
          resourceGuardsName: path.resourceGuardsName
      - text: Show the protected-item modification request named {requestName} for guard {resourceGuardsName}.
        slots:
          requestName: path.requestName
          resourceGuardsName: path.resourceGuardsName
      method: generated
      generated: '2026-09-26'