Qodex.ai

Update hostnames for a property version

PUT https://{{host}}/papi/v1/properties/:propertyId/versions/:propertyVersion/hostnames

Modify the set of hostnames for a property version. For each hostname entry, set headers indicating their limits.

Note: If you're using a new account, first register it on the Akamai network by activating any property version on either staging or production. Otherwise, your attempts to create or specify certificates will fail with a 403 error.

Request Params

KeyDatatypeRequiredDescription
contractIdstring(Optional) Unique identifier for the contract. The parameter is optional if a property belongs to only one contract. Otherwise you need to specify it along with the groupId. In other operations that don't specify a propertyId URL parameter, this parameter is always required. See ID prefixes for details on omitting the value's ctr_ prefix.
groupIdstring(Optional) Unique identifier for the group. The parameter is optional if a property belongs to only one group. Otherwise you need to specify it along with the contractId. In other operations that don't specify a propertyId URL parameter, this parameter is always required. See ID prefixes for details on omitting the value's grp_ prefix.
validateHostnamesstring(Optional) When false, skips validation tests that would identify potential hostname-related problems within the response object's errors and warnings arrays. See Property hostname errors for details on relevant error feedback. See Validation best practices for guidance on when to defer validation.
includeCertStatusstring(Optional) Limited availability Whether the response should include the certificate status for the hostname on staging and production networks.
accountSwitchKeystring(Optional) 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.

Request Body

{"0"=>{"certProvisioningType"=>"DEFAULT", "cnameFrom"=>"m.example.com", "cnameTo"=>"example.com.edgekey.net", "cnameType"=>"EDGE_HOSTNAME"}, "1"=>{"certProvisioningType"=>"CPS_MANAGED", "cnameFrom"=>"example3.com", "cnameType"=>"EDGE_HOSTNAME", "edgeHostnameId"=>"ehn_895824"}}

HEADERS

KeyDatatypeRequiredDescription
If-Matchstring(Required) This corresponds to the ETag response header. Passing this value back as If-Match in write requests ensures you don't overwrite edits by any other API clients. See Concurrency control for details.
PAPI-Use-Prefixesstring(Required) Enum Sets whether to represent ID prefixes in response data. Set to false when exchanging PAPI data with other APIs.
Content-Typestring
Acceptstring

RESPONSES

status: OK

{"accountId":"act_A-CCT5678","contractId":"ctr_K-0N7RAK71","etag":"6aed418629b4e5c0","groupId":"grp_54321","hostnames":{"items":[{"certProvisioningType":"DEFAULT","certStatus":{"production":[{"status":"PENDING"}],"staging":[{"status":"PENDING"}],"validationCname":{"hostname":"_acme-challenge.www.example.com","target":"{token}.www.example.com.akamai-domain.com"}},"cnameFrom":"example.com","cnameTo":"example.com.edgekey.net","cnameType":"EDGE_HOSTNAME","edgeHostnameId":"ehn_895822"},{"certProvisioningType":"CPS_MANAGED","cnameFrom":"m.example.com","cnameTo":"m.example.com.edgesuite.net","cnameType":"EDGE_HOSTNAME","edgeHostnameId":"ehn_895833"}]},"propertyId":"prp_175780","propertyName":"mytestproperty.com","propertyVersion":1}