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

Querying a Retrieval Host

Function

This API is used to query a retrieval host. A retrieval host is the domain name accessed by CDN nodes when the nodes retrieve content from the origin server. It is specified in the header of an HTTP retrieval request.

URI

GET /v1.0/cdn/domains/{domain_id}/originhost

Table 1 Path Parameters

Parameter

Mandatory

Type

Description

domain_id

Yes

String

Specifies the acceleration domain name ID. For details, see Querying Details About a Domain Name.

Table 2 Query Parameters

Parameter

Mandatory

Type

Description

enterprise_project_id

No

String

Enterprise project that the resource belongs to. This parameter is valid only when the enterprise project function is enabled. The value all indicates all projects. This parameter is mandatory when you use an IAM user to call this API.

Obtain the enterprise project ID by calling the ListEnterpriseProject API of Enterprise Project Management Service (EPS).

Request Parameters

Table 3 Request header parameters

Parameter

Mandatory

Type

Description

X-Auth-Token

Yes

String

Specifies the user token.

The token can be obtained by calling the IAM API used to obtain a user token. The value of **X-Subject-Token** in the response header is the user token.

Response Parameters

Status code: 200

Table 4 Response body parameters

Parameter

Type

Description

origin_host

DomainOriginHost object

Host header settings for origin pull.

Table 5 DomainOriginHost

Parameter

Type

Description

domain_id

String

Domain name ID.

origin_host_type

String

Host type. Possible values: accelerate (Select the acceleration domain name as the retrieval host domain name), customize (Use the user-defined domain name as the retrieval host domain name).

customize_domain

String

Specifies the custom domain name of the retrieval host.

Example Requests

GET https://cdn.myhuaweicloud.com/v1.0/cdn/domains/ff80*****************************d71/originhost?enterprise_project_id=0

Example Responses

Status code: 200

OK

{
  "origin_host" : {
    "domain_id" : "ff80*****************************d71",
    "origin_host_type" : "customize",
    "customize_domain" : "www.example.com"
  }
}

Status Codes

Status Code

Description

200

OK

Error Codes

See Error Codes.