MCP Tools Reference: cloud-sql

Tool: list_users

Alle Datenbanknutzer für eine Cloud SQL-Instanz auflisten.

Im folgenden Beispiel wird gezeigt, wie Sie mit curl das MCP-Tool list_users aufrufen.

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

Eingabeschema

SqlUsersListRequest

JSON-Darstellung 
{
  "instance": string,
  "project": string
}
Felder
instance

string

ID der Datenbankinstanz. Die Projekt-ID ist darin nicht enthalten.
project

string

Projekt-ID des Projekts mit der Instanz.

Ausgabeschema

Antwort der Nutzerliste.

UsersListResponse

JSON-Darstellung 
{
  "kind": string,
  "items": [
    {
      object (User)
    }
  ],
  "nextPageToken": string
}
Felder
kind

string

Dies ist immer sql#usersList.
items[]

object (User)

Liste der Nutzerressourcen in der Instanz.
nextPageToken
(deprecated)

string

Nicht in Verwendung.

Nutzer

JSON-Darstellung 
{
  "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.
}
Felder
kind

string

Dies ist immer sql#user.
password

string

Das Passwort für den Nutzer.
etag

string

Dieses Feld ist veraltet und wird aus einer zukünftigen Version der API entfernt.
name

string

Der Nutzername in der Cloud SQL-Instanz. Kann für update weggelassen werden, da er bereits in der URL angegeben ist.
host

string

Optional. Der Host, von dem aus der Nutzer eine Verbindung herstellen kann. Bei insert-Vorgängen ist der Host standardmäßig ein leerer String. Bei update-Vorgängen wird der Host als Teil der Anfrage-URL angegeben. Der Hostname kann nach dem Einfügen nicht mehr aktualisiert werden. Für eine MySQL-Instanz ist sie erforderlich, für eine PostgreSQL- oder SQL Server-Instanz ist sie optional.
instance

string

Der Name der Cloud SQL-Instanz. Die Projekt-ID ist darin nicht enthalten. Kann für update weggelassen werden, da er bereits in der URL angegeben ist.
project

string

Die Projekt-ID des Projekts, das die Cloud SQL-Datenbank enthält. Der Google Apps-Domain wird gegebenenfalls ein Präfix vorangestellt. Kann für update weggelassen werden, da er bereits in der URL angegeben ist.
type

enum (SqlUserType)

Der Nutzertyp. Sie bestimmt die Methode zur Authentifizierung des Nutzers bei der Anmeldung. Der Standardwert ist der integrierte Nutzertyp der Datenbank.
iamEmail

string

Optional. Die vollständige E-Mail-Adresse eines IAM-Nutzers. Bei normalen Datenbanknutzern wird dieses Feld nicht ausgefüllt. Gilt nur für MySQL-Datenbanknutzer.
passwordPolicy

object (UserPasswordValidationPolicy)

Richtlinie zur Passwortvalidierung auf Nutzerebene.
databaseRoles[]

string

Optional. Rollenmitgliedschaften des Nutzers
Union-Feld user_details. Nutzerdetails für den spezifischen Datenbanktyp user_details können nur eines der folgenden sein:
sqlserverUserDetails

object (SqlServerUserDetails)

Union-Feld _dual_password_type.

Für _dual_password_type ist nur einer der folgenden Werte zulässig:
dualPasswordType

enum (DualPasswordType)

Status des doppelten Passworts für den Nutzer.

Union-Feld _iam_status.

Für _iam_status ist nur einer der folgenden Werte zulässig:
iamStatus

enum (IamStatus)

Gibt an, ob eine Gruppe für die IAM-Datenbankauthentifizierung aktiv oder inaktiv ist.

SqlServerUserDetails

JSON-Darstellung 
{
  "disabled": boolean,
  "serverRoles": [
    string
  ]
}
Felder
disabled

boolean

Wenn der Nutzer deaktiviert wurde
serverRoles[]

string

Die Serverrollen für diesen Nutzer

UserPasswordValidationPolicy

JSON-Darstellung 
{
  "allowedFailedAttempts": integer,
  "passwordExpirationDuration": string,
  "enableFailedAttemptsCheck": boolean,
  "status": {
    object (PasswordStatus)
  },
  "enablePasswordVerification": boolean
}
Felder
allowedFailedAttempts

integer

Anzahl der fehlgeschlagenen Anmeldeversuche, die zulässig sind, bevor der Nutzer gesperrt wird.
passwordExpirationDuration

string (Duration format)

Ablaufdauer nach der Aktualisierung des Passworts.

Die Dauer in Sekunden mit bis zu neun Nachkommastellen und am Ende mit „s“. Beispiel: "3.5s".
enableFailedAttemptsCheck

boolean

Bei „true“ wird die Prüfung auf fehlgeschlagene Anmeldeversuche aktiviert.
status

object (PasswordStatus)

Nur Ausgabe. Schreibgeschützter Passwortstatus.
enablePasswordVerification

boolean

Wenn „true“ festgelegt ist, muss der Nutzer das aktuelle Passwort angeben, bevor er das Passwort ändern kann. Dieses Flag wird nur für MySQL unterstützt.

Dauer

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

string (int64 format)

Signierte Sekunden des Zeitraums. Muss zwischen -315.576.000.000 und +315.576.000.000 (einschließlich) liegen. Hinweis: Diese Grenzen werden so berechnet: 60 Sek./Min. × 60 Min./Std. × 24 Std./Tag × 365,25 Tage/Jahr × 10.000 Jahre
nanos

integer

Signierte Sekundenbruchteile mit Nanosekunden-Auflösung für den Zeitraum. Dauern von weniger als einer Sekunde werden mit dem Feld „0“ seconds und einem positiven oder negativen Feld nanos dargestellt. Bei Zeiträumen von einer Sekunde oder mehr muss ein Wert ungleich null für das Feld nanos dasselbe Vorzeichen wie das Feld seconds haben. Muss zwischen -999.999.999 und +999.999.999 liegen (einschließlich).

PasswordStatus

JSON-Darstellung 
{
  "locked": boolean,
  "passwordExpirationTime": string
}
Felder
locked

boolean

Wenn „true“ festgelegt ist, hat der Nutzer keine Anmeldeberechtigungen.
passwordExpirationTime

string (Timestamp format)

Die Ablaufzeit des aktuellen Passworts.

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

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

Destruktiver Hinweis: ❌ | Idempotenter Hinweis: ❌ | Hinweis „Nur lesen“: ✅ | Hinweis „Offene Welt“: ❌