第3章 Object Gateway Swift Application Programming Interface (API)


Ceph は、Swift API の基本データアクセスモデルと互換性のある RESTful API をサポートします。

以下の表は、現在の Swift 機能機能のサポート状況を示しています。

Expand
表3.1 機能
機能状態備考

認証

サポート対象

 

アカウントメタデータの取得

サポート対象

カスタムメタデータなし

Swift ACL

サポート対象

Swift ACL のサブセットに対応

コンテナーの一覧表示

サポート対象

 

コンテナーの削除

サポート対象

 

コンテナーの作成

サポート対象

 

コンテナーメタデータの取得

サポート対象

 

コンテナーメタデータの更新

サポート対象

 

コンテナーメタデータの削除

サポート対象

 

オブジェクトの一覧表示

サポート対象

 

静的な Web サイト

サポート対象外

 

マルチテナンシー

サポート対象

 

オブジェクトの作成/更新

サポート対象

 

大規模オブジェクトの作成

サポート対象

 

オブジェクトの削除

サポート対象

 

オブジェクトの取得

サポート対象

 

オブジェクトのコピー

サポート対象

 

オブジェクトメタデータの取得

サポート対象

 

オブジェクトメタデータの追加/更新

サポート対象

 

一時 URL 操作

サポート対象

 

オブジェクトの期限設定

サポート対象

 

オブジェクトのバージョン管理

サポート対象外

 

CORS

サポート対象外

 

3.1. 認証

認証を必要とする Swift API リクエストには、要求ヘッダーに X-Storage-Token 認証トークンが含まれている必要があります。トークンは、Ceph Object Gateway から別のオーセンティケーターから取得できます。Ceph Object Gateway からトークンを取得するには、ユーザーを作成する必要があります。

構文

# radosgw-admin user create --uid="<user_name>" --display-name="<display_name>"
Copy to Clipboard Toggle word wrap

# radosgw-admin user create --uid="swift1" --display-name="First Swift User"
Copy to Clipboard Toggle word wrap

features テーブルに戻ります。

3.1.1. authentication GET

ユーザーを認証するには、X-Auth-User および X-Auth-Key を含むリクエストを作成します。

構文

GET /auth HTTP/1.1
Host: swift.radosgwhost.com
X-Auth-User: johndoe
X-Auth-Key: R7UUOLFDI2ZI9PRCQ53K
Copy to Clipboard Toggle word wrap

Expand
表3.2 リクエストヘッダー
名前説明必須

X-Auth-User

認証するキーの Ceph Object Gateway のユーザー名。

文字列

はい

X-Auth-Key

Ceph Object Gateway のユーザー名に関連付けられたキー。

文字列

はい

サーバーからのレスポンスには、X-Auth-Token の値が含まれている必要があります。応答には、API ドキュメント全体で他の要求で指定した < api_version>/<account > 接頭辞を提供する X-Storage-Url が含まれる場合があります。

Expand
表3.3 レスポンスヘッダー
名前説明

X-Storage-Token

要求に指定された X-Auth-User の承認トークン。

文字列

X-Storage-Url

ユーザーの URL および <api_version>/<account > パス。

String

レスポンスの例

HTTP/1.1 204 No Content
Date: Mon, 16 Jul 2012 11:05:33 GMT
Server: swift
X-Storage-Url: https://swift.radosgwhost.com/v1/ACCT-12345
X-Storage-Token: UOlCCC8TahFKlWuv9DB09TWHF0nDjpPElha0kAa
Content-Length: 0
Content-Type: text/plain; charset=UTF-8
Copy to Clipboard Toggle word wrap

トップに戻る
Red Hat logoGithubredditYoutubeTwitter

詳細情報

試用、購入および販売

コミュニティー

Red Hat ドキュメントについて

Red Hat をお使いのお客様が、信頼できるコンテンツが含まれている製品やサービスを活用することで、イノベーションを行い、目標を達成できるようにします。 最新の更新を見る.

多様性を受け入れるオープンソースの強化

Red Hat では、コード、ドキュメント、Web プロパティーにおける配慮に欠ける用語の置き換えに取り組んでいます。このような変更は、段階的に実施される予定です。詳細情報: Red Hat ブログ.

会社概要

Red Hat は、企業がコアとなるデータセンターからネットワークエッジに至るまで、各種プラットフォームや環境全体で作業を簡素化できるように、強化されたソリューションを提供しています。

Theme

© 2025 Red Hat