Obtener credenciales compatibles con S3 para Blob Storage
curl --request GET \
--url https://blob.vertracloud.app/v1/s3/credentials \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://blob.vertracloud.app/v1/s3/credentials', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://blob.vertracloud.app/v1/s3/credentials"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://blob.vertracloud.app/v1/s3/credentials"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}{
"response": {
"access_key_id": "VCS3K7P2M9X4QA",
"secret_access_key": "<secret>",
"endpoint": "https://s3.vertracloud.dev",
"region": "auto",
"buckets": [
"public",
"private"
],
"access": {
"read": true,
"write": true
}
}
}
Cuenta
Obtener credenciales compatibles con S3 para Blob Storage
Devuelve credenciales compatibles con S3 derivadas de la clave de API, para aws-cli, rclone y boto3. Límite de 10 llamadas por hora.
GET
/
v1
/
s3
/
credentials
Obtener credenciales compatibles con S3 para Blob Storage
curl --request GET \
--url https://blob.vertracloud.app/v1/s3/credentials \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://blob.vertracloud.app/v1/s3/credentials', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://blob.vertracloud.app/v1/s3/credentials"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://blob.vertracloud.app/v1/s3/credentials"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}{
"response": {
"access_key_id": "VCS3K7P2M9X4QA",
"secret_access_key": "<secret>",
"endpoint": "https://s3.vertracloud.dev",
"region": "auto",
"buckets": [
"public",
"private"
],
"access": {
"read": true,
"write": true
}
}
}
Devuelve credenciales compatibles con S3 para herramientas como aws-cli, rclone y boto3. El par se deriva de la clave de API
que hace la llamada, así que revocar esa clave corta el acceso S3 de inmediato. Con una clave de API que solo tiene
blob:read, las credenciales son de solo lectura (access.write es false). Trata secret_access_key como una
contraseña. Esta ruta requiere una clave de API: una sesión del panel se rechaza. Al rotar la clave de API el par se
reemplaza, así que vuelve a obtener las credenciales después.
Ámbito: blob:read.
string
El ID del workspace, cuando el blob pertenece a un workspace. La petición actúa sobre el blob del propietario del
workspace y necesita el permiso
blob:read del workspace (blob:manage en las rutas que modifican datos). Omítelo
para actuar sobre tu propio blob.Ejemplo de petición
curl "https://blob.vertracloud.app/v1/s3/credentials" \
-H "Authorization: Bearer $VERTRA_API_KEY"
Respuesta
object
Las credenciales de S3 de la cuenta.
Mostrar propiedades
Mostrar propiedades
string
ID de la clave de acceso. Empieza por
VCS3.string
Clave secreta. Trátala como una contraseña.
string
Endpoint de S3 que debes configurar en tu herramienta.
string
Siempre
auto.string[]
Los dos buckets:
public y private.boolean
Si las credenciales pueden leer.
boolean
Si las credenciales pueden escribir.
false con una clave de API que solo tiene blob:read.{
"response": {
"access_key_id": "VCS3K7P2M9X4QA",
"secret_access_key": "<secret>",
"endpoint": "https://s3.vertracloud.dev",
"region": "auto",
"buckets": [
"public",
"private"
],
"access": {
"read": true,
"write": true
}
}
}
Respuestas de error
string
El código de error que indica el motivo del fallo. Valores posibles:
AUTH_TOKEN_MISSING(401): No se envió la cabeceraAuthorization.API_KEY_INVALID(401): La clave de API no existe, fue revocada o su secreto no coincide.API_KEY_SCOPE_DENIED(403): La clave no tiene el ámbito que necesita esta ruta (blob:readoblob:write);details.requiredlo indica.WORKSPACE_PERMISSION_DENIED(403): Solo conworkspace_id: no eres miembro, o tu rol no tiene el permiso de blob.WORKSPACE_NOT_FOUND(404): Solo conworkspace_id: no existe un workspace con ese ID, o no eres miembro.VALIDATION_ERROR(400): La llamada no se hizo con una clave de API;details.reasonesapi_key_required.RATE_LIMIT_EXCEEDED(429): Más de 10 llamadas en una hora.details.retry_afterindica la espera en segundos.
{
"code": "AUTH_TOKEN_MISSING"
}
{
"code": "API_KEY_SCOPE_DENIED"
}
{
"code": "WORKSPACE_NOT_FOUND"
}
{
"code": "RATE_LIMIT_EXCEEDED"
}
Última modificación el 28 de octubre de 2026