API workflow

This section summarizes the API's workflow patterns to manage your property hostnames on China CDN. See the API summary for details on all operations.

Before running many of the operations, you need the ICP number identifier. Before creating or updating objects, you also need a relevant property hostname identifier. The ID values let you access these interfaces:

• Use the List ICP numbers operation if you want to see all ICP numbers under your account.

• Use the List edge hostnames operation if you want to find out if an edge hostname is provided on China CDN.

• Use the List groups operation if you want to find out to which property hostnames existing groups are assigned.

• Use the Property Hostnames interface if you want a list of available property hostnames or Create or update a property hostname.

Follow these basic workflows to deploy, manage, and maintain your property hostnames on China CDN. To allowlist your property hostname on China CDN:

1. Run the List property hostnames operation for a list
   of property hostnames under your account.

2. Use the hostname to run the Create a new provision state change operation, which responds with a ProvisionStateChange object.

3. When you build the new ProvisionStateChange object, set the targetState to WHITELISTED, then POST a Create a new provision state change object.

4. The operation responds with a ProvisionStateChange object.

5. To track the property hostname's currentStatus, Get a provision state change.

To activate your property hostname on China CDN:

1. Run the List property hostnames operation for a list of property hostnames under your account.

2. Use the hostname to run the Create a new provision state change operation, which responds with a ProvisionStateChange object.

3. When you build the new ProvisionStateChange object, set the targetState to PROVISIONED, then POST a Create a new provision state change object.

4. The operation responds with a ProvisionStateChange object.

5. To track the property hostname's currentStatus, Get a provision state change.

To deactivate your property hostname on China CDN:

1. Run the List property hostnames operation for a list of property hostnames under your account.

2. Use the hostname to run the Create a new provision state change operation, which responds with a ProvisionStateChange.

3. When you build a new ProvisionStateChange object, set the targetState to WHITELISTED, then POST a Create a new provision state change object.

4. The operation responds with a ProvisionStateChange object.

5. To track the property hostname's currentStatus, Get a provision state change.

To deprovision your property hostname on China CDN:

1. Run the List property hostnames operation for a list of property hostnames under your account.

2. Use the hostname to run the Create a new provision state change operation, which responds with a ProvisionStateChange object.

3. When you build a new ProvisionStateChange object, set the targetState to DEPROVISIONED, then POST a Create a new provision state change object.

4. To track the property hostname's currentStatus, Get a provision state change.