MCP Tools Reference: dataform.googleapis.com

Alat: create_folder

Membuat folder Dataform baru di project dan lokasi Google Cloud tertentu.

Folder mengatur repositori Dataform ke dalam hierarki. Membuat folder tidak akan memindahkan repositori apa pun ke dalamnya. Untuk menempatkan repositori di dalam folder, tetapkan nilai parameter containing_folder saat menggunakan alat create_repository.

Jangan mencoba memindahkan repositori yang ada ke dalam folder menggunakan alat update_repository. Setelah repositori dibuat, kolom containing_folder tidak dapat diubah menggunakan alat MCP.

Nilai parameter parent harus dalam format projects/{project_id}/locations/{location}.

Nilai parameter folder.display_name wajib diisi dan menentukan nama folder yang mudah digunakan.

Contoh kode berikut menunjukkan cara menggunakan curl untuk memanggil alat MCP create_folder.

Permintaan Curl 
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
}'

Skema Input

Pesan permintaan CreateFolder.

CreateFolderRequest

Representasi JSON 
{
  "parent": string,
  "folder": {
    object (Folder)
  },
  "folderId": string
}
Kolom
parent

string

Wajib. Lokasi tempat Folder akan dibuat. Harus dalam format projects/*/locations/*.
folder

object (Folder)

Wajib. Folder yang akan dibuat.
folderId
(deprecated)

string

Tidak digunakan lagi: Kolom ini tidak digunakan. Nama resource dibuat secara otomatis. ID yang akan digunakan untuk Folder, yang akan menjadi komponen akhir dari nama resource Folder.

Folder

Representasi JSON 
{
  "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.
}
Kolom
name

string

ID. Nama Folder.
displayName

string

Wajib. Nama Folder yang mudah digunakan.
containingFolder

string

Opsional. Nama resource Folder yang berisi. Formatnya harus: projects/{project}/locations/{location}/folders/{folder}, projects/{project}/locations/{location}/teamFolders/{teamFolder}, atau hanya "" jika ini adalah Folder root. Kolom ini hanya dapat diperbarui melalui MoveFolder.
teamFolderName

string

Hanya output. Nama resource TeamFolder yang terkait dengan Folder ini. Formatnya adalah: projects/{project}/locations/{location}/teamFolders/{teamFolder}. Jika tidak disetel, Folder tidak dikaitkan dengan TeamFolder dan merupakan UserFolder.
createTime

string (Timestamp format)

Hanya output. Stempel waktu saat Folder dibuat.

Menggunakan RFC 3339 yang outputnya akan selalu dinormalisasi Z dan menggunakan 0, 3, 6, atau 9 digit pecahan. Offset selain "Z" juga diterima. Contoh: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z", atau "2014-10-02T15:01:23+05:30".
updateTime

string (Timestamp format)

Hanya output. Stempel waktu saat Folder terakhir diperbarui.

Menggunakan RFC 3339 yang outputnya akan selalu dinormalisasi Z dan menggunakan 0, 3, 6, atau 9 digit pecahan. Offset selain "Z" juga diterima. Contoh: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z", atau "2014-10-02T15:01:23+05:30".

Kolom union _internal_metadata.

_internal_metadata hanya dapat berupa salah satu dari hal berikut:
internalMetadata

string

Hanya output. Semua informasi metadata yang digunakan secara internal untuk menayangkan resource. Misalnya: stempel waktu, tanda, kolom status, dll. Format kolom ini adalah string JSON.

Kolom union _creator_iam_principal.

_creator_iam_principal hanya dapat berupa salah satu dari hal berikut:
creatorIamPrincipal

string

Hanya output. ID utama IAM pembuat Folder.

Stempel waktu

Representasi JSON 
{
  "seconds": string,
  "nanos": integer
}
Kolom
seconds

string (int64 format)

Mewakili detik waktu UTC sejak epoch Unix 1970-01-01T00:00:00Z. Harus antara -62135596800 dan 253402300799 inklusif (yang sesuai dengan 0001-01-01T00:00:00Z hingga 9999-12-31T23:59:59Z).
nanos

integer

Pecahan detik non-negatif pada resolusi nanodetik. Kolom ini adalah bagian nanodetik dari durasi, bukan alternatif untuk detik. Nilai detik negatif dengan pecahan harus tetap memiliki nilai nanos non-negatif yang dihitung maju dalam waktu. Harus antara 0 dan 999.999.999 inklusif.

Skema Output

Mewakili Folder Dataform. Ini adalah resource yang digunakan untuk mengatur File dan Folder lainnya serta menyediakan kontrol akses hierarkis.

Folder

Representasi JSON 
{
  "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.
}
Kolom
name

string

ID. Nama Folder.
displayName

string

Wajib. Nama Folder yang mudah digunakan.
containingFolder

string

Opsional. Nama resource Folder yang berisi. Formatnya harus: projects/{project}/locations/{location}/folders/{folder}, projects/{project}/locations/{location}/teamFolders/{teamFolder}, atau hanya "" jika ini adalah Folder root. Kolom ini hanya dapat diperbarui melalui MoveFolder.
teamFolderName

string

Hanya output. Nama resource TeamFolder yang terkait dengan Folder ini. Formatnya adalah: projects/{project}/locations/{location}/teamFolders/{teamFolder}. Jika tidak disetel, Folder tidak dikaitkan dengan TeamFolder dan merupakan UserFolder.
createTime

string (Timestamp format)

Hanya output. Stempel waktu saat Folder dibuat.

Menggunakan RFC 3339 yang outputnya akan selalu dinormalisasi Z dan menggunakan 0, 3, 6, atau 9 digit pecahan. Offset selain "Z" juga diterima. Contoh: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z", atau "2014-10-02T15:01:23+05:30".
updateTime

string (Timestamp format)

Hanya output. Stempel waktu saat Folder terakhir diperbarui.

Menggunakan RFC 3339 yang outputnya akan selalu dinormalisasi Z dan menggunakan 0, 3, 6, atau 9 digit pecahan. Offset selain "Z" juga diterima. Contoh: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z", atau "2014-10-02T15:01:23+05:30".

Kolom union _internal_metadata.

_internal_metadata hanya dapat berupa salah satu dari hal berikut:
internalMetadata

string

Hanya output. Semua informasi metadata yang digunakan secara internal untuk menayangkan resource. Misalnya: stempel waktu, tanda, kolom status, dll. Format kolom ini adalah string JSON.

Kolom union _creator_iam_principal.

_creator_iam_principal hanya dapat berupa salah satu dari hal berikut:
creatorIamPrincipal

string

Hanya output. ID utama IAM pembuat Folder.

Stempel waktu

Representasi JSON 
{
  "seconds": string,
  "nanos": integer
}
Kolom
seconds

string (int64 format)

Mewakili detik waktu UTC sejak epoch Unix 1970-01-01T00:00:00Z. Harus antara -62135596800 dan 253402300799 inklusif (yang sesuai dengan 0001-01-01T00:00:00Z hingga 9999-12-31T23:59:59Z).
nanos

integer

Pecahan detik non-negatif pada resolusi nanodetik. Kolom ini adalah bagian nanodetik dari durasi, bukan alternatif untuk detik. Nilai detik negatif dengan pecahan harus tetap memiliki nilai nanos non-negatif yang dihitung maju dalam waktu. Harus antara 0 dan 999.999.999 inklusif.

Anotasi Alat

Anotasi alat dikirim ke klien MCP untuk menjelaskan risiko dasar alat tertentu. Sebagian besar klien memperlakukan petunjuk ini sebagai tidak tepercaya, tetapi petunjuk ini dapat digunakan untuk memutuskan kapan perintah konfirmasi dapat dikirim ke pengguna.

Selain string judul, petunjuk boolean berikut ditentukan sebagai berikut:

  • readOnlyHint: Jika benar, alat tidak akan mengubah lingkungannya. Default: false.
  • destructiveHint: Jika benar, alat dapat melakukan tindakan destruktif. Jika salah (false), alat hanya dapat melakukan tindakan tambahan. Default: true.
  • idempotentHint: Jika benar (true), memanggil alat berulang kali dengan argumen yang sama tidak akan memberikan efek tambahan pada lingkungannya. Default: false.
  • openWorldHint: Jika benar, alat dapat berinteraksi dengan 'dunia terbuka' entitas eksternal. Jika salah (false), alat hanya dapat berinteraksi dengan entitas internal. Misalnya, alat penelusuran web akan menjadi open world, sedangkan alat memori tidak akan menjadi open world.

Petunjuk Destruktif: ❌ | Petunjuk Idempoten: ❌ | Petunjuk Hanya Baca: ❌ | Petunjuk Dunia Terbuka: ❌