JD Cloud Object Storage Service

https://docs.jdcloud.com/cn/object-storage-service/
Admin
This project documents the JD Cloud Object Storage Service (OSS), covering its features, API...
Tokens:1,601,349
Snippets:16,095
Trust Score:9.8
Update:3 months ago
Show doc for...
Tokens:
Raw
### OSS Getting Started Guide

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

Guides for quickly starting with OSS, including console quick start and S3 Browser quick start.

```APIDOC
## Getting Started with OSS

### Description
Provides step-by-step instructions to help new users begin using the Object Storage Service (OSS) efficiently, covering console and S3 Browser initial setups.

### Quick Start Options
- Console Quick Start
- S3 Browser Quick Start
```

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

### OSS Getting Started - Console Quick Start

Source: https://docs.jdcloud.com/cn/object-storage-service/create-video-snapshot

This guide provides a quick start for using the Object Storage Service (OSS) console to perform basic operations.

```APIDOC
## OSS Getting Started - Console Quick Start

### Description
This guide provides a quick start for using the Object Storage Service (OSS) console to perform basic operations.

### Steps
- **Console Quick Start**: Instructions for navigating and using the OSS management console.
```

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

### Object Storage Service (OSS) - Getting Started

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

Guides to help users start using OSS, including console and S3 Browser quick starts.

```APIDOC
## OSS Getting Started Guide

### Description
This guide provides instructions for new users to quickly begin using JD Cloud's Object Storage Service (OSS).

### Quick Start Options
- **Console Quick Start**: Step-by-step guide using the JD Cloud management console.
- **S3 Browser Quick Start**: Instructions for using S3 Browser to interact with OSS.
```

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

### Object Storage Service - Getting Started

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

Guides to help new users quickly start using the Object Storage Service.

```APIDOC
## Getting Started

### Console Quick Start
- **Description**: A guide to quickly get started using the Object Storage Service via the management console.

### S3 Browser Quick Start
- **Description**: A guide to quickly get started using the Object Storage Service with S3 Browser.
```

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

### OSS Console Quick Start

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

A guide to getting started with OSS using the web-based console. Covers basic operations like creating buckets and uploading files.

```text
Console quick start
```

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

### OSS Getting Started - S3 Browser Quick Start

Source: https://docs.jdcloud.com/cn/object-storage-service/create-video-snapshot

This guide provides a quick start for using S3 Browser with Object Storage Service (OSS) for basic file management.

```APIDOC
## OSS Getting Started - S3 Browser Quick Start

### Description
This guide provides a quick start for using S3 Browser with Object Storage Service (OSS) for basic file management.

### Steps
- **S3 Browser Quick Start**: Instructions for connecting and using S3 Browser with OSS.
```

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

### S3 Browser Quick Start

Source: https://docs.jdcloud.com/cn/object-storage-service/manage-oss-with-s3browser

This section provides a quick start guide for using S3 Browser to manage your OSS resources. It covers the initial setup and basic operations.

```APIDOC
## S3 Browser Quick Start

### Description
This guide helps you get started with S3 Browser for managing your Object Storage Service (OSS) resources. It covers the essential steps to connect to your OSS and perform basic operations.

### Method
N/A (Client-side tool usage)

### Endpoint
N/A (Client-side tool usage)

### Parameters
N/A (Configuration within S3 Browser)

### Request Example
N/A

### Response
N/A
```

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

### Console Quick Start

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

A quick start guide for using the OSS console to manage your storage resources.

```N/A
    * 控制台快速入门
```

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

### OSS Operation Guide: Media Processing Service (Legacy) - Quick Start

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

Quick start guides for using the legacy Media Processing Service, including video transcoding and screenshotting workflows.

```APIDOC
## Media Processing Service (Legacy) - Quick Start

### Create Video Transcoding Workflow
Steps to create a video transcoding workflow.

### Create Video Screenshot Workflow
Steps to create a video screenshot workflow.
```

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

### OSS S3 Browser Quick Start

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

Guide to quickly start using OSS with S3 Browser for object storage management.

```en
控制台快速入门 
 S3 Browser 快速入门
```

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

### OSS Operation Guide - Open Service

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

This guide provides instructions on how to enable and start using the Object Storage Service (OSS).

```APIDOC
## OSS Operation Guide - Open Service

### Description
This guide provides instructions on how to enable and start using the Object Storage Service (OSS).

### Opening the Service
- **Steps**: Instructions on how to open and activate the OSS service.
```

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

### Example GET Request for Bucket Referer

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

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

```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

```

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

### SDK Usage - Python

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

Guide to using the Python SDK for interacting with OSS, including installation, initialization, and common operations.

```APIDOC
## SDK Reference - Python

Interact with OSS using the recommended Python SDK.

### Installation

Install the OSS SDK using pip:

```bash
pip install jdcloud-sdk-python
```

### Initialization

Initialize the OSS client with your credentials and endpoint.

```python
from jdcloud_sdk.services.oss.oss_client import OssClient
from jdcloud_sdk.core.credential import BasicCredentials

# Replace with your actual credentials and endpoint
access_key_id = "your-access-key-id"
secret_access_key = "your-secret-access-key"
region_id = "your-region" # e.g., "cn-north-1"
endpoint = "oss.jdcloud.com"

credentials = BasicCredentials(access_key_id, secret_access_key)
ossc = OssClient(credentials, region_id, endpoint)
```

### Bucket Operations

#### Create Bucket

```python
ossc.create_bucket(bucket_name="your-new-bucket-name")
```

#### List Buckets

```python
response = ossc.list_buckets()
if response.error is None:
    for bucket in response.buckets:
        print(bucket.name)
```

### Object Operations

#### Upload Object

```python
with open("path/to/your/file.txt", "rb") as f:
    response = ossc.put_object(bucket_name="your-bucket-name", object_key="your-object-key", content=f)
    if response.error:
        print(f"Upload failed: {response.error}")
```

#### Download Object

```python
response = ossc.get_object(bucket_name="your-bucket-name", object_key="your-object-key")
if response.error is None:
    with open("path/to/save/file.txt", "wb") as f:
        f.write(response.content)
```

#### Delete Object

```python
ossc.delete_object(bucket_name="your-bucket-name", object_key="your-object-key")
```
```

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

### Create S3 Bucket using Java SDK (S3 Browser Quick Start)

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

Example of creating a bucket using the Java SDK, as might be done in a quick start guide.

```java
AmazonS3 s3Client = AmazonS3ClientBuilder.standard().build();
s3Client.createBucket("example-bucket-name");
```

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

### Compatible S3 SDK-.NET

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

Usage guide for the compatible S3 SDK with .NET applications. Covers setup and examples for C# and other .NET languages.

```csharp
using Amazon.S3;
```

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

### Initialize Java SDK for OSS

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

Demonstrates how to initialize the Java SDK for OSS. Ensure you have the correct dependencies and credentials configured.

```java
import com.amazonaws.regions.Regions;
import com.amazonaws.services.s3.AmazonS3;
import com.amazonaws.services.s3.AmazonS3ClientBuilder;

public class OssSdkExample {

    public static void main(String[] args) {
        // Initialize the S3 client
        AmazonS3 s3Client = AmazonS3ClientBuilder.standard()
                .withRegion(Regions.US_EAST_1) // Specify your region
                .build();

        // Now you can use s3Client to interact with OSS
        System.out.println("OSS Client initialized successfully.");
    }
}
```

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

### Best Practice: Bucket Policy Examples

Source: https://docs.jdcloud.com/cn/object-storage-service/add-text-watermarks

Provides practical examples and recommendations for implementing Bucket Policies in JD Cloud OSS. This helps in setting up robust access control.

```json
{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Principal": {"AWS": "arn:aws:iam::123456789012:user/test"},
      "Action": ["s3:GetObject"],
      "Resource": ["arn:aws:s3:::my-bucket-name/*"]
    }
  ]
}
```

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

### Compatible S3 SDK-Node.js

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

Guide for using the compatible S3 SDK with Node.js. Covers installation, configuration, and examples for server-side or client-side JavaScript applications.

```javascript
const AWS = require('aws-sdk');
```

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

### GET Object Request Example

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

An example of a GET Object request to retrieve a specific object.

```http
GET /my-image.jpg HTTP/1.1
Host: oss-example.s3.<region>.jcloudcs.com 
Date: Mon, 3 Oct 2016 22:32:00 GMT
Authorization: <authorization string>

```

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

### GET Bucket Accelerate Response Example

Source: https://docs.jdcloud.com/cn/object-storage-service/api/get-bucket-accelerate

Example response for the GET Bucket accelerate operation.

```http
HTTP/1.1 200 OK
x-amz-request-id: 51991C342C575321
Date: Thu, 15 Nov 2012 00:17:23 GMT
Server: JDCloudOSS
Content-Length: length

<AccelerateConfiguration xmlns="http://s3.amazonaws.com/doc/2006-03-01/">
  <Status>Enabled</Status>
</AccelerateConfiguration>
```

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

### Go SDK: Initialize S3 Compatible Client

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

Example of initializing the OSS client using S3 compatible SDK for Go.

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

// Replace with your OSS endpoint and credentials
endpoint := "http://oss-cn-hangzhou.aliyuncs.com"
accessKeyID := "YOUR_ACCESS_KEY_ID"
secretAccessKey := "YOUR_ACCESS_KEY_SECRET"

session, err := session.NewSession(&aws.Config{
	Endpoint:         aws.String(endpoint),
	Region:           aws.String("cn-hangzhou"), // Region might be needed
	DisableSSL:       aws.Bool(true), // Use true if your endpoint is http
	S3ForcePathStyle: aws.Bool(true), // Often required for S3 compatible storage
})
if err != nil {
	panic(err)
}

// Create an S3 client
svc := s3.New(session, &aws.ClientConfig{
	Credentials: credentials.NewStaticCredentials(accessKeyID, secretAccessKey, ""),
})

// Now you can use svc to interact with OSS
```

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

### S3cmd: Manage OSS using Command Line

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

This example shows how to use the s3cmd tool to manage OSS. It demonstrates basic operations like listing buckets and uploading files.

```bash
# Configure s3cmd with your OSS credentials and endpoint
s3cmd ls
s3cmd put local_file.txt s3://your-bucket-name/object_key.txt
```

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

### Request Example for GET Object retention

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

An example of a GET Object retention API request, including necessary headers.

```HTTP
GET /<object-key>?retention HTTP/1.1
Host: <BUCKET_NAME>.s3.<REGION>.jdcloud-oss.com
Date: Thu, 12 Apr 2018 21:37:21 GMT
Authorization: authorization string

```

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

### GET Object legal hold Request Example

Source: https://docs.jdcloud.com/cn/object-storage-service/api/get-object-legal-hold

An example of a GET Object legal hold request with specific headers.

```HTTP
GET /<object-key>?legal-hold HTTP/1.1
Host: <BUCKET_NAME>.s3.<REGION>.jdcloud-oss.com
Date: Thu, 12 Apr 2018 21:37:21 GMT
Authorization: authorization string

```

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

### OSS Best Practices - Tools Guide

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

A guide covering various tools that can be used for managing and interacting with OSS.

```N/A
    * 工具指南
```

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

### GET Bucket website Request Example

Source: https://docs.jdcloud.com/cn/object-storage-service/api/get-bucket-website-2

This example shows a typical GET request to retrieve a bucket's website configuration.

```HTTP
GET ?website HTTP/1.1
Host: <BUCKET_NAME>.s3.<REGION>.jdcloud-oss.com
Date: Thu, 27 Jan 2011 00:49:20 GMT
Authorization: <authorization string>
```

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

### GET Service Request Example

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

An example of a GET Service request. Replace placeholders like <BUCKET_NAME>, <REGION>, and <authorization string> with your specific details.

```http
GET / HTTP/1.1
Host: <BUCKET_NAME>.s3.<REGION>.jdcloud-oss.com
Date: Wed, 01 Mar  2006 12:00:00 GMT
Authorization: <authorization string>
```

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

### Enable Bucket Logging Request Example

Source: https://docs.jdcloud.com/cn/object-storage-service/api/put-bucket-logging

This example demonstrates how to enable bucket logging by specifying a target bucket and prefix.

```http
PUT ?logging HTTP/1.1
Host: <BUCKET_NAME>.s3.<REGION>.jdcloud-oss.com
Content-Length: 163
x-amz-date: Thu, 12 Apr 2012 20:04:21 GMT
Authorization: authorization string

<BucketLoggingStatus>
<LoggingEnabled>
<TargetBucket>examplebucket</TargetBucket>
<TargetPrefix>MyLog-</TargetPrefix>
</LoggingEnabled>
</BucketLoggingStatus>
```

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

### Response Example for GET Object retention

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

An example of a successful response from the GET Object retention API, showing the retention mode and retain until date.

```XML
HTTP/1.1 200 OK
x-amz-request-id: 0M26D08072A8EX6A
x-amz-date: Thu, 12 Apr 2018 21:37:21 GMT
Content-Length: 643
Server: JDCloudOSS

<Retention>
    <Mode>GOVERNANCE</Mode>
    <RetainUntilDate>2019-06-16T10:00:00.000Z</RetainUntilDate>
</Retention>

```

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

### S3 Object Metadata Demo Main Method

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

Entry point for the S3 metadata demonstration. Initializes the S3 client and calls various metadata-related methods.

```Java
public static void main(String[] args) {
        String accessKey = "your-access-key";
        String secretKey = "your-secret-key";
        String region = "cn-north-1";
        String bucketName = "your-bucket-name";
        
        S3GetMetadataV1 example = new S3GetMetadataV1(accessKey, secretKey, region);
        
        // 示例1：基本获取元数据
        example.getObjectMetadataBasic(bucketName, "documents/report.pdf");
        
        // 示例2：使用请求对象获取元数据
        example.getObjectMetadataWithRequest(bucketName, 
                                           "data/config.json", 
                                           null);
        
        // 示例3：获取对象内容
        example.getObjectWithMetadata(bucketName, "logs/application.log");
        
        // 示例4：批量获取元数据
        example.batchGetObjectsMetadata(bucketName, "images/");
        
        // 示例5：检查特定元数据
        boolean exists = example.checkMetadataExists(
            bucketName, 
            "documents/contract.docx", 
            "Contract-Status", 
            "Approved"
        );
        System.out.println("元数据检查结果: " + exists);
        
        // 示例6：检查对象是否存在
        example.checkObjectExists(bucketName, "non-existent-file.txt");
    }
```

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

### Example GET Bucket Notification Request

Source: https://docs.jdcloud.com/cn/object-storage-service/api/get-bucket-notification-2

An example of a GET request to retrieve notification settings for a bucket. This includes the Host, Date, and Authorization headers.

```HTTP
GET ?notification HTTP/1.1 
Host: <BUCKET_NAME>.s3.<REGION>.jdcloud-oss.com
Date: Wed, 15 Oct 2014 16:59:03 GMT
Authorization: <authorization string>
```

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

### Get Bucket ACL Request Example

Source: https://docs.jdcloud.com/cn/object-storage-service/api/get-bucket-acl-2

An example of a GET request to retrieve a bucket's ACL. This includes the Host, Date, and Authorization headers.

```http
GET ?acl HTTP/1.1
Host: <BUCKET_NAME>.s3.<REGION>.jdcloud-oss.com
Date: Wed, 28 Oct 2009 22:32:00 GMT
Authorization: <authorization string>
```

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

### Initialize S3 SDK for .NET

Source: https://docs.jdcloud.com/cn/object-storage-service/product-terms-of-service

Instructions and code examples for initializing the S3 SDK for .NET to interact with OSS. This covers setting up the client.

```csharp
// This section would contain C# code examples for initializing the S3 SDK on .NET.
```

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

### GET Object legal hold Response Example

Source: https://docs.jdcloud.com/cn/object-storage-service/api/get-object-legal-hold

An example of a successful response to a GET Object legal hold request, indicating the legal hold status.

```HTTP
HTTP/1.1 200 OK
x-amz-request-id: 0M26D08072A8EX6A
x-amz-date: Thu, 12 Apr 2018 21:37:21 GMT
Content-Length: 341
Server: JDCloudOSS

<LegalHold>
   <Status>ON</Status>
</LegalHold>  

```

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

### SDK Usage - Java

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

Guide to using the Java SDK for interacting with OSS, including installation, initialization, and common operations.

```APIDOC
## SDK Reference - Java

Interact with OSS using the recommended Java SDK.

### Installation

Add the OSS SDK dependency to your project (e.g., Maven or Gradle).

```xml
<dependency>
    <groupId>com.jdcloud.sdk</groupId>
    <artifactId>oss-java-sdk</artifactId>
    <version>x.y.z</version>
</dependency>
```

### Initialization

Initialize the OSS client with your credentials and endpoint.

```java
import com.jdcloud.sdk.service.oss.client.OssClient;
import com.jdcloud.sdk.service.oss.model.OssConfig;

// ...

OssConfig config = new OssConfig();
config.setEndpoint("oss.jdcloud.com"); // Replace with your region endpoint

OssClient ossClient = OssClient.builder()
    .region("your-region") // e.g., "cn-north-1"
    .credentials("your-access-key-id", "your-secret-access-key")
    .config(config)
    .build();
```

### Bucket Operations

#### Create Bucket

```java
ossClient.createBucket("your-new-bucket-name");
```

#### List Buckets

```java
List<Bucket> buckets = ossClient.listBuckets();
for (Bucket bucket : buckets) {
    System.out.println(bucket.getName());
}
```

### Object Operations

#### Upload Object

```java
ossClient.putObject("your-bucket-name", "your-object-key", new File("path/to/your/file.txt"));
```

#### Download Object

```java
ossClient.getObject("your-bucket-name", "your-object-key", new File("path/to/save/file.txt"));
```

#### Delete Object

```java
ossClient.deleteObject("your-bucket-name", "your-object-key");
```
```

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

### Example Bucket Lifecycle Configuration

Source: https://docs.jdcloud.com/cn/object-storage-service/api/put-bucket-lifecycle

This example demonstrates how to configure lifecycle rules for a bucket. It includes rules for expiring objects after a certain number of days and transitioning objects to a different storage class.

```XML
<LifecycleConfiguration>
  <Rule>
    <ID>id1</ID>
    <Filter>
       <Prefix>documents/</Prefix>
    </Filter>
    <Status>Enabled</Status>
    <Expiration>
      <Days>365</Days>
    </Expiration>
  </Rule>
  <Rule>
    <ID>id2</ID>
    <Filter>
       <Prefix>documents/</Prefix>
    </Filter>
    <Status>Enabled</Status>
    <Transition>
      <Days>30</Days>
      <StorageClass>GLACIER</StorageClass>
    </Transition>
  </Rule>
</LifecycleConfiguration>
```

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

### GET Bucket Logging Request Example

Source: https://docs.jdcloud.com/cn/object-storage-service/api/get-bucket-logging

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

```HTTP
GET ?logging HTTP/1.1
Host: <BUCKET_NAME>.s3.<REGION>.jdcloud-oss.com
Date: date
Authorization: authorization string


```

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

### Configure OSS Lifecycle

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

Step-by-step guide on configuring lifecycle rules for OSS storage spaces (buckets).

```N/A
        * 配置生命周期
```

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

### Example Bucket Policy GET Request

Source: https://docs.jdcloud.com/cn/object-storage-service/api/get-bucket-policy-2

An example of a GET request to retrieve a bucket policy. This includes a sample Host header and a placeholder for the Authorization string.

```HTTP
GET ?policy HTTP/1.1
Host: <BUCKET_NAME>.s3.<REGION>.jdcloud-oss.com
Date: Wed, 28 Oct 2009 22:32:00 GMT
Authorization: <authorization string>
```

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

### OSS SDK: Overview

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

Provides a general introduction to the OSS SDKs available for various programming languages. Highlights their purpose and benefits.

```text
# SDKs simplify interaction with OSS, abstracting API calls.
# Supported languages include Java, Python, Go, Node.js, PHP, iOS, Ruby, .NET, Rust.
```

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

### GET Bucket Tagging Request Example

Source: https://docs.jdcloud.com/cn/object-storage-service/api/get-bucket-tagging

An example of a GET Bucket tagging request. This demonstrates the structure of the request, including the Host header which specifies the bucket and region.

```HTTP
GET ?tagging HTTP/1.1
Host: <BUCKET_NAME>.s3.<REGION>.jdcloud-oss.com
Date: date
Authorization: authorization string

```

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

### Initialize S3 .NET SDK

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

Provides an example of initializing the S3-compatible SDK for .NET.

```csharp
using Amazon.S3;
using Amazon.S3.Model;

var config = new AmazonS3Config
{
    ServiceURL = endpoint,
    Region = region
};

var s3Client = new AmazonS3Client(accessKeyId, secretAccessKey, config);
```

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

### Example Request for Get Video Task List

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

An example of a GET request to search for video tasks with specific query parameters. This includes detailed JSON parameters for filtering and pagination.

```HTTP
GET http://oss.cn-north-1.jcloudcs.com/?searchVideoList&videoTaskQuery=%7B%22flag%22%3A0%2C%22mysqlPage%22%3A0%2C%22orderCloumn%22%3A%22update_time%22%2C%22orderType%22%3A%22desc%22%2C%22page%22%3A1%2C%22pageSize%22%3A10%2C%22status%22%3A0%7DHTTP/1.1
Date: Tue, 15 Dec 2015 12:59:11 GMT
Authorization: jingdong 2sTXh1AoApNv5x8p:opNHt6cimASzR20CcsglKbpSaxQ=
Content-Length: 0
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)

```

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

### Initialize S3 Go SDK

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

Provides instructions on how to initialize the S3 Go SDK for interacting with OSS. Ensure you configure the correct region and credentials.

```go
import (
	"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() {
	ssess, err := session.NewSession(&aws.Config{
		Region: aws.String("cn-hangzhou"),
		Endpoint: aws.String("https://oss-cn-hangzhou.aliyuncs.com"),
	})
	if err != nil {
		panic(err)
	}

	ssvc := s3.New(sess)
	_ = ssvc // Use the s3 service client
}
```

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

### Initialize S3 Compatible Python SDK

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

This code example shows how to initialize the S3 compatible Python SDK (boto3). Ensure your AWS credentials and endpoint are correctly configured.

```python
import boto3

s3 = boto3.client('s3',
    endpoint_url='http://oss.example.com',
    region_name='us-east-1', # Replace with your region
    aws_access_key_id='YOUR_ACCESS_KEY_ID',
    aws_secret_access_key='YOUR_SECRET_ACCESS_KEY'
)

# Use s3 for S3 operations
```

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

### GET Service Response Example

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

An example XML response for the GET Service operation, listing the owner and their buckets with creation dates. This response is returned upon successful authentication and request.

```xml
<?xml version="1.0" encoding="UTF-8"?>
<ListAllMyBucketsResult xmlns="http://s3.amazonaws.com/doc/2006-03-01">
  <Owner>
    <ID>bcaf1ffd86f461ca5fb16fd081034f</ID>
    <DisplayName>webfile</DisplayName>
  </Owner>
  <Buckets>
    <Bucket>
      <Name>quotes</Name>
      <CreationDate>2006-02-03T16:45:09.000Z</CreationDate>
    </Bucket>
    <Bucket>
      <Name>samples</Name>
      <CreationDate>2006-02-03T16:41:58.000Z</CreationDate>
    </Bucket>
  </Buckets>
</ListAllMyBucketsResult>
```

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

### Bucket Management Guide

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

This guide explains how to manage storage buckets in OSS, including creation, deletion, listing, and configuring access permissions and lifecycle rules.

```APIDOC
## Storage Space Management

This section details the management of storage buckets (referred to as storage spaces) within OSS.

### Storage Space Overview
General information about storage buckets and their purpose.

### Create Storage Space
Instructions for creating a new storage bucket.

### Delete Storage Space
Procedures for deleting an existing storage bucket.

### List Storage Space
How to retrieve a list of all storage buckets associated with your account.

### Manage Storage Space Tags
Methods for adding, viewing, and managing tags for storage buckets.

### Query Bucket Usage
How to check the current storage usage for a specific bucket.

### Access Permission Settings
Configuration of access control for buckets.

### Lifecycle Management
*   **Lifecycle Overview**: Introduction to lifecycle management.
*   **Lifecycle Configuration Elements**: Details on the components of a lifecycle rule.
*   **Configure Lifecycle**: Steps to set up lifecycle rules for automatic object management (e.g., deletion, transition).

### Cross-domain Access Settings
Configuration for allowing cross-origin resource sharing (CORS).

### Static Website Hosting Settings
Enabling and configuring a bucket to host a static website.

### Custom Domain
Instructions for associating a custom domain name with your OSS bucket.

### Callback Notification
Setting up notifications for events related to object storage.

### Default Encryption
Configuring default encryption for objects stored in the bucket.

### Mirroring Back to Source
Setting up mirroring for data retrieval.

### Access Logs
Enabling and configuring access logging for buckets.

### Transfer Acceleration
Activating transfer acceleration for faster data uploads and downloads.

### Inventory Settings
Configuring inventory reports for objects within a bucket.
```

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

### GET Object Tagging Request Example

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

An example of a GET Object tagging request, including necessary headers like Date and Authorization. This request retrieves the tags for a specific object.

```HTTP
GET /<object-key>?tagging HTTP/1.1
Host: <BUCKET_NAME>.s3.<REGION>.jdcloud-oss.com
Date: Thu, 19 Apr 2020 22:18:21 GMT
Authorization: authorization string

```

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

### GET Object Response Example

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

Example of a successful HTTP response when retrieving an object.

```http
HTTP/1.1 200 OK
x-amz-request-id: 318BC8BC148832E5
Date: Mon, 3 Oct 2016 22:32:00 GMT
Last-Modified: Wed, 12 Oct 2009 17:50:00 GMT
ETag: "fba9dede5f27731c9771645a39863328"
Content-Length: 434234

[434234 bytes of object data]

```

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

### OSS SDK Documentation: Overview

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

Provides a general introduction to the SDKs available for interacting with JD Cloud Object Storage Service (OSS).

```text
JD Cloud offers SDKs in various programming languages to simplify integration with OSS. These SDKs are generally compatible with the S3 API.
```

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

### OSS Best Practices - Tool Guides

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

Guides on using various tools for managing OSS, including S3cmd, S3 Browser, and data migration tools.

```en
工具指南 
 使用S3cmd管理OSS 
 使用S3 Browser管理OSS 
 数据迁移工具 
 使用S3fs在Linux实例上挂载Bucket
```

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

### Example GET Request for List Parts

Source: https://docs.jdcloud.com/cn/object-storage-service/api/list-parts-2

An example of a GET request to list parts, including parameters like uploadId, max-parts, and part-number-marker. This request is useful for paginating through large numbers of parts.

```http
GET /example-object?uploadId=XXBsb2FkIElEIGZvciBlbHZpbmcncyVcdS1tb3ZpZS5tMnRzEEEwbG9hZA&max-parts=2&part-number-marker=1 HTTP/1.1
Host: oss-example.s3.<region>.jdcloud-oss.com
Date: Mon, 1 Nov 2010 20:34:56 GMT
Authorization: <authorization string>


```

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

### GET Bucket Tagging Response Example

Source: https://docs.jdcloud.com/cn/object-storage-service/api/get-bucket-tagging

This example shows a successful response (HTTP 200 OK) to a GET Bucket tagging request. It includes the bucket's tags within the <TagSet> element.

```XML
HTTP/1.1 200 OK
x-amz-request-id: 51991C342C575321
Date: Thu, 15 Nov 2012 00:17:23 GMT
Server: JDCloudOSS
Content-Length: length

<Tagging>
  <TagSet>
     <Tag>
       <Key>Project</Key>
       <Value>Project One</Value>
     </Tag>
     <Tag>
       <Key>User</Key>
       <Value>jsmith</Value>
     </Tag>
  </TagSet>
</Tagging>

```

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

### Initialize S3 Python SDK

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

Demonstrates initializing the S3 Python SDK (boto3) for OSS. Ensure the correct region and endpoint are configured.

```python
import boto3

s3 = boto3.client('s3',
                  region_name='cn-hangzhou',
                  endpoint_url='http://oss-cn-hangzhou.aliyuncs.com',
                  aws_access_key_id='YOUR_ACCESS_KEY_ID',
                  aws_secret_access_key='YOUR_SECRET_ACCESS_KEY')
```

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

### OSSutil Tool Guide

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

Guide on using the ossutil command-line tool for managing OSS resources, including uploading, downloading, and configuring buckets.

```bash
# ossutil configuration example:
# ~/.ossutilconfig
# [Credentials]
# language = EN
# endpoint = oss-cn-hangzhou.aliyuncs.com
# access_key_id = YOUR-ACCESSKEYID
# access_key_secret = YOUR-ACCESSKEYSECRET
# 
# Example command to upload a file:
# ossutil cp local_file.txt oss://your-bucket-name/remote_file.txt
```

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

### Create Website from Bucket with s3cmd

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

Use this command to configure a bucket to serve static website content.

```bash
s3cmd ws-create s3://BUCKET
```
Tokens:
Raw