# 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 ProvisioningServiceClient Enrollment Group…
  version: 1.0.0
extends: openapi/microsoft-azure-enrollmentgroup-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: 5
- target: $.paths['/enrollmentGroups/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a device enrollment group
      effect: read
      questions:
      - What attestation and allocation settings does an enrollment group have in Device Provisioning Service?
      - Can I look up one device enrollment group by id?
      instructions:
      - text: Get enrollment group {id}.
        slots:
          id: path.id
      - text: Show the provisioning settings of device enrollment group {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/enrollmentGroups/{id}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create or update a device enrollment group
      effect: write
      questions:
      - How do I register a group of IoT devices that share an X.509 or symmetric key attestation?
      - Can I set which IoT hubs devices from an enrollment group get assigned to?
      instructions:
      - text: Create enrollment group {id} with enrollmentGroupId {enrollmentGroupId} and attestation {attestation}.
        slots:
          id: path.id
          enrollmentGroupId: requestBody.enrollmentGroupId
          attestation: requestBody.attestation
      - text: Update enrollment group {id} to allocate devices using {allocationPolicy}, etag {etag}.
        slots:
          id: path.id
          allocationPolicy: requestBody.allocationPolicy
          etag: header.If-Match
      method: generated
      generated: '2026-09-26'
- target: $.paths['/enrollmentGroups/query'].post
  update:
    x-apievangelist-phrasing:
      intent: Query device enrollment groups
      effect: read
      questions:
      - Can I search my enrollment groups with a query expression?
      - How many enrollment groups can come back per page when querying?
      instructions:
      - text: Query enrollment groups with {query}.
        slots:
          query: requestBody.query
      - text: Find enrollment groups matching {query}, {maxItems} at a time.
        slots:
          query: requestBody.query
          maxItems: header.x-ms-max-item-count
      method: generated
      generated: '2026-09-26'
- target: $.paths['/enrollmentGroups/{id}/attestationmechanism'].post
  update:
    x-apievangelist-phrasing:
      intent: Get an enrollment group's attestation mechanism
      effect: read
      questions:
      - Which certificates or keys does an enrollment group use to attest devices?
      - Can I read just the attestation mechanism of a device enrollment group?
      instructions:
      - text: Get the attestation mechanism for enrollment group {id}.
        slots:
          id: path.id
      - text: Show how devices in enrollment group {id} prove their identity.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/enrollmentGroups'].post
  update:
    x-apievangelist-phrasing:
      intent: Bulk create, update or delete enrollment groups
      effect: write
      questions:
      - Can I create or delete several enrollment groups in one call?
      - What is the maximum number of enrollment groups in a bulk operation?
      instructions:
      - text: Run a {mode} bulk operation on enrollment groups {enrollmentGroups}.
        slots:
          mode: requestBody.mode
          enrollmentGroups: requestBody.enrollmentGroups
      - text: 'Apply {mode} to up to ten enrollment groups at once: {enrollmentGroups}.'
        slots:
          mode: requestBody.mode
          enrollmentGroups: requestBody.enrollmentGroups
      method: generated
      generated: '2026-09-26'