Skip to content

CDNetworks Documentation

Using Properties to Configure the Edge permalink

A "property" is a configuration of one or more hostnames (domains) that need to be deployed to the CDN Pro edge servers. A property determines how you want the servers to obtain, cache, modify, and distribute your content to end users. The key elements of a property include:

  • Service hostname(s) to be accelerated
  • One or more origin servers
  • Caching rules for different types of contents
  • Modifications to the URL or HTTP header fields
  • Whether HTTPS is required, TLS certificates, and TLS protocol version

Managing Properties permalink

On the CDN Pro platform, each property is versioned to track the history of changes and allow rollback if needed. Each version can be deployed independently to the staging or production environment.

Using the Properties page, you can create, modify, validate, and deploy properties. You can also undeploy and delete properties if needed. To display the Properties page, click Edge Configurations in the left pane, and then select Properties. The following figure shows the key elements on the page, and the table following the figure describes them.

properties page

FieldsDescription
1A search box for filtering properties that have been deployed to staging or production. You can filter properties by ID, name, description, hostname, or configuration settings. To enter multiple search strings, separate each one with a carriage return. Advanced filtering capabilities allow you to search specific configurations. For more information, see Filtering Properties.
2Appears only for resellers, allowing them to search the properties of their child customers.
3The list of all properties that are available to you.
4Icons to filter properties based on whether they have been deployed to staging or production.
5Drop-down lists to take actions on each property.
6The button to create new properties.

Filtering Properties permalink

CDN Pro provides robust filtering capabilities that allow you to find properties that meet certain criteria.

Using the Carat permalink

Typing the carat character at the beginning of a search string narrows matches to properties whose name, description, or hostnames fields start with the text following the ^. For example, ^domain matches the hostnames domain.com and domain123.com, but not abc.123domain.com.

Note: When searching for a property by ID, specify the entire ID, not just a portion of it.

Performing Advanced Searches permalink

CDN Pro provides an advanced search filter that allows you to find properties that match a specific configuration. This feature is particularly useful if you have many properties.

You can access the advanced search using either the Advanced Filter icon next to the search box or the hasConfig=<'configuration'> search string syntax.

Using the Advanced Filter Icon permalink

The Advanced Filter icon next to the search box allows you to search specific configurations by entering keywords and conditions in an Advanced Filter dialog box.

  1. Click the Advanced Filter icon.

    advfilter icon

  2. When the dialog box appears, complete the following fields.

Fields/ButtonsDescription
KeywordsTo search by keywords, enter one or more keywords associated with the property you want to find. A keyword can be a property ID, name, or description. To enter multiple keywords, separate each one with a carriage return. For more information, refer to the CDN Pro API Specification.
Add New +To search based on conditions, click Add New +. Select a field name and operator from the first two lists. If a value is required, enter it in the rightmost field. Click Add New +. Repeat these steps for each additional filter condition you want to add.
  1. After specifying your search criteria, click Search.

Using the hasConfig=<'configuration'> Search String Syntax permalink

The hasConfig=<'configuration'> syntax allows you to find properties that match a specific configuration. You enter these by entering keywords in the search box. Using this advanced filter method, <'configuration'> is a keyword supported by the CDN Pro API. For more information, refer to the CDN Pro API Specification.

You can search for properties matching multiple settings by entering more than one hasConfig=<'configuration'> search string in the search box. Type the first one and press the Carriage Return key, and then repeat this sequence for each additional advanced search string you want to enter in the search box.

Observe the following guidelines when performing advanced searches:

  • Searches on numeric and Boolean fields return an exact match.
  • Searches on strings return full and partial matches.
  • If you omit the colon and configuration keyword, CDN Pro returns all properties that have a non-empty configuration for the field.
  • If a property has multiple versions, the property is included in the matched results if any of its versions matches the hasConfig configuration keyword.
  • You can specify the subfields of a property version by using the period (.) as a separator.

The following table shows examples of using hasConfig=<'configuration'> to perform advanced searches.

ExampleDescription
hasConfig=hasBeian:trueReturns properties whose Has ICP Beian setting is Yes.
hasConfig=edgeLogic!sortedReturns properties for which the Edge Logic field does not include the configuration keyword sorted.
hasConfig=hostnames:domainReturns all properties with a hostname containing the string domain such as mydomain.com and thedomains.com.
hasConfig=disableHttp2:trueReturns properties that do not support HTTP2.
hasConfig=extraServicePorts.http:85Returns properties that support port 85 for HTTP requests.
hasConfig=origins.servers:myorigin.comReturns properties that use myorigin.com as an origin server.

Property Actions permalink

Each property has a vertical ellipsis in the Actions column. Clicking the ellipsis shows the available actions that can be performed on the selected property.

  • Edit: Update the selected property.
  • Compare Versions: Compare two property versions.
  • Undeploy from Staging: Undeploy the selected property from the staging environment.
  • Undeploy from Production: Undeploy the selected property from production.
  • Delete: Delete the selected property.
  • Deployment History: View the deployment history of the selected property.
  • Clone: Copy settings into the Create a Property form to create a new property.
  • Report: Run a report using the hostnames of the deployed property. This action is available only for properties that have been deployed to production.