MCP Tools Reference: dataform.googleapis.com

Tool: create_folder

Erstellt einen neuen Dataform-Ordner in einem bestimmten Google Cloud-Projekt und an einem bestimmten Standort.

Mit Ordnern werden Dataform-Repositories in einer Hierarchie organisiert. Wenn Sie einen Ordner erstellen, werden keine Repositorys darin verschoben. Wenn Sie ein Repository in einem Ordner platzieren möchten, legen Sie den Parameterwert containing_folder fest, wenn Sie das Tool create_repository verwenden.

Versuchen Sie nicht, ein vorhandenes Repository mit dem update_repository-Tool in einen Ordner zu verschieben. Nachdem ein Repository erstellt wurde, kann das Feld containing_folder nicht mehr mit MCP-Tools geändert werden.

Der Parameterwert parent muss das Format projects/{project_id}/locations/{location} haben.

Der Parameterwert folder.display_name ist erforderlich und gibt den benutzerfreundlichen Namen des Ordners an.

Das folgende Codebeispiel zeigt, wie Sie mit curl das MCP-Tool create_folder aufrufen.

Curl-Anfrage 
curl --location 'https://dataform.googleapis.com/mcp' \
--header 'content-type: application/json' \
--header 'accept: application/json, text/event-stream' \
--data '{
  "method": "tools/call",
  "params": {
    "name": "create_folder",
    "arguments": {
      // Provide these details according to the MCP tool specification.
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

Eingabeschema

CreateFolder-Anfragenachricht.

CreateFolderRequest

JSON-Darstellung 
{
  "parent": string,
  "folder": {
    object (Folder)
  },
  "folderId": string
}
Felder
parent

string

Erforderlich. Der Speicherort, an dem der Ordner erstellt werden soll. Muss das Format projects/*/locations/* aufweisen.
folder

object (Folder)

Erforderlich. Der zu erstellende Ordner.
folderId
(deprecated)

string

Eingestellt: Dieses Feld wird nicht verwendet. Der Ressourcenname wird automatisch generiert. Die für den Ordner zu verwendende ID, die als letzte Komponente des Ressourcennamens des Ordners verwendet wird.

Ordner

JSON-Darstellung 
{
  "name": string,
  "displayName": string,
  "containingFolder": string,
  "teamFolderName": string,
  "createTime": string,
  "updateTime": string,

  // Union field _internal_metadata can be only one of the following:
  "internalMetadata": string
  // End of list of possible types for union field _internal_metadata.

  // Union field _creator_iam_principal can be only one of the following:
  "creatorIamPrincipal": string
  // End of list of possible types for union field _creator_iam_principal.
}
Felder
name

string

ID. Der Name des Ordners.
displayName

string

Erforderlich. Der nutzerfreundliche Name des Ordners.
containingFolder

string

Optional. Der Ressourcenname des übergeordneten Ordners. Das Format sollte „projects/{project}/locations/{location}/folders/{folder}“, „projects/{project}/locations/{location}/teamFolders/{teamFolder}“ oder einfach „“ sein, wenn es sich um einen Stammordner handelt. Dieses Feld kann nur über MoveFolder aktualisiert werden.
teamFolderName

string

Nur Ausgabe. Der Ressourcenname des Teamordners, dem dieser Ordner zugeordnet ist. Muss das Format „projects/{project}/locations/{location}/teamFolders/{teamFolder}“ haben. Wenn dies nicht festgelegt ist, ist der Ordner kein Teamordner, sondern ein Nutzerordner.
createTime

string (Timestamp format)

Nur Ausgabe. Der Zeitstempel für die Erstellung des Ordners.

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30"
updateTime

string (Timestamp format)

Nur Ausgabe. Der Zeitstempel, der angibt, wann der Ordner zuletzt aktualisiert wurde.

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30".

Union-Feld _internal_metadata.

Für _internal_metadata ist nur einer der folgenden Werte zulässig:
internalMetadata

string

Nur Ausgabe. Alle Metadateninformationen, die intern zum Bereitstellen der Ressource verwendet werden. Beispiele: Zeitstempel, Flags, Statusfelder usw. Das Format dieses Felds ist ein JSON-String.

Union-Feld _creator_iam_principal.

Für _creator_iam_principal ist nur einer der folgenden Werte zulässig:
creatorIamPrincipal

string

Nur Ausgabe. Die IAM-Hauptkonto-ID des Erstellers des Ordners.

Zeitstempel

JSON-Darstellung 
{
  "seconds": string,
  "nanos": integer
}
Felder
seconds

string (int64 format)

Stellt Sekunden der UTC-Zeit seit Unix-Epoche 1970-01-01T00:00:00Z dar. Muss einschließlich zwischen -62135596800 und 253402300799 liegen (entspricht 0001-01-01T00:00:00Z bis 9999-12-31T23:59:59Z).
nanos

integer

Nicht negative Sekundenbruchteile Nanosekunden-Auflösung. Dieses Feld enthält den Nanosekundenanteil der Dauer und ist keine Alternative zu Sekunden. Negative Sekundenwerte mit Bruchteilen müssen weiterhin nicht negative Nano-Werte haben, die zeitlich vorwärts gezählt werden. Muss zwischen 0 und 999.999.999 liegen (einschließlich).

Ausgabeschema

Stellt einen Dataform-Ordner dar. Dies ist eine Ressource, mit der Dateien und andere Ordner organisiert und hierarchische Zugriffssteuerungen bereitgestellt werden.

Ordner

JSON-Darstellung 
{
  "name": string,
  "displayName": string,
  "containingFolder": string,
  "teamFolderName": string,
  "createTime": string,
  "updateTime": string,

  // Union field _internal_metadata can be only one of the following:
  "internalMetadata": string
  // End of list of possible types for union field _internal_metadata.

  // Union field _creator_iam_principal can be only one of the following:
  "creatorIamPrincipal": string
  // End of list of possible types for union field _creator_iam_principal.
}
Felder
name

string

ID. Der Name des Ordners.
displayName

string

Erforderlich. Der nutzerfreundliche Name des Ordners.
containingFolder

string

Optional. Der Ressourcenname des übergeordneten Ordners. Das Format sollte „projects/{project}/locations/{location}/folders/{folder}“, „projects/{project}/locations/{location}/teamFolders/{teamFolder}“ oder einfach „“ sein, wenn es sich um einen Stammordner handelt. Dieses Feld kann nur über MoveFolder aktualisiert werden.
teamFolderName

string

Nur Ausgabe. Der Ressourcenname des Teamordners, dem dieser Ordner zugeordnet ist. Muss das Format „projects/{project}/locations/{location}/teamFolders/{teamFolder}“ haben. Wenn dies nicht festgelegt ist, ist der Ordner kein Teamordner, sondern ein Nutzerordner.
createTime

string (Timestamp format)

Nur Ausgabe. Der Zeitstempel für die Erstellung des Ordners.

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30"
updateTime

string (Timestamp format)

Nur Ausgabe. Der Zeitstempel, der angibt, wann der Ordner zuletzt aktualisiert wurde.

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30".

Union-Feld _internal_metadata.

Für _internal_metadata ist nur einer der folgenden Werte zulässig:
internalMetadata

string

Nur Ausgabe. Alle Metadateninformationen, die intern zum Bereitstellen der Ressource verwendet werden. Beispiele: Zeitstempel, Flags, Statusfelder usw. Das Format dieses Felds ist ein JSON-String.

Union-Feld _creator_iam_principal.

Für _creator_iam_principal ist nur einer der folgenden Werte zulässig:
creatorIamPrincipal

string

Nur Ausgabe. Die IAM-Hauptkonto-ID des Erstellers des Ordners.

Zeitstempel

JSON-Darstellung 
{
  "seconds": string,
  "nanos": integer
}
Felder
seconds

string (int64 format)

Stellt Sekunden der UTC-Zeit seit Unix-Epoche 1970-01-01T00:00:00Z dar. Muss einschließlich zwischen -62135596800 und 253402300799 liegen (entspricht 0001-01-01T00:00:00Z bis 9999-12-31T23:59:59Z).
nanos

integer

Nicht negative Sekundenbruchteile Nanosekunden-Auflösung. Dieses Feld enthält den Nanosekundenanteil der Dauer und ist keine Alternative zu Sekunden. Negative Sekundenwerte mit Bruchteilen müssen weiterhin nicht negative Nano-Werte haben, die zeitlich vorwärts gezählt werden. Muss zwischen 0 und 999.999.999 liegen (einschließlich).

Tool-Annotationen

Tool-Anmerkungen werden an MCP-Clients gesendet, um das grundlegende Risiko eines bestimmten Tools zu beschreiben. Die meisten Clients behandeln diese Hinweise als nicht vertrauenswürdig, sie können aber verwendet werden, um zu entscheiden, wann eine Bestätigungsaufforderung an einen Nutzer gesendet wird.

Zusammen mit dem Titelstring sind die folgenden booleschen Hinweise definiert:

  • readOnlyHint: Wenn „true“, ändert das Tool seine Umgebung nicht. Standardeinstellung: false.
  • destructiveHint: Wenn „true“, kann das Tool destruktive Aktionen ausführen. Wenn „false“, kann das Tool nur additive Aktionen ausführen. Standardeinstellung: true.
  • idempotentHint: Wenn „true“, hat das wiederholte Aufrufen des Tools mit denselben Argumenten keine zusätzlichen Auswirkungen auf die Umgebung. Standardeinstellung: false.
  • openWorldHint: Wenn „true“, kann das Tool mit einer „offenen Welt“ externer Einheiten interagieren. Wenn „false“, kann das Tool nur mit internen Einheiten interagieren. Ein Web-Suchtool wäre beispielsweise frei verfügbar, ein Tool für das Gedächtnis jedoch nicht.

Destruktiver Hinweis: ❌ | Idempotenter Hinweis: ❌ | Nur-Lese-Hinweis: ❌ | Open-World-Hinweis: ❌