A.19. NFS Ganesha
Ceph RESTful API の nfs-ganesha
エンドポイントを使用して Ceph NFS ゲートウェイを管理するメソッド参照。
GET /api/nfs-ganesha/daemon
- 説明
- NFS Ganesha デーモンに関する情報を表示します。
- 例
GET /api/nfs-ganesha/daemon HTTP/1.1 Host: example.com
- ステータスコード
- 200 OK – Okay.
- 400 Bad Request – Operation exception.詳細は、レスポンスボディーを確認してください。
- 401 Unauthorized – Unauthenticated access.最初にログインしてください。
- 403 Forbidden – Unauthorized access.パーミッションを確認してください。
- 500 Internal Server Error – Unexpected error.スタックトレースのレスポンスボディーを確認してください。
GET /api/nfs-ganesha/export
- 説明
- すべての NFS Ganesha エクスポートを表示します。
- 例
GET /api/nfs-ganesha/export HTTP/1.1 Host: example.com
- ステータスコード
- 200 OK – Okay.
- 400 Bad Request – Operation exception.詳細は、レスポンスボディーを確認してください。
- 401 Unauthorized – Unauthenticated access.最初にログインしてください。
- 403 Forbidden – Unauthorized access.パーミッションを確認してください。
- 500 Internal Server Error – Unexpected error.スタックトレースのレスポンスボディーを確認してください。
POST /api/nfs-ganesha/export
- 説明
- NFS Ganesha エクスポートを新たに作成します。
- 例
POST /api/nfs-ganesha/export HTTP/1.1 Host: example.com Content-Type: application/json { "access_type": "STRING", "clients": [ { "access_type": "STRING", "addresses": [ "STRING" ], "squash": "STRING" } ], "cluster_id": "STRING", "daemons": [ "STRING" ], "fsal": { "filesystem": "STRING", "name": "STRING", "rgw_user_id": "STRING", "sec_label_xattr": "STRING", "user_id": "STRING" }, "path": "STRING", "protocols": [ 1 ], "pseudo": "STRING", "reload_daemons": true, "security_label": "STRING", "squash": "STRING", "tag": "STRING", "transports": [ "STRING" ] }
- ステータスコード
- 201 Created – Resource created.
- 202 Accepted – Operation is still executing.タスクキューを確認してください。
- 400 Bad Request – Operation exception.詳細は、レスポンスボディーを確認してください。
- 401 Unauthorized – Unauthenticated access.最初にログインしてください。
- 403 Forbidden – Unauthorized access.パーミッションを確認してください。
- 500 Internal Server Error – Unexpected error.スタックトレースのレスポンスボディーを確認してください。
DELETE /api/nfs-ganesha/export/CLUSTER_ID/EXPORT_ID
- 説明
- NFS Ganesha エクスポートを削除します。
- パラメーター
-
CLUSTER_ID
はストレージクラスター識別子の文字列に置き換えます。 -
EXPORT_ID
は、エクスポート ID を整数に置き換えます。 クエリー:
-
reload_daemons
: NFS Ganesha デーモン設定の再読み込みをトリガーするブール値。
-
-
- ステータスコード
- 202 Accepted – Operation is still executing.タスクキューを確認してください。
- 204 No Content – Resource deleted.
- 400 Bad Request – Operation exception.詳細は、レスポンスボディーを確認してください。
- 401 Unauthorized – Unauthenticated access.最初にログインしてください。
- 403 Forbidden – Unauthorized access.パーミッションを確認してください。
- 500 Internal Server Error – Unexpected error.スタックトレースのレスポンスボディーを確認してください。
GET /api/nfs-ganesha/export/CLUSTER_ID/EXPORT_ID
- 説明
- NFS Ganesha エクスポート情報を表示します。
- パラメーター
-
CLUSTER_ID
はストレージクラスター識別子の文字列に置き換えます。 -
EXPORT_ID
は、エクスポート ID を整数に置き換えます。
-
- 例
GET /api/nfs-ganesha/export/CLUSTER_ID/EXPORT_ID HTTP/1.1 Host: example.com
- ステータスコード
- 200 OK – Okay.
- 400 Bad Request – Operation exception.詳細は、レスポンスボディーを確認してください。
- 401 Unauthorized – Unauthenticated access.最初にログインしてください。
- 403 Forbidden – Unauthorized access.パーミッションを確認してください。
- 500 Internal Server Error – Unexpected error.スタックトレースのレスポンスボディーを確認してください。
PUT /api/nfs-ganesha/export/CLUSTER_ID/EXPORT_ID
- 説明
- NFS Ganesha エクスポート情報を更新します。
- パラメーター
-
CLUSTER_ID
はストレージクラスター識別子の文字列に置き換えます。 -
EXPORT_ID
は、エクスポート ID を整数に置き換えます。
-
- 例
PUT /api/nfs-ganesha/export/CLUSTER_ID/EXPORT_ID HTTP/1.1 Host: example.com Content-Type: application/json { "access_type": "STRING", "clients": [ { "access_type": "STRING", "addresses": [ "STRING" ], "squash": "STRING" } ], "daemons": [ "STRING" ], "fsal": { "filesystem": "STRING", "name": "STRING", "rgw_user_id": "STRING", "sec_label_xattr": "STRING", "user_id": "STRING" }, "path": "STRING", "protocols": [ 1 ], "pseudo": "STRING", "reload_daemons": true, "security_label": "STRING", "squash": "STRING", "tag": "STRING", "transports": [ "STRING" ] }
- ステータスコード
- 200 OK – Okay.
- 202 Accepted – Operation is still executing.タスクキューを確認してください。
- 400 Bad Request – Operation exception.詳細は、レスポンスボディーを確認してください。
- 401 Unauthorized – Unauthenticated access.最初にログインしてください。
- 403 Forbidden – Unauthorized access.パーミッションを確認してください。
- 500 Internal Server Error – Unexpected error.スタックトレースのレスポンスボディーを確認してください。
GET /api/nfs-ganesha/status
- 説明
- NFS Ganesha 管理機能のステータス情報を表示します。
- 例
GET /api/nfs-ganesha/status HTTP/1.1 Host: example.com
- ステータスコード
- 200 OK – Okay.
- 400 Bad Request – Operation exception.詳細は、レスポンスボディーを確認してください。
- 401 Unauthorized – Unauthenticated access.最初にログインしてください。
- 403 Forbidden – Unauthorized access.パーミッションを確認してください。
- 500 Internal Server Error – Unexpected error.スタックトレースのレスポンスボディーを確認してください。
関連情報
- 詳細は、Red Hat Ceph Storage 開発者ガイドの Ceph RESTful API の章を参照してください。
- 詳細は、Red Hat Ceph Storage Object Gateway ガイド の namespace から NFS-Ganesha へのエクスポート セクションを参照してください。