JD Cloud Documentation

https://docs.jdcloud.com/cn/
Admin
This documentation portal provides comprehensive guides, API references, and conceptual overviews...
Tokens:809,977
Snippets:9,188
Trust Score:9.8
Update:3 months ago
Show doc for...
Tokens:
Raw
### OSS Console Quick Start

Source: https://docs.jdcloud.com/cn/object-storage-service/listbucketsdemo

A guide to getting started with Object Storage Service (OSS) using the management console. It covers basic operations and navigation.

```text
控制台快速入门
```

--------------------------------

### Initialize S3 Client with Credentials

Source: https://docs.jdcloud.com/cn/object-storage-service/sdk-go

Example of creating an S3 client using your AccessKey and SecretKey. Ensure you have Go 1.5 or later installed.

```go
package main

import (
    "github.com/aws/aws-sdk-go/aws"
    "github.com/aws/aws-sdk-go/aws/credentials"
    "github.com/aws/aws-sdk-go/aws/session"
    "github.com/aws/aws-sdk-go/service/s3"
)

func main() {

    ak := "your accesskey"
    sk := "your secretkey"
    creds := credentials.NewStaticCredentials(ak, sk, "")
    _,err := creds.Get()

    config := &aws.Config{
        Region          :aws.String("cn-north-1"),
        Endpoint        :aws.String("s3.cn-north-1.jdcloud-oss.com"),
        DisableSSL      :aws.Bool(false),
        Credentials     :creds,
    }

    client := s3.New(session.New(config))
    
    //use s3 client to create bucket、put object....

}    

```

--------------------------------

### Media Processing Service (Old) Quick Start

Source: https://docs.jdcloud.com/cn/object-storage-service/listbucketsdemo

A quick start guide for using the legacy Media Processing Service, covering basic workflow creation.

```text
快速入门
```

--------------------------------

### Initialize Go SDK for OSS

Source: https://docs.jdcloud.com/cn/object-storage-service/sdk-go

Provides an example of initializing the S3 compatible Go SDK for Object Storage Service. Ensure the AWS SDK for Go is installed.

```go
package main

import (
	"fmt"
	"github.com/aws/aws-sdk-go/aws"
	"github.com/aws/aws-sdk-go/aws/session"
	"github.com/aws/aws-sdk-go/service/s3"
)

func main() {
	// Initialize a session in us-west-2 that the SDK will use to load
	// credentials from the shared credentials file ~/.aws/credentials
	// and from the AWS configuration file ~/.aws/config.
	ssess := session.Must(session.NewSessionWithOptions(session.Options{
		SharedConfigState: session.SharedConfigEnable,
	}))

	// Create S3 client in the specified region
	ssvc := s3.New(sess, &aws.Config{
		Region: aws.String("us-west-2"), // Replace with your desired region
	})

	fmt.Println("S3 client initialized successfully.")
	// You can now use ssvc to interact with OSS
	_ = ssvc // Prevent unused variable error
}
```

--------------------------------

### Upload Object using S3 Browser Quick Start

Source: https://docs.jdcloud.com/cn/object-storage-service/listbucketsdemo

This example is a conceptual reference to using S3 Browser for managing OSS. It implies a GUI-based approach rather than code.

```text
S3 Browser 快速入门
```

--------------------------------

### Get Bucket Referer Request Example

Source: https://docs.jdcloud.com/cn/object-storage-service/api/getbucketreferer

An example of a GET request to retrieve bucket referer configuration. This includes necessary headers like Host, Date, and Authorization.

```http
GET   /?bucketReferer HTTP/1.1
Date: Tue, 11 Jul 2017   09:12:11 GMT
Authorization: jingdong   qbS5QXpLORrvdrmb:x7J06zQT3CJ5qF3CXKTKWjVBLvc=
Host: oss-test.s-bj.jcloud.com
Connection: Keep-Alive

```

--------------------------------

### Linux Cloud Assistant Client Installation (Suqian)

Source: https://docs.jdcloud.com/cn/virtual-machines/Install-cloudassistant-client

Use this startup script to install the Cloud Assistant client on Linux instances in the Suqian region. The script checks network connectivity, downloads the client, and installs it.

```bash
#!/bin/bash
date_time=`date '+%Y%m%d-%H%M%S'`
test_dir_name="assist-agent-${date_time}"

mkdir /home/$test_dir_name
cd /home/$test_dir_name

time_used=0
url="sq-cloudassistant.s3-internal.cn-east-1.jdcloud-oss.com"

while [ $time_used -le 600 ]; do
    ping $url -c 1
    if [ $? -eq 0 ]; then
        echo "connected!"
        break
    else
        echo "Cannot access, continue"
        sleep 5
        ((time_used += 5 ))
    fi
done

wget https://$url/x86/jdcloudservice.tar.gz
tar zxvf jdcloudservice.tar.gz
cd jdcloudservice
./install.sh

systemctl status jdcloudservice

```

--------------------------------

### Request Example for Get Watermark Template

Source: https://docs.jdcloud.com/cn/media-processing-service/api/getWatermarkTemplate

This example shows the GET request URL to retrieve a watermark template by its ID. Ensure you replace 'c35a7f843a6e49a4a32b1f8fab99fbd8' with the actual template ID.

```bash
GET
https://mps.jdcloud-api.com/v1/watermarkTemplates/c35a7f843a6e49a4a32b1f8fab99fbd8
```

--------------------------------

### Example database creation and switch

Source: https://docs.jdcloud.com/cn/rds/dblink

This example shows the creation of a database named 'db1' and then switching the current connection to 'db1'.

```sql
postgres=> create database db1;  
CREATE DATABASE  

postgres=> \c db1  
```

--------------------------------

### Get Snapshot Template Request

Source: https://docs.jdcloud.com/cn/media-processing-service/api/getsnapshottemplate

This is an example of a GET request to retrieve a specific snapshot template by its ID.

```bash
GET
https://mps.jdcloud-api.com/v1/snapshotTemplates/c35a7f843a6e49a4a32b1f8fab99fbd8
```

--------------------------------

### Linux Cloud Assistant Client Installation (Guangzhou)

Source: https://docs.jdcloud.com/cn/virtual-machines/Install-cloudassistant-client

Use this startup script to install the Cloud Assistant client on Linux instances in the Guangzhou region. The script checks network connectivity, downloads the client, and installs it.

```bash
#!/bin/bash
date_time=`date '+%Y%m%d-%H%M%S'`
test_dir_name="assist-agent-${date_time}"

mkdir /home/$test_dir_name
cd /home/$test_dir_name

time_used=0
url="gz-cloudassistant.s3-internal.cn-south-1.jdcloud-oss.com"

while [ $time_used -le 600 ]; do
    ping $url -c 1
    if [ $? -eq 0 ]; then
        echo "connected!"
        break
    else
        echo "Cannot access, continue"
        sleep 5
        ((time_used += 5 ))
    fi
done

wget https://$url/x86/jdcloudservice.tar.gz
tar zxvf jdcloudservice.tar.gz
cd jdcloudservice
./install.sh

systemctl status jdcloudservice

```

--------------------------------

### DescribeQuotas API Request Example

Source: https://docs.jdcloud.com/cn/dedicated-host/api/describequotas

This is an example of a GET request to the DescribeQuotas API to retrieve quota information for a specific region.

```bash
GET
/v1/regions/cn-north-1/dhQuotas
```

--------------------------------

### Create Database Example

Source: https://docs.jdcloud.com/cn/jchdb/sqlgrammar

Example of creating a database named 'db_1' on the 'default' cluster.

```sql
CREATE DATABASE db_1 ON CLUSTER default;
```

--------------------------------

### Get Bucket Request with Prefix and Delimiter

Source: https://docs.jdcloud.com/cn/object-storage-service/api/getbucket

This is an example of a GET request to the Get Bucket API, including prefix and delimiter parameters. These parameters help in organizing and filtering the bucket's contents.

```http
GET   /?prefix=jingdong%2F&delimiter=%2F HTTP/1.1
Host: oss-example.s-bj.jcloud.com
Date: Tue, 11 Jul 2017   08:05:13 GMT    
Authorization: jingdong   qbS5QXpLORrvdrmb:jXw8QQvs6IS+JJ2EpiFMUGtgNEM=
```

--------------------------------

### Linux Cloud Assistant Client Installation (Beijing)

Source: https://docs.jdcloud.com/cn/virtual-machines/Install-cloudassistant-client

Use this startup script to install the Cloud Assistant client on Linux instances in the Beijing region. The script checks network connectivity, downloads the client, and installs it.

```bash
#!/bin/bash
date_time=`date '+%Y%m%d-%H%M%S'`
test_dir_name="assist-agent-${date_time}"

mkdir /home/$test_dir_name
cd /home/$test_dir_name

time_used=0
url="bj-cloudassistant.s3-internal.cn-north-1.jdcloud-oss.com"

while [ $time_used -le 600 ]; do
    ping $url -c 1
    if [ $? -eq 0 ]; then
        echo "connected!"
        break
    else
        echo "Cannot access, continue"
        sleep 5
        ((time_used += 5 ))
    fi
done

wget https://$url/x86/jdcloudservice.tar.gz
tar zxvf jdcloudservice.tar.gz
cd jdcloudservice
./install.sh

systemctl status jdcloudservice

```

--------------------------------

### Install Cloud Assistant Client

Source: https://docs.jdcloud.com/cn/virtual-machines/Install-cloudassistant-client

Execute the installation script for the Cloud Assistant client.

```bash
./install.sh 

```

--------------------------------

### Get Bucket Response with Prefix

Source: https://docs.jdcloud.com/cn/object-storage-service/api/getbucket

This is an example of a successful response from the Get Bucket API when a prefix parameter is used. It lists objects and common prefixes within the specified prefix.

```json
HTTP/1.1 200 OK
Server: nginx
Date: Tue, 11 Jul 2017   08:01:09 GMT
Content-Type: application/json;charset=UTF-8
Content-Length: 613
Connection: keep-alive
Vary: Accept-Encoding
Vary: Accept-Encoding
x-jss-request-id:   9CCEA5403AA5ED6E
X-Trace:   200-1499760069435-0-0-20-45-45
 
{
      "Name": "oss-example",
      "Prefix": "jingdong/",
      "Marker":   null,
      "NextMarker":null,
      "Delimiter": null,
      "MaxKeys": 1000,
      "HasNext": false,
      "HasCommonPrefix": true,
      "Contents": [
          {
              "Key": "jingdong/dir/file",
              "LastModified": "Mon, 17 Jul 2017 12:12:39 GMT",
              "ETag": "77abd5a162ef88440102129fffbb404c",
              "Size": 2884006,
              "StorageClass": "STANDARD"
          },
          {
              "Key": "jingdong/dir/file2",
              "LastModified": "Mon, 17 Jul 2017 12:14:49 GMT",
              "ETag": "77abd5a162ef88440102129fffbb404c",
              "Size": 2884006,
              "StorageClass": "STANDARD"
          },
          {
              "Key": "jingdong/test.jpg",
              "LastModified": "Mon, 17 Jul 2017 12:12:17 GMT",
              "ETag": "77abd5a162ef88440102129fffbb404c",
              "Size": 2884006,
              "StorageClass": "STANDARD"
          }
    ],
      "CommonPrefixes": [ ]
}
```

--------------------------------

### Linux Cloud Assistant Client Installation (Shanghai)

Source: https://docs.jdcloud.com/cn/virtual-machines/Install-cloudassistant-client

Use this startup script to install the Cloud Assistant client on Linux instances in the Shanghai region. The script checks network connectivity, downloads the client, and installs it.

```bash
#!/bin/bash
date_time=`date '+%Y%m%d-%H%M%S'`
test_dir_name="assist-agent-${date_time}"

mkdir /home/$test_dir_name
cd /home/$test_dir_name

time_used=0
url="sh-cloudassistant.s3-internal.cn-east-2.jdcloud-oss.com"

while [ $time_used -le 600 ]; do
    ping $url -c 1
    if [ $? -eq 0 ]; then
        echo "connected!"
        break
    else
        echo "Cannot access, continue"
        sleep 5
        ((time_used += 5 ))
    fi
done

wget https://$url/x86/jdcloudservice.tar.gz
tar zxvf jdcloudservice.tar.gz
cd jdcloudservice
./install.sh

systemctl status jdcloudservice

```

--------------------------------

### Example Video Task Query Request

Source: https://docs.jdcloud.com/cn/object-storage-service/query-video-task

An example of an HTTP GET request to query a specific video task. This includes sample headers like Date, Authorization, Host, and User-Agent.

```http
GET getVideoTask&taskId=11311576e2ee46d3b11dd4672d8e13c4 HTTP/1.1
Date: Tue, 15 Dec 2015 12:43:24 GMT
Authorization: jingdong 2sTXh1AoApNv5x8p:AsYj3qfR2lhnwZT+5ZweZG0JgOs=
Host: oss.cn-north-1.jcloudcs.com
Connection: Keep-Alive
User-Agent: JFS-JCLOUD-SDK-JAVA/1.0.0 (Java 1.8.0_45; Vendor Oracle Corporation; Windows 7 6.1; HttpClient 4.2.1)
```

--------------------------------

### Get Bucket with Prefix

Source: https://docs.jdcloud.com/cn/object-storage-service/api/getbucket

This example shows how to list objects in a bucket using only a prefix for filtering.

```APIDOC
## GET /

### Description
Retrieves a list of objects within a bucket, filtered by a specified prefix.

### Method
GET

### Endpoint
`/?prefix={prefix}`

### Query Parameters
- **prefix** (string) - Optional - Specifies a prefix to filter the objects returned.

### Response
#### Success Response (200)
- **Name** (string) - The name of the bucket.
- **Prefix** (string) - The prefix used for filtering.
- **Marker** (string) - The marker used for pagination.
- **NextMarker** (string) - The marker for the next page of results.
- **Delimiter** (string) - The delimiter used for grouping.
- **MaxKeys** (integer) - The maximum number of keys to return.
- **HasNext** (boolean) - Indicates if there are more results.
- **HasCommonPrefix** (boolean) - Indicates if common prefixes are returned.
- **Contents** (array) - A list of objects matching the criteria.
  - **Key** (string) - The object key.
  - **LastModified** (string) - The last modified date of the object.
  - **ETag** (string) - The ETag of the object.
  - **Size** (integer) - The size of the object in bytes.
  - **StorageClass** (string) - The storage class of the object.
- **CommonPrefixes** (array) - A list of common prefixes found.

#### Response Example
```json
{
      "Name": "oss-example",
      "Prefix": "jingdong/",
      "Marker":   null,
      "NextMarker":null,
      "Delimiter": null,
      "MaxKeys": 1000,
      "HasNext": false,
      "HasCommonPrefix": true,
      "Contents": [
          {
              "Key": "jingdong/dir/file",
              "LastModified": "Mon, 17 Jul 2017 12:12:39 GMT",
              "ETag": "77abd5a162ef88440102129fffbb404c",
              "Size": 2884006,
              "StorageClass": "STANDARD"
          },
          {
              "Key": "jingdong/dir/file2",
              "LastModified": "Mon, 17 Jul 2017 12:14:49 GMT",
              "ETag": "77abd5a162ef88440102129fffbb404c",
              "Size": 2884006,
              "StorageClass": "STANDARD"
          },
          {
              "Key": "jingdong/test.jpg",
              "LastModified": "Mon, 17 Jul 2017 12:12:17 GMT",
              "ETag": "77abd5a162ef88440102129fffbb404c",
              "Size": 2884006,
              "StorageClass": "STANDARD"
          }
    ],
      "CommonPrefixes": [ ]
}
```
```

--------------------------------

### startInstance

Source: https://docs.jdcloud.com/cn/iavm/linuxs

Starts a specified Linux system host that is currently stopped.

```APIDOC
## POST /instances/{instanceId}/start

### Description
Starts a specified Linux system host that is currently stopped.

### Method
POST

### Endpoint
/instances/{instanceId}/start

### Parameters
#### Path Parameters
- **instanceId** (string) - Required - The ID of the instance to start.

### Response
#### Success Response (200)
- **requestId** (string) - The ID of the request.

#### Response Example
```json
{
  "requestId": "req-xxxxxxxx"
}
```
```

--------------------------------

### Install AWS SDK for Go

Source: https://docs.jdcloud.com/cn/object-storage-service/sdk-go

Run this command to install the AWS SDK for Go.

```bash
go get github.com/aws/aws-sdk-go

```

--------------------------------

### Get Snapshot Template Response

Source: https://docs.jdcloud.com/cn/media-processing-service/api/getsnapshottemplate

This is an example of a successful JSON response when querying for a snapshot template.

```json
{
    "requestId": "bgvmivir54gddpgi764se9f4kfr7ge41", 
    "result": {
        "createTime": "2019-04-16T15:51:32Z", 
        "fillType": "stretch", 
        "format": "jpg", 
        "frameType": "any", 
        "height": 480, 
        "interval": 10, 
        "number": 10, 
        "spriteConfig": {
            "cellHeight": 48, 
            "cellWidth": 48, 
            "columns": 10,
            "doKeepShots": true,
            "rows": 10
        }, 
        "startTime": 0,
        "templateId": "c35a7f843a6e49a4a32b1f8fab99fbd8", 
        "title": "我的截图模板", 
        "updateTime": "2019-04-16T15:51:32Z", 
        "width": 720
    }
}
```

--------------------------------

### OpenClaw Quick Deployment Guide

Source: https://docs.jdcloud.com/cn/iavm/openclawbs

This section outlines the steps for a quick deployment of OpenClaw, including creating applications, setting up Linux and Windows hosts, and one-click deployment of 幻兽帕鲁.

```APIDOC
## OpenClaw Quick Deployment Guide

### Description
This guide provides instructions for quickly deploying OpenClaw. It covers the process of creating applications, setting up Linux and Windows system hosts, and offers a one-click deployment option for 幻兽帕鲁.

### Topics Covered:
- Quick application creation
- Creating Linux system hosts
- Creating Windows system hosts
- One-click deployment of 幻兽帕鲁
- Methods for logging into Windows systems
```

--------------------------------

### Get Bucket Response with Prefix and Delimiter

Source: https://docs.jdcloud.com/cn/object-storage-service/api/getbucket

This is an example of a successful response from the Get Bucket API when both prefix and delimiter parameters are used. It shows how to list objects and common prefixes under a specific directory structure.

```json
HTTP/1.1 200 OK
Server: nginx
Date: Tue, 11 Jul 2017   08:05:13 GMT
Content-Type: application/json;charset=UTF-8
Content-Length: 456
Connection: keep-alive
Vary: Accept-Encoding
Vary: Accept-Encoding
x-jss-request-id:   96F2C2E9FC9B3BE5
X-Trace:   200-1499760313279-0-0-20-45-45
 
{
      "Name": "oss-example",
      "Prefix": "jingdong/",
      "Marker": null,
      "NextMarker":null,
      "Delimiter": "/",
      "MaxKeys": 1000,
      "HasNext": false,
      "HasCommonPrefix": false,
      "Contents": [
          {
              "Key": "jingdong/test.jpg",
              "LastModified": "Mon, 17 Jul 2017 12:12:17 GMT",
              "ETag": "77abd5a162ef88440102129fffbb404c",
              "Size": 2884006,
              "StorageClass": "STANDARD"
          }
    ],
      "CommonPrefixes": [
          "jingdong/dir"
    ]
}
```

--------------------------------

### List Watermark Templates Request

Source: https://docs.jdcloud.com/cn/media-processing-service/api/listWatermarkTemplates

This is an example GET request to list watermark templates with specified pagination.

```bash
https://mps.jdcloud-api.com/v1/watermarkTemplates?pageNumber=1&pageSize=10

```

--------------------------------

### Slow Log Response Example

Source: https://docs.jdcloud.com/cn/jcs-for-redis/api/describeslowlog

An example of the JSON response structure when retrieving slow query logs. It includes the request ID, and a list of slow logs with command details, execution time, shard ID, and start time.

```json
{
    "requestId": "c3o9oteswcpou221oegepq4mtd4or99c", 
    "result": {
        "slowLogs": [
            {
                "command": "hgetall post:user1:1234", 
                "executionTime": "10.58 ms", 
                "shardId": "redis-1234-shard-0", 
                "startTime": "2021-07-14T08:09:48Z"
            },
            {
                "command": "keys *", 
                "executionTime": "15.85 ms", 
                "shardId": "redis-1234-shard-0", 
                "startTime": "2021-07-14T08:06:20Z"
            }
        ],
        "totalCount": 2
    }
}
```

--------------------------------

### OSS SDK Initialization with Access Keys

Source: https://docs.jdcloud.com/cn/object-storage-service/Regularupload

Demonstrates initializing the OSS client with access key ID and secret access key. These credentials are required for authentication.

```java
OSSClient ossClient = new OSSClient(endpoint, accessKeyId, accessKeySecret);
```

--------------------------------

### Response Example for DescribeTaskProgressList

Source: https://docs.jdcloud.com/cn/jcs-for-redis/api/describetaskprogresslist

This is an example of the JSON response received after calling the DescribeTaskProgressList API. It shows the request ID and the details of the task progress, including task type, ID, status, progress percentage, elapsed time, and start time.

```json
```json
{
    "requestId": "c3o9ovh8ujsqnfm8bw56piuoqcn03ue4", 
    "result": {
        "taskProgresses": [
            {
                "elapsedTimeSecond": 443,
                "progressPercent": 100,
                "startTime": "2021-07-08T06:20:18Z", 
                "taskId": "c3j9i8fr05a7bhcbuncr3hj39nipmguc", 
                "taskStatus": "success", 
                "taskType": "resize"
            }
        ]
    }
}

```
```

--------------------------------

### Java SDK: Get Bucket Policy

Source: https://docs.jdcloud.com/cn/object-storage-service/buy-resourcepkg

Example of retrieving the bucket policy using the S3 compatible Java SDK for OSS.

```java
OSSClient ossClient = new OSSClient("http://oss-cn-hangzhou.aliyuncs.com", "<accessKeyId>", "<accessKeySecret>");
//获取存储桶策略
String bucketPolicy = ossClient.getBucketPolicy("my-bucket");
System.out.println("Bucket policy:" + bucketPolicy);
//关闭client
ossClient.shutdown();
```

--------------------------------

### Create Local Table Example

Source: https://docs.jdcloud.com/cn/jchdb/sqlgrammar

Example of creating a replicated local table 'ontime_local' with specific columns, partitioning, ordering, and sampling.

```sql
CREATE TABLE ontime_local ON CLUSTER default
(
    Year UInt16,
    Quarter UInt8,
    Month UInt8,
    DayofMonth UInt8,
    DayOfWeek UInt8,
    FlightDate Date,
    FlightNum String,
    Div5WheelsOff String,
    Div5TailNum String
)ENGINE = ReplicatedMergeTree('/clickhouse/tables/{shard}/ontime_local','{replica}')
 PARTITION BY toYYYYMM(FlightDate)
 PRIMARY KEY (intHash32(FlightDate))
 ORDER BY (intHash32(FlightDate),FlightNum)
 SAMPLE BY intHash32(FlightDate)
SETTINGS index_granularity= 8192 ;
```

--------------------------------

### Create OSS Bucket

Source: https://docs.jdcloud.com/cn/object-storage-service/listbucketsdemo

Step-by-step instructions on how to create a new storage bucket in OSS using the console or API.

```text
创建存储空间
```

--------------------------------

### Media Processing Service: Get Video Task List API

Source: https://docs.jdcloud.com/cn/object-storage-service/default-encryption-for-oss-buckets-2

Example of using the API to retrieve a list of video processing tasks.

```json
{
  "Action": "ListVideoTasks",
  "Bucket": "your-bucket-name",
  "Status": "Processing"
}
```

--------------------------------

### 控制台创建Deployment及静态块存储卷挂载示例

Source: https://docs.jdcloud.com/cn/jcs-for-kubernetes/create-pv-dynamically

Example of creating a Deployment and mounting a static block volume (CDS) using the console. This involves configuring the Deployment to use a pre-existing PersistentVolumeClaim for block storage.

```yaml
apiVersion: apps/v1
kind: Deployment
metadata:
  name: my-app-block
spec:
  replicas: 1
  selector:
    matchLabels:
      app: my-app-block
  template:
    metadata:
      labels:
        app: my-app-block
    spec:
      containers:
        - name: my-app-container
          image: nginx
          ports:
            - containerPort: 80
          volumeMounts:
            - name: my-block-volume
              mountPath: /usr/share/nginx/html
      volumes:
        - name: my-block-volume
          persistentVolumeClaim:
            claimName: my-pvc
```

--------------------------------

### Java SDK: Get Bucket Metadata

Source: https://docs.jdcloud.com/cn/object-storage-service/buy-resourcepkg

Example of retrieving metadata for a specific bucket using the S3 compatible Java SDK for OSS.

```java
OSSClient ossClient = new OSSClient("http://oss-cn-hangzhou.aliyuncs.com", "<accessKeyId>", "<accessKeySecret>");
//获取存储空间元数据
BucketMeta bucketMeta = ossClient.getBucketMeta("my-bucket");
System.out.println("Bucket location:" + bucketMeta.getLocation());
//关闭client
ossClient.shutdown();
```

--------------------------------

### Get Bucket with Prefix and Delimiter

Source: https://docs.jdcloud.com/cn/object-storage-service/api/getbucket

This example demonstrates how to list objects in a bucket, filtering by a prefix and specifying a delimiter to simulate directory structures.

```APIDOC
## GET /

### Description
Retrieves a list of objects within a bucket, optionally filtered by a prefix and a delimiter. This allows for simulating directory listings.

### Method
GET

### Endpoint
`/?prefix={prefix}&delimiter={delimiter}`

### Query Parameters
- **prefix** (string) - Optional - Specifies a prefix to filter the objects returned.
- **delimiter** (string) - Optional - Specifies a delimiter, typically '/' to simulate directory structures.

### Request Example
```http
GET   /?prefix=jingdong%2F&delimiter=%2F HTTP/1.1
Host: oss-example.s-bj.jcloud.com
Date: Tue, 11 Jul 2017   08:05:13 GMT    
Authorization: jingdong   qbS5QXpLORrvdrmb:jXw8QQvs6IS+JJ2EpiFMUGtgNEM=
```

### Response
#### Success Response (200)
- **Name** (string) - The name of the bucket.
- **Prefix** (string) - The prefix used for filtering.
- **Marker** (string) - The marker used for pagination.
- **NextMarker** (string) - The marker for the next page of results.
- **Delimiter** (string) - The delimiter used for grouping.
- **MaxKeys** (integer) - The maximum number of keys to return.
- **HasNext** (boolean) - Indicates if there are more results.
- **HasCommonPrefix** (boolean) - Indicates if common prefixes are returned.
- **Contents** (array) - A list of objects matching the criteria.
  - **Key** (string) - The object key.
  - **LastModified** (string) - The last modified date of the object.
  - **ETag** (string) - The ETag of the object.
  - **Size** (integer) - The size of the object in bytes.
  - **StorageClass** (string) - The storage class of the object.
- **CommonPrefixes** (array) - A list of common prefixes found.

#### Response Example
```json
{
      "Name": "oss-example",
      "Prefix": "jingdong/",
      "Marker": null,
      "NextMarker":null,
      "Delimiter": "/",
      "MaxKeys": 1000,
      "HasNext": false,
      "HasCommonPrefix": false,
      "Contents": [
          {
              "Key": "jingdong/test.jpg",
              "LastModified": "Mon, 17 Jul 2017 12:12:17 GMT",
              "ETag": "77abd5a162ef88440102129fffbb404c",
              "Size": 2884006,
              "StorageClass": "STANDARD"
          }
    ],
      "CommonPrefixes": [
          "jingdong/dir"
    ]
}
```
```

--------------------------------

### Download Cloud Assistant Client Package (Suqian)

Source: https://docs.jdcloud.com/cn/virtual-machines/Install-cloudassistant-client

Download the Cloud Assistant client installation package for Linux instances in the Suqian region.

```bash
wget https://sq-cloudassistant.s3-internal.cn-east-1.jdcloud-oss.com/x86/jdcloudservice.tar.gz

```

--------------------------------

### Create MongoDB Configuration File

Source: https://docs.jdcloud.com/cn/jcs-for-mongodb/export-data

Create a configuration file for starting mongod in single-node mode. This example uses the WiredTiger storage engine.

```bash
touch /root/mongo/mongod.conf
```

```yaml
systemLog:
    destination: file
    path: /home/Logs/mongod.log
    logAppend: true
security:
    authorization: enabled
storage:
    dbPath: /home/data
    directoryPerDB: true
net:
    port: 27017
    unixDomainSocket:
    enabled: false
processManagement:
    fork: true
    pidFilePath: /home/var/mongod.pid
```

--------------------------------

### 控制台创建Deployment及静态文件存储卷挂载示例

Source: https://docs.jdcloud.com/cn/jcs-for-kubernetes/create-pv-dynamically

Example of creating a Deployment and mounting a static file volume (CFS) using the console. This involves configuring the Deployment to use a pre-existing PersistentVolumeClaim.

```yaml
apiVersion: apps/v1
kind: Deployment
metadata:
  name: my-app
spec:
  replicas: 1
  selector:
    matchLabels:
      app: my-app
  template:
    metadata:
      labels:
        app: my-app
    spec:
      containers:
        - name: my-app-container
          image: nginx
          ports:
            - containerPort: 80
          volumeMounts:
            - name: my-volume
              mountPath: /usr/share/nginx/html
      volumes:
        - name: my-volume
          persistentVolumeClaim:
            claimName: my-static-pvc
```

--------------------------------

### Request Example for DescribeBandwidthPackage

Source: https://docs.jdcloud.com/cn/virtual-private-cloud/api/describebandwidthpackage

This snippet shows how to make a GET request to retrieve the details of a specific shared bandwidth package using its region and ID.

```bash
GET
https://vpc.jdcloud-api.com/v1/regions/cn-north-1/bandwidthPackages/bwp-1njs5vuoh7
```
Tokens:
Raw