Modify Instance
Select
Modifies the properties of the object storage instance
Path Parameters
- instanceId string required
ID of the object storage instance
- application/json
Request Body
This request enables modifications to the instance name, the associated access nodes, authentication method, host url, and the assigned plan.
instanceProperties object
cloudAppsInstance object
instanceType string requiredPossible values: [
ALIBABA_OSS
,AMAZON_S3
,AZURE_BLOB
,AZURE_DATA_LAKE
,GOOGLE_CLOUD
,IBM_COS
,ORACLE_STORAGE_SERVICE
]Type of the object storage instance.
generalCloudProperties object required
memberServers object[]
List of access nodes / access node groups associated with the instance.
client object
clientId integerAccess node ID
clientName stringAccess node name
clientGroupId integerAccess node group's ID
clientGroupName stringAccess node group's name
credentials object required
credentialId integerID of the credential
credentialName stringName of the credential
cloudInstance object required
Based on the cloud vendor and authentication type, the parameter name and it's value will vary. Please refer to the examples for more details.
hostURL stringURL for the instance
useIamRole booleanExclusive for S3 instances.
adAccountName stringExclusive to azure instances.
serverName stringURL for Azure Datalake / GCP instances.
GCPProjectId stringProject ID for GCP instance.
endpointURL stringURL for OCI instances
compartmentName stringExclusive to OCI instance. Name of the compartment.
includeSubCompartments booleanExclusive to OCI instance. To include subcompartments, set to True.
credentialType string requiredPossible values: [
AMAZON_S3
,AMAZON_STS_IAM_ROLE
,AMAZON_IAM_ROLE
,AZUREACCOUNT
,MICROSOFT_AZURE
,MICROSOFT_AZURE_VM_ROLE
,GOOGLE_CLOUD
,GOOGLE_SERVICE_ACCOUNT
,ALICLOUD_OSS
,IBM_CLOUD
,ORACLE_CLOUD_INFRASTRUCTURE
]Type of the credential based on cloud vendor.
planEntity object
planId integerID of the plan associated with instance.
planName stringName of the plan associated with instance.
newName stringName for the object storage instance
- 200
- 409
OK
- application/json
- Schema
- Example (from schema)
Schema
processinginstructioninfo object
attributes object[]
name stringvalue stringresponse object[]
warningCode integererrorCode integerwarningMessage stringentity object
subclientId integerclientId integer_SubclType_ integerinstanceName stringinstanceId integer_type_ integer
{
"processinginstructioninfo": {
"attributes": [
{
"name": "string",
"value": "string"
}
]
},
"response": [
{
"warningCode": 0,
"errorCode": 0,
"warningMessage": "string",
"entity": {
"subclientId": 0,
"clientId": 0,
"_SubclType_": 0,
"instanceName": "string",
"instanceId": 0,
"_type_": 0
}
}
]
}
Conflict
- application/json
- Schema
- Example (from schema)
Schema
- errorMessage string
- errorCode integer
{
"errorMessage": "string",
"errorCode": 0
}