# 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 Service Fabric Client Property Management…
  version: 1.0.0
extends: openapi/microsoft-azure-property-management-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: 9
- target: $.paths['/Names/$/Create'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a Service Fabric name
      effect: write
      questions:
      - How do I create a new name in the Service Fabric naming service?
      - Do I need to create a Service Fabric name before storing properties under it?
      instructions:
      - text: Create the Service Fabric name {NameDescription}.
        slots:
          NameDescription: body.NameDescription
      - text: Register Service Fabric name {NameDescription} with a timeout of {timeout} seconds.
        slots:
          NameDescription: body.NameDescription
          timeout: query.timeout
      method: generated
      generated: '2026-09-26'
- target: $.paths['/Names/{nameId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Check whether a Service Fabric name exists
      effect: read
      questions:
      - How can I tell if a Service Fabric name already exists?
      - Is there a quick existence check for a name in the naming service?
      instructions:
      - text: Check whether Service Fabric name {nameId} exists.
        slots:
          nameId: path.nameId
      - text: Tell me if the name {nameId} is registered in Service Fabric.
        slots:
          nameId: path.nameId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/Names/{nameId}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a Service Fabric name
      effect: destructive
      questions:
      - How do I delete a Service Fabric name?
      - Why would deleting a Service Fabric name fail when it still has properties?
      instructions:
      - text: Delete Service Fabric name {nameId}.
        slots:
          nameId: path.nameId
      - text: Remove the name {nameId} from the Service Fabric naming service.
        slots:
          nameId: path.nameId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/Names/{nameId}/$/GetSubNames'].get
  update:
    x-apievangelist-phrasing:
      intent: List sub-names under a Service Fabric name
      effect: read
      questions:
      - How do I enumerate all the names nested under a Service Fabric name?
      - Can I list child names recursively and page with a continuation token?
      instructions:
      - text: List the sub-names under Service Fabric name {nameId}.
        slots:
          nameId: path.nameId
      - text: List all sub-names under {nameId} recursively set to {Recursive}.
        slots:
          nameId: path.nameId
          Recursive: query.Recursive
      - text: Get the next page of sub-names under {nameId} using token {ContinuationToken}.
        slots:
          nameId: path.nameId
          ContinuationToken: query.ContinuationToken
      method: generated
      generated: '2026-09-26'
- target: $.paths['/Names/{nameId}/$/GetProperties'].get
  update:
    x-apievangelist-phrasing:
      intent: List properties under a Service Fabric name
      effect: read
      questions:
      - What custom properties are stored under a Service Fabric name?
      - Can I include the property values, not just metadata, when listing them?
      instructions:
      - text: List the properties stored under Service Fabric name {nameId}.
        slots:
          nameId: path.nameId
      - text: List properties under {nameId} with values included set to {IncludeValues}.
        slots:
          nameId: path.nameId
          IncludeValues: query.IncludeValues
      method: generated
      generated: '2026-09-26'
- target: $.paths['/Names/{nameId}/$/GetProperty'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a Service Fabric property
      effect: read
      questions:
      - How do I read the value of one named property under a Service Fabric name?
      - Does fetching a single Service Fabric property return its metadata too?
      instructions:
      - text: Get property {PropertyName} under Service Fabric name {nameId}.
        slots:
          nameId: path.nameId
          PropertyName: query.PropertyName
      - text: Read the value and metadata of {PropertyName} on {nameId}.
        slots:
          nameId: path.nameId
          PropertyName: query.PropertyName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/Names/{nameId}/$/GetProperty'].put
  update:
    x-apievangelist-phrasing:
      intent: Create or update a Service Fabric property
      effect: write
      questions:
      - How do I store a custom value as a property under a Service Fabric name?
      - Can I overwrite an existing Service Fabric property's value?
      instructions:
      - text: Put property {PropertyDescription} under Service Fabric name {nameId}.
        slots:
          nameId: path.nameId
          PropertyDescription: body.PropertyDescription
      - text: Set the property described by {PropertyDescription} on name {nameId}.
        slots:
          nameId: path.nameId
          PropertyDescription: body.PropertyDescription
      method: generated
      generated: '2026-09-26'
- target: $.paths['/Names/{nameId}/$/GetProperty'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a Service Fabric property
      effect: destructive
      questions:
      - How do I delete a single property from a Service Fabric name?
      - Can I remove a property without deleting the name it belongs to?
      instructions:
      - text: Delete property {PropertyName} under Service Fabric name {nameId}.
        slots:
          nameId: path.nameId
          PropertyName: query.PropertyName
      - text: Remove {PropertyName} from name {nameId}.
        slots:
          nameId: path.nameId
          PropertyName: query.PropertyName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/Names/{nameId}/$/GetProperties/$/SubmitBatch'].post
  update:
    x-apievangelist-phrasing:
      intent: Submit an atomic batch of property operations
      effect: write
      questions:
      - Can I apply several property changes to a Service Fabric name all at once?
      - Is a Service Fabric property batch all-or-nothing?
      instructions:
      - text: Submit the property batch {PropertyBatchDescriptionList} against name {nameId}.
        slots:
          nameId: path.nameId
          PropertyBatchDescriptionList: body.PropertyBatchDescriptionList
      - text: 'Apply these property operations atomically to {nameId}: {PropertyBatchDescriptionList}.'
        slots:
          nameId: path.nameId
          PropertyBatchDescriptionList: body.PropertyBatchDescriptionList
      method: generated
      generated: '2026-09-26'