ipfs pin ls

使用ipfs pin ls [<ipfs-path>]...命令列表显示本地存储中已固定的ipfs对象。

命令行

ipfs pin ls [--type=<type> | -t] [--quiet | -q] [--] [<ipfs-path>...]

[<ipfs-path>]... - 要列举其被固定内容的ipfs对象路径

选项

-t, --type  string - 要显示的被固定密钥的类型，可以是"direct", "indirect", "recursive", 或者 "all"。默认值：all
-q, --quiet bool   - 是否仅显示被固定对象的哈希，默认值：false

说明

ipfs pin ls命令返回一组本地固定的ipfs对象。默认情况下，该命令将返回 所有被固定的对象，不过可以使用--type选项来限定要求仅返回特定类型的 被固定对象，或使用路径参数来限定仅返回指定ipfs对象所链接的被固定对象。

使用--type=<type>选项来指定要显示的密钥类型。可选值如下：

• "direct": 选中指定对象
• "recursive": 选中指定对象及其后代对象
• "indirect": 被祖先对象间接选中，类似于refcount
• "all"： 全部对象

当使用路径参数时，如果该路径所指向的对象不是被固定对象，ipfs pin ls 命令将失败。同时，如果使用--type=<type>选项指定一个与该路径对象不符 的类型，命令也会失败。

示例

$ echo "hello" | ipfs add -q
QmZULkCELmmk5XNfCgTnCyFgAVxBRBXyDHGGMVoLFLiXEN
$ ipfs pin ls
QmZULkCELmmk5XNfCgTnCyFgAVxBRBXyDHGGMVoLFLiXEN recursive
# now remove the pin, and repin it directly
$ ipfs pin rm QmZULkCELmmk5XNfCgTnCyFgAVxBRBXyDHGGMVoLFLiXEN
unpinned QmZULkCELmmk5XNfCgTnCyFgAVxBRBXyDHGGMVoLFLiXEN
$ ipfs pin add -r=false QmZULkCELmmk5XNfCgTnCyFgAVxBRBXyDHGGMVoLFLiXEN
pinned QmZULkCELmmk5XNfCgTnCyFgAVxBRBXyDHGGMVoLFLiXEN directly
$ ipfs pin ls --type=direct
QmZULkCELmmk5XNfCgTnCyFgAVxBRBXyDHGGMVoLFLiXEN direct
$ ipfs pin ls QmZULkCELmmk5XNfCgTnCyFgAVxBRBXyDHGGMVoLFLiXEN
QmZULkCELmmk5XNfCgTnCyFgAVxBRBXyDHGGMVoLFLiXEN direct