Help Center> CodeArts Deploy> API Reference> APIs> Managing Application Permissions> Modifying Application Permissions in Batches
Updated on 2024-07-05 GMT+08:00

Modifying Application Permissions in Batches

Function

This API is used to modify application permissions in batches.

Calling Method

For details, see Calling APIs.

URI

PUT /v3/applications/permissions

Request Parameters

Table 1 Request header parameters

Parameter

Mandatory

Type

Description

X-Auth-Token

Yes

String

User token. It can be obtained by calling an IAM API. The value of X-Subject-Token in the response header is the user token.

Minimum: 0

Maximum: 20000

Table 2 Request body parameters

Parameter

Mandatory

Type

Description

project_id

Yes

String

Project ID

application_ids

Yes

Array of strings

Application list

Array Length: 1 - 1000

roles

Yes

Array of AppPermission objects

Role permissions

Array Length: 1 - 500

Table 3 AppPermission

Parameter

Mandatory

Type

Description

dev_role_id

Yes

String

Role ID

can_modify

Yes

Boolean

Whether you have the edit permission

can_delete

Yes

Boolean

Whether you have the delete permission

can_view

Yes

Boolean

Whether you have the view permission

can_execute

Yes

Boolean

Whether you have the execute permission

can_copy

Yes

Boolean

Whether you have the clone permission

can_manage

Yes

Boolean

Whether you can manage permissions

can_create_env

Yes

Boolean

Whether you have the permission to create environments

can_disable

Yes

Boolean

Whether you have the disable permission

Response Parameters

Status code: 200

Table 4 Response body parameters

Parameter

Type

Description

status

String

Request success or failure status

Example Requests

https://{endpoint}/v3/applications/permissions

{
  "application_ids" : [ "eac65c10c5c34df1824af96ec93a9eea", "3ba2ad194ff141e39b1d3d0749242858" ],
  "project_id" : "0a38ce9ba3c740c199a0f872b6163661",
  "roles" : [ {
    "dev_role_id" : "ba0d4b2e-f7e6-46a3-aece-3002ff640e73",
    "can_copy" : true,
    "can_create_env" : true,
    "can_delete" : true,
    "can_disable" : true,
    "can_execute" : true,
    "can_manage" : true,
    "can_modify" : true,
    "can_view" : true
  } ]
}

Example Responses

Status code: 200

OK: The request is successful.

{
  "status" : "success"
}

Status Codes

Status Code

Description

200

OK: The request is successful.

Error Codes

See Error Codes.