{"base_path":null,"components":null,"consumes":"","definitions":{"ErrorMessage":{"description":"失败时返回的错误对象","properties":{"common_error_code":{"description":"CBC公共错误码","example":"CMM.1008","maxLength":36,"minLength":1,"type":"string"},"error_code":{"description":"错误码","example":"lakeformation.00010003","maxLength":36,"minLength":8,"type":"string"},"error_msg":{"description":"错误描述","example":"failed","maxLength":4096,"minLength":2,"type":"string"},"solution_msg":{"description":"解决方案描述","example":"Please use correct instance id.","maxLength":4096,"minLength":2,"type":"string"}},"required":["error_code","error_msg"],"type":"object"},"PagedInfo":{"description":"分页返回信息","properties":{"current_count":{"description":"本次返回的对象个数","format":"int32","maximum":2000,"minimum":0,"type":"integer"},"next_marker":{"description":"下一页查询地址","example":"006f492b-xxxx","maxLength":32,"type":"string"},"previous_marker":{"description":"上一页查询地址","example":"003e6eba-xxxx","maxLength":32,"type":"string"}},"required":["current_count","next_marker","previous_marker"],"type":"object"},"PagedListPrincipal":{"description":"principal分页信息","properties":{"page_info":{"$ref":"#/definitions/PagedInfo","description":"分页信息"},"principals":{"description":"主体列表","items":{"$ref":"#/definitions/Principal"},"maxItems":100000,"minItems":0,"type":"array"}},"title":"PagedListPrincipal","type":"object"},"Principal":{"properties":{"principal_name":{"description":"主体名","example":"user1","maxLength":49,"minLength":1,"pattern":"^[A-Za-z0-9_]+$","type":"string"},"principal_source":{"description":"主体来源\nIAM云用户\nSAML联邦\nLDAP ld用户\nLOCAL 本地用户","enum":["IAM","SAML","LDAP","LOCAL"],"example":"IAM","type":"string"},"principal_type":{"description":"主体类型\nUSER用户\nGROUP组\nROLE角色\nSHARE共享\nOTHER其它","enum":["USER","GROUP","ROLE","SHARE","OTHER"],"example":"USER","type":"string"}},"required":["principal_name","principal_source","principal_type"],"title":"Principal","type":"object"}},"description":null,"group_id":"bf0ce8340d8b4439b53683607ef0d87f","host":"lakeformation.cn-north-4.myhuaweicloud.com","id":"e04e019df9f040768e967f3a7e656f02","info_version":"v1","method":"get","name":"ListPrincipals","parameters":{},"paths":{"/v1/{project_id}/instances/{instance_id}/roles/{role_name}/principals":{"get":{"deprecated":false,"description":"查询角色下的用户/用户组","operationId":"ListPrincipals","parameters":[{"description":"租户token","in":"header","items":{"type":"string"},"maxItems":100,"minItems":1,"name":"X-Auth-Token","required":true,"type":"array"},{"description":"项目编号。获取方法,请参见[获取项目ID](lakeformation_04_0026.xml)。","in":"path","maxLength":64,"minLength":1,"name":"project_id","pattern":"^[a-z0-9]+$","required":true,"type":"string"},{"description":"LakeFormation实例ID。创建实例时自动生成。例如:2180518f-42b8-4947-b20b-adfc53981a25。","in":"path","name":"instance_id","pattern":"^[a-zA-Z0-9-]{36}$","required":true,"type":"string"},{"description":"模糊匹配主体名称。只能包含中文、字母、数字和_|*.-特殊字符,且长度为1~49个字符。","in":"query","maxLength":49,"minLength":1,"name":"principal_pattern","pattern":"^[a-zA-Z0-9\\u4e00-\\u9fa5_\\-.|*.]*$","required":false,"type":"string"},{"default":100,"description":"查询返回条数。默认值为100。最小值为1,最大值为1000。","format":"int32","in":"query","maximum":1000,"minimum":1,"name":"limit","required":false,"type":"integer"},{"default":"","description":"查询的起始记录ID。最小长度为0,最大长度为1024。","in":"query","maxLength":1024,"minLength":0,"name":"marker","required":false,"type":"string"},{"default":false,"description":"是否查询上一页。默认为false。","in":"query","name":"reverse_page","required":false,"type":"boolean","x-annotations":["@UsNoConstraint(reason = \"Boolean类型无需校验\")"],"x-imports":["com.huawei.us.validator.annotation.UsNoConstraint;"]},{"description":"角色名称。只能包含字母、数字和下划线,且长度为1~255个字符。","in":"path","maxLength":255,"minLength":1,"name":"role_name","pattern":"^[a-zA-Z_0-9]+$","required":true,"type":"string"}],"produces":["application/json;charset=UTF-8"],"responses":{"200":{"description":"OK","examples":{"application/json":{"page_info":{"current_count":2000,"next_marker":"006f492b-xxxx","previous_marker":"003e6eba-xxxx"},"principals":[{"principal_name":"user1","principal_source":"IAM","principal_type":"USER"}]}},"schema":{"$ref":"#/definitions/PagedListPrincipal"}},"400":{"description":"Bad Request","examples":{"application/json":{"error_code":"common.01000001","error_msg":"failed to read http request, please check your input, code: 400, reason: Type mismatch., cause: TypeMismatchException"}},"schema":{"$ref":"#/definitions/ErrorMessage"}},"401":{"description":"Unauthorized","examples":{"application/json":"{\n  \"error_code\": 'APIG.1002',\n  \"error_msg\": 'Incorrect token or token resolution failed'\n}"}},"403":{"description":"Forbidden","examples":{"application/json":{"error":{"code":"403","error_code":null,"error_msg":null,"message":"X-Auth-Token is invalid in the request","title":"Forbidden"},"error_code":"403","error_msg":"X-Auth-Token is invalid in the request","title":"Forbidden"}}},"404":{"description":"Not Found","examples":{"application/json":{"error_code":"common.01000001","error_msg":"response status exception, code: 404"}},"schema":{"$ref":"#/definitions/ErrorMessage"}},"408":{"description":"Request Timeout","examples":{"application/json":{"error_code":"common.00000408","error_msg":"timeout exception occurred"}}},"500":{"description":"Internal Server Error","examples":{"application/json":{"error_code":"common.00000500","error_msg":"internal error"}},"schema":{"$ref":"#/definitions/ErrorMessage"}}},"summary":"查询角色下的用户/用户组","tags":["Role"],"x-apiexplorer-hide":"N","x-enable-auth-anno":{"type":"iam-token"},"x-iam-auth-meta-anno":{"abacAction":"lakeformation:role:describe","authLevel":"instance"},"x-is-registered":"Y","x-method-annotations":["@ApiCount"],"x-request-examples-url-1":"GET https://{endpoint}/v1/{project_id}/instances/{instance_id}/roles/{role_name}/principals","x-support-sdk":"Y"}}},"product_short":"LakeFormation","region_id":"cn-north-4","schemes":["HTTPS"],"security_definitions":null,"summary":"查询角色下的用户/用户组","tags":"角色管理","uri":null,"version":"2.0"}