Modifying a Workspace
Function
This API is used to modify a workspace.
Debugging
You can debug this API through automatic authentication in API Explorer or use the SDK sample code generated by API Explorer.
URI
PUT /v1/{project_id}/workspaces/{workspace_id}
Parameter |
Mandatory |
Type |
Description |
---|---|---|---|
project_id |
Yes |
String |
Project ID. For details, see Obtaining a Project ID and Name. |
workspace_id |
Yes |
String |
Workspace ID For details about how to obtain the value, see Querying the Workspace List. If no workspace is created, the default value is 0. If a workspace is created and used, the actual value prevails. |
Request Parameters
Parameter |
Mandatory |
Type |
Description |
---|---|---|---|
X-Auth-Token |
Yes |
String |
User token. It can be obtained by calling the IAM API that is used to obtain a user token. The value of X-Subject-Token in the response header is the user token. |
Parameter |
Mandatory |
Type |
Description |
---|---|---|---|
grants |
No |
Array of grants objects |
Dataset of a training job. This parameter cannot be used with data_url, dataset_id, or dataset_version_id. |
auth_type |
No |
String |
Authorization type. The value can be PUBLIC, PRIVATE, or INTERNAL. The default value is PUBLIC. |
name |
No |
String |
Workspace name The value contains 4 to 64 characters, including uppercase letters, lowercase letters, digits, hyphens (-), and underscores (_). In addition, default is the default workspace name reserved by the system. You cannot create a workspace named default. |
description |
No |
String |
Workspace description. By default, this parameter is left blank. Enter 0 to 256 characters. |
Response Parameters
Status code: 200
Parameter |
Type |
Description |
---|---|---|
workspace_id |
String |
Workspace ID |
Example Requests
PUT https://{endpoint}/v1/{project_id}/workspaces/ccd05d1a553b4e188ea878e7dcb85e47 { "name" : "my_workspace", "description" : "It is my workspace", "auth_type" : "INTERNAL", "grants" : [ { "user_name" : "my_iam_user" } ] }
Example Responses
Status code: 200
Response parameter indicating that a workspace is modified
{ "workspace_id" : "***05d1a553b4e188ea878e7dcb85***" }
Status Codes
Status Code |
Description |
---|---|
200 |
Response parameter indicating that a workspace is modified |
Error Codes
See Error Codes.
Feedback
Was this page helpful?
Provide feedbackThank you very much for your feedback. We will continue working to improve the documentation.See the reply and handling status in My Cloud VOC.
For any further questions, feel free to contact us through the chatbot.
Chatbot