MCP Tools Reference: cloud-sql

Strumento: list_users

Elenca tutti gli utenti del database per un'istanza Cloud SQL.

Il seguente esempio mostra come utilizzare curl per richiamare lo strumento MCP list_users.

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

Schema di input

SqlUsersListRequest

Rappresentazione JSON 
{
  "instance": string,
  "project": string
}
Campi
instance

string

ID istanza database. L'ID progetto non è incluso.
project

string

ID progetto del progetto che contiene l'istanza.

Schema di output

Risposta dell'elenco utenti.

UsersListResponse

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

string

Questo valore è sempre sql#usersList.
items[]

object (User)

Elenco delle risorse utente nell'istanza.
nextPageToken
(deprecated)

string

Non utilizzata.

Utente

Rappresentazione 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.
}
Campi
kind

string

Questo valore è sempre sql#user.
password

string

La password dell'utente.
etag

string

Questo campo è deprecato e verrà rimosso da una versione futura dell'API.
name

string

Il nome dell'utente nell'istanza Cloud SQL. Può essere omesso per update perché è già specificato nell'URL.
host

string

Facoltativo. L'host da cui l'utente può connettersi. Per le operazioni insert, l'host è impostato per impostazione predefinita su una stringa vuota. Per le operazioni update, l'host viene specificato come parte dell'URL della richiesta. Il nome host non può essere aggiornato dopo l'inserimento. È obbligatorio per un'istanza MySQL, mentre è facoltativo per un'istanza PostgreSQL o SQL Server.
instance

string

Il nome dell'istanza Cloud SQL. L'ID progetto non è incluso. Può essere omesso per update perché è già specificato nell'URL.
project

string

L'ID progetto del progetto contenente il database Cloud SQL. Il dominio delle app Google ha un prefisso, se applicabile. Può essere omesso per update perché è già specificato nell'URL.
type

enum (SqlUserType)

Il tipo di utente. Determina il metodo per autenticare l'utente durante l'accesso. Il valore predefinito è il tipo di utente integrato del database.
iamEmail

string

Facoltativo. L'email completa di un utente IAM. Per gli utenti normali del database, questo campo non verrà compilato. Applicabile solo agli utenti del database MySQL.
passwordPolicy

object (UserPasswordValidationPolicy)

Policy di convalida delle password a livello di utente.
databaseRoles[]

string

Facoltativo. Appartenenze ai ruoli dell'utente
Campo unione user_details. I dettagli utente per il tipo di database specifico user_details possono essere solo uno dei seguenti:
sqlserverUserDetails

object (SqlServerUserDetails)

Campo unione _dual_password_type.

_dual_password_type può essere solo uno dei seguenti tipi:
dualPasswordType

enum (DualPasswordType)

Stato della doppia password per l'utente.

Campo unione _iam_status.

_iam_status può essere solo uno dei seguenti tipi:
iamStatus

enum (IamStatus)

Indica se un gruppo è attivo o inattivo per l'autenticazione database IAM.

SqlServerUserDetails

Rappresentazione JSON 
{
  "disabled": boolean,
  "serverRoles": [
    string
  ]
}
Campi
disabled

boolean

Se l'utente è stato disattivato
serverRoles[]

string

I ruoli del server per questo utente

UserPasswordValidationPolicy

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

integer

Numero di tentativi di accesso non riusciti consentiti prima del blocco dell'utente.
passwordExpirationDuration

string (Duration format)

Durata della scadenza dopo l'aggiornamento della password.

Una durata in secondi con un massimo di nove cifre frazionarie, che termina con "s". Esempio: "3.5s".
enableFailedAttemptsCheck

boolean

Se è vero, il controllo dei tentativi di accesso non riusciti verrà attivato.
status

object (PasswordStatus)

Solo output. Stato della password di sola lettura.
enablePasswordVerification

boolean

Se è true, l'utente deve specificare la password attuale prima di cambiarla. Questo flag è supportato solo per MySQL.

Durata

Rappresentazione JSON 
{
  "seconds": string,
  "nanos": integer
}
Campi
seconds

string (int64 format)

Secondi firmati dell'intervallo di tempo. Deve essere compreso tra -315.576.000.000 e +315.576.000.000 inclusi. Nota: questi limiti vengono calcolati in base a: 60 sec/min * 60 min/ora * 24 ore/giorno * 365,25 giorni/anno * 10.000 anni
nanos

integer

Frazioni di secondo con segno con risoluzione in nanosecondi dell'intervallo di tempo. Le durate inferiori a un secondo sono rappresentate con un campo seconds pari a 0 e un campo nanos positivo o negativo. Per durate di un secondo o più, un valore diverso da zero per il campo nanos deve avere lo stesso segno del campo seconds. Deve essere compreso tra -999.999.999 e +999.999.999 inclusi.

PasswordStatus

Rappresentazione JSON 
{
  "locked": boolean,
  "passwordExpirationTime": string
}
Campi
locked

boolean

Se il valore è true, l'utente non dispone dei privilegi di accesso.
passwordExpirationTime

string (Timestamp format)

Il tempo per la scadenza della password attuale.

Utilizza RFC 3339, in cui l'output generato è sempre con normalizzazione Z e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".

Timestamp

Rappresentazione JSON 
{
  "seconds": string,
  "nanos": integer
}
Campi
seconds

string (int64 format)

Rappresenta i secondi di tempo UTC dall'epoca di Unix 1970-01-01T00:00:00Z. Deve essere compreso tra -62135596800 e 253402300799 inclusi (corrispondenti a 0001-01-01T00:00:00Z e 9999-12-31T23:59:59Z).
nanos

integer

Frazioni di secondo non negative con risoluzione in nanosecondi. Questo campo è la parte in nanosecondi della durata, non un'alternativa ai secondi. I valori negativi dei secondi con frazioni devono comunque avere valori di nanosecondi non negativi che vengono conteggiati in avanti nel tempo. Deve essere compreso tra 0 e 999.999.999 inclusi.

Annotazioni dello strumento

Suggerimento distruttivo: ❌ | Suggerimento idempotente: ❌ | Suggerimento di sola lettura: ✅ | Suggerimento open world: ❌