# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Cohesity REST Network Information Service (NIS) API
  version: 1.0.0
extends: openapi/cohesity-network-information-service-nis-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: 10
- target: $.paths['/nis-netgroups'].get
  update:
    x-apievangelist-phrasing:
      intent: List NIS netgroups
      effect: read
      questions:
      - Which NIS netgroups are configured on my cluster?
      - Can I look up several netgroups by name at once?
      instructions:
      - text: List all NIS netgroups.
      - text: Show the NIS netgroups named {netgroupNames}.
        slots:
          netgroupNames: query.netgroupNames
      method: generated
      generated: '2026-10-01'
- target: $.paths['/nis-netgroups'].post
  update:
    x-apievangelist-phrasing:
      intent: Create an NIS netgroup
      effect: write
      questions:
      - How do I add an NIS netgroup to control NFS access?
      - Can I set root squash when creating a netgroup?
      instructions:
      - text: Create NIS netgroup {name} in domain {domain}.
        slots:
          name: requestBody.name
          domain: requestBody.domain
      - text: Add netgroup {name} on domain {domain} with NFS access {nfsAccess} and squash {nfsSquash}.
        slots:
          name: requestBody.name
          domain: requestBody.domain
          nfsAccess: requestBody.nfsAccess
          nfsSquash: requestBody.nfsSquash
      method: generated
      generated: '2026-10-01'
- target: $.paths['/nis-netgroups/{name}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one NIS netgroup
      effect: read
      questions:
      - What NFS access does a specific netgroup grant?
      - Which domain is a given NIS netgroup in?
      instructions:
      - text: Show NIS netgroup {name}.
        slots:
          name: path.name
      - text: Get the NFS access settings of netgroup {name}.
        slots:
          name: path.name
      method: generated
      generated: '2026-10-01'
- target: $.paths['/nis-netgroups/{name}'].put
  update:
    x-apievangelist-phrasing:
      intent: Update an NIS netgroup
      effect: write
      questions:
      - How do I change the NFS access level of an existing netgroup?
      - Can I move a netgroup to a different NIS domain?
      instructions:
      - text: Update netgroup {name} in domain {domain} to NFS access {nfsAccess}.
        slots:
          name: path.name
          domain: requestBody.domain
          nfsAccess: requestBody.nfsAccess
      - text: Change squash on existing netgroup {name} (domain {domain}) to {nfsSquash}.
        slots:
          name: path.name
          domain: requestBody.domain
          nfsSquash: requestBody.nfsSquash
      method: generated
      generated: '2026-10-01'
- target: $.paths['/nis-netgroups/{name}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete an NIS netgroup
      effect: destructive
      questions:
      - How do I remove an NIS netgroup from the cluster?
      - Do I need the domain as well as the name to delete a netgroup?
      instructions:
      - text: Delete NIS netgroup {name} in domain {domain}.
        slots:
          name: path.name
          domain: requestBody.domain
      - text: Remove netgroup {name}.
        slots:
          name: path.name
      method: generated
      generated: '2026-10-01'
- target: $.paths['/nis-providers'].get
  update:
    x-apievangelist-phrasing:
      intent: List NIS providers
      effect: read
      questions:
      - Which NIS servers is my cluster configured to use?
      - Can I filter NIS providers by domain name?
      instructions:
      - text: List all NIS providers.
      - text: Show NIS providers for domains {domainNames}.
        slots:
          domainNames: query.domainNames
      method: generated
      generated: '2026-10-01'
- target: $.paths['/nis-providers'].post
  update:
    x-apievangelist-phrasing:
      intent: Add an NIS provider
      effect: write
      questions:
      - How do I connect my cluster to an NIS domain?
      - Can I add slave servers alongside the master NIS server?
      instructions:
      - text: Add NIS provider for domain {domain} with master server {masterServerHostname}.
        slots:
          domain: requestBody.domain
          masterServerHostname: requestBody.masterServerHostname
      - text: Register NIS domain {domain} using master {masterServerHostname} and slaves {slaveServers}.
        slots:
          domain: requestBody.domain
          masterServerHostname: requestBody.masterServerHostname
          slaveServers: requestBody.slaveServers
      method: generated
      generated: '2026-10-01'
- target: $.paths['/nis-providers/{domain}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an NIS provider by domain
      effect: read
      questions:
      - Which master server is set for a given NIS domain?
      - What tenants can use a particular NIS provider?
      instructions:
      - text: Show the NIS provider for domain {domain}.
        slots:
          domain: path.domain
      - text: Get master and slave servers of NIS domain {domain}.
        slots:
          domain: path.domain
      method: generated
      generated: '2026-10-01'
- target: $.paths['/nis-providers/{domain}'].put
  update:
    x-apievangelist-phrasing:
      intent: Update an NIS provider
      effect: write
      questions:
      - How do I change the master server for an existing NIS domain?
      - Can I update which tenants an NIS provider is shared with?
      instructions:
      - text: Change NIS domain {domain} to master server {masterServerHostname}.
        slots:
          domain: path.domain
          masterServerHostname: requestBody.masterServerHostname
      - text: Update NIS provider {domain} with master {masterServerHostname} for tenants {tenantIds}.
        slots:
          domain: path.domain
          masterServerHostname: requestBody.masterServerHostname
          tenantIds: requestBody.tenantIds
      method: generated
      generated: '2026-10-01'
- target: $.paths['/nis-providers/{domain}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete an NIS provider
      effect: destructive
      questions:
      - How do I disconnect my cluster from an NIS domain?
      - Can I delete an NIS provider by its domain name?
      instructions:
      - text: Delete the NIS provider for domain {domain}.
        slots:
          domain: path.domain
      - text: Remove NIS domain {domain} from the cluster.
        slots:
          domain: path.domain
      method: generated
      generated: '2026-10-01'