DsgUserGroupAddOrUpdate -

調試

您可以在OpenAPI Explorer中直接運行該介面，免去您計算簽名的困擾。運行成功後，OpenAPI Explorer可以自動產生SDK程式碼範例。

請求參數

名稱	類型	是否必選	樣本值	描述
Action	String	是	DsgUserGroupAddOrUpdate	系統規定參數。取值：DsgUserGroupAddOrUpdate。
UserGroups	Array	是		使用者組資訊。
Id	Long	否	123	使用者組ID。不配置該參數：表示當前操作為新增使用者組。配置該參數：表示編輯指定使用者組資訊。您可調用DsgUserGroupQueryList介面查詢使用者組ID。
Name	String	是	yun_group	使用者組名稱。
Owner	String	是	user1	使用者組的負責人。
Accounts	Array of String	是	user1	輸入使用者名稱或MaxCompute角色。該參數需基於UserGroupType參數的取值配置。
ProjectName	String	否	dev_project	MaxCompute專案名稱。建立MaxCompute使用者組時必須配置該參數。
UserGroupType	Integer	是	1	使用者群組類型。取值如下： 1：阿里雲使用者 2：RAM角色 3：MaxCompute角色

返回資料

名稱	類型	樣本值	描述
Success	Boolean	true	調用是否成功。取值如下： true：調用成功。 false：調用失敗。
ErrorCode	String	1029030003	錯誤碼。
ErrorMessage	String	param error	錯誤資訊。
HttpStatusCode	Integer	400	HTTP狀態代碼。
Data	Boolean	true	操作結果。取值如下： true：操作成功。 false：操作失敗。
RequestId	String	102400001	請求的ID。用於定位日誌，排查問題。

樣本

請求樣本

http(s)://[Endpoint]/?Action=DsgUserGroupAddOrUpdate
&UserGroups=[{"Id":123,"Name":"yun_group","Owner":"user1","Accounts":["user1"],"ProjectName":"dev_project","UserGroupType":1}]
&公用請求參數

正常返回樣本

XML格式

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

<DsgUserGroupAddOrUpdateResponse>
    <Success>true</Success>
    <ErrorCode>1029030003</ErrorCode>
    <ErrorMessage>param error</ErrorMessage>
    <HttpStatusCode>400</HttpStatusCode>
    <Data>true</Data>
    <RequestId>102400001</RequestId>
</DsgUserGroupAddOrUpdateResponse>

JSON格式

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

{
  "Success" : true,
  "ErrorCode" : "1029030003",
  "ErrorMessage" : "param error",
  "HttpStatusCode" : 400,
  "Data" : true,
  "RequestId" : "102400001"
}

錯誤碼

HttpCode	錯誤碼	錯誤資訊	描述
400	USERGROUP.ACCOUNTLISTSIZE.ERROR	The number of account exceeds the limit.	使用者數量超限。
400	USERGROUP.ID.ERROR	The user group ID does not match the tenant or does not exist.	使用者組ID不存在或不屬於該租戶。
400	USERGROUP.LISTSIZE.ERROR	The number of user groups exceeds the limit.	使用者組數量超限。
400	USERGROUP.PAGESIZE.ERROR	Page size is too large, maximum of 100.	頁大小超限，最大為100。
400	USERACCOUNT.OWNER.ERROR	User list or owner user does not exist.	使用者列表或負責人使用者不存在。
400	PARAMS.ERROR	param error.	參數錯誤。
403	PERMISSION.DENIED.ERROR	Permission denied	許可權不足。
500	UNKNOWN.ERROR	unknown error.	未知錯誤。

訪問錯誤中心查看更多錯誤碼。