# إدارة وقت تشغيل مساحة

راجع صفحة توثيق [HfApi](/docs/huggingface_hub/main/ar/package_reference/hf_api#huggingface_hub.HfApi) للاطلاع على مرجع الطرق لإدارة مساحتك على Hub.

- جلب وقت التشغيل الحالي: [get_space_runtime()](/docs/huggingface_hub/main/ar/package_reference/hf_api#huggingface_hub.HfApi.get_space_runtime)
- جلب سجلات البناء أو التشغيل: [fetch_space_logs()](/docs/huggingface_hub/main/ar/package_reference/hf_api#huggingface_hub.HfApi.fetch_space_logs)
- إدارة الأسرار: [add_space_secret()](/docs/huggingface_hub/main/ar/package_reference/hf_api#huggingface_hub.HfApi.add_space_secret) و [delete_space_secret()](/docs/huggingface_hub/main/ar/package_reference/hf_api#huggingface_hub.HfApi.delete_space_secret)
- إدارة العتاد: [request_space_hardware()](/docs/huggingface_hub/main/ar/package_reference/hf_api#huggingface_hub.HfApi.request_space_hardware)
- إدارة الحالة: [pause_space()](/docs/huggingface_hub/main/ar/package_reference/hf_api#huggingface_hub.HfApi.pause_space)، [restart_space()](/docs/huggingface_hub/main/ar/package_reference/hf_api#huggingface_hub.HfApi.restart_space)، [set_space_sleep_time()](/docs/huggingface_hub/main/ar/package_reference/hf_api#huggingface_hub.HfApi.set_space_sleep_time)
- انتظر حتى يصبح Space جاهزًا: [wait_for_space()](/docs/huggingface_hub/main/ar/package_reference/hf_api#huggingface_hub.HfApi.wait_for_space)
- تحقق من حصة ZeroGPU الخاصة بك: [get_zero_gpu_quota()](/docs/huggingface_hub/main/ar/package_reference/hf_api#huggingface_hub.HfApi.get_zero_gpu_quota)

## هياكل البيانات

### SpaceRuntime[[huggingface_hub.SpaceRuntime]]

#### huggingface_hub.SpaceRuntime[[huggingface_hub.SpaceRuntime]]

```python
huggingface_hub.SpaceRuntime(data: dict)
```

[المصدر](https://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/_space_api.py#L201)

**المعاملات:**

stage (`str`) : المرحلة الحالية للمساحة. مثال: RUNNING.

hardware (`str` أو `None`) : العتاد الحالي للمساحة. مثال: "cpu-basic". يمكن أن يكون `None` إذا كانت المساحة في حالة `BUILDING` لأول مرة.

requested_hardware (`str` أو `None`) : العتاد المطلوب. قد يختلف عن `hardware` خاصةً إذا كان الطلب قد تم تقديمه للتو. مثال: "t4-medium". يمكن أن يكون `None` إذا لم يتم طلب أي عتاد بعد.

sleep_time (`int` أو `None`) : عدد الثواني التي سيبقى فيها المساحة نشطة بعد آخر طلب. افتراضيًا (إذا كانت القيمة `None`)، لن تدخل المساحة في وضع السكون أبدًا إذا كانت تعمل على أجهزة محسّنة، بينما ستدخل في وضع السكون بعد 48 ساعة على أجهزة 'cpu-basic' المجانية. لمزيد من التفاصيل، راجع https://huggingface.co/docs/hub/spaces-gpus#sleep-time.

volumes (`list[Volume]` أو `None`) : قائمة بالأحجام (Volumes) المرفقة في المساحة (Space). كل حجم هو كائن [Volume](/docs/huggingface_hub/main/ar/package_reference/jobs#huggingface_hub.Volume) يصف نوعه ومصدره ومسار التركيب والإعدادات الاختيارية. `None` إذا لم تكن هناك أحجام مرفقة.

raw (`dict`) : الاستجابة الخام من الخادم. تحتوي على مزيد من المعلومات حول بيئة تشغيل المساحة مثل عدد النسخ، وعدد المعالجات المركزية، وحجم الذاكرة،...

تحتوي على معلومات حول وقت التشغيل الحالي لمساحة.

### SpaceHardware[[huggingface_hub.SpaceHardware]]

#### huggingface_hub.SpaceHardware[[huggingface_hub.SpaceHardware]]

```python
huggingface_hub.SpaceHardware(value, names = None, module = None, qualname = None, type = None, start = 1)
```

[المصدر](https://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/_space_api.py#L68)

قائمة بالأجهزة المتاحة لتشغيل مساحتك على Hub.

يمكن مقارنة القيمة Value بسلسلة نصية:
```py
assert SpaceHardware.CPU_BASIC == "cpu-basic"
```

مأخوذة من https://github.com/huggingface-internal/moon-landing/blob/main/server/repo_types/SpaceHardwareFlavor.ts (رابط خاص).

### SpaceStage[[huggingface_hub.SpaceStage]]

#### huggingface_hub.SpaceStage[[huggingface_hub.SpaceStage]]

```python
huggingface_hub.SpaceStage(value, names = None, module = None, qualname = None, type = None, start = 1)
```

[المصدر](https://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/_space_api.py#L22)

قائمة بالمراحل الممكنة لمساحة على Hub.

يمكن مقارنة القيمة Value بسلسلة نصية:
```py
assert SpaceStage.BUILDING == "BUILDING"
```

مأخوذة من https://github.com/huggingface/moon-landing/blob/main/server/repo_types/SpaceInfo.ts#L61 (رابط خاص).

### SpaceStorage[[huggingface_hub.SpaceStorage]]

#### huggingface_hub.SpaceStorage[[huggingface_hub.SpaceStorage]]

```python
huggingface_hub.SpaceStorage(value, names = None, module = None, qualname = None, type = None, start = 1)
```

[المصدر](https://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/_space_api.py#L110)

قائمة بتخزين البيانات الدائم المتاح لمساحتك على Hub.

يمكن مقارنة القيمة Value بسلسلة نصية:
```py
assert SpaceStorage.SMALL == "small"
```

مأخوذة من https://github.com/huggingface/moon-landing/blob/main/server/repo_types/SpaceHardwareFlavor.ts#L24 (رابط خاص).

### SpaceVariable[[huggingface_hub.SpaceVariable]]

#### huggingface_hub.SpaceVariable[[huggingface_hub.SpaceVariable]]

```python
huggingface_hub.SpaceVariable(key: str, values: dict)
```

[المصدر](https://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/_space_api.py#L280)

**المعاملات:**

key (`str`) : مفتاح متغير. مثال: `"MODEL_REPO_ID"`

value (`str`) : قيمة المتغير. مثال: `"the_model_repo_id"`.

description (`str` أو None) : وصف المتغير. مثال: `"Model Repo ID of the implemented model"`.

updatedAt (`datetime` أو None) : تاريخ وقت آخر تحديث للمتغير (إذا تم تحديث المتغير مرة واحدة على الأقل).

تحتوي على معلومات حول المتغيرات الحالية لمساحة.

### SpaceTemplate[[huggingface_hub.SpaceTemplate]]

#### huggingface_hub.SpaceTemplate[[huggingface_hub.SpaceTemplate]]

```python
huggingface_hub.SpaceTemplate(data: dict)
```

[المصدر](https://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/_space_api.py#L375)

**المعاملات:**

name (`str`) : اسم قابل للقراءة البشرية للقالب (مثل `"JupyterLab"`، `"chatbot"`).

repo_id (`str`) : معرّف المستودع (Repo id) للمساحة (Space) القالب (مثل `"SpacesExamples/jupyterlab"`).

sdk (`str`) : SDK الذي بُنيت به القالب (مثل `"gradio"`، `"docker"`، `"static"`).

preferred_private (`bool`) : ما إذا كان يُنصح بأن تكون المساحات (Spaces) المُنشأة من هذا القالب خاصة.

تحتوي على معلومات حول قالب مساحة متاح على Hub.

تُعاد بواسطة [HfApi.list_space_templates()](/docs/huggingface_hub/main/ar/package_reference/hf_api#huggingface_hub.HfApi.list_space_templates). يمكن تمرير `repo_id` كـ `space_template` إلى [HfApi.create_repo()](/docs/huggingface_hub/main/ar/package_reference/hf_api#huggingface_hub.HfApi.create_repo) لإنشاء مساحة جديدة من ذلك القالب.

### ZeroGpuQuota[[huggingface_hub.ZeroGpuQuota]]

#### huggingface_hub.ZeroGpuQuota[[huggingface_hub.ZeroGpuQuota]]

```python
huggingface_hub.ZeroGpuQuota(data: dict)
```

[المصدر](https://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/_space_api.py#L406)

**المعاملات:**

base (`float`) : إجمالي الحصة، بالثواني المعالجة على وحدة معالجة الرسومات.

remaining (`float`) : الحصة المتبقية، بالثواني على وحدة معالجة الرسومات.

resets_at (`datetime` أو `None`) : التاريخ الذي سيتم فيه إعادة تعيين الحصة. `None` إذا لم تُستخدم الحصة بعد.

overquota_used (`float` أو `None`) : ثوانٍ GPU المدفوعة المستهلكة بعد استنفاد الحصة الأساسية. يمكن للمستخدمين من فئات PRO وTeam وEnterprise شراء أرصدة للتجاوز عن الحصة الأساسية عبر https://huggingface.co/settings/billing?add-credits=true.

تحتوي على معلومات حول حصة ZeroGPU للمستخدم الموثّق.

يُستهلك حصة ZeroGPU في كل مرة تستخدم فيها مساحة ZeroGPU (سواءً من واجهة المستخدم أو عبر واجهة برمجية التطبيقات الخاصة بها) وتُعاد ضبطها بشكل دوري. راجع https://huggingface.co/docs/hub/spaces-zerogpu لمزيد من التفاصيل.

تُعاد بواسطة [HfApi.get_zero_gpu_quota()](/docs/huggingface_hub/main/ar/package_reference/hf_api#huggingface_hub.HfApi.get_zero_gpu_quota).