Updated on 2024-10-12 GMT+08:00

Before You Start

Welcome to Content Delivery Network API Reference. Content Delivery Network (CDN) is an intelligent virtual network built on top of existing Internet infrastructure. Origin content is cached on nodes closer to end users so content can load faster. CDN speeds up site response and improves site availability, breaking through the bottlenecks caused by low bandwidth, heavy user access traffic, and uneven distribution of edge nodes.

This document describes how to use application programming interfaces (APIs) to perform operations on CDN, such as creating, deleting, and modifying an accelerated domain name. For details about all supported operations, see API Overview.

If you plan to access CDN through an API, ensure that you are familiar with CDN concepts. For details, see Service Overview.

API Calling

CDN supports Representational State Transfer (REST) APIs, allowing you to call APIs using HTTPS. For details about API calling, see Making an API Request.

Additionally, CDN provides software development kits (SDKs) for multiple programming languages. For details about how to use SDKs, see CDN SDKs.

Endpoints

An endpoint is the request address for calling an API. CDN is a global-level service and does not have endpoint requirements. Table 1 lists CDN endpoints. You can also query the endpoints of services on Regions and Endpoints.

Table 1 CDN endpoints

Region Name

Region

Endpoint

ALL

All regions

cdn.myhuaweicloud.com

Constraints and Limitations

  • The number of domain names that you can create and number of URLs to be refreshed and preheated are determined by your quota. For details, see Service Quota.
  • For more constraints, see API description.

Concepts

  • Account

    An account is created upon successful registration with Huawei Cloud. The account has full access permissions for all of its cloud services and resources. It can be used to reset user passwords and grant user permissions. The account is a payment entity and should not be used directly to perform routine management. For security purposes, create IAM users and grant them permissions for routine management.

  • IAM user

    An IAM user is created using an account to use cloud services. Each IAM user has its own identity credentials (password and access keys).

    The account name, username, and password will be required for API authentication.

  • Region

    Regions are divided based on geographical location and network latency. Public services, such as Elastic Cloud Server (ECS), Elastic Volume Service (EVS), Object Storage Service (OBS), Virtual Private Cloud (VPC), Elastic IP (EIP), and Image Management Service (IMS), are shared within the same region. Regions are classified into universal regions and dedicated regions. A universal region provides universal cloud services for common tenants. A dedicated region provides specific services for specific tenants.

    For details, see Region and AZ.

  • AZ

    An availability zone (AZ) contains one or more physical data centers. Each AZ has independent cooling, fire extinguishing, moisture-proof, and electricity facilities. Within an AZ, computing, network, storage, and other resources are logically divided into multiple clusters. AZs within a region are interconnected using high-speed optical fibers to support cross-AZ high-availability systems.

  • Project
    Projects group and isolate resources (including compute, storage, and network resources) across physical regions. A default project is provided for each Huawei Cloud region, and subprojects can be created under each default project. Users can be granted permissions to access all resources in a specific project. For more refined access control, create subprojects under a project and purchase resources in the subprojects. Users can then be assigned permissions to access only specific resources in the subprojects.
    Figure 1 Project isolating model
  • Enterprise Project

    Enterprise projects group and manage resources across regions. Resources in enterprise projects are logically isolated from each other. An enterprise project can contain resources of multiple regions, and resources can be added to or removed from enterprise projects.

    For details about how to obtain enterprise project IDs and features, see Enterprise Management Service User Guide.