Edit sub account

Available in Classic and VPC

Edit sub account information.

Request

This section describes the request format. The method and URI are as follows:

Method	URI
PUT	/api/v1/sub-accounts/{subAccountId}

Request headers

For information about the headers common to all Sub Account APIs, see Sub Account request headers.

Request path parameters

You can use the following path parameters with your request:

Field	Type	Required	Description
`subAccountId`	String	Required	Sub account ID Check through Get sub account list

Request body

You can include the following data in the body of your request:

Field	Type	Required	Description
`active`	Boolean	Optional	Whether it is enabled `true` \| `false` `true`: enabled `false`: disabled
`apiAllowSources`	Array	Optional	List of sources accessible via API
`canAPIGatewayAccess`	Boolean	Optional	API Gateway accessibility `true` \| `false` `true`: accessible `false`: not accessible You can use APIs registered in API Gateway by creating a access key
`canConsoleAccess`	Boolean	Optional	Console accessibility `true` \| `false` `true`: accessible `false`: not accessible
`consolePermitIps`	Array	Optional	List of IP range accessible to the console
`email`	String	Optional	User's email address 6-100 characters
`isMfaMandatory`	Boolean	Optional	Whether two-factor authentication is required `true` \| `false` `true`: required `false`: optional
`memo`	String	Optional	Description of the sub account (byte) 0-300
`name`	String	Required	Sub account user's name 2-30 characters
`useApiAllowSource`	Boolean	Optional	Whether the accessible source for the API is restricted `true` \| `false` `true`: Accessible only from specified sources `false`: Accessible from all sources
`useConsolePermitIp`	Boolean	Optional	Whether the IP range accessible to the console is restricted `true` \| `false` `true`: Accessible only from specified IP range `false`: Accessible from everywhere

`apiAllowSources`

The following describes apiAllowSources.

Field	Type	Required	Description
`type`	String	Conditional	Access source type `IP` \| `VPC` \| `VPC_SERVER` `IP`: Single server IP or IP range including subnet `VPC`: VPC in use `VPC_SERVER`: Server in the VPC in use
`source`	String	Conditional	Access source information Enter an IP address or an instance number

Request example

The request example is as follows:

curl --location --request PUT 'https://subaccount.apigw.ntruss.com/api/v1/sub-accounts/2b141960-****-****-****-246e9659184c' \
--header 'x-ncp-apigw-timestamp: {Timestamp}' \
--header 'x-ncp-iam-access-key: {Access Key}' \
--header 'x-ncp-apigw-signature-v2: {API Gateway Signature}' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--data '{
    "email": "email@ncloud.com",
    "isMfaMandatory": false,
    "memo": "test",
    "name": "test",
    "useApiAllowSource": false,
    "useConsolePermitIp": false
}'

Response

This section describes the response format.

Response body

The response body includes the following data:

Field	Type	Required	Description
`success`	Boolean	-	API call success status `true` \| `false` `true`: succeeded `false`: failed

Response status codes

For information about the HTTP status codes common to all Sub Account APIs, see Sub Account status codes.

Response example

The response example is as follows:

{
    "success": true
}