v1

latestOpenAPI 3.0.32026-07-22194221292.5 KB
drives

Update a drive

Updates an existing drive. Metadata fields like displayName and labels can be changed. Size can be set if not already configured.

put/drives/{driveName}

Path parameters

driveNamestring required

Request body

statusstring

Drive status computed from events

Example request

{
  "events": [
    {
      "message": "Deployment successful",
      "revision": "rev-abc123",
      "status": "DEPLOYED",
      "time": "2025-01-15T10:30:00Z",
      "type": "deployment"
    }
  ],
  "metadata": {
    "displayName": "My Resource",
    "externalId": "my-session-123",
    "name": "my-resource"
  },
  "spec": {
    "permissions": [
      {
        "path": "/data"
      }
    ],
    "region": "us-pdx-1",
    "size": 100
  }
}

Response

successful operation

statusstring

Drive status computed from events

Example response

{
  "events": [
    {
      "message": "Deployment successful",
      "revision": "rev-abc123",
      "status": "DEPLOYED",
      "time": "2025-01-15T10:30:00Z",
      "type": "deployment"
    }
  ],
  "metadata": {
    "displayName": "My Resource",
    "externalId": "my-session-123",
    "name": "my-resource"
  },
  "spec": {
    "permissions": [
      {
        "path": "/data"
      }
    ],
    "region": "us-pdx-1",
    "size": 100
  }
}