# File and Directory Metadata
<subtitle>Retrieve detailed attribute information for files or directories, including permissions, size, and modification time.</subtitle>

You can use the `files.get_info()` method to obtain information about files or directories. The returned information includes file name, type, path, and more.

## Environment Setup

Before using the SDK, please ensure that the `AGENTBOX_API_KEY` environment variable is configured.

>
> You can obtain your API key from the [Console API Keys page](https://console.ucloud.cn/modelverse/experience/api-keys).

```bash
export AGENTBOX_API_KEY=your_api_key
```

### Get File Information

```python
from ucloud_sandbox import Sandbox

sandbox = Sandbox.create()

# Create a new file
sandbox.files.write('test_file.txt', 'Hello, world!')

# Get file-related information
info = sandbox.files.get_info('test_file.txt')

print(info)
# EntryInfo(
#   name='test_file.txt',
#   type=<FileType.FILE: 'file'>,
#   path='/home/user/test_file.txt',
#   size=13,
#   mode=0o644,
#   permissions='-rw-r--r--',
#   owner='user',
#   group='user',
#   modified_time='2025-05-26T12:00:00.000Z',
#   symlink_target=None
# )
```

### Get Directory Information

```python
from ucloud_sandbox import Sandbox

sandbox = Sandbox.create()

# Create a new directory
sandbox.files.make_dir('test_dir')

# Get directory-related information
info = sandbox.files.get_info('test_dir')

print(info)
# EntryInfo(
#   name='test_dir',
#   type=<FileType.DIR: 'dir'>,
#   path='/home/user/test_dir',
#   size=0,
#   mode=0o755,
#   permissions='drwxr-xr-x',
#   owner='user',
#   group='user',
#   modified_time='2025-05-26T12:00:00.000Z',
#   symlink_target=None
# )
```