MCP Tools Reference: cloud-sql

Alat: list_users

Mencantumkan semua pengguna database untuk instance Cloud SQL.

Contoh berikut menunjukkan cara menggunakan curl untuk memanggil alat MCP list_users.

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

Skema Input

SqlUsersListRequest

Representasi JSON 
{
  "instance": string,
  "project": string
}
Kolom
instance

string

ID instance database. Ini tidak menyertakan project ID.
project

string

Project ID project yang berisi instance.

Skema Output

Respons daftar pengguna.

UsersListResponse

Representasi JSON 
{
  "kind": string,
  "items": [
    {
      object (User)
    }
  ],
  "nextPageToken": string
}
Kolom
kind

string

Nilai ini selalu sql#usersList.
items[]

object (User)

Daftar resource pengguna dalam instance.
nextPageToken
(deprecated)

string

Tidak digunakan.

Pengguna

Representasi JSON 
{
  "kind": string,
  "password": string,
  "etag": string,
  "name": string,
  "host": string,
  "instance": string,
  "project": string,
  "type": enum (SqlUserType),
  "iamEmail": string,
  "passwordPolicy": {
    object (UserPasswordValidationPolicy)
  },
  "databaseRoles": [
    string
  ],

  // Union field user_details can be only one of the following:
  "sqlserverUserDetails": {
    object (SqlServerUserDetails)
  }
  // End of list of possible types for union field user_details.

  // Union field _dual_password_type can be only one of the following:
  "dualPasswordType": enum (DualPasswordType)
  // End of list of possible types for union field _dual_password_type.

  // Union field _iam_status can be only one of the following:
  "iamStatus": enum (IamStatus)
  // End of list of possible types for union field _iam_status.
}
Kolom
kind

string

Nilai ini selalu sql#user.
password

string

Sandi untuk pengguna.
etag

string

Kolom ini tidak digunakan lagi dan akan dihapus dari versi mendatang API.
name

string

Nama pengguna di instance Cloud SQL. Dapat dihapus untuk update karena sudah ditentukan dalam URL.
host

string

Opsional. Host tempat pengguna dapat terhubung. Untuk operasi insert, host secara default adalah string kosong. Untuk operasi update, host ditentukan sebagai bagian dari URL permintaan. Nama host tidak dapat diupdate setelah penyisipan. Untuk instance MySQL, parameter ini wajib diisi; untuk instance PostgreSQL atau SQL Server, parameter ini opsional.
instance

string

Nama instance Cloud SQL. Ini tidak menyertakan project ID. Dapat dihapus untuk update karena sudah ditentukan di URL.
project

string

Project ID project yang berisi database Cloud SQL. Domain aplikasi Google diberi awalan jika berlaku. Dapat dihapus untuk update karena sudah ditentukan di URL.
type

enum (SqlUserType)

Jenis pengguna. Menentukan metode untuk mengautentikasi pengguna selama login. Defaultnya adalah jenis pengguna bawaan database.
iamEmail

string

Opsional. Email lengkap untuk pengguna IAM. Untuk pengguna database normal, kolom ini tidak akan diisi. Hanya berlaku untuk pengguna database MySQL.
passwordPolicy

object (UserPasswordValidationPolicy)

Kebijakan validasi sandi tingkat pengguna.
databaseRoles[]

string

Opsional. Keanggotaan peran pengguna
Kolom union user_details. Detail pengguna untuk jenis database tertentu user_details hanya dapat berupa salah satu dari berikut ini:
sqlserverUserDetails

object (SqlServerUserDetails)

Kolom union _dual_password_type.

_dual_password_type hanya dapat berupa salah satu dari berikut:
dualPasswordType

enum (DualPasswordType)

Status sandi ganda untuk pengguna.

Kolom union _iam_status.

_iam_status hanya dapat berupa salah satu dari berikut:
iamStatus

enum (IamStatus)

Menunjukkan apakah grup aktif atau tidak aktif untuk autentikasi database IAM.

SqlServerUserDetails

Representasi JSON 
{
  "disabled": boolean,
  "serverRoles": [
    string
  ]
}
Kolom
disabled

boolean

Jika pengguna telah dinonaktifkan
serverRoles[]

string

Peran server untuk pengguna ini

UserPasswordValidationPolicy

Representasi JSON 
{
  "allowedFailedAttempts": integer,
  "passwordExpirationDuration": string,
  "enableFailedAttemptsCheck": boolean,
  "status": {
    object (PasswordStatus)
  },
  "enablePasswordVerification": boolean
}
Kolom
allowedFailedAttempts

integer

Jumlah upaya login yang gagal yang diizinkan sebelum pengguna terkunci.
passwordExpirationDuration

string (Duration format)

Durasi masa berlaku setelah sandi diperbarui.

Durasi dalam detik dengan maksimal sembilan digit pecahan, yang diakhiri dengan 's'. Contoh: "3.5s".
enableFailedAttemptsCheck

boolean

Jika benar (true), pemeriksaan upaya login yang gagal akan diaktifkan.
status

object (PasswordStatus)

Hanya output. Status sandi hanya baca.
enablePasswordVerification

boolean

Jika benar (true), pengguna harus menentukan sandi saat ini sebelum mengubah sandi. Flag ini hanya didukung untuk MySQL.

Durasi

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

string (int64 format)

Detik bertanda dari rentang waktu. Harus dari -315.576.000.000 hingga +315.576.000.000 inklusif. Catatan: batas ini dihitung dari: 60 dtk/mnt * 60 mnt/j * 24 j/h * 365,25 h/thn * 10.000 thn
nanos

integer

Pecahan detik bertanda pada resolusi nanodetik rentang waktu. Durasi kurang dari satu detik ditampilkan dengan kolom seconds 0 dan kolom nanos positif atau negatif. Untuk durasi satu detik atau lebih, nilai non-nol untuk kolom nanos harus memiliki tanda yang sama dengan kolom seconds. Harus dari -999.999.999 hingga +999.999.999 inklusif.

PasswordStatus

Representasi JSON 
{
  "locked": boolean,
  "passwordExpirationTime": string
}
Kolom
locked

boolean

Jika benar (true), pengguna tidak memiliki hak istimewa login.
passwordExpirationTime

string (Timestamp format)

Waktu habis masa berlaku sandi saat ini.

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".

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

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