url

url is used to specify a valid URL where the given object can be found, instead of passing a blob. This is valid for Add* commands that currently expect a blob, except for AddDescriptor.

We currently support S3 buckets for remote location specified as S3 URI. The expected format for S3 is "s3://<bucket-name>/<path-to-object>/<object-name>".

The object is read with the credentials added for its bucket with CreateCredential, and with nothing else. A URL into the bucket ApertureDB keeps its own data in is refused.

Examples

Insert an image that already lives in an S3 bucket. No blob must be passed for this command with the JSON Query.

[{
    "AddImage": {
        "properties": {
            "type": "scan",
            "part": "brain"
        },
        "url": "s3://aperturedb-s3-api-testing-0/brain.png"
    }
}]

Response:

[{
    "AddImage": {
        "status": 0
    }
}]

Examples​

Examples