Pulumi APIs — ResourcesUnderManagement

naftiko: 1.0.0-alpha2
info:
  label: Pulumi APIs — ResourcesUnderManagement
  description: 'Pulumi APIs — ResourcesUnderManagement. 2 operations. Lead operation: GetUsageSummaryDiscoveredResourceHours.
    Self-contained Naftiko capability covering one Pulumi business surface.'
  tags:
  - Pulumi
  - ResourcesUnderManagement
  created: '2026-05-19'
  modified: '2026-05-19'
binds:
- namespace: env
  keys:
    PULUMI_API_KEY: PULUMI_API_KEY
capability:
  consumes:
  - type: http
    namespace: pulumi-resourcesundermanagement
    baseUri: ''
    description: Pulumi APIs — ResourcesUnderManagement business capability. Self-contained, no shared references.
    resources:
    - name: api-orgs-orgName-discovered-resources-summary
      path: /api/orgs/{orgName}/discovered-resources/summary
      operations:
      - name: getusagesummarydiscoveredresourcehours
        method: GET
        description: GetUsageSummaryDiscoveredResourceHours
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: orgName
          in: path
          type: string
          description: The organization name
          required: true
        - name: granularity
          in: query
          type: string
          description: Time granularity for aggregation (e.g., 'hourly', 'daily', 'monthly')
        - name: lookbackDays
          in: query
          type: integer
          description: Number of days to look back from the current time or lookbackStart
        - name: lookbackStart
          in: query
          type: integer
          description: Unix timestamp for the start of the lookback period (defaults to current time if omitted)
    - name: api-orgs-orgName-resources-summary
      path: /api/orgs/{orgName}/resources/summary
      operations:
      - name: getusagesummaryresourcehours
        method: GET
        description: GetUsageSummaryResourceHours
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: orgName
          in: path
          type: string
          description: The organization name
          required: true
        - name: granularity
          in: query
          type: string
          description: Time granularity for aggregation (e.g., 'hourly', 'daily', 'monthly')
        - name: lookbackDays
          in: query
          type: integer
          description: Number of days to look back from the current time or lookbackStart
        - name: lookbackStart
          in: query
          type: integer
          description: Unix timestamp for the start of the lookback period (defaults to current time if omitted)
  exposes:
  - type: rest
    namespace: pulumi-resourcesundermanagement-rest
    port: 8080
    description: REST adapter for Pulumi APIs — ResourcesUnderManagement. One Spectral-compliant resource per consumed operation,
      prefixed with /v1.
    resources:
    - path: /v1/api/orgs/{orgname}/discovered-resources/summary
      name: api-orgs-orgname-discovered-resources-summary
      description: REST surface for api-orgs-orgName-discovered-resources-summary.
      operations:
      - method: GET
        name: getusagesummarydiscoveredresourcehours
        description: GetUsageSummaryDiscoveredResourceHours
        call: pulumi-resourcesundermanagement.getusagesummarydiscoveredresourcehours
        with:
          orgName: rest.orgName
          granularity: rest.granularity
          lookbackDays: rest.lookbackDays
          lookbackStart: rest.lookbackStart
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/orgs/{orgname}/resources/summary
      name: api-orgs-orgname-resources-summary
      description: REST surface for api-orgs-orgName-resources-summary.
      operations:
      - method: GET
        name: getusagesummaryresourcehours
        description: GetUsageSummaryResourceHours
        call: pulumi-resourcesundermanagement.getusagesummaryresourcehours
        with:
          orgName: rest.orgName
          granularity: rest.granularity
          lookbackDays: rest.lookbackDays
          lookbackStart: rest.lookbackStart
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    namespace: pulumi-resourcesundermanagement-mcp
    port: 9090
    transport: http
    description: MCP adapter for Pulumi APIs — ResourcesUnderManagement. One tool per consumed operation, routed inline through
      this capability's consumes block.
    tools:
    - name: getusagesummarydiscoveredresourcehours
      description: GetUsageSummaryDiscoveredResourceHours
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: pulumi-resourcesundermanagement.getusagesummarydiscoveredresourcehours
      with:
        orgName: tools.orgName
        granularity: tools.granularity
        lookbackDays: tools.lookbackDays
        lookbackStart: tools.lookbackStart
      outputParameters:
      - type: object
        mapping: $.
    - name: getusagesummaryresourcehours
      description: GetUsageSummaryResourceHours
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: pulumi-resourcesundermanagement.getusagesummaryresourcehours
      with:
        orgName: tools.orgName
        granularity: tools.granularity
        lookbackDays: tools.lookbackDays
        lookbackStart: tools.lookbackStart
      outputParameters:
      - type: object
        mapping: $.