> For the complete documentation index, see [llms.txt](https://docs.g-iot.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.g-iot.io/de/plattform-benutzerhandbuch/verwaltung/subtenant-gerate.md).

# Subtenant-Geräte

Der Bereich „Subtenant-Geräte“ bietet Super Admins und berechtigten Rollen eine Übersicht sowie die vollständige Kontrolle über die Geräteverteilung zwischen Subtenants. Diese Funktion ermöglicht eine zentrale Überwachung und Verwaltung, welche Geräte jedem Subtenant zugewiesen sind, und stellt eine transparente Nachverfolgung von Eigentum und Gruppenzuweisungen innerhalb der Tenant-Struktur sicher.

Aus diesem Bereich können Benutzer:

* Einen Subtenant auswählen und die derzeit zugewiesenen Geräte einsehen.
* Die individuelle Zuweisung von Geräten zu und von Subtenants verwalten.
* Ganze Gruppen – einschließlich der zugehörigen Geräte – einem ausgewählten Subtenant zuweisen.

<figure><img src="/files/nVv0hSNJejwlOOQXzG8R" alt=""><figcaption></figcaption></figure>

***

**Schritte zum Aufrufen der Logs-Seite**

1. **Cockpit-Menü öffnen**\
   Navigieren Sie über die Sidebar zum Cockpit-Menü.
2. **Administration auswählen**\
   Wählen Sie im Cockpit-Menü den Bereich „Administration“.
3. **Logs auswählen**\
   Klicken Sie auf „Logs“, um die Seite zu öffnen.

Nach dem Öffnen zeigt die Seite eine chronologische Liste aller tenantbezogenen Aktivitäten. Durch Auswahl eines Log-Eintrags wird die Detailansicht mit zusätzlichen Metadaten und Kontextinformationen angezeigt.

***

**Seitenübersicht und spezifische Funktionen**

1. **Subtenant-Auswahlpanel (linke Spalte)**
   * Listet alle vorhandenen Subtenants auf.
   * Klicken Sie auf einen Subtenant, um dessen zugewiesene Gerätedaten anzuzeigen.
2. **Geräte-Zuweisungsbereich**
   * Zeigt die vollständige Liste der derzeit dem ausgewählten Subtenant zugewiesenen Geräte.
   * Ermöglicht die manuelle Zuweisung oder Entfernung einzelner Geräte.
3. **Gruppenzuweisungs-Panel**
   * Ermöglicht die Zuweisung ganzer Gruppen an den Subtenant.
   * Alle Geräte innerhalb der ausgewählten Gruppen werden automatisch dem Subtenant zugewiesen.
   * Nützlich, um große Gerätebestände unter einer strukturierten Subtenant-Zuordnung zu organisieren.

{% hint style="info" %}
Nur Super Admins können Geräte- oder Gruppenzuweisungen über Subtenants hinweg ändern. Alle Änderungen werden sofort übernommen und auf der gesamten Plattform angezeigt.
{% endhint %}

{% hint style="warning" %}
Bei der Zuweisung einer Gruppe an einen Subtenant gelingt die Aktion nur, wenn alle Geräte dieser Gruppe ausschließlich dieser Gruppe zugewiesen sind.\
Wenn ein Gerät der ausgewählten Gruppe auch einer anderen Gruppe zugewiesen ist, blockiert die Plattform die Zuweisung, um Konflikte bei der Gerätezuordnung über Subtenants hinweg zu vermeiden.

**Tipp:** Vor der Zuweisung überprüfen Sie, ob alle Geräte der Gruppe ausschließlich dieser Gruppe angehören, oder bereinigen Sie gegebenenfalls Überschneidungen zwischen Gruppen.
{% endhint %}

<figure><img src="/files/dXMQm84ZfBb2ACygXQOo" alt=""><figcaption></figcaption></figure>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.g-iot.io/de/plattform-benutzerhandbuch/verwaltung/subtenant-gerate.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.