Delete One Folder Rule
curl --request DELETE \
--url https://blob.vertracloud.app/v1/rules/{prefix}import requests
url = "https://blob.vertracloud.app/v1/rules/{prefix}"
response = requests.delete(url)
print(response.text)const options = {method: 'DELETE'};
fetch('https://blob.vertracloud.app/v1/rules/{prefix}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://blob.vertracloud.app/v1/rules/{prefix}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "DELETE",
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://blob.vertracloud.app/v1/rules/{prefix}"
req, _ := http.NewRequest("DELETE", url, nil)
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.delete("https://blob.vertracloud.app/v1/rules/{prefix}")
.asString();require 'uri'
require 'net/http'
url = URI("https://blob.vertracloud.app/v1/rules/{prefix}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Delete.new(url)
response = http.request(request)
puts response.read_body{
"response": {
"rules": [],
"etag": "v4"
}
}
Folder rules
Delete One Folder Rule
Removes the rule of one folder prefix and returns the remaining rules with the new etag.
DELETE
/
v1
/
rules
/
{prefix}
Delete One Folder Rule
curl --request DELETE \
--url https://blob.vertracloud.app/v1/rules/{prefix}import requests
url = "https://blob.vertracloud.app/v1/rules/{prefix}"
response = requests.delete(url)
print(response.text)const options = {method: 'DELETE'};
fetch('https://blob.vertracloud.app/v1/rules/{prefix}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://blob.vertracloud.app/v1/rules/{prefix}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "DELETE",
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://blob.vertracloud.app/v1/rules/{prefix}"
req, _ := http.NewRequest("DELETE", url, nil)
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.delete("https://blob.vertracloud.app/v1/rules/{prefix}")
.asString();require 'uri'
require 'net/http'
url = URI("https://blob.vertracloud.app/v1/rules/{prefix}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Delete.new(url)
response = http.request(request)
puts response.read_body{
"response": {
"rules": [],
"etag": "v4"
}
}
Removes the rule of one folder prefix. Objects already stored in the folder are not changed. The response is the remaining list with its new
etag. Deleting a rule that does not exist is not an error: it answers 200 with the current list, so the call is safe to repeat.
Scope: blob:write.
string
required
Folder prefix, URL-encoded.
string
The workspace ID, when the blob belongs to a workspace. The call acts on the blob of the workspace owner and needs the
blob:read workspace permission (blob:manage on routes that change data). Leave it out to act on your own blob.Example request
curl -X DELETE "https://blob.vertracloud.app/v1/rules/tmp%2F" \
-H "Authorization: Bearer $VERTRA_API_KEY"
Response
object
The remaining rules and their new etag.
Show properties
Show properties
object[]
Folder rules. The longest matching prefix applies.
string
Folder prefix, always stored with a trailing
/.string
Default visibility of new objects in the folder.
number
Default expiration of each new object, in seconds.
number
Largest accepted file in bytes, 512 B to 10 GB.
string[]
Accepted extensions, 1–50, lowercase, without the dot.
string
Default
cache_control of new objects.number
Objects are deleted this many days after they’re uploaded, 1–3650.
string
When
delete_after_days starts to apply, set by the platform (24 hours after the rule is saved).string
ISO 8601 time the rule was created.
string
Version of the whole rule list. Send it back in
If-Match when you replace the list.{
"response": {
"rules": [],
"etag": "v4"
}
}
Error Responses
string
The error code indicating the reason for failure. Possible values:
AUTH_TOKEN_MISSING(401): NoAuthorizationheader was sent.API_KEY_INVALID(401): The API key doesn’t exist, was revoked, or its secret doesn’t match.API_KEY_SCOPE_DENIED(403): The key lacks the scope this route needs (blob:readorblob:write);details.requirednames it.WORKSPACE_PERMISSION_DENIED(403): Only withworkspace_id: you’re not a member, or your role lacks the blob permission.WORKSPACE_NOT_FOUND(404): Only withworkspace_id: no workspace with that ID, or you’re not a member.
{
"code": "AUTH_TOKEN_MISSING"
}
{
"code": "API_KEY_SCOPE_DENIED"
}
{
"code": "WORKSPACE_NOT_FOUND"
}