Jump to

• Request
• Response

Get tablespace data file usage

get

/database/storage/tablespaces/{tablespace_name}/datafiles/{file_id}/usage

Returns GV$DATAFILE and DBA_DATA_FILES records for a specific tablespace and file. A client requires SQL Administrator role to invoke this service.

Request

Path Parameters

• file_id(required): string
  File identifier.
• tablespace_name(required): string
  Name of the tablespace.

There's no request body for this operation.

Back to Top

Response

Supported Media Types

• application/json

200 Response

Description of the space usage for the tablespace data file.

Body ()

Root Schema : DatabaseTablespaceDatafileUsageItem

Type: object

Using GV$DATAFILE and DBA_FREE_SPACE data this object represents the usage of a data file in the database.

Show Source

• autoextend: string
  Indicates whether the file is autoextensible (YES) or not (NO).
• file_id: integer
  File identifier number of the database file.
• file_name: string
  Name of the database file.
• links: array links
• status: string
  File status.
• tablespace: string
  Name of the tablespace.
• total_space: integer
  Total size of the files (in bytes).
• used_space: integer
  Total used space (in bytes).
• used_space_pct: number
  :Percentage of how much space is used.

{
    "type":"object",
    "description":"Using GV$DATAFILE and DBA_FREE_SPACE data this object represents the usage of a data file in the database.",
    "properties":{
        "file_name":{
            "type":"string",
            "description":"Name of the database file."
        },
        "file_id":{
            "type":"integer",
            "description":"File identifier number of the database file."
        },
        "tablespace":{
            "type":"string",
            "description":"Name of the tablespace."
        },
        "status":{
            "type":"string",
            "description":"File status."
        },
        "total_space":{
            "type":"integer",
            "description":"Total size of the files (in bytes)."
        },
        "used_space":{
            "type":"integer",
            "description":"Total used space (in bytes)."
        },
        "used_space_pct":{
            "type":"number",
            "description":":Percentage of how much space is used."
        },
        "autoextend":{
            "type":"string",
            "description":"Indicates whether the file is autoextensible (YES) or not (NO)."
        },
        "links":{
            "type":"array",
            "items":{
                "$ref":"#/components/schemas/LinkRelation"
            }
        }
    }
}

Nested Schema : links

Type: array

Show Source

• Array of: object LinkRelation

{
    "type":"array",
    "items":{
        "$ref":"#/components/schemas/LinkRelation"
    }
}

Nested Schema : LinkRelation

Type: object

Show Source

• href(required): string
• rel(required): string

{
    "type":"object",
    "properties":{
        "rel":{
            "type":"string"
        },
        "href":{
            "type":"string"
        }
    },
    "required":[
        "rel",
        "href"
    ]
}

Back to Top