アップロード済みパートのリスト - Object Storage Service - Alibaba Cloud ドキュメントセンター

list-parts コマンドは、指定されたアップロード ID にマッピングされている、アップロード済みのすべてのパートをリストするために使用されます。

使用上の注意

Object Storage Service (OSS) から返される結果は、パート番号の昇順でソートされます。
ネットワーク転送中にエラーが発生する可能性があります。ListParts 操作の結果に含まれるパート番号と ETag 値を使用して、アップロード済みパートのリストを生成しないでください。

権限

デフォルトでは、Alibaba Cloud アカウントはすべての権限を持っています。Alibaba Cloud アカウントの RAM ユーザーまたは RAM ロールは、デフォルトでは権限を持っていません。Alibaba Cloud アカウントまたはアカウント管理者は、RAM ポリシーまたはバケットポリシーを介して操作権限を付与する必要があります。

API	アクション	定義
ListParts	`oss:ListParts`	アップロード ID を使用してアップロードされたすべてのパートをリストします。

コマンド構文

ossutil api list-parts --bucket value --key value --upload-id value [flags]

パラメーター	タイプ	説明
--bucket	string	バケットの名前。
--key	string	オブジェクトのフルパス。
--encoding-type	string	レスポンス内のオブジェクト名のエンコーディングタイプ。
--max-parts	int	OSS のレスポンスに含まれる最大パート数。
--part-number-marker	int	リストの開始位置。このパラメーターの値よりも大きいパート番号を持つすべてのパートがリストされます。
--upload-id	string	マルチパートアップロードタスクの ID。

説明

list-parts コマンドは、ListParts 操作に対応します。ListParts 操作のパラメーターの詳細については、「ListParts」をご参照ください。
サポートされているグローバルコマンドラインオプションの詳細については、「コマンドラインオプション」をご参照ください。

例

名前が exampleobject で、アップロード ID が 123 である examplebucket 内の、アップロード済みのすべてのパートをリストします。
```
ossutil api list-parts --bucket examplebucket --key exampleobject --upload-id 123
```
名前が exampleobject で、アップロード ID が 123 である examplebucket 内の、アップロード済みのすべてのパートをリストし、出力を JSON 形式で表示します。
```
ossutil api list-parts --bucket examplebucket --key exampleobject --upload-id 123 --output-format json
```
名前が exampleobject で、アップロード ID が 123 である examplebucket 内の、アップロード済みのすべてのパートをリストし、出力を YAML 形式で表示します。
```
ossutil api list-parts --bucket examplebucket --key exampleobject --upload-id 123 --output-format yaml
```

examplebucket 内の最初の 100 個のパートをリストします。

ossutil api list-parts --bucket examplebucket --key exampleobject --upload-id 123 --max-parts 100

examplebucket 内のすべてのパートをリストし、返されたオブジェクトの名前を URL エンコードします。
```
ossutil api list-parts --bucket examplebucket --key exampleobject --upload-id 123 --encoding-type url
```