Skip to main content
Version: v1

Update Resource

This method allows updating parameters of a selected S3 resource

info

A background task will be created upon successful request. You can track the task progress using the Tasks API

Request Parameters

PUT /api/clients/v1/s3Resources/{id}/

Headers

  • Content-Type: application/json
  • Authorization: Bearer $access_token

Path

ParameterTypeConstraintsDescriptionExample
idinteger> 0, requiredResource ID16

JSON body

ParameterTypeConstraintsDescriptionExample
project_idinteger> 0, requiredProject ID associated with the resource2
namestring0 < length < 256, requiredResource namestorage-europe
provider_idinteger> 0, requiredS3 provider ID2
provider_protostringhttp | https, requiredS3 provider URL schemehttps
provider_hoststring0 < length < 256, requiredS3 provider hostnamestorage.googleapis.com
provider_portinteger> 0, < 65536, requiredS3 provider port number443

Response Parameters

JSON body

ParameterTypeDescription
task_idstringTask ID

Examples

200 OK

Task ID for resource update. The task result is contained in the task object

{
"task_id": "bb4dcd80-01a5-4a73-8c2b-62c5027a9b72"
}
400 Bad Request

Invalid or missing required path/body parameters

{
"provider_host": [
"This field may not be blank."
],
"provider_port": [
"Ensure this value is less than or equal to 65535."
]
}
401 Unauthorized

Authentication credentials missing or invalid

{
"detail": "Given token not valid for any token type",
"code": "token_not_valid",
"messages": [
{
"token_class": "AccessToken",
"token_type": "access",
"message": "Token is invalid or expired"
}
]
}
403 Forbidden

Resource can only be associated with your own project

{
"detail": "Only project participants can view this project's resources"
}
404 Not Found

Resource with specified ID not found

{
"detail": "Resource not found"
}