Update a configuration

put

https://{hostname}/cloud-wrapper/v1/configurations/{configId}

Update a saved or inactive configuration.

Path Params

configId

int32

required

1 to 1000000000

The unique identifier Akamai assigns to your Cloud Wrapper configuration.

Query Params

activate

boolean

Defaults to false

Specify if you want to activate the modified configuration, false by default. Otherwise, you can run the Activate a configuration operation separately.

accountSwitchKey

string

For customers who manage more than one account, this runs the operation from another account. The Identity and Access Management API provides a list of available account switch keys.

Body Params

capacityAlertsThreshold

int64 | null

50 to 100

Represents the threshold for sending alerts. Displayed as null if you haven't enabled capacity alerts.

comments

string

required

length between 1 and 255

Additional information you provide to differentiate or track changes of the configuration.

locations

array of objects

required

length between 1 and 2147483647

The locations eligible for use with the configuration. Locations need to have a pre-approved capacity for the selected contract.

locations*

capacity

object

required

The capacity assigned to this configuration's location. List capacity to view the approvedCapacity and assignedCapacity values.

comments

string

required

length between 1 and 255

Additional information provided when creating the property.

trafficTypeId

int64

required

0 to 1000

The unique identifier for the location and traffic type combination. You can list locations to see your available combinations.

multiCdnSettings

object | null

Specify details about the Multi CDN settings. Displayed as null if Multi CDN isn't defined in your Cloud Wrapper configuration.

notificationEmails

array of strings

length ≥ 0

Email addresses to receive notifications.

notificationEmails

propertyIds

array of strings

required

length ≥ 1

The identifiers that represent the properties eligible to add Cloud Wrapper. To see property specifics, run the list properties operation. A property can be assigned to a single Cloud Wrapper configuration. Properties don't need to be from the same contract you've specified for the configuration.

propertyIds*

retainIdleObjects

boolean

Defaults to false

Retain idle objects beyond their max idle lifetime.

Headers

string

enum

Defaults to application/json

Generated from available response content types

Allowed:

Responses

`application/xml`. Try the operation again using `application/json`.

Language

Authentication

Remember to add your authentication credentials to run this code.

URL


xxxxxxxxxx
15
1
curl --request PUT \
2
     --url https://hostname/cloud-wrapper/v1/configurations/configId \
3
     --header 'accept: application/problem+json' \
4
     --header 'content-type: application/json' \
5
     --data '
6
{
7
  "locations": [
8
    {
9
      "capacity": {
10
        "unit": "GB"
11
      }
12
    }
13
  ]
14
}
15
'


xxxxxxxxxx
58
7
}
 
1
{
2
  "detail": "Invalid body",
3
  "instance": "12ab3c45-789d-01ef-2gh3-ijk4l56m78no",
4
  "status": 400,
5
  "title": "Bad Request",
6
  "type": "bad_request"
7
}

200The response returns the updated configuration.

400Bad request. You provided bad parameter data or formatted the request body incorrectly.

401Unauthorized. A value in your authentication credential is invalid or it's expired.

403Access forbidden. You lack permission for this operation, such as having read-only access.

404Not found. You've input the API URL incorrectly or named an asset that doesn't exist.

405Not allowed. You used an unsupported method with this operation. For example, you set the method to PUT for a GET operation.

415Unsupported media type. You've used an unsupported request or response content type, such as application/xml. Try the operation again using application/json.

500Internal server error. An internal error occurred. Try the request again. If the error continues, contact your account team.

`application/xml`. Try the operation again using `application/json`.