Jump to

• Request
• Response

Get data files for a tablespace

get

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

Returns records from DBA_DATA_FILES for a specific tablespace. A client requires SQL Administrator role to invoke this service.

Request

Path Parameters

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

Query Parameters

• limit: integer(int32)
  The maximum number of records to return.
• q:
  Filtering is the process of limiting a collection resource by using a per-request dynamic filter definition across multiple page resources, where each page contains a subset of items found in the complete collection. Filtering enables efficient traversal of large collections.

  Examples

  Select an example FilterCriteriaExample OrderByPropertyExample FilterAndOrderExample

There's no request body for this operation.

Back to Top

Response

Supported Media Types

• application/json

200 Response

Description of all data files for a specific tablespace.

Body ()

Root Schema : DatabaseTablespaceDatafiles

Type: object

Show Source

• count: integer
  Total number of records in the current response.
• hasMore: boolean
  Indicates if there are more records to be retrieved.
• items: array items
• limit: integer
  The actual page size limit on number of records applied by the server.
• links: array links
• offset: integer
  The actual index from which the item resources are returned.

{
    "type":"object",
    "properties":{
        "items":{
            "type":"array",
            "items":{
                "$ref":"#/components/schemas/DatabaseTablespaceDatafilesItem"
            }
        },
        "hasMore":{
            "type":"boolean",
            "description":"Indicates if there are more records to be retrieved."
        },
        "limit":{
            "type":"integer",
            "description":"The actual page size limit on number of records applied by the server."
        },
        "offset":{
            "type":"integer",
            "description":"The actual index from which the item resources are returned."
        },
        "count":{
            "type":"integer",
            "description":"Total number of records in the current response."
        },
        "links":{
            "type":"array",
            "items":{
                "$ref":"#/components/schemas/LinkRelation"
            }
        }
    }
}

Nested Schema : items

Type: array

Show Source

• Array of: object DatabaseTablespaceDatafilesItem

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

Nested Schema : links

Type: array

Show Source

• Array of: object LinkRelation

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

Nested Schema : DatabaseTablespaceDatafilesItem

Type: object

Show Source

• autoextensible: string
  Indicates whether the file is autoextensible (YES) or not (NO).
• blocks: integer
  Size of the file (in Oracle blocks).
• bytes: integer
  Size of the file (in bytes).
• file_name: string
  Name of the database file.
• increment_by: integer
  Default increment for autoextension (in Oracle blocks).
• links: array links
• lost_write_protect: integer
  Lost write protection status of the file.
• maxblocks: integer
  Maximum size of the file (in Oracle blocks).
• maxbytes: integer
  Maximum size of the file (in bytes).
• online_status: string
  Online status of the file.
• relative_fno: integer
  Tablespace-relative file number.
• status: string
  File status.
• tablespace: string
  Name of the tablespace.
• user_blocks: integer
  Size of the useful portion of the file (in Oracle blocks).
• user_bytes: integer
  The size of the file available for user data. The actual size of the file minus the USER_BYTES value is used to store file related metadata.

{
    "type":"object",
    "description":"",
    "properties":{
        "file_name":{
            "type":"string",
            "description":"Name of the database file."
        },
        "tablespace":{
            "type":"string",
            "description":"Name of the tablespace."
        },
        "bytes":{
            "type":"integer",
            "description":"Size of the file (in bytes)."
        },
        "blocks":{
            "type":"integer",
            "description":"Size of the file (in Oracle blocks)."
        },
        "status":{
            "type":"string",
            "description":"File status."
        },
        "relative_fno":{
            "type":"integer",
            "description":"Tablespace-relative file number."
        },
        "autoextensible":{
            "type":"string",
            "description":"Indicates whether the file is autoextensible (YES) or not (NO)."
        },
        "maxbytes":{
            "type":"integer",
            "description":"Maximum size of the file (in bytes)."
        },
        "maxblocks":{
            "type":"integer",
            "description":"Maximum size of the file (in Oracle blocks)."
        },
        "increment_by":{
            "type":"integer",
            "description":"Default increment for autoextension (in Oracle blocks)."
        },
        "user_bytes":{
            "type":"integer",
            "description":"The size of the file available for user data. The actual size of the file minus the USER_BYTES value is used to store file related metadata."
        },
        "user_blocks":{
            "type":"integer",
            "description":"Size of the useful portion of the file (in Oracle blocks)."
        },
        "online_status":{
            "type":"string",
            "description":"Online status of the file."
        },
        "lost_write_protect":{
            "type":"integer",
            "description":"Lost write protection status of the file."
        },
        "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