Method list

Статья создана

Yandex Cloud

улучшена

amatol

HTTP request
Path parameters
Query parameters
Response

Retrieves the list of users in a cluster.

HTTP request

GET https://mdb.api.cloud.yandex.net/managed-mysql/v1/clusters/{clusterId}/users

Path parameters

Parameter	Description
clusterId	Required. ID of the cluster to list the users in. To get this ID, make a list request. The maximum string length in characters is 50.

Query parameters

Parameter	Description
pageSize	The maximum number of results per page to return. If the number of available results is larger than pageSize, the API returns a nextPageToken that can be used to get the next page of results in the subsequent list requests. Acceptable values are 0 to 1000, inclusive.
pageToken	Page token that can be used to iterate through multiple pages of results. To get the next page of results, set pageToken to the nextPageToken returned by the previous list request. The maximum string length in characters is 100.

Response

HTTP Code: 200 - OK

{
  "users": [
    {
      "name": "string",
      "clusterId": "string",
      "permissions": [
        {
          "databaseName": "string",
          "roles": [
            "string"
          ]
        }
      ],
      "globalPermissions": [
        "string"
      ],
      "connectionLimits": {
        "maxQuestionsPerHour": "integer",
        "maxUpdatesPerHour": "integer",
        "maxConnectionsPerHour": "integer",
        "maxUserConnections": "integer"
      },
      "authenticationPlugin": "string"
    }
  ],
  "nextPageToken": "string"
}

Field	Description
users[]	object An object that represents MySQL user. See the documentation for details.
users[]. name	string Name of the user.
users[]. clusterId	string ID of the cluster the user belongs to.
users[]. permissions[]	object Set of permissions granted to the user.
users[]. permissions[]. databaseName	string Name of the database that the permission grants access to.
users[]. permissions[]. roles[]	string ALL_PRIVILEGES: All privileges that can be made available to the user. ALTER: Altering tables. ALTER_ROUTINE: Altering stored routines and functions. CREATE: Creating tables or indexes. CREATE_ROUTINE: Creating stored routines. CREATE_TEMPORARY_TABLES: Creating temporary tables. CREATE_VIEW: Creating views. DELETE: Deleting tables. DROP: Removing tables or views. EVENT: Creating, altering, dropping, or displaying events for the Event Scheduler. EXECUTE: Executing stored routines. INDEX: Creating and removing indexes. INSERT: Inserting rows into the database. LOCK_TABLES: Using `LOCK TABLES` statement for tables available with `SELECT` privilege. SELECT: Selecting rows from tables. Some `SELECT` statements can be allowed without the `SELECT` privilege. All statements that read column values require the `SELECT` privilege. See MySQL documentation for details. SHOW_VIEW: Using the `SHOW CREATE VIEW` statement. Also needed for views used with `EXPLAIN`. TRIGGER: Creating, removing, executing, or displaying triggers for a table. UPDATE: Updating rows in the database. REFERENCES: Creation of a foreign key constraint for the parent table.
users[]. globalPermissions[]	string REPLICATION_CLIENT: Enables use of the `SHOW MASTER STATUS`, `SHOW SLAVE STATUS`, and `SHOW BINARY LOGS` statements. REPLICATION_SLAVE: Enables the account to request updates that have been made to databases on the master server, using the `SHOW SLAVE HOSTS`, `SHOW RELAYLOG EVENTS` and `SHOW BINLOG EVENTS` statements. PROCESS: Enables display of information about the the statements currently being performed by sessions (the set of threads executing within the server). The privilege enables use of `SHOW PROCESSLIST` or `mysqladmin` processlist to see threads belonging to other users. You can always see your own threads. The `PROCESS` privilege also enables use of `SHOW ENGINE`.
users[]. connectionLimits	object Set of user connection limits.
users[]. connectionLimits. maxQuestionsPerHour	integer (int64) The maximum permitted number of user questions per hour. The minimum value is 0.
users[]. connectionLimits. maxUpdatesPerHour	integer (int64) The maximum permitted number of user updates per hour. The minimum value is 0.
users[]. connectionLimits. maxConnectionsPerHour	integer (int64) The maximum permitted number of simultaneous client connections per hour. The minimum value is 0.
users[]. connectionLimits. maxUserConnections	integer (int64) The maximum number of simultaneous connections permitted to any given MySQL user account. The minimum value is 0.
users[]. authenticationPlugin	string User authentication plugin. MYSQL_NATIVE_PASSWORD: Use Native Pluggable Authentication. CACHING_SHA2_PASSWORD: Use Caching SHA-2 Pluggable Authentication. SHA256_PASSWORD: Use SHA-256 Pluggable Authentication.
nextPageToken	string The token that can be used to get the next page of results. If the number of results is larger than pageSize, use the nextPageToken as the value for the pageToken in the subsequent list request to iterate through multiple pages of results. Each of the subsequent list requests should use the nextPageToken value returned by the previous request to continue paging through the results.

Method list

HTTP request

Path parameters

Query parameters

Response

Была ли статья полезна?