naftiko: 1.0.0-alpha2
info:
  label: Solaris Zones Management API — Zone Manager
  description: 'Solaris Zones Management API — Zone Manager. 9 operations. Lead operation: Solaris Zones List All Zone Management
    Interfaces. Self-contained Naftiko capability covering one Solaris Zones business surface.'
  tags:
  - Solaris Zones
  - Zone Manager
  created: '2026-05-19'
  modified: '2026-05-19'
binds:
- namespace: env
  keys:
    SOLARIS_ZONES_API_KEY: SOLARIS_ZONES_API_KEY
capability:
  consumes:
  - type: http
    namespace: management-zone-manager
    baseUri: https://{host}:{port}/api/com.oracle.solaris.rad.zonemgr/1.6
    description: Solaris Zones Management API — Zone Manager business capability. Self-contained, no shared references.
    resources:
    - name: root
      path: /
      operations:
      - name: listzoneinterfaces
        method: GET
        description: Solaris Zones List All Zone Management Interfaces
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: ZoneManager
      path: /ZoneManager
      operations:
      - name: getzonemanager
        method: GET
        description: Solaris Zones Get Zone Manager Instance
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: ZoneManager-_rad_method-cancelEvacuate
      path: /ZoneManager/_rad_method/cancelEvacuate
      operations:
      - name: cancelevacuation
        method: PUT
        description: Solaris Zones Cancel Zone Evacuation in Progress
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: ZoneManager-_rad_method-create
      path: /ZoneManager/_rad_method/create
      operations:
      - name: createzone
        method: PUT
        description: Solaris Zones Create a New Zone
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: ZoneManager-_rad_method-createConfig
      path: /ZoneManager/_rad_method/createConfig
      operations:
      - name: createephemeralconfig
        method: PUT
        description: Solaris Zones Create Ephemeral Zone Configuration
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: ZoneManager-_rad_method-delete
      path: /ZoneManager/_rad_method/delete
      operations:
      - name: deletezone
        method: PUT
        description: Solaris Zones Delete a Zone
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: ZoneManager-_rad_method-evacuate
      path: /ZoneManager/_rad_method/evacuate
      operations:
      - name: evacuatezones
        method: PUT
        description: Solaris Zones Evacuate Zones to Remote Host
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: ZoneManager-_rad_method-importConfig
      path: /ZoneManager/_rad_method/importConfig
      operations:
      - name: importzoneconfig
        method: PUT
        description: Solaris Zones Import a Zone From Configuration
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: ZoneManager-_rad_method-initEvacuate
      path: /ZoneManager/_rad_method/initEvacuate
      operations:
      - name: initializeevacuation
        method: PUT
        description: Solaris Zones Initialize Zone Evacuation
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    authentication:
      type: apikey
      key: _rad_session
      value: '{{env.SOLARIS_ZONES_API_KEY}}'
      placement: cookie
  exposes:
  - type: rest
    namespace: management-zone-manager-rest
    port: 8080
    description: REST adapter for Solaris Zones Management API — Zone Manager. One Spectral-compliant resource per consumed
      operation, prefixed with /v1.
    resources:
    - path: /v1
      name: root
      description: REST surface for root.
      operations:
      - method: GET
        name: listzoneinterfaces
        description: Solaris Zones List All Zone Management Interfaces
        call: management-zone-manager.listzoneinterfaces
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/zonemanager
      name: zonemanager
      description: REST surface for ZoneManager.
      operations:
      - method: GET
        name: getzonemanager
        description: Solaris Zones Get Zone Manager Instance
        call: management-zone-manager.getzonemanager
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/zonemanager/rad-method/cancelevacuate
      name: zonemanager-rad-method-cancelevacuate
      description: REST surface for ZoneManager-_rad_method-cancelEvacuate.
      operations:
      - method: PUT
        name: cancelevacuation
        description: Solaris Zones Cancel Zone Evacuation in Progress
        call: management-zone-manager.cancelevacuation
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/zonemanager/rad-method/create
      name: zonemanager-rad-method-create
      description: REST surface for ZoneManager-_rad_method-create.
      operations:
      - method: PUT
        name: createzone
        description: Solaris Zones Create a New Zone
        call: management-zone-manager.createzone
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/zonemanager/rad-method/createconfig
      name: zonemanager-rad-method-createconfig
      description: REST surface for ZoneManager-_rad_method-createConfig.
      operations:
      - method: PUT
        name: createephemeralconfig
        description: Solaris Zones Create Ephemeral Zone Configuration
        call: management-zone-manager.createephemeralconfig
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/zonemanager/rad-method/delete
      name: zonemanager-rad-method-delete
      description: REST surface for ZoneManager-_rad_method-delete.
      operations:
      - method: PUT
        name: deletezone
        description: Solaris Zones Delete a Zone
        call: management-zone-manager.deletezone
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/zonemanager/rad-method/evacuate
      name: zonemanager-rad-method-evacuate
      description: REST surface for ZoneManager-_rad_method-evacuate.
      operations:
      - method: PUT
        name: evacuatezones
        description: Solaris Zones Evacuate Zones to Remote Host
        call: management-zone-manager.evacuatezones
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/zonemanager/rad-method/importconfig
      name: zonemanager-rad-method-importconfig
      description: REST surface for ZoneManager-_rad_method-importConfig.
      operations:
      - method: PUT
        name: importzoneconfig
        description: Solaris Zones Import a Zone From Configuration
        call: management-zone-manager.importzoneconfig
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/zonemanager/rad-method/initevacuate
      name: zonemanager-rad-method-initevacuate
      description: REST surface for ZoneManager-_rad_method-initEvacuate.
      operations:
      - method: PUT
        name: initializeevacuation
        description: Solaris Zones Initialize Zone Evacuation
        call: management-zone-manager.initializeevacuation
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    namespace: management-zone-manager-mcp
    port: 9090
    transport: http
    description: MCP adapter for Solaris Zones Management API — Zone Manager. One tool per consumed operation, routed inline
      through this capability's consumes block.
    tools:
    - name: solaris-zones-list-all-zone
      description: Solaris Zones List All Zone Management Interfaces
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: management-zone-manager.listzoneinterfaces
      outputParameters:
      - type: object
        mapping: $.
    - name: solaris-zones-get-zone-manager
      description: Solaris Zones Get Zone Manager Instance
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: management-zone-manager.getzonemanager
      outputParameters:
      - type: object
        mapping: $.
    - name: solaris-zones-cancel-zone-evacuation
      description: Solaris Zones Cancel Zone Evacuation in Progress
      hints:
        readOnly: false
        destructive: false
        idempotent: true
      call: management-zone-manager.cancelevacuation
      outputParameters:
      - type: object
        mapping: $.
    - name: solaris-zones-create-new-zone
      description: Solaris Zones Create a New Zone
      hints:
        readOnly: false
        destructive: false
        idempotent: true
      call: management-zone-manager.createzone
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: solaris-zones-create-ephemeral-zone
      description: Solaris Zones Create Ephemeral Zone Configuration
      hints:
        readOnly: false
        destructive: false
        idempotent: true
      call: management-zone-manager.createephemeralconfig
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: solaris-zones-delete-zone
      description: Solaris Zones Delete a Zone
      hints:
        readOnly: false
        destructive: false
        idempotent: true
      call: management-zone-manager.deletezone
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: solaris-zones-evacuate-zones-remote
      description: Solaris Zones Evacuate Zones to Remote Host
      hints:
        readOnly: false
        destructive: false
        idempotent: true
      call: management-zone-manager.evacuatezones
      outputParameters:
      - type: object
        mapping: $.
    - name: solaris-zones-import-zone-configuration
      description: Solaris Zones Import a Zone From Configuration
      hints:
        readOnly: false
        destructive: false
        idempotent: true
      call: management-zone-manager.importzoneconfig
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: solaris-zones-initialize-zone-evacuation
      description: Solaris Zones Initialize Zone Evacuation
      hints:
        readOnly: false
        destructive: false
        idempotent: true
      call: management-zone-manager.initializeevacuation
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.