3.3. ストリーム
現在、file、HTTP、S3、および NBD ストリームがサポートされています。
ファイルストリーム
ファイル ストリームを使用して、ローカルでアクセス可能な POSIX ファイルソースからインポートできます。
構文
{
<format unique parameters>
"stream": {
"type": "file",
"file_path": "FILE_PATH"
}
}
たとえば、/mnt/image.raw にあるファイルから raw 形式のイメージをインポートするには、source-spec JSON ファイルは以下のようになります。
例
{
"type": "raw",
"stream": {
"type": "file",
"file_path": "/mnt/image.raw"
}
}
HTTP ストリーム
HTTP ストリームを使用して、リモートの HTTP または HTTPS Web サーバーからインポートできます。
構文
{
<format unique parameters>
"stream": {
"type": "http",
"url": "URL_PATH"
}
}
たとえば、http://download.ceph.com/image.raw にあるファイルから raw 形式のイメージをインポートするには、source-spec JSON ファイルは以下のようになります。
例
{
"type": "raw",
"stream": {
"type": "http",
"url": "http://download.ceph.com/image.raw"
}
}
S3 ストリーム
s3 ストリームを使用して、リモート S3 バケットからインポートできます。
構文
{
<format unique parameters>
"stream": {
"type": "s3",
"url": "URL_PATH",
"access_key": "ACCESS_KEY",
"secret_key": "SECRET_KEY"
}
}
たとえば、http://s3.ceph.com/bucket/image.raw にあるファイルから raw 形式のイメージをインポートするには、以下のように source-spec JSON をエンコードします。
例
{
"type": "raw",
"stream": {
"type": "s3",
"url": "http://s3.ceph.com/bucket/image.raw",
"access_key": "NX5QOQKC6BH2IDN8HC7A",
"secret_key": "LnEsqNNqZIpkzauboDcLXLcYaWwLQ3Kop0zAnKIn"
}
}
NBD ストリーム
NBD ストリームを使用して、リモートの NBD エクスポートからインポートできます。
構文
{
<format unique parameters>
"stream": {
"type": "nbd",
"uri": "<nbd-uri>",
}
}
たとえば、nbd://nbd.ceph.com/image.raw にある NBD エクスポートから raw 形式のイメージをインポートする場合、そのソース仕様 JSON は次のようにエンコードされます。
{
"type": "raw",
"stream": {
"type": "nbd",
"uri": "nbd://nbd.ceph.com/image.raw",
}
}
nbd-uri パラメーターは、NBD URI specification に従う必要があります。デフォルトの NBD ポートは 10809 です。