Update import storage | API Reference

curl -X PATCH http://localhost:8000/api/storages/gcs/1 \
     -H "Authorization: Token  <api_key>" \
     -H "Content-Type: application/json" \
     -d '{}'

{
  "created_at": "2024-01-15T09:30:00Z",
  "id": 1,
  "project": 42,
  "type": "gcs",
  "bucket": "my-labelstudio-bucket",
  "description": "Primary GCS storage for project assets",
  "google_application_credentials": "{\n  \"type\": \"service_account\",\n  \"project_id\": \"label-studio-project-123\",\n  \"private_key_id\": \"abcdef1234567890\",\n  \"private_key\": \"-----BEGIN PRIVATE KEY-----\\nMIIEv...\\n-----END PRIVATE KEY-----\\n\",\n  \"client_email\": \"labelstudio@label-studio-project-123.iam.gserviceaccount.com\",\n  \"client_id\": \"1234567890\",\n  \"auth_uri\": \"https://accounts.google.com/o/oauth2/auth\",\n  \"token_uri\": \"https://oauth2.googleapis.com/token\",\n  \"auth_provider_x509_cert_url\": \"https://www.googleapis.com/oauth2/v1/certs\",\n  \"client_x509_cert_url\": \"https://www.googleapis.com/robot/v1/metadata/x509/labelstudio%40label-studio-project-123.iam.gserviceaccount.com\"\n}",
  "google_project_id": "label-studio-project-123",
  "last_sync": "2024-04-10T14:45:00Z",
  "last_sync_count": 150,
  "last_sync_job": "sync-job-20240410-1445",
  "meta": null,
  "prefix": "images/2024/",
  "presign": true,
  "presign_ttl": 60,
  "recursive_scan": true,
  "regex_filter": "^.*\\.(jpg|jpeg|png|bmp)$",
  "status": "initialized",
  "synchronizable": true,
  "title": "Label Studio GCS Storage",
  "traceback": "",
  "use_blob_urls": true
}

Update a specific GCS import storage connection.

Authentication

AuthorizationToken

The token (or API key) must be passed as a request header. You can find your user token on the User Account page in Label Studio. Example: <br><pre><code class="language-bash">curl https://label-studio-host/api/projects -H "Authorization: Token [your-token]"</code></pre>

Path parameters

idintegerRequired

Request

This endpoint expects an object.

bucketstringOptional

GCS bucket name

descriptionstringOptional

Storage description

google_application_credentialsstringOptional

The content of GOOGLE_APPLICATION_CREDENTIALS json file. Check official Google Cloud Authentication documentation for more details.

google_project_idstringOptional

Google project ID

prefixstringOptional

GCS bucket prefix

presignbooleanOptionalDefaults to true

Presign URLs for direct download

presign_ttlintegerOptionalDefaults to 1

Presign TTL in minutes

projectintegerOptional

Project ID

regex_filterstringOptional

Cloud storage regex for filtering objects. You must specify it otherwise no objects will be imported.

titlestringOptional<=2048 characters

Storage title

use_blob_urlsbooleanOptionalDefaults to false

Interpret objects as BLOBs and generate URLs. For example, if your bucket contains images, you can use this option to generate URLs for these images. If set to False, it will read the content of the file and load it into Label Studio.

Response

created_atdatetimeRead-only

Creation time

idintegerRead-only

projectinteger

A unique integer value identifying this project.

typestringRead-onlyDefaults to gcs

bucketstring or null

GCS bucket name

descriptionstring or null

Cloud storage description

google_application_credentialsstring or null

The content of GOOGLE_APPLICATION_CREDENTIALS json file

google_project_idstring or null

Google project ID

last_syncdatetime or null

Last sync finished time

last_sync_countinteger or null0-2147483647

Count of tasks synced last time

last_sync_jobstring or null<=256 characters

Last sync job ID

metaany or null

Meta and debug information about storage processes

prefixstring or null

GCS bucket prefix

presignbooleanDefaults to true

presign_ttlinteger0-32767

Presigned URLs TTL (in minutes)

recursive_scanboolean or null

Perform recursive scan over the bucket content

regex_filterstring or null

Cloud storage regex for filtering objects

statusenum

initialized - Initialized
queued - Queued
in_progress - In progress
failed - Failed
completed - Completed
completed_with_errors - Completed with errors

synchronizablebooleanDefaults to true

titlestring or null<=256 characters

Cloud storage title

tracebackstring or null

Traceback report for the last failed sync

use_blob_urlsboolean

Interpret objects as BLOBs and generate URLs