EditControlGroup
This interface is used to modify the information of a specified ControlGroup, including the name, domain list, and account list of the ControlGroup. Users can choose to update by either overwriting or appending as needed. For custom-type ControlGroups, users can modify their name and domain list, while client-type and contract-type ControlGroups do not allow such modifications. Additionally, users can specify a list of accounts with access permissions for the ControlGroup. This interface facilitates flexible management of ControlGroup configuration, allowing users to control access permissions and applicability by adjusting these settings, thereby better serving business needs.
- 데이터 지연: 5-15 minutes
- 단일 사용자 통화 빈도: 30/5min
- 해당 상품(제품): IAM
요청 파라미터
Path 파라미터
| 파라미터 이름 | 설명 |
|---|---|
*ControlGroupCodeString | Control Group Code, Can be obtained through the API interface [QueryControlGroupList] |
Body 파라미터
| 파라미터 이름 | 설명 |
|---|---|
controlGroupNameString | Control Group name, which only the User Customized type Control Group can be modified, customer type Control Group and product type Control Group can not be modified. User Customized type Control Group keeps the original Control Group name if no value is passed |
accountListList | Account object array,Used to specify accounts with permission. all types of Control Group can be modified, if no value is passed, the original accountList will be emptied |
loginNameString | Account |
domainListList | Domain array, which only the User Customized type Control Group can be modified, customer type Control Group and product type Control Group can not be modified.User Customized type Control Group empties the original domainList if no value is passed |
isAddBoolean | Whether to add:
|
응답 파라미터
Body 파라미터
| 파라미터 이름 | 설명 |
|---|---|
codeString | Status Code |
msgString | Message |
dataObject | |
controlGroupCodeString | Control Group Code |
controlGroupNameString | Control Group Name |
requestIdString | Request ID |
에러 코드
| 에러 코드(code) | 설명(message) | HTTP 상태 코드 | 설명 |
|---|---|---|---|
| 24192105 | The "controlGroupCode"you specified is not exist | 200 | The "controlGroupCode"you specified is not exist |
| 24192107 | You do not have permission to operate this "controlGroup" | 200 | You do not have permission to operate this "controlGroup" |
| 24192109 | The "controlGroup" you specified does not belong to you | 200 | The "controlGroup" you specified does not belong to you |
| 24192103 | There are accounts that do not belong to you in the variable "accountName". | 200 | There are accounts that do not belong to you in the variable "accountName". |
예제
- 요청 예제 복사 완료
#!/bin/bash username="example_username" apiKey="example_apiKey" date=`env LANG="en_US.UTF-8" date -u "+%a, %d %b %Y %H:%M:%S GMT"` password=`echo -en "$date" | openssl dgst -sha1 -hmac $apiKey -binary | openssl enc -base64` curl -i --url "https://api.cdnetworks.com/user/control-groups/<ControlGroupCode>" \ -X "PUT" \ -u "$username:$password" \ -H "Date: $date" \ -H "Accept: application/json" \ -d '{ "accountList":[{"loginName":"test1"},{"loginName":"test2"}], "controlGroupName":"xxx", "domainList":["www.aaa.com","www.bbb.com"], "isAdd":"false" }'- 응답 예제 복사 완료
{ "msg":"success", "code":"0", "data":{ "controlGroupCode":"CG201906241004", "controlGroupName":"xxx" } }