Updated on 2024-05-09 GMT+08:00
Listing Versioning Objects
If you have any questions during development, post them on the Issues page of GitHub. For details about parameters and usage of each API, see the API Reference.
You can call ObsClient.listVersions to list versioning objects.
The following table describes the parameters involved in this API.
Parameter |
Description |
|---|---|
Prefix |
Prefix that the object names to be listed must contain. |
KeyMarker |
Versioning object name to start with when listing versioning objects in a bucket. All versioning objects are listed in the lexicographical order. |
MaxKeys |
Maximum number of listed versioning objects. The value ranges from 1 to 1000. If the specified value exceeds 1000, only 1,000 versioning objects are returned. |
Delimiter |
Character used to group object names. If the object name contains the Delimiter parameter, the character string from the first character to the first Delimiter parameter in the object name is grouped under a single result element, CommonPrefix. (If a prefix is specified in the request, the prefix must be removed from the object name.) |
VersionIdMarker |
All versioning objects are listed in the lexicographical order by object name and version ID. This parameter must be used together with KeyMarker. |
- If the value of VersionIdMarker is not a version ID specified by KeyMarker, VersionIdMarker is ineffective.
- The returned result of ObsClient.listVersions includes the versioning objects and delete markers.
Listing Versioning Objects in Simple Mode
The following sample code shows how to list versioning objects in simple mode. A maximum of 1,000 versioning objects can be returned.
// Import the OBS library.
// Use npm to install the client.
var ObsClient = require('esdk-obs-nodejs');
// Use the source code to install the client.
// var ObsClient = require('./lib/obs');
// Create an instance of ObsClient.
var obsClient = new ObsClient({
//Obtain an AK/SK pair using environment variables or import the AK/SK pair in other ways. Using hard coding may result in leakage.
//Obtain an AK/SK pair on the management console. For details, see https://support.huaweicloud.com/intl/en-us/usermanual-ca/ca_01_0003.html.
access_key_id: process.env.ACCESS_KEY_ID,
secret_access_key: process.env.SECRET_ACCESS_KEY,
server : 'https://your-endpoint'
});
obsClient.listVersions({
Bucket : 'bucketname'
}, (err, result) => {
if(err){
console.log('Error-->' + err);
}else{
console.log('Status-->' + result.CommonMsg.Status);
if(result.CommonMsg.Status < 300 && result.InterfaceResult){
// Obtain versioning objects.
for(let j=0;j<result.InterfaceResult.Versions.length;j++){
console.log('Version[' + j + ']:');
console.log('Key-->' + result.InterfaceResult.Versions[j]['Key']);
console.log('VersionId-->' + result.InterfaceResult.Versions[j]['VersionId']);
console.log('Owner[ID]-->' + result.InterfaceResult.Versions[j]['Owner']['ID']);
}
// Obtain delete markers.
for(let i=0;i<result.InterfaceResult.DeleteMarkers.length;i++){
console.log('DeleteMarker[' + i + ']:');
console.log('Key-->' + result.InterfaceResult.DeleteMarkers[i]['Key']);
console.log('VersionId-->' + result.InterfaceResult.DeleteMarkers[i]['VersionId']);
console.log('Owner[ID]-->' + result.InterfaceResult.DeleteMarkers[i]['Owner']['ID']);
}
}
}
});
- A maximum of 1,000 object versions can be listed each time. If a bucket contains more than 1,000 object versions, InterfaceResult.IsTruncated in the response is true, indicating not all object versions were listed. In such case, you can use InterfaceResult.NextKeyMarker and InterfaceResult.NextVersionIdMarker to obtain the start position for the next listing.
- If you want to obtain all versioning objects in a specified bucket, you can use the paging mode for listing objects.
Listing Versioning Objects by Specifying the Number
Sample code:
// Import the OBS library.
// Use npm to install the client.
var ObsClient = require('esdk-obs-nodejs');
// Use the source code to install the client.
// var ObsClient = require('./lib/obs');
// Create an instance of ObsClient.
var obsClient = new ObsClient({
//Obtain an AK/SK pair using environment variables or import the AK/SK pair in other ways. Using hard coding may result in leakage.
//Obtain an AK/SK pair on the management console. For details, see https://support.huaweicloud.com/intl/en-us/usermanual-ca/ca_01_0003.html.
access_key_id: process.env.ACCESS_KEY_ID,
secret_access_key: process.env.SECRET_ACCESS_KEY,
server : 'https://your-endpoint'
});
obsClient.listVersions({
Bucket : 'bucketname',
MaxKeys : 100
}, (err, result) => {
if(err){
console.log('Error-->' + err);
}else{
console.log('Status-->' + result.CommonMsg.Status);
if(result.CommonMsg.Status < 300 && result.InterfaceResult){
// Obtain versioning objects.
for(let j=0;j<result.InterfaceResult.Versions.length;j++){
console.log('Version[' + j + ']:');
console.log('Key-->' + result.InterfaceResult.Versions[j]['Key']);
console.log('VersionId-->' + result.InterfaceResult.Versions[j]['VersionId']);
console.log('Owner[ID]-->' + result.InterfaceResult.Versions[j]['Owner']['ID']);
}
// Obtain delete markers.
for(let i=0;i<result.InterfaceResult.DeleteMarkers.length;i++){
console.log('DeleteMarker[' + i + ']:');
console.log('Key-->' + result.InterfaceResult.DeleteMarkers[i]['Key']);
console.log('VersionId-->' + result.InterfaceResult.DeleteMarkers[i]['VersionId']);
console.log('Owner[ID]-->' + result.InterfaceResult.DeleteMarkers[i]['Owner']['ID']);
}
}
}
});
Listing Versioning Objects by Specifying a Prefix
Sample code:
// Import the OBS library.
// Use npm to install the client.
var ObsClient = require('esdk-obs-nodejs');
// Use the source code to install the client.
// var ObsClient = require('./lib/obs');
// Create an instance of ObsClient.
var obsClient = new ObsClient({
//Obtain an AK/SK pair using environment variables or import the AK/SK pair in other ways. Using hard coding may result in leakage.
//Obtain an AK/SK pair on the management console. For details, see https://support.huaweicloud.com/intl/en-us/usermanual-ca/ca_01_0003.html.
access_key_id: process.env.ACCESS_KEY_ID,
secret_access_key: process.env.SECRET_ACCESS_KEY,
server : 'https://your-endpoint'
});
;
// Set the prefix to prefix and the number to 100.
obsClient.listVersions({
Bucket : 'bucketname',
MaxKeys : 100,
Prefix : 'prefix'
}, (err, result) => {
if(err){
console.log('Error-->' + err);
}else{
console.log('Status-->' + result.CommonMsg.Status);
if(result.CommonMsg.Status < 300 && result.InterfaceResult){
// Obtain versioning objects.
for(let j=0;j<result.InterfaceResult.Versions.length;j++){
console.log('Version[' + j + ']:');
console.log('Key-->' + result.InterfaceResult.Versions[j]['Key']);
console.log('VersionId-->' + result.InterfaceResult.Versions[j]['VersionId']);
console.log('Owner[ID]-->' + result.InterfaceResult.Versions[j]['Owner']['ID']);
}
// Obtain delete markers.
for(let i=0;i<result.InterfaceResult.DeleteMarkers.length;i++){
console.log('DeleteMarker[' + i + ']:');
console.log('Key-->' + result.InterfaceResult.DeleteMarkers[i]['Key']);
console.log('VersionId-->' + result.InterfaceResult.DeleteMarkers[i]['VersionId']);
console.log('Owner[ID]-->' + result.InterfaceResult.DeleteMarkers[i]['Owner']['ID']);
}
}
}
});
Listing Versioning Objects by Specifying the Start Position
Sample code:
// Import the OBS library.
// Use npm to install the client.
var ObsClient = require('esdk-obs-nodejs');
// Use the source code to install the client.
// var ObsClient = require('./lib/obs');
// Create an instance of ObsClient.
var obsClient = new ObsClient({
//Obtain an AK/SK pair using environment variables or import the AK/SK pair in other ways. Using hard coding may result in leakage.
//Obtain an AK/SK pair on the management console. For details, see https://support.huaweicloud.com/intl/en-us/usermanual-ca/ca_01_0003.html.
access_key_id: process.env.ACCESS_KEY_ID,
secret_access_key: process.env.SECRET_ACCESS_KEY,
server : 'https://your-endpoint'
});
// List 100 versioning objects whose names following test in lexicographic order.
obsClient.listVersions({
Bucket : 'bucketname',
MaxKeys : 100,
KeyMarker : 'test'
}, (err, result) => {
if(err){
console.log('Error-->' + err);
}else{
console.log('Status-->' + result.CommonMsg.Status);
if(result.CommonMsg.Status < 300 && result.InterfaceResult){
// Obtain versioning objects.
for(let j=0;j<result.InterfaceResult.Versions.length;j++){
console.log('Version[' + j + ']:');
console.log('Key-->' + result.InterfaceResult.Versions[j]['Key']);
console.log('VersionId-->' + result.InterfaceResult.Versions[j]['VersionId']);
console.log('Owner[ID]-->' + result.InterfaceResult.Versions[j]['Owner']['ID']);
}
// Obtain delete markers.
for(let i=0;i<result.InterfaceResult.DeleteMarkers.length;i++){
console.log('DeleteMarker[' + i + ']:');
console.log('Key-->' + result.InterfaceResult.DeleteMarkers[i]['Key']);
console.log('VersionId-->' + result.InterfaceResult.DeleteMarkers[i]['VersionId']);
console.log('Owner[ID]-->' + result.InterfaceResult.DeleteMarkers[i]['Owner']['ID']);
}
}
}
});
Listing All Versioning Objects in Paging Mode
Sample code:
// Import the OBS library.
// Use npm to install the client.
var ObsClient = require('esdk-obs-nodejs');
// Use the source code to install the client.
// var ObsClient = require('./lib/obs');
// Create an instance of ObsClient.
var obsClient = new ObsClient({
//Obtain an AK/SK pair using environment variables or import the AK/SK pair in other ways. Using hard coding may result in leakage.
//Obtain an AK/SK pair on the management console. For details, see https://support.huaweicloud.com/intl/en-us/usermanual-ca/ca_01_0003.html.
access_key_id: process.env.ACCESS_KEY_ID,
secret_access_key: process.env.SECRET_ACCESS_KEY,
server : 'https://your-endpoint'
});
var listAll = (keyMarker, versionIdMarker) => {
obsClient.listVersions({
Bucket : 'bucketname',
MaxKeys : 100,
KeyMarker : keyMarker,
VersionIdMarker : versionIdMarker
}, (err, result) => {
if(err){
console.log('Error-->' + err);
}else{
console.log('Status-->' + result.CommonMsg.Status);
if(result.CommonMsg.Status < 300 && result.InterfaceResult){
// Obtain versioning objects.
for(let j=0;j<result.InterfaceResult.Versions.length;j++){
console.log('Version[' + j + ']:');
console.log('Key-->' + result.InterfaceResult.Versions[j]['Key']);
console.log('VersionId-->' + result.InterfaceResult.Versions[j]['VersionId']);
console.log('Owner[ID]-->' + result.InterfaceResult.Versions[j]['Owner']['ID']);
}
// Obtain delete markers.
for(let i=0;i<result.InterfaceResult.DeleteMarkers.length;i++){
console.log('DeleteMarker[' + i + ']:');
console.log('Key-->' + result.InterfaceResult.DeleteMarkers[i]['Key']);
console.log('VersionId-->' + result.InterfaceResult.DeleteMarkers[i]['VersionId']);
console.log('Owner[ID]-->' + result.InterfaceResult.DeleteMarkers[i]['Owner']['ID']);
}
if(result.InterfaceResult.IsTruncated === 'true'){
listAll(result.InterfaceResult.NextKeyMarker, result.InterfaceResult.NextVersionIdMarker);
}
}
}
});
};
listAll();
Listing All Versioning Objects in a Folder
There is no folder concept in OBS. All elements in buckets are objects. Folders are actually objects whose sizes are 0 and whose names end with a slash (/). When you set a folder name as the prefix, objects in this folder will be listed. Sample code is as follows:
// Import the OBS library.
// Use npm to install the client.
var ObsClient = require('esdk-obs-nodejs');
// Use the source code to install the client.
// var ObsClient = require('./lib/obs');
// Create an instance of ObsClient.
var obsClient = new ObsClient({
//Obtain an AK/SK pair using environment variables or import the AK/SK pair in other ways. Using hard coding may result in leakage.
//Obtain an AK/SK pair on the management console. For details, see https://support.huaweicloud.com/intl/en-us/usermanual-ca/ca_01_0003.html.
access_key_id: process.env.ACCESS_KEY_ID,
secret_access_key: process.env.SECRET_ACCESS_KEY,
server : 'https://your-endpoint'
});
var listAll = (keyMarker, versionIdMarker) => {
obsClient.listVersions({
Bucket : 'bucketname',
MaxKeys : 100,
KeyMarker : keyMarker,
VersionIdMarker : versionIdMarker,
// Set the prefix of objects in the folder to dir/.
Prefix : 'dir/'
}, (err, result) => {
if(err){
console.log('Error-->' + err);
}else{
console.log('Status-->' + result.CommonMsg.Status);
if(result.CommonMsg.Status < 300 && result.InterfaceResult){
// Obtain versioning objects.
for(let j=0;j<result.InterfaceResult.Versions.length;j++){
console.log('Version[' + j + ']:');
console.log('Key-->' + result.InterfaceResult.Versions[j]['Key']);
console.log('VersionId-->' + result.InterfaceResult.Versions[j]['VersionId']);
console.log('Owner[ID]-->' + result.InterfaceResult.Versions[j]['Owner']['ID']);
}
// Obtain delete markers.
for(let i=0;i<result.InterfaceResult.DeleteMarkers.length;i++){
console.log('DeleteMarker[' + i + ']:');
console.log('Key-->' + result.InterfaceResult.DeleteMarkers[i]['Key']);
console.log('VersionId-->' + result.InterfaceResult.DeleteMarkers[i]['VersionId']);
console.log('Owner[ID]-->' + result.InterfaceResult.DeleteMarkers[i]['Owner']['ID']);
}
if(result.InterfaceResult.IsTruncated === 'true'){
listAll(result.InterfaceResult.NextKeyMarker, result.InterfaceResult.NextVersionIdMarker);
}
}
}
});
};
listAll();
Listing All Versioning Objects According to Folders in a Bucket
Sample code:
// Import the OBS library.
// Use npm to install the client.
var ObsClient = require('esdk-obs-nodejs');
// Use the source code to install the client.
// var ObsClient = require('./lib/obs');
// Create an instance of ObsClient.
var obsClient = new ObsClient({
//Obtain an AK/SK pair using environment variables or import the AK/SK pair in other ways. Using hard coding may result in leakage.
//Obtain an AK/SK pair on the management console. For details, see https://support.huaweicloud.com/intl/en-us/usermanual-ca/ca_01_0003.html.
access_key_id: process.env.ACCESS_KEY_ID,
secret_access_key: process.env.SECRET_ACCESS_KEY,
server : 'https://your-endpoint'
});
obsClient.listVersions({
Bucket : 'bucketname',
// Set the folder isolators to slashes (/).
Delimiter : '/'
}, (err, result) => {
if(err){
console.log('Error-->' + err);
}else{
console.log('Objects in the root directory:');
if(result.CommonMsg.Status < 300 && result.InterfaceResult){
// Obtain versioning objects.
for(let j=0;j<result.InterfaceResult.Versions.length;j++){
console.log('Version[' + j + ']:');
console.log('Key-->' + result.InterfaceResult.Versions[j]['Key']);
console.log('VersionId-->' + result.InterfaceResult.Versions[j]['VersionId']);
console.log('Owner[ID]-->' + result.InterfaceResult.Versions[j]['Owner']['ID']);
}
// Obtain delete markers.
for(let i=0;i<result.InterfaceResult.DeleteMarkers.length;i++){
console.log('DeleteMarker[' + i + ']:');
console.log('Key-->' + result.InterfaceResult.DeleteMarkers[i]['Key']);
console.log('VersionId-->'+ result.InterfaceResult.DeleteMarkers[i]['VersionId']);
console.log('Owner[ID]-->' + result.InterfaceResult.DeleteMarkers[i]['Owner']['ID']);
}
}
var listVersionsByPrefix = (commonPrefixes) => {
for(let n=0;n<commonPrefixes.length;n++){
obsClient.listVersions({
Bucket : 'bucketname',
Delimiter : '/',
Prefix: commonPrefixes[n]['Prefix']
}, (err, result) => {
console.log('Objects in folder [' + commonPrefixes[n]['Prefix'] + ']:');
if(result.CommonMsg.Status < 300 && result.InterfaceResult){
// Obtain versioning objects.
for(let j=0;j<result.InterfaceResult.Versions.length;j++){
console.log('Version[' + j + ']:');
console.log('Key-->' + result.InterfaceResult.Versions[j]['Key']);
console.log('VersionId-->' + result.InterfaceResult.Versions[j]['VersionId']);
console.log('Owner[ID]-->' + result.InterfaceResult.Versions[j]['Owner']['ID']);
}
// Obtain delete markers.
for(let i=0;i<result.InterfaceResult.DeleteMarkers.length;i++){
console.log('DeleteMarker[' + i + ']:');
console.log('Key-->' + result.InterfaceResult.DeleteMarkers[i]['Key']);
console.log('VersionId-->' + result.InterfaceResult.DeleteMarkers[i]['VersionId']);
console.log('Owner[ID]-->' + result.InterfaceResult.DeleteMarkers[i]['Owner']['ID']);
}
console.log('\n');
if(result.InterfaceResult.CommonPrefixes && result.InterfaceResult.CommonPrefixes.length > 0){
listVersionsByPrefix(result.InterfaceResult.CommonPrefixes);
}
}
});
}
};
listVersionsByPrefix(result.InterfaceResult.CommonPrefixes);
}
});
- The previous sample code does not include scenarios where the number of objects in a folder exceeds 1000.
- Because objects and sub-folders in a folder are to be listed and all the objects end with a slash (/), Delimiter is always a slash (/).
- In the returned result of each recursion, InterfaceResult.Versions includes the versioning objects in the folder, InterfaceResult.DeleteMarkers includes the delete markers involved in the folder, and InterfaceResult.CommonPrefixes includes the sub-folders in the folder.
Parent topic: Versioning Management
Feedback
Was this page helpful?
Provide feedbackThank you very much for your feedback. We will continue working to improve the documentation.See the reply and handling status in My Cloud VOC.
The system is busy. Please try again later.
For any further questions, feel free to contact us through the chatbot.
Chatbot
