...
| Verb | URI | Request body | Response body | Notes |
|---|---|---|---|---|
| POST | /costAllocation/report/csv/async/start | CostAllocationReportRequest type: Enum (COST_ALLOCATIONS, ALLOCATED_PROJECTS, UNALLOCATED_PROJECTS) | AsyncJobId | Initiates a job to create a CSV report for the sizes of cost allocations or unallocated projects in Synapse. The type describes the type of report will be generated. COST_ALLOCATIONS will generate a report of the largest cost allocations, ALLOCATED_PROJECTS will generate a report of the largest projects that are assigned to cost allocations, and UNALLOCATED_PROJECTS will generate a report of the largest projects that are not assigned to cost allocations. See examples below. |
| GET | /costAllocation/report/csv/async/get/{token} | None | CostAllocationReportResult: resultsFileHandleId: String timestamp: Date | Get an object containing a file handle that points to a Cost Allocation Report CSV |
| POST | /entity/{entityId}/costAllocation | name: String | CostAllocation id: String name: String bucket: String projects: Array<String> eTag: String createdBy: Long createdOn: Date | Associates a project with a cost allocation. If the cost allocation doesn't exist, it creates a new one. If the project is currently associated with a different cost allocation, it will be replaced with a new one. Name is case-insensitive (will be coerced to lowercase) and can include alphanumeric, "-", ".", and "_". |
| GET | /entity/{entityId}/costAllocation | None | CostAllocation | Gets the cost allocation for a specific project. This request can only be made by a member of the Synapse Cost Allocation Team |
| DELETE | /entity/{entityId}/costAllocation | None | None | Removes the cost allocation tied to a project. The contents of the project that are in the cost allocation storage location will be moved to the default Synapse storage. After all of the contents have been moved, the project is removed from the cost allocation. |
| GET | /costAllocation/report/csv/async/get/{token} | None | CostAllocationReportResult: resultsFileHandleId: String timestamp: Date | Get an object containing a file handle that points to a Cost Allocation Report CSV |
| POST | /costAllocation/report/csv/async/start | CostAllocationReportRequest type: Enum (COST_ALLOCATIONS, ALLOCATED_PROJECTS, UNALLOCATED_PROJECTS) | AsyncJobId | Initiates a job to create a CSV report for the sizes of cost allocations or unallocated projects in Synapse. The type describes the type of report will be generated. COST_ALLOCATIONS will generate a report of all cost allocations, ALLOCATED_PROJECTS will generate a report of the largest projects that are assigned to cost allocations, and UNALLOCATED_PROJECTS will generate a report of the largest projects that are not assigned to cost allocations. See examples below. |
Sample Reports
Type: COST_ALLOCATION
| Cost Allocation ID | Name | Size (B) | Proportion of Synapse Storage |
|---|---|---|---|
| 18 | amp-ad | 424483013985391 | 0.6534 |
| 1 | grant123 | 53579813875383 | 0.0824 |
| 4 | smith_projects | 31482472428417 | 0.0414 |
| ... | ... | ... | ... |
| 0 | unallocated | 89573285798719 | 0.2139 |
Type: ALLOCATED_PROJECTS
| Project ID | Name | Size (B) | Proportion of Synapse Storage |
|---|---|---|---|
| syn154314 | Project Onc-RNA | 124483013985391 | 0.1244 |
| syn428582 | Super Cool Data | 74579813875383 | 0.0644 |
| syn523913 | Smith Lab Repository 1 | 31482472428417 | 0.0311 |
| ... | ... | ... | ... |
| 0 | unallocated | 424483013985391 | 0.8538 |
Type: UNALLOCATED_PROJECTS
| Project ID | Name | Size (B) | Proportion of Synapse Storage |
|---|---|---|---|
| syn123456 | Cool Project 123 | 14483013985391 | 0.1829 |
| syn999999 | Research Group Data | 8579813875383 | 0.1041 |
| syn583725 | Smith Lab Repository 2 | 5148247242841 | 0.0612 |
| ... | ... | ... | ... |
| 0 | allocated | 424483013985391 | 0.7538 |
Implementation Details
| Note |
|---|
This section is unrelated to the API. Feel free to ignore it if it is not within your scope of concern. |
...