Delete a container#
空のコンテナを削除します。
📒注: コンテナ内にオブジェクトが存在する場合、本操作は失敗します。
APIエンドポイント#
| リージョン | APIエンドポイント |
|---|---|
| 西日本リージョン3の場合 | https://objectstorage.jp-west-3.cloud.global.fujitsu.com |
| 東日本リージョン3の場合 | https://objectstorage.jp-east-3.cloud.global.fujitsu.com |
HTTPメソッドとURI#
DELETE
/v2/{account}/{container}
HTTPステータスコード#
正常時：204
エラー時：400,401,403,404,405,409,411,412,416,422,500,501
リクエストパラメータの説明#
| 名前 | In | Type | デフォルト値 /必須指定 |
Description |
|---|---|---|---|---|
| X-Auth-Token | header | string | 必須 | 認証トークン |
| account | path | string | 必須 | プロジェクト単位でユニークに割り当てられる名前 |
| container | path | string | 必須 | コンテナ名 |
レスポンスヘッダーの説明#
| 名前 | Type | Description |
|---|---|---|
| Date | string | トランザクションが実行された日時 |
| Content-Type | string | オブジェクトのMIME typeの種類 |
| Content-Length | string | レスポンスボディのバイト数 |
| Connection | string | 持続接続の状態を表示します。 |
| X-Trans-Id | string | このリクエストに付与されるID トラブルについて問い合わせる際に利用されます。 |
| x-ntap-sg-trace-id | string | このリクエストに対する処理ID トラブルについて問い合わせる際に利用されます。 |
| X-Fcx-Endpoint-Request | string | APIエンドポイントとしてリクエストを受け付けたことを示す番号 |
リクエスト例#
curl -i $publicURL/steven -X DELETE -H "X-Auth-Token: $token"
レスポンス例#
コンテナが存在して、削除に成功した場合
HTTP/1.1 204 No Content Date: Tue, 29 May 2018 08:18:25 GMT Content-Length: 0 Connection: keep-alive X-Trans-Id: 3984485427 X-Fcx-Endpoint-Request: EXECUTED_api2-rmp1.test.local-31428-1919550-1_204
コンテナが存在するが、空ではなかった場合
HTTP/1.1 409 Conflict Date: Tue, 29 May 2018 08:25:35 GMT Content-Type: text/html; charset=UTF-8 Content-Length: 95 Connection: keep-alive X-Trans-Id: 393836044 x-ntap-sg-trace-id: 5ae4f675bd4d0374 X-Fcx-Endpoint-Request: EXECUTED_api3-rmp2.test.local-29489-2100248-1_409 <html><h1>Conflict</h1><p>There was a conflict when trying to complete your request.</p></html>