ListUsers - - Alibaba Cloud Dokümantasyon Merkezi

Kullanıcıların ayrıntılarını sorgular.

Try it now

Try this API in OpenAPI Explorer, no manual signing needed. Successful calls auto-generate SDK code matching your parameters. Download it with built-in credential security for local usage.

Test

RAM authorization

The table below describes the authorization required to call this API. You can define it in a Resource Access Management (RAM) policy. The table's columns are detailed below:

Action: The actions can be used in the Action element of RAM permission policy statements to grant permissions to perform the operation.
API: The API that you can call to perform the action.
Access level: The predefined level of access granted for each API. Valid values: create, list, get, update, and delete.
Resource type: The type of the resource that supports authorization to perform the action. It indicates if the action supports resource-level permission. The specified resource must be compatible with the action. Otherwise, the policy will be ineffective.
- For APIs with resource-level permissions, required resource types are marked with an asterisk (*). Specify the corresponding Alibaba Cloud Resource Name (ARN) in the Resource element of the policy.
- For APIs without resource-level permissions, it is shown as All Resources. Use an asterisk (*) in the Resource element of the policy.
Condition key: The condition keys defined by the service. The key allows for granular control, applying to either actions alone or actions associated with specific resources. In addition to service-specific condition keys, Alibaba Cloud provides a set of common condition keys applicable across all RAM-supported services.
Dependent action: The dependent actions required to run the action. To complete the action, the RAM user or the RAM role must have the permissions to perform all dependent actions.

Action

Access level

Resource type

Condition key

Dependent action

dms:ListUsers

list

*All Resource

*

None

Request parameters

Parameter	Type	Required	Description	Example
Tid	integer	No	Kiracının kimliği. Kiracı kimliğini almak için GetUserActiveTenant işlemini çağırabilirsiniz.	3***
Role	string	No	Kullanıcıya atanan rol. Geçerli değerler: USER: normal kullanıcı. DBA : veritabanı yöneticisi (DBA). ADMIN: Veri Yönetimi (DMS) yöneticisi. SECURITY_ADMIN: güvenlik yöneticisi. STRUCT_READ_ONLY: şema salt okunur kullanıcı. Not Rolünüzü kontrol etmek için DMS konsolunun sağ üst köşesindeki profil resminin üzerine gelin.	DBA
UserState	string	No	Kullanıcının durumu. Geçerli değerler: NORMAL: Kullanıcı normal durumda. DISABLE: Kullanıcı devre dışı bırakılmış. DELETE: Kullanıcı silinmiş.	NORMAL
SearchKey	string	No	Arama anahtar kelimesi. Bulanık eşleştirme desteklenir.	test
PageNumber	integer	No	Döndürülecek sayfanın numarası.	1
PageSize	integer	No	Her sayfada döndürülecek giriş sayısı. Geçerli değerler: 10, 20, 50 ve 100.** Varsayılan değer: 10.	10

Response elements

Element	Type	Description	Example
	object
TotalCount	integer	Döndürülen toplam giriş sayısı.	3
RequestId	string	İsteğin kimliği.	69161997-6030-53BA-A333-DBEC83B732FF
ErrorCode	string	İstek başarısız olduğunda döndürülen hata kodu.	InvalidTid
ErrorMessage	string	İstek başarısız olduğunda döndürülen hata mesajı.	Specified parameter Tid is not valid.
UserList	object
User	array<object>	Kullanıcıların ayrıntıları.
	array<object>	Kullanıcının ayrıntıları.
State	string	Kullanıcının durumu. Geçerli değerler: NORMAL: Kullanıcı normal durumda. DISABLE: Kullanıcı devre dışı bırakılmış. DELETE: Kullanıcı silinmiş.	NORMAL
CurResultCount	integer	Cari günde sorgulanan satır sayısı.	0
UserId	string	Kullanıcının kimliği.	8****
LastLoginTime	string	Kullanıcının konsolda en son oturum açtığı zaman.	2021-11-08 13:43:43
MaxResultCount	integer	Cari günde sorgulanabilecek maksimum satır sayısı.	50000
ParentUid	string	Kullanıcının Alibaba Cloud hesabının kimliği.	140692647406****
RoleIdList	object
RoleIds	array	Rollerin kimlikleri.
	integer	Kullanıcıya atanan rolün kimliği. Geçerli değerler: 1: normal kullanıcı rolü. 2: DBA rolü. 3: DMS yöneticisi rolü. 4: güvenlik yöneticisi rolü. 6: şema salt okunur kullanıcı rolü.	3
RoleNameList	object
RoleNames	array	Rollerin adları.
	string	Kullanıcıya atanan rolün adı. Geçerli değerler: USER: normal kullanıcı. DBA : DBA. ADMIN: DMS yöneticisi. SECURITY_ADMIN: güvenlik yöneticisi. STRUCT_READ_ONLY: şema salt okunur kullanıcı.	ADMIN
NickName	string	Kullanıcının takma adı.	test_NickName
MaxExecuteCount	integer	Cari günde gerçekleştirilebilecek maksimum sorgu sayısı.	2000
CurExecuteCount	integer	Cari günde gerçekleştirilen sorgu sayısı.	0
Mobile	string	Kullanıcının cep telefonu numarası. Not Konsolda bir cep telefonu numarası ayarladıysanız sistem bu parametreyi döndürür. Konsolda cep telefonu numarası ayarlamak için sağ üst köşedeki profil resminin üzerine gelin ve Bildirim yanındaki Düzenle simgesine tıklayın. Bir cep telefonu numarası ayarlamadıysanız sistem bu parametreyi döndürmez.	1389999****
Uid	string	Alibaba Cloud hesabının kimliği.	167382665015****
Email	string	Bildirimleri almak için kullanılan e-posta adresi. Not Konsolda bir e-posta adresi ayarladıysanız sistem bu parametreyi döndürür. Konsolda e-posta adresi ayarlamak için sağ üst köşedeki profil resminin üzerine gelin ve Bildirim yanındaki Düzenle simgesine tıklayın. Bir e-posta adresi ayarlamadıysanız sistem bu parametreyi döndürmez.	username@example.com
DingRobot	string	Bildirimleri almak için kullanılan DingTalk sohbet robotu URL'si. Not Konsolda bir DingTalk sohbet robotu URL'si ayarladıysanız sistem bu parametreyi döndürür. Konsolda DingTalk sohbet robotu URL'si ayarlamak için sağ üst köşedeki profil resminin üzerine gelin ve Bildirim yanındaki Düzenle simgesine tıklayın. Bir DingTalk sohbet robotu URL'si ayarlamadıysanız sistem bu parametreyi döndürmez.	https://XXX.dingtalk.com/robot/send?access_token=9b7a4a562cbe7fcdea9962afac7b9d7b4504d564948083419750f9cafa78e4ef
Webhook	string	Bildirimleri almak için kullanılan webhook URL'si. Not Bir webhook URL'si ayarladıysanız DMS bildirimleri belirtilen URL'ye gönderir. Bir webhook URL'si ayarlamadıysanız sistem bu parametreyi döndürmez.	http://dms-XXX.aliyun.com:8***
SignatureMethod	string	Webhook URL'si kullanıldığında bağlantıları güvenceye almak için kullanılan imza yöntemi. Geçerli değerler: NONE: imza yok. HMAC_SHA1: HMAC_SHA1.	HMAC_SHA1
NotificationMode	string	Bildirim yöntemi. Sistem bir veya daha fazla değer döndürür. Geçerli değerler: SMS: metin mesajı EMAIL: e-posta. DINGDING: DingTalk. DINGROBOT: DingTalk sohbet robotu. WEBHOOK: webhook.	DINGROBOT
Success	boolean	İsteğin başarılı olup olmadığını gösterir. Geçerli değerler: true: İstek başarılı. false: İstek başarısız.	true

Examples

Success response

JSON format

{
  "TotalCount": 3,
  "RequestId": "69161997-6030-53BA-A333-DBEC83B732FF",
  "ErrorCode": "InvalidTid",
  "ErrorMessage": "Specified parameter Tid is not valid.",
  "UserList": {
    "User": [
      {
        "State": "NORMAL",
        "CurResultCount": 0,
        "UserId": "8****",
        "LastLoginTime": "2021-11-08 13:43:43",
        "MaxResultCount": 50000,
        "ParentUid": "140692647406****",
        "RoleIdList": {
          "RoleIds": [
            3
          ]
        },
        "RoleNameList": {
          "RoleNames": [
            "ADMIN"
          ]
        },
        "NickName": "test_NickName",
        "MaxExecuteCount": 2000,
        "CurExecuteCount": 0,
        "Mobile": "1389999****",
        "Uid": "167382665015****",
        "Email": "username@example.com",
        "DingRobot": "https://XXX.dingtalk.com/robot/send?access_token=9b7a4a562cbe7fcdea9962afac7b9d7b4504d564948083419750f9cafa78e4ef",
        "Webhook": "http://dms-XXX.aliyun.com:8***",
        "SignatureMethod": "HMAC_SHA1",
        "NotificationMode": "DINGROBOT"
      }
    ]
  },
  "Success": true
}

Error codes

See Error Codes for a complete list.

Release notes

See Release Notes for a complete list.