openapi.json

{"openapi":"3.0.1","info":{"title":"Starburst Galaxy Public API","description":"APIs for managing your Starburst Galaxy account","version":"v1"},"servers":[{"url":"https://{account-domain}","variables":{"account-domain":{"description":"Your account domain","default":""}}}],"tags":[{"name":"Cluster Service","description":"Cluster related operations"}],"paths":{"/public/api/v1/cluster":{"get":{"tags":["Cluster Service"],"description":"Return the clusters of your account","operationId":"listClusters","responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/cluster"}}}}},"400":{"description":"InvalidArgument","content":{"application/json":{"schema":{"$ref":"#/components/schemas/badrequest"}}}},"401":{"description":"Unauthenticated","content":{"application/json":{"schema":{"$ref":"#/components/schemas/errorinfo"}}}},"403":{"description":"PermissionDenied","content":{"application/json":{"schema":{"$ref":"#/components/schemas/errorinfo"}}}}},"security":[{"bearerAuth":[]}]},"parameters":[]},"/public/api/v1/cluster/{clusterId}:start":{"post":{"tags":["Cluster Service"],"description":"Start a cluster","operationId":"startCluster","responses":{"204":{"description":"Success"},"400":{"description":"InvalidArgument","content":{"application/json":{"schema":{"$ref":"#/components/schemas/badrequest"}}}},"401":{"description":"Unauthenticated","content":{"application/json":{"schema":{"$ref":"#/components/schemas/errorinfo"}}}},"403":{"description":"PermissionDenied","content":{"application/json":{"schema":{"$ref":"#/components/schemas/errorinfo"}}}},"404":{"description":"NotFound","content":{"application/json":{"schema":{"$ref":"#/components/schemas/resourceinfo"}}}}},"security":[{"bearerAuth":[]}]},"parameters":[{"name":"clusterId","in":"path","description":"A Trino cluster","required":true,"schema":{"type":"string"}}]},"/public/api/v1/cluster/{clusterId}:stop":{"post":{"tags":["Cluster Service"],"description":"Stop a cluster","operationId":"stopCluster","responses":{"204":{"description":"Success"},"400":{"description":"InvalidArgument","content":{"application/json":{"schema":{"$ref":"#/components/schemas/badrequest"}}}},"401":{"description":"Unauthenticated","content":{"application/json":{"schema":{"$ref":"#/components/schemas/errorinfo"}}}},"403":{"description":"PermissionDenied","content":{"application/json":{"schema":{"$ref":"#/components/schemas/errorinfo"}}}},"404":{"description":"NotFound","content":{"application/json":{"schema":{"$ref":"#/components/schemas/resourceinfo"}}}}},"security":[{"bearerAuth":[]}]},"parameters":[{"name":"clusterId","in":"path","description":"A Trino cluster","required":true,"schema":{"type":"string"}}]}},"components":{"schemas":{"resourceinfo":{"required":["description","owner","resourceName","resourceType"],"properties":{"resourceType":{"type":"string","description":"Type of resource (read only)"},"resourceName":{"type":"string","description":"Name of the resource (read only)"},"owner":{"type":"string","description":"Resource owner (read only)"},"description":{"type":"string","description":"Violation description (read only)"}},"description":"Resource failure or inconsistency (read only)"},"badrequest":{"required":["fieldViolations"],"properties":{"fieldViolations":{"type":"array","items":{"$ref":"#/components/schemas/fieldviolation"}}},"description":"Invalid request (read only)"},"errorinfo":{"required":["domain","metadata","reason"],"properties":{"reason":{"type":"string","description":"Error reason/detail (read only)"},"domain":{"type":"string","description":"Domain of the error (read only)"},"metadata":{"type":"object","additionalProperties":{"type":"string","description":"Any additional details (read only)"}}},"description":"Error (read only)"},"cluster":{"required":["clusterId","name","syncToken"],"properties":{"syncToken":{"type":"string","description":"Used to ensure consistency for resource updates. A syncToken that is returned\nfrom the server is valid until the resource is updated when a new syncToken will\nbe generated. Only the latest version of the object is maintained.\n (read only)"},"clusterId":{"type":"string","description":"Cluster ID (read only)"},"name":{"type":"string","description":"Cluster name"}},"description":"A Trino cluster"},"fieldviolation":{"required":["description","field"],"properties":{"field":{"type":"string","description":"Field name"},"description":{"type":"string","description":"Description of the violation"}},"description":"Field violations (read only)"}},"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT"}}}}