Akamai APIs API Documentation
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.
Body
PARAM
| Key | Datatype | Required | Description |
contractId
|
string | (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](https://techdocs.akamai.com/property-mgr/reference/id-prefixes) for details on omitting the value's `ctr_` prefix. | |
groupId
|
string | (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](https://techdocs.akamai.com/property-mgr/reference/id-prefixes) for details on omitting the value's `grp_` prefix. | |
validateHostnames
|
string | (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](https://techdocs.akamai.com/property-mgr/reference/validation-errors) for details on relevant error feedback. See [Validation best practices](https://techdocs.akamai.com/property-mgr/reference/validation-best-practices) for guidance on when to defer validation. | |
includeCertStatus
|
string | (Optional) __Limited availability__ Whether the response should include the certificate status for the hostname on staging and production networks. | |
accountSwitchKey
|
string | (Optional) For customers who manage more than one account, this [runs the operation from another account](https://techdocs.akamai.com/developer/docs/manage-many-accounts-with-one-api-client). The Identity and Access Management API provides a [list of available account switch keys](https://techdocs.akamai.com/iam-api/reference/get-client-account-switch-keys). |
HEADERS
| Key | Datatype | Curl curl -X PUT 'https://host/papi/v1/properties/:propertyId/versions/:propertyVersion/hostnames?contractId=&groupId=&validateHostnames=&includeCertStatus=&accountSwitchKey=' -H 'If-Match: If-Match' -H 'PAPI-Use-Prefixes: PAPI-Use-Prefixes' -H 'Content-Type: application/json' -H 'Accept: application/json' -d '{"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"}}' ENDPOINTS |