Swift Object Storage
All operations require authentication.
List containersProduction
Returns the containers of the project across every region offering Swift object storage.
Path parameters
Project ID
Headers
Pagination cursor
Pagination size
Response
Computed hash representing the current target specification value
Creation date of the container
Current observed state of the container, read from the Swift backend
Ongoing asynchronous tasks related to the container
Container identifier, built as _, for example GRA_my-container. A container name is unique within a region of the project, so the pair identifies it.
Container readiness in the system
CREATINGCREATION_PLANNEDDELETINGERROROUT_OF_SYNCREADYSUSPENDEDUNKNOWNUPDATINGLast target specification of the container
Last update date of the container
Example uses projectId = string
$ curl https:/[ { "checksum": "string", "createdAt": "2024-01-01T12:00:00Z", "currentState": { "archive": true, "cors": [ "string" ], "location": { "availabilityZone": "string", "region": "string" }, "name": "string", "objectsCount": 0, "objectsSize": 0, "staticUrl": "string", "type": "PRIVATE" }, "currentTasks": [ { "errors": [ { "message": "string" } ], "id": "00000000-0000-0000-0000-000000000000", "link": "string", "status": "ERROR", "type": "string" } ], "id": "string", "resourceStatus": "CREATING", "targetSpec": { "archive": true, "cors": [ "string" ], "location": { "availabilityZone": "string", "region": "string" }, "name": "string", "type": "PRIVATE" }, "updatedAt": "2024-01-01T12:00:00Z" }]
Create a containerProduction
Creates a container in a region. The archive policy, the access type and the CORS origins can be set at creation. Name, region and archive policy cannot be changed afterward.
Path parameters
Project ID
Request body (required)
Desired target specification for the container to create
Response
Computed hash representing the current target specification value
Creation date of the container
Current observed state of the container, read from the Swift backend
Ongoing asynchronous tasks related to the container
Container identifier, built as _, for example GRA_my-container. A container name is unique within a region of the project, so the pair identifies it.
Container readiness in the system
CREATINGCREATION_PLANNEDDELETINGERROROUT_OF_SYNCREADYSUSPENDEDUNKNOWNUPDATINGLast target specification of the container
Last update date of the container
Example uses projectId = string
$ curl https:/{ "checksum": "string", "createdAt": "2024-01-01T12:00:00Z", "currentState": { "archive": true, "cors": [ "string" ], "location": { "availabilityZone": "string", "region": "string" }, "name": "string", "objectsCount": 0, "objectsSize": 0, "staticUrl": "string", "type": "PRIVATE" }, "currentTasks": [ { "errors": [ { "message": "string" } ], "id": "00000000-0000-0000-0000-000000000000", "link": "string", "status": "ERROR", "type": "string" } ], "id": "string", "resourceStatus": "CREATING", "targetSpec": { "archive": true, "cors": [ "string" ], "location": { "availabilityZone": "string", "region": "string" }, "name": "string", "type": "PRIVATE" }, "updatedAt": "2024-01-01T12:00:00Z"}
Get a containerProduction
Returns the container configuration and its current state, including its object count and stored size.
Path parameters
Container ID
Project ID
Response
Computed hash representing the current target specification value
Creation date of the container
Current observed state of the container, read from the Swift backend
Ongoing asynchronous tasks related to the container
Container identifier, built as _, for example GRA_my-container. A container name is unique within a region of the project, so the pair identifies it.
Container readiness in the system
CREATINGCREATION_PLANNEDDELETINGERROROUT_OF_SYNCREADYSUSPENDEDUNKNOWNUPDATINGLast target specification of the container
Last update date of the container
Example uses containerId = string, projectId = string
$ curl https:/{ "checksum": "string", "createdAt": "2024-01-01T12:00:00Z", "currentState": { "archive": true, "cors": [ "string" ], "location": { "availabilityZone": "string", "region": "string" }, "name": "string", "objectsCount": 0, "objectsSize": 0, "staticUrl": "string", "type": "PRIVATE" }, "currentTasks": [ { "errors": [ { "message": "string" } ], "id": "00000000-0000-0000-0000-000000000000", "link": "string", "status": "ERROR", "type": "string" } ], "id": "string", "resourceStatus": "CREATING", "targetSpec": { "archive": true, "cors": [ "string" ], "location": { "availabilityZone": "string", "region": "string" }, "name": "string", "type": "PRIVATE" }, "updatedAt": "2024-01-01T12:00:00Z"}
Update a containerProduction
Updates the access type and the CORS origins of the container. Send the current checksum to prevent overwriting a concurrent change. Without it, the last write wins.
Path parameters
Container ID
Project ID
Request body (required)
Optional concurrency-control checksum. When supplied, it must match the resource's current checksum or the request is rejected with a 409 checksum-mismatch conflict. When omitted or empty, the concurrency check is skipped and the write is forced (last-write-wins).
Desired target specification for the container
Response
Computed hash representing the current target specification value
Creation date of the container
Current observed state of the container, read from the Swift backend
Ongoing asynchronous tasks related to the container
Container identifier, built as _, for example GRA_my-container. A container name is unique within a region of the project, so the pair identifies it.
Container readiness in the system
CREATINGCREATION_PLANNEDDELETINGERROROUT_OF_SYNCREADYSUSPENDEDUNKNOWNUPDATINGLast target specification of the container
Last update date of the container
Example uses containerId = string, projectId = string
$ curl https:/{ "checksum": "string", "createdAt": "2024-01-01T12:00:00Z", "currentState": { "archive": true, "cors": [ "string" ], "location": { "availabilityZone": "string", "region": "string" }, "name": "string", "objectsCount": 0, "objectsSize": 0, "staticUrl": "string", "type": "PRIVATE" }, "currentTasks": [ { "errors": [ { "message": "string" } ], "id": "00000000-0000-0000-0000-000000000000", "link": "string", "status": "ERROR", "type": "string" } ], "id": "string", "resourceStatus": "CREATING", "targetSpec": { "archive": true, "cors": [ "string" ], "location": { "availabilityZone": "string", "region": "string" }, "name": "string", "type": "PRIVATE" }, "updatedAt": "2024-01-01T12:00:00Z"}
Delete a containerProduction
Deletes the container and every object it holds. The deletion is asynchronous: the container stays in DELETING status until it is emptied and removed.
Path parameters
Container ID
Project ID
Response
Computed hash representing the current target specification value
Creation date of the container
Current observed state of the container, read from the Swift backend
Ongoing asynchronous tasks related to the container
Container identifier, built as _, for example GRA_my-container. A container name is unique within a region of the project, so the pair identifies it.
Container readiness in the system
CREATINGCREATION_PLANNEDDELETINGERROROUT_OF_SYNCREADYSUSPENDEDUNKNOWNUPDATINGLast target specification of the container
Last update date of the container
Example uses containerId = string, projectId = string
$ curl https:/{ "checksum": "string", "createdAt": "2024-01-01T12:00:00Z", "currentState": { "archive": true, "cors": [ "string" ], "location": { "availabilityZone": "string", "region": "string" }, "name": "string", "objectsCount": 0, "objectsSize": 0, "staticUrl": "string", "type": "PRIVATE" }, "currentTasks": [ { "errors": [ { "message": "string" } ], "id": "00000000-0000-0000-0000-000000000000", "link": "string", "status": "ERROR", "type": "string" } ], "id": "string", "resourceStatus": "CREATING", "targetSpec": { "archive": true, "cors": [ "string" ], "location": { "availabilityZone": "string", "region": "string" }, "name": "string", "type": "PRIVATE" }, "updatedAt": "2024-01-01T12:00:00Z"}