> ## Documentation Index
> Fetch the complete documentation index at: https://developers.liara.ir/llms.txt
> Use this file to discover all available pages before exploring further.

# hisotrical metrics



## OpenAPI

````yaml /spec/object-storage.yaml get /api/v1/buckets/{bucket}/metrics/historical
openapi: 3.0.1
info:
  title: Object Storage API Documentaion
  description: |-
    A scalable, reliable, and cost effective Object Storage solution to
    support your application from liara-cloud

    Parameters:
    - `teamID`: To access services in a team
  contact:
    name: liara
    url: https://liara.ir
    email: support@liara.ir
  version: 1.0.0
servers:
  - url: https://storage-service.iran.liara.ir
security:
  - jwt: []
tags:
  - name: Bucket
    description: Operations about bucket
  - name: Key
    description: Operations about key
  - name: Folder
    description: Operations about folder
  - name: Object
    description: Operations about object
externalDocs:
  description: Find out more about Liara Object Storage
  url: https://docs.liara.ir/buckets/about/
paths:
  /api/v1/buckets/{bucket}/metrics/historical:
    get:
      tags:
        - Metrics
      summary: hisotrical metrics
      operationId: getHisotricalMetrics
      parameters:
        - name: bucket
          in: path
          required: true
          schema:
            type: string
        - name: since
          in: query
          description: unix time
          required: true
          schema:
            type: string
      responses:
        '200':
          description: successful operation
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: string
                  data:
                    type: object
                    properties:
                      bucket:
                        type: string
                      metrics:
                        type: object
                        properties:
                          totol_objects:
                            type: array
                            items:
                              oneOf:
                                - type: number
                                - type: string
        '400':
          description: Bad Request
          content: {}
        '401':
          description: Missing authentication
          content: {}
        '404':
          description: Not Found
          content: {}
        '409':
          description: Conflict
          content: {}
        '500':
          description: server does not response
          content: {}
components:
  securitySchemes:
    jwt:
      type: apiKey
      description: 'Enter the token with the `Bearer: ` prefix, e.g. "Bearer abcde12345".  #'
      name: Authorization
      in: header

````