Function
This API is used to list shared cache groups.
URI
GET /v1.0/cdn/configuration/share-cache-groups
Table 1 Query Parameters
|
Parameter |
Mandatory |
Type |
Description |
|
limit |
No |
Integer |
Definition
Number of records on each page during pagination query.
Constraints
N/A
Range
1 to 1,000.
Default Value
10 |
|
offset |
No |
Integer |
Definition
Query offset, indicating the number of data records to skip for query.
Constraints
N/A
Range
0 to 65,535.
Default Value
0 |
Response Parameters
Status code: 200
Table 2 Response body parameters
|
Parameter |
Type |
Description |
|
total |
Integer |
Total number of shared cache groups. |
|
share_cache_groups |
Array of ListShareCacheGroupsConfig objects |
Shared cache group configuration. |
Table 3 ListShareCacheGroupsConfig
|
Parameter |
Type |
Description |
|
id |
String |
Shared cache group ID. |
|
group_name |
String |
Shared cache group name. |
|
create_time |
Integer |
Time when the shared cache group is created. |
|
share_cache_records |
Array of ListShareCacheGroupsRecord objects |
Domain names sharing the cache. |
|
primary_domain |
String |
Primary domain name of the shared cache group. |
Table 4 ListShareCacheGroupsRecord
|
Parameter |
Type |
Description |
|
domain_name |
String |
Associated domain name of the shared cache group. |
Example Requests
GET https://cdn.myhuaweicloud.com/v1.0/cdn/configuration/share-cache-groups?limit=1000&offset=0
Example Responses
Status code: 200
Request succeeded.
{
"total" : 1,
"share_cache_groups" : [ {
"id" : "example***********************id",
"group_name" : "example",
"create_time" : 1000000000000,
"primary_domain" : "www.example.com",
"share_cache_records" : [ {
"domain_name" : "www.example.com"
}, {
"domain_name" : "www.example.cn.com"
} ]
} ]
}
SDK Sample Code
The SDK sample code is as follows.
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
|
package com.huaweicloud.sdk.test;
import com.huaweicloud.sdk.core.auth.ICredential;
import com.huaweicloud.sdk.core.auth.GlobalCredentials;
import com.huaweicloud.sdk.core.exception.ConnectionException;
import com.huaweicloud.sdk.core.exception.RequestTimeoutException;
import com.huaweicloud.sdk.core.exception.ServiceResponseException;
import com.huaweicloud.sdk.cdn.v2.region.CdnRegion;
import com.huaweicloud.sdk.cdn.v2.*;
import com.huaweicloud.sdk.cdn.v2.model.*;
public class ListShareCacheGroupsSolution {
public static void main(String[] args) {
// The AK and SK used for authentication are hard-coded or stored in plaintext, which has great security risks. It is recommended that the AK and SK be stored in ciphertext in configuration files or environment variables and decrypted during use to ensure security.
// In this example, AK and SK are stored in environment variables for authentication. Before running this example, set environment variables CLOUD_SDK_AK and CLOUD_SDK_SK in the local environment
String ak = System.getenv("CLOUD_SDK_AK");
String sk = System.getenv("CLOUD_SDK_SK");
ICredential auth = new GlobalCredentials()
.withAk(ak)
.withSk(sk);
CdnClient client = CdnClient.newBuilder()
.withCredential(auth)
.withRegion(CdnRegion.valueOf("<YOUR REGION>"))
.build();
ListShareCacheGroupsRequest request = new ListShareCacheGroupsRequest();
try {
ListShareCacheGroupsResponse response = client.listShareCacheGroups(request);
System.out.println(response.toString());
} catch (ConnectionException e) {
e.printStackTrace();
} catch (RequestTimeoutException e) {
e.printStackTrace();
} catch (ServiceResponseException e) {
e.printStackTrace();
System.out.println(e.getHttpStatusCode());
System.out.println(e.getRequestId());
System.out.println(e.getErrorCode());
System.out.println(e.getErrorMsg());
}
}
}
|
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
|
# coding: utf-8
import os
from huaweicloudsdkcore.auth.credentials import GlobalCredentials
from huaweicloudsdkcdn.v2.region.cdn_region import CdnRegion
from huaweicloudsdkcore.exceptions import exceptions
from huaweicloudsdkcdn.v2 import *
if __name__ == "__main__":
# The AK and SK used for authentication are hard-coded or stored in plaintext, which has great security risks. It is recommended that the AK and SK be stored in ciphertext in configuration files or environment variables and decrypted during use to ensure security.
# In this example, AK and SK are stored in environment variables for authentication. Before running this example, set environment variables CLOUD_SDK_AK and CLOUD_SDK_SK in the local environment
ak = os.environ["CLOUD_SDK_AK"]
sk = os.environ["CLOUD_SDK_SK"]
credentials = GlobalCredentials(ak, sk)
client = CdnClient.new_builder() \
.with_credentials(credentials) \
.with_region(CdnRegion.value_of("<YOUR REGION>")) \
.build()
try:
request = ListShareCacheGroupsRequest()
response = client.list_share_cache_groups(request)
print(response)
except exceptions.ClientRequestException as e:
print(e.status_code)
print(e.request_id)
print(e.error_code)
print(e.error_msg)
|
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
|
package main
import (
"fmt"
"github.com/huaweicloud/huaweicloud-sdk-go-v3/core/auth/global"
cdn "github.com/huaweicloud/huaweicloud-sdk-go-v3/services/cdn/v2"
"github.com/huaweicloud/huaweicloud-sdk-go-v3/services/cdn/v2/model"
region "github.com/huaweicloud/huaweicloud-sdk-go-v3/services/cdn/v2/region"
)
func main() {
// The AK and SK used for authentication are hard-coded or stored in plaintext, which has great security risks. It is recommended that the AK and SK be stored in ciphertext in configuration files or environment variables and decrypted during use to ensure security.
// In this example, AK and SK are stored in environment variables for authentication. Before running this example, set environment variables CLOUD_SDK_AK and CLOUD_SDK_SK in the local environment
ak := os.Getenv("CLOUD_SDK_AK")
sk := os.Getenv("CLOUD_SDK_SK")
auth, err := global.NewCredentialsBuilder().
WithAk(ak).
WithSk(sk).
SafeBuild()
if err != nil {
fmt.Println(err)
return
}
hcClient, err := cdn.CdnClientBuilder().
WithRegion(region.ValueOf("<YOUR REGION>")).
WithCredential(auth).
SafeBuild()
if err != nil {
fmt.Println(err)
return
}
client := cdn.NewCdnClient(hcClient)
request := &model.ListShareCacheGroupsRequest{}
response, err := client.ListShareCacheGroups(request)
if err == nil {
fmt.Printf("%+v\n", response)
} else {
fmt.Println(err)
}
}
|
For SDK sample code of more programming languages, see the Sample Code tab in API Explorer. SDK sample code can be automatically generated.
Status Codes
|
Status Code |
Description |
|
200 |
Request succeeded. |