tencent cloud

Cloud Object Storage

最新情報とお知らせ
製品アップデート情報
製品のお知らせ
製品概要
製品概要
機能概要
応用シナリオ
製品の優位性
基本概念
リージョンとアクセスドメイン名
仕様と制限
製品の課金
課金概要
課金方式
課金項目
無料利用枠
記帳例
請求書の確認とダウンロード
お支払い遅れについて
よくある質問
クイックスタート
コンソールクイックスタート
COSBrowserクイックスタート
ユーザーガイド
リクエストの作成
バケット
オブジェクト
データ管理
バッチ処理
グローバルアクセラレーション
監視とアラーム
運用管理センター
データ処理
インテリジェントツールボックス使用ガイド
データワークフロー
アプリ統合
ツールガイド
ツール概要
環境のインストールと設定
COSBrowserツール
COSCLIツール
COSCMDツール
COS Migrationツール
FTP Serverツール
Hadoopツール
COSDistCpツール
HDFS TO COSツール
オンラインツール (Onrain Tsūru)
セルフ診断ツール
実践チュートリアル
概要
アクセス制御と権限管理
パフォーマンスの最適化
AWS S3 SDKを使用したCOSアクセス
データディザスタリカバリバックアップ
ドメイン名管理の実践
画像処理の実践
COSオーディオビデオプレーヤーの実践
データセキュリティ
データ検証
COSコスト最適化ソリューション
サードパーティアプリケーションでのCOSの使用
移行ガイド
サードパーティクラウドストレージのデータをCOSへ移行
データレークストレージ
クラウドネイティブデータレイク
メタデータアクセラレーション
データアクセラレーター GooseFS
データ処理
データ処理概要
画像処理
メディア処理
コンテンツ審査
ファイル処理
ドキュメントプレビュー
トラブルシューティング
RequestId取得の操作ガイド
パブリックネットワーク経由でのCOSへのファイルアップロード速度の遅さ
COSへのアクセス時に403エラーコードが返される
リソースアクセス異常
POST Objectの一般的な異常
セキュリティとコンプライアンス
データ災害復帰
データセキュリティ
クラウドアクセスマネジメント
よくある質問
よくあるご質問
一般的な問題
従量課金に関するご質問
ドメインコンプライアンスに関するご質問
バケット設定に関する質問
ドメイン名とCDNに関するご質問
ファイル操作に関するご質問
権限管理に関するご質問
データ処理に関するご質問
データセキュリティに関するご質問
署名付きURLに関するご質問
SDKクラスに関するご質問
ツール類に関するご質問
APIクラスに関するご質問
Agreements
Service Level Agreement
プライバシーポリシー
データ処理とセキュリティ契約
連絡先
用語集
ドキュメントCloud Object Storage

HEAD Object

フォーカスモード
フォントサイズ
最終更新日: 2025-12-22 17:28:14

Introduction

This document describes the sample code and description for querying object metadata via the Node.js SDK in COS.

Notes

If you want to query the metadata of the target object, you need to have read permission for the target object: when you configure the authorization policy, the action needs to be set to cos:HeadObject. For more authorization, see business interfaces supporting CAM.

Feature Overview

Query the metadata information of an object.

Preliminary Preparation

Before starting to use, ensure that you have completed SDK initialization.

Use Case

cos.headObject({
Bucket: 'examplebucket-1250000000', // Fill in your own bucket; mandatory field.
Region: 'COS_REGION', // Bucket region, for example ap-beijing; mandatory field.
Key: '1.jpg', // object key stored in the bucket (for example, 1.jpg, a/b/test.txt); mandatory field.
}, function(err, data) {
console.log(err || data);
});

Parameter Description

Parameter Name
Parameter Description
Type
Required
Bucket
The name of the bucket, in the format of BucketName-APPID; the bucket name filled in here must be in this format.
String
Yes
Region
Bucket region; for enumerated values, see Regions and Access Domains
String
Yes
Key
Object key (name of the Object), which uniquely identifies the object in the bucket. For details, see Object Overview
String
Yes
IfModifiedSince
If the object has been modified after the specified time, the metadata information of the corresponding object is returned; otherwise, 304 is returned.
String
No

Description of the callback function

function(err, data) { ... }
Parameter Name
Parameter Description
Type
err
The object returned when an error occurs in the request, including network errors and business errors. It is null if the request is successful. For more details, see Error Codes.
Object
- statusCode
HTTP status code returned by the request, such as 200, 403, 404.
Number
- headers
Header returned by the request
Object
data
The object returned when the request is successful, or null if an error occurs in the request.
Object
- ETag
The unique identifier of the returned file. For files uploaded via simple upload, the ETag is the MD5 hash of the file. The value of the ETag can be used to check whether the object was corrupted during the upload process.
For example, "09cba091df696af91549de27b8e7d0f6", Note: The ETag value string is enclosed in double quotes.
String
- VersionId
When an object is uploaded to a bucket with versioning enabled, the version ID of the object is returned; if versioning has never been enabled for the bucket, this parameter is not returned.
String
- statusCode
HTTP status code returned by the request, such as 200, 304, and so on. It returns 304 if the resource has not been modified after the specified time.
Number
- headers
Header returned by the request
Object
- - x-cos-object-type
Indicates whether the object can be appended to. Enumerated values: normal, appendable. By default, normal is not returned.
String
- - x-cos-storage-class
The storage class of the object. Enumerated values: STANDARD, STANDARD_IA, ARCHIVE, DEEP_ARCHIVE, and so on. Default: STANDARD (not returned). For more storage classes, see Storage Class Overview.
String
- - x-cos-meta-*
User-defined metadata
String
- - NotModified
Whether the object has not been modified after the specified time
Boolean

API Operations

Description of the API interface for querying object metadata, see the HEAD Object document.

ヘルプとサポート

この記事はお役に立ちましたか?

フィードバック