すべてのプロダクト
Search
ドキュメントセンター

:API 操作の呼び出し料金

最終更新日:Oct 18, 2024

Object Storage Service (OSS) の操作は、OSS API 操作を呼び出すことによって実行できます。 料金は、API リクエストの数に基づいて計算されます。 ビジネスアプリケーションでコールドアーカイブオブジェクトへのアクセスが必要な場合は、オブジェクトにアクセスする前にコールドアーカイブオブジェクトを復元する必要があります。 この場合、データ取得料金も課金されます。

説明

このトピックでは、OSS の課金項目と課金方法について説明します。 詳細については、[OSS の料金] ページをご覧ください。

課金項目

API 操作の呼び出し料金には、PUTリクエスト、GET リクエスト、データ取得リクエストの料金が含まれます。

重要

バケットへの PUT リクエストと GET リクエストの料金を、バケット所有者ではなくリクエスト元が支払う必要がある場合は、バケットに対してリクエスト元課金を有効化できます。 詳細については、「リクエスト元課金の有効化」をご参照ください。

課金項目

課金ルール

課金サイクル

課金方法

PUT リクエスト (PutRequest)

PUT リクエストを送信するために呼び出された OSS API に対して課金されます。 PUT リクエストの詳細については、「PUT リクエスト」をご参照ください。

説明

失敗したリクエストに対しては課金されません。 失敗したリクエストには、HTTP ステータスコード 4xx または 5xx が返されたリクエストが含まれます。

課金は時間単位で行われます。 料金は、Alibaba Cloud アカウントの残高から自動的に差し引かれます。 通常の場合、請求書は課金サイクルの終了後に生成されます。 請求書が生成される時刻は、システムによって決定されます。

  • 従量課金:API 操作の呼び出し料金 = リクエスト数 × 10,000 リクエストあたりの単価 / 10,000

  • リソースプラン:サポートされていません。

GET リクエスト (GetRequest)

GET リクエストを送信するために呼び出された OSS API に対して課金されます。 GET リクエストの詳細については、「GET リクエスト」をご参照ください。

説明

失敗したリクエストに対しては課金されません。 失敗したリクエストには、HTTP ステータスコード 4xx または 5xx が返されたリクエストが含まれます。

  • 従量課金:API 操作の呼び出し料金 = リクエスト数 × 10,000 リクエストあたりの単価 / 10,000

  • リソースプラン:サポートされていません。

コールドアーカイブデータの取得リクエスト

コールドアーカイブオブジェクトにアクセスする場合、事前に復元しておく必要があります。 コールドアーカイブオブジェクトの復元に必要な時間は、オブジェクトのサイズと選択した復元の優先順位によって変わります。 コールドアーカイブオブジェクトを復元すると、データ取得料金が発生します。 コールドアーカイブオブジェクトの復元は、データ取得リクエストと見なされます。 リクエストの数は、オブジェクトのサイズとは無関係です。

データ取得リクエストは、復元優先順位に基づいて以下のタイプに分類されます。

  • 標準 (CAStdRetrievalRequest)

  • 優先 (CAHighPriorRetrievalRequest)

  • 一括 (CABulkRetrievalRequest)

  • 従量課金:API 操作の呼び出し料金 = リクエスト数 × 10,000 リクエストあたりの単価 / 10,000

  • リソースプラン:サポートされていません。

ディープコールドアーカイブデータの取得リクエスト

ディープコールドアーカイブオブジェクトにアクセスする場合、事前に復元しておく必要があります。 ディープコールドアーカイブオブジェクトの復元に必要な時間は、オブジェクトのサイズと選択した復元の優先順位によって変わります。 ディープコールドアーカイブオブジェクトを復元すると、データ取得料金が発生します。 ディープコールドアーカイブオブジェクトの復元は、データ取得リクエストと見なされます。 リクエストの数は、オブジェクトのサイズとは無関係です。

ディープコールドアーカイブのデータ取得リクエストは、復元優先順位に基づいて以下のタイプに分類されます。

  • 標準 (DeepCAStdRetrievalRequest)

  • 優先 (DeepCAHighPriorRetrievalRequest)

  • 従量課金:API 操作の呼び出し料金 = リクエスト数 × 10,000 リクエストあたりの単価 / 10,000

  • リソースプラン:サポートされていません。

PUT リクエストと GET リクエストの詳細については、「機能別操作一覧」をご参照ください。

PUT リクエスト

PUT リクエストには、OSS API、SDK、またはコンソールを使用して、データアップロード、データコピー、データ削除などの操作を実行するために開始されるリクエストが含まれます。

Request

説明

PutBucket

バケットを作成します。

GetBucket (ListObject) または GetBucketV2 (ListObjectsV2)

バケット内のすべてのオブジェクトを一覧表示します。

PutBucketACL

バケットのアクセス制御リスト (ACL) を設定します。

PutBucketInventory

バケットのインベントリを設定します。

DeleteBucketInventory

バケットに設定されている特定のインベントリを削除します。

PutBucketLogging

バケットに対するロギングを有効化します。

DeleteBucketLogging

バケットに対するロギングを無効化します。

PutBucketWebsite

バケットの静的 Web サイトホスティングを有効化し、バケットのリダイレクションルールを設定します。

DeleteBucketWebsite

バケットの静的 Web サイトホスティングを無効化し、バケットに設定されたリダイレクションルールを削除します。

PutBucketReferer

リファラーホワイトリストを設定し、空の Referer フィールドを持つリクエストを許可するかどうかを指定します。

PutBucketLifecycle

バケットのライフサイクルルールを設定します。

CommitTransition

オブジェクトのストレージクラスを自動的に変換するためのライフサイクルルールを設定します。

重要

ライフサイクルルールに基づいて IA、アーカイブ、またはコールドアーカイブオブジェクトがディープコールドアーカイブオブジェクトに変換される場合、標準オブジェクトが IA、アーカイブ、コールドアーカイブ、またはディープコールドアーカイブオブジェクトに変換される場合と比較して、PUT リクエストの料金が高額になります。

ExpireObject

ライフサイクルルールに基づいてオブジェクトを削除します。

重要
  • 中国本土のリージョンでは、ライフサイクルルールに基づいて IA、アーカイブ、またはコールドアーカイブオブジェクトが削除された場合、標準オブジェクトが削除された場合の PUT リクエスト料金と比較して高額の PUT リクエスト料金が課金されます。 ライフサイクルルールを使用してディープコールドアーカイブオブジェクトを削除する場合、PUTリクエスト料金は課金されません。

  • 中国 (香港) リージョンおよび中国本土外のリージョンでは、ライフサイクルルールを使用してストレージクラスのオブジェクトを削除した場合、PUT リクエスト料金は課金されません。

DeleteBucketLifecycle

バケットのライフサイクルルールを削除します。

DeleteBucket

バケットを削除します。

PutObject

オブジェクトをアップロードします。

CopyObject

オブジェクトを同じバケットまたは同じリージョン内の別のバケットにコピーします。

AppendObject

オブジェクトをアップロードして、オブジェクトのコンテンツを既存のオブジェクトに追加します。

DeleteObject

単一のオブジェクトを削除します。

DeleteMultipleObjects

複数のオブジェクトを削除します。

PutObjectACL

オブジェクトの ACL を設定します。

PostObject

HTML フォームを使用してオブジェクトをアップロードします。

PutSymlink

シンボリックリンクを作成します。

RestoreObject

アーカイブ、コールドアーカイブ、またはディープコールドアーカイブオブジェクトを復元します。

InitiateMultipartUpload

マルチパートアップロードタスクを開始します。

UploadPart

指定したオブジェクト名とアップロード ID に基づいて、オブジェクトをパーツ単位でアップロードします。

AbortMultipartUpload

マルチパートアップロードタスクをキャンセルし、アップロードしたパーツを削除します。

    重要
    • 中国本土のリージョンでは、ライフサイクルルールに基づいて IA、アーカイブ、またはコールドアーカイブのパーツを削除した場合、標準パーツを削除した場合と比較して高額の PUT リクエスト料金が課金されます。 ライフサイクルルールを使用してディープコールドアーカイブのパーツを削除する場合、PUT リクエスト料金は課金されません。

    • 中国 (香港) リージョンおよび中国本土外のリージョンでは、ライフサイクルルールを使用してパーツを削除する場合、ストレージクラスにかかわらず PUT リクエスト料金は課金されません。

UploadPartCopy

オブジェクトをパーツごとにコピーします。

ListMultipartUploads

開始後、完了またはキャンセルされていないタスクを含む、進行中のすべてのマルチパートアップロードタスクを一覧表示します。

ListParts

特定のアップロード ID を使用してアップロードされたすべてのパーツを一覧表示します。

PutBucketReplication

バケットのデータレプリケーションルールを設定します。

DeleteBucketReplication

バケットのデータレプリケーションタスクを停止し、バケットのデータレプリケーションルールを削除します。

PutBucketCors

バケットに対してクロスオリジンリソース共有 (CORS) を設定します。

DeleteBucketCors

バケットの CORS 設定を削除します。

CompleteMultipartUpload

マルチパートアップロードタスクを完了します。

InitiateBucketWorm

バケットの保持ポリシーを作成します。

AbortBucketWorm

ロック解除された保持ポリシーを削除します。

CompleteBucketWorm

保持ポリシーをロックします。

ExtendBucketWorm

保持ポリシーがロックされているバケット内のオブジェクトの保持期間 (日数) を延長します。

PutBucketVersioning

バケットのバージョン管理を有効化します。

ListObjectVersions (GetBucketVersions)

削除マーカーを含む、バケット内のすべてのオブジェクトのバージョンを一覧表示します。

PutBucketPolicy

バケットポリシーを設定します。

DeleteBucketPolicy

バケットポリシーを削除します。

PutBucketTags

バケットにタグを追加、またはバケットのタグを変更します。

DeleteBucketTags

バケットのタグを削除します。

PutBucketEncryption

バケットのデータ暗号化ルールを設定します。

DeleteBucketEncryption

バケットのデータ暗号化ルールを削除します。

PutBucketRequestPayment

バケットに対するリクエスト元支払いを設定します。

PutObjectTagging

オブジェクトにタグを追加、またはオブジェクトのタグを変更します。

DeleteObjectTagging

オブジェクトのタグを削除します。

PutLiveChannel

LiveChannel を作成します。

DeleteLiveChannel

特定の LiveChannel を削除します。

PutLiveChannelStatus

LiveChannel のステータスを変更します。

PostVodPlaylist

LiveChannel のビデオオンデマンド (VOD) に使用されるプレイリストを生成します。

PutStyle

バケットに対する画像スタイルを作成します。

ListStyle

バケットに対して作成されたすべての画像スタイルを照会します。

DeleteStyle

バケットから画像スタイルを削除します。

WriteGetObjectResponse

カスタムレスポンスヘッダーとレスポンスデータを設定します。

GET リクエスト

GETリクエストには、GetBucket (ListObject) およびGetBucketV2 (ListObjectsV2) を除く、OSS API、OSS SDK、または OSS コンソールを使用して、すべてのオブジェクトおよびその他の情報に対して読み取り操作を実行するために開始されるリクエストが含まれます。

Request

説明

GetBucketAcl

バケットの ACL を照会します。

GetBucketLocation

バケットが配置されているデータセンターを照会します。

GetBucketInfo

バケットに関する情報を照会します。

GetBucketLogging

バケットのロギング設定を照会します。

GetBucketWebsite

バケットの静的 Web サイトホスティング設定を照会します。

GetBucketReferer

バケットのリファラー設定を照会します。

GetBucketLifecycle

バケットのライフサイクルルールを照会します。

GetBucketReplication

バケットのデータレプリケーションルールを照会します。

GetBucketReplicationLocation

データをレプリケート可能なレプリケート先バケットのリージョンを照会します。

GetBucketReplicationProgress

データレプリケーションの進行状況を照会します。

GetBucketInventory

バケットの特定のインベントリを照会します。

ListBucketInventory

バケットのすべてのインベントリを照会します。

GetObject

オブジェクトをダウンロードします。

HeadObject

オブジェクトのすべてのメタデータを照会します。

GetObjectMeta

オブジェクトのメタデータ情報を照会します。

GetObjectACL

オブジェクトの ACL を照会します。

GetSymlink

シンボリックリンクを照会します。

GetBucketcors

バケットに設定された CORS ルールを照会します。

GetBucketWorm

バケットの保持ポリシーを照会します。

GetBucketVersioning

バケットのバージョン管理ステータスを照会します。

GetBucketPolicy

バケットのバケットポリシーを照会します。

GetBucketReferer

バケットのリファラー設定を照会します。

GetBucketTags

バケットのタグを照会します。

GetBucketEncryption

バケットの暗号化設定を照会します。

GetBucketRequestPayment

バケットのリクエスト支払い設定を照会します。

DoMetaQuery

特定の条件を満たすオブジェクトを照会し、特定のフィールドとソート方法に基づいてオブジェクト情報を一覧表示します。

GetObjectTagging

オブジェクトのタグを照会します。

ListLiveChannel

LiveChannel のリストを照会します。

GetLiveChannelInfo

特定の LiveChannel の設定を照会します。

GetLiveChannelStat

特定の LiveChannel のストリーム取り込みステータスを照会します。

GetLiveChannelHistory

特定の LiveChannel のストリーム取り込み履歴を照会します。

GetVodPlaylist

特定の期間内に特定の LiveChannel に取り込まれたストリームによって生成されたプレイリストを照会します。

GetStyle

バケットの特定の画像スタイルに関する情報を照会します。

get_image_info

画像に関する基本情報を照会します。

get_image_exif

イメージの EXIF データを照会します。

get_image_infoexif

画像の EXIF データに関する基本情報を照会します。

ProcessImage

画像を処理します。