ListUsers - - Alibaba Cloud Dokümantasyon Merkezi

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

Hata Ayıklama

OpenAPI Explorer imza değerini otomatik olarak hesaplar. Kolaylık sağlaması açısından bu işlemi OpenAPI Explorer içinde çağırmanızı öneririz. OpenAPI Explorer, farklı SDK'ler için örnek kodu dinamik olarak oluşturur.

İstek parametreleri

Parametre	Tür	Gerekli	Örnek	Açıklama
Action	String	Evet	ListUsers	Gerçekleştirmek istediğiniz işlem. Değeri ListUsers olarak ayarlayın.
Tid	Long	Evet	3***	Kiracının ID'si. Kiracının ID'sini sorgulamak için GetUserActiveTenant işlemini çağırabilirsiniz.
Role	String	Hayır	DBA	Kullanıcıya atanan rol. Geçerli değerler: USER: normal kullanıcı rolü. DBA: veritabanı yöneticisi (DBA) rolü. ADMIN: Data Management (DMS) yönetici rolü. SECURITY_ADMIN: güvenlik yöneticisi rolü. STRUCT_READ_ONLY: şema salt okunur kullanıcı rolü. Not Rolünüzü kontrol etmek için DMS konsolunun sağ üst köşesindeki profil resminin üzerine gelin.
UserState	String	Hayır	NORMAL	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ş.
SearchKey	String	Hayır	test	Arama anahtar kelimesi. Bulanık eşleştirme desteklenir.
PageNumber	Integer	Hayır	1	Döndürülecek sayfanın numarası.
PageSize	Integer	Hayır	10	Her sayfada döndürülecek kayıt sayısı. Not Geçerli değerler: 10, 20, 50 ve 100. Varsayılan değer: 10.

Yanıt parametreleri

Parametre	Tür	Örnek	Açıklama
TotalCount	Long	3	Döndürülen toplam kayıt sayısı.
RequestId	String	67E910F2-4B62-5B0C-ACA3-7547695C****	İsteğin ID'si.
ErrorCode	String	InvalidTid	Döndürülen hata kodu.
ErrorMessage	String	Specified parameter Tid is not valid.	Döndürülen hata mesajı.
UserList	Array of User		Kullanıcıların ayrıntıları.
User
State	String	NORMAL	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ş.
CurResultCount	Long	0	Bugün sorgulanan satır sayısı.
UserId	String	8****	Kullanıcının ID'si.
LastLoginTime	String	2021-11-08 13:43:43	Kullanıcının konsola en son giriş yaptığı zaman.
MaxResultCount	Long	50000	Bugün sorgulanabilecek maksimum satır sayısı.
ParentUid	String	140692647406****	Kullanıcının Alibaba Cloud hesabının UID'si.
RoleIdList	Array of Integer	3	Kullanıcıya atanan rolün ID'si. Geçerli değerler: 1: normal kullanıcı rolü. 2: DBA rolü. 3: DMS yönetici rolü. 4: güvenlik yöneticisi rolü. 6: şema salt okunur kullanıcı rolü.
RoleNameList	Array of String	ADMIN	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ı.
NickName	String	test_NickName	Kullanıcının takma adı.
MaxExecuteCount	Long	2000	Bugün çalıştırılabilecek maksimum sorgu sayısı.
CurExecuteCount	Long	0	Bugün çalıştırılan sorgu sayısı.
Mobile	String	1389999****	Bildirim almak için kullanılan cep telefonu numarası. Not Kullanıcı konsolda bir cep telefonu numarası ayarlamışsa sistem bu parametreyi döndürür. Konsolda bir cep telefonu numarası ayarlamak için sağ üst köşedeki profil resminin üzerine gelin ve Notice yanındaki Düzenle simgesini tıklayın. Kullanıcı bir cep telefonu numarası ayarlamamışsa sistem bu parametreyi döndürmez.
Uid	String	167382665015****	Kullanıcının UID'si.
Email	String	username@example.com	Bildirim almak için kullanılan e-posta adresi. Not Kullanıcı konsolda bir e-posta adresi ayarlamışsa sistem bu parametreyi döndürür. Konsolda bir e-posta adresi ayarlamak için sağ üst köşedeki profil resminin üzerine gelin ve Notice yanındaki Düzenle simgesini tıklayın. Kullanıcı bir e-posta adresi ayarlamamışsa sistem bu parametreyi döndürmez.
DingRobot	String	https://XXX.dingtalk.com/robot/send?access_token=9b7a4a562cbe7fcdea9962afac7b9d7b4504d564948083419750f9cafa78e4ef	Bildirim almak için kullanılan DingTalk sohbet botu URL'si. Not Kullanıcı konsolda bir DingTalk sohbet botu URL'si ayarlamışsa sistem bu parametreyi döndürür. Konsolda bir DingTalk sohbet botu URL'si ayarlamak için sağ üst köşedeki profil resminin üzerine gelin ve Notice yanındaki Düzenle simgesini tıklayın. Kullanıcı bir DingTalk sohbet botu URL'si ayarlamamışsa sistem bu parametreyi döndürmez.
Webhook	String	http://dms-XXX.aliyun.com:8***	Bildirim almak için kullanılan Webhook URL'si. Not Kullanıcı bir Webhook URL'si ayarladıysa DMS bildirimleri belirtilen URL'ye gönderir. Kullanıcı bir Webhook URL'si ayarlamamışsa sistem bu parametreyi döndürmez.
SignatureMethod	String	HMAC_SHA1	Bir Webhook URL'si kullanılırken bağlantıları güvence altına almak için kullanılan imzalama yöntemi. Geçerli değerler: NONE: imza yok. HMAC_SHA1: HMAC-SHA1.
NotificationMode	String	DINGROBOT	Bildirim yöntemi. Sistem bir veya daha fazla değer döndürür. Geçerli değerler: SMS: kısa mesaj. EMAIL: e-posta. DingTalk: DingTalk. DINGROBOT: DingTalk sohbet botu. WEBHOOK: webhook.
Success	Boolean	true	İsteğin başarılı olup olmadığını gösterir. Geçerli değerler: true: İstek başarılı oldu. false: İstek başarısız oldu.

Örnekler

Örnek istekler

http(s)://dms-enterprise.aliyuncs.com/?Action=ListUsers
&Tid=3***
&Role=DBA
&UserState=NORMAL
&SearchKey=test
&PageNumber=1
&PageSize=10
&<Common request parameters>

Örnek başarılı yanıt

XML biçimi

HTTP/1.1 200 OK
Content-Type:application/xml

<ListUsersResponse>
    <TotalCount>3</TotalCount>
    <RequestId>67E910F2-4B62-5B0C-ACA3-7547695C****</RequestId>
    <UserList>
        <User>
            <Email>test1_email</Email>
            <RoleNameList>
                <RoleNames>DBA</RoleNames>
            </RoleNameList>
            <NickName>Ms. Wang</NickName>
            <MaxExecuteCount>2000</MaxExecuteCount>
            <CurResultCount>0</CurResultCount>
            <LastLoginTime>2021-10-22 17:02:19</LastLoginTime>
            <Uid>23236106758310****</Uid>
            <RoleIdList>
                <RoleIds>2</RoleIds>
            </RoleIdList>
            <MaxResultCount>10000</MaxResultCount>
            <State>NORMAL</State>
            <UserId>13****</UserId>
            <CurExecuteCount>1</CurExecuteCount>
            <ParentUid>140692647406****</ParentUid>
        </User>
        <User>
            <Email>test2_email</Email>
            <RoleNameList>
                <RoleNames>ADMIN</RoleNames>
                <RoleNames>USER</RoleNames>
                <RoleNames>SECURITY_ADMIN</RoleNames>
                <RoleNames>DBA</RoleNames>
                <RoleNames>SUPPORT</RoleNames>
            </RoleNameList>
            <NickName>Mr. Wang</NickName>
            <MaxExecuteCount>2000</MaxExecuteCount>
            <CurResultCount>400</CurResultCount>
            <LastLoginTime>2021-09-16 10:19:58</LastLoginTime>
            <Uid>26984203785603****</Uid>
            <RoleIdList>
                <RoleIds>3</RoleIds>
                <RoleIds>1</RoleIds>
                <RoleIds>4</RoleIds>
                <RoleIds>2</RoleIds>
                <RoleIds>5</RoleIds>
            </RoleIdList>
            <MaxResultCount>10000</MaxResultCount>
            <State>NORMAL</State>
            <UserId>12****</UserId>
            <CurExecuteCount>5</CurExecuteCount>
            <ParentUid>140692647406****</ParentUid>
        </User>
        <User>
            <NotificationMode>DINGROBOT</NotificationMode>
            <Email>username@example.com</Email>
            <RoleNameList>
                <RoleNames>ADMIN</RoleNames>
                <RoleNames>USER</RoleNames>
                <RoleNames>SECURITY_ADMIN</RoleNames>
                <RoleNames>DBA</RoleNames>
                <RoleNames>STRUCT_READ_ONLY</RoleNames>
            </RoleNameList>
            <NickName>test_NickName</NickName>
            <MaxExecuteCount>2000</MaxExecuteCount>
            <CurResultCount>0</CurResultCount>
            <LastLoginTime>2021-11-08 13:43:43</LastLoginTime>
            <Uid>167382665015****</Uid>
            <RoleIdList>
                <RoleIds>3</RoleIds>
                <RoleIds>1</RoleIds>
                <RoleIds>4</RoleIds>
                <RoleIds>2</RoleIds>
                <RoleIds>6</RoleIds>
            </RoleIdList>
            <MaxResultCount>50000</MaxResultCount>
            <State>NORMAL</State>
            <UserId>8****</UserId>
            <CurExecuteCount>0</CurExecuteCount>
            <Webhook>http://****.aliyun.com:8080</Webhook>
            <SignatureMethod>HMAC_SHA1</SignatureMethod>
            <DingRobot>https://****.dingtalk.com/robot/send?access_token=9b7a4a562cbe7fcdea9962afac7b9d7b4504d564948083419750f9cafa78****</DingRobot>
        </User>
    </UserList>
    <Success>true</Success>
</ListUsersResponse>

JSON biçimi

HTTP/1.1 200 OK
Content-Type:application/json

{
  "TotalCount" : 3,
  "RequestId" : "67E910F2-4B62-5B0C-ACA3-7547695C****",
  "UserList" : {
    "User" : [ {
      "Email" : "test1_email",
      "RoleNameList" : {
        "RoleNames" : [ "DBA" ]
      },
      "NickName" : "Ms. Wang",
      "MaxExecuteCount" : 2000,
      "CurResultCount" : 0,
      "LastLoginTime" : "2021-10-22 17:02:19",
      "Uid" : "23236106758310****",
      "RoleIdList" : {
        "RoleIds" : [ 2 ]
      },
      "MaxResultCount" : 10000,
      "State" : "NORMAL",
      "UserId" : "13****",
      "CurExecuteCount" : 1,
      "ParentUid" : "140692647406****"
    }, {
      "Email" : "test2_email",
      "RoleNameList" : {
        "RoleNames" : [ "ADMIN", "USER", "SECURITY_ADMIN", "DBA", "SUPPORT" ]
      },
      "NickName" : "Mr. Wang",
      "MaxExecuteCount" : 2000,
      "CurResultCount" : 400,
      "LastLoginTime" : "2021-09-16 10:19:58",
      "Uid" : "26984203785603****",
      "RoleIdList" : {
        "RoleIds" : [ 3, 1, 4, 2, 5 ]
      },
      "MaxResultCount" : 10000,
      "State" : "NORMAL",
      "UserId" : "12****",
      "CurExecuteCount" : 5,
      "ParentUid" : "140692647406****"
    }, {
      "NotificationMode" : "DINGROBOT",
      "Email" : "username@example.com",
      "RoleNameList" : {
        "RoleNames" : [ "ADMIN", "USER", "SECURITY_ADMIN", "DBA", "STRUCT_READ_ONLY" ]
      },
      "NickName" : "test_NickName",
      "MaxExecuteCount" : 2000,
      "CurResultCount" : 0,
      "LastLoginTime" : "2021-11-08 13:43:43",
      "Uid" : "167382665015****",
      "RoleIdList" : {
        "RoleIds" : [ 3, 1, 4, 2, 6 ]
      },
      "MaxResultCount" : 50000,
      "State" : "NORMAL",
      "UserId" : "8****",
      "CurExecuteCount" : 0,
      "Webhook" : "http://****.aliyun.com:8080",
      "SignatureMethod" : "HMAC_SHA1",
      "DingRobot" : "https://****.dingtalk.com/robot/send?access_token=9b7a4a562cbe7fcdea9962afac7b9d7b4504d564948083419750f9cafa78****"
    } ]
  },
  "Success" : true
}

Hata kodları

Hata kodlarının listesi için API Hata Merkezi adresini ziyaret edin.