Fetch container type details based on the filters passed

1min

GET
API to get the list of all container types and their basic details.
Important: Core Attributes Configuration and State Machine Configuration of container types are not included in the response.
HEADER/QUERY PARAMETERDESCRIPTIONTYPEVALIDATION
X-COREOS-REQUEST-ID*(header)Unique request ID.string
X-COREOS-TID*(header)Tenant ID.string
X-COREOS-ACCESS*(header)Core-OS access token.string
limit(query)Number of items to return.integerDefault value: 50
offset(query)The number of items to skip from the start.integerDefault value: 0
select(query)Specifies the list of attributes to be included in the response. If not specified, all attributes are included in the response.array[string]Available values: name, isSystem, isActive, allowedOwner, ttl
query(query)Query criteria.objectRefer following links for more details:  ㅤ1. match  ㅤ2. term ㅤ3. terms ㅤ4. range ㅤ5. regexp ㅤ6. exists ㅤ7. prefix
sortKey(query)Key to be used for sorting data.stringDefault value: createdAt
sortBy(query)Fetching data in ascending (asc) or descending (desc) order.stringDefault value: descAvailable values: desc, asc
*This is required.
HTTP Status Code Summary
CodeDescription
200 - OKEverything worked as expected.
400 - Bad RequestThe request was unacceptable, often due to missing a required parameter.
401 - UnauthorizedNo valid API key provided.
404 - Not FoundThe requested resource doesn't exist.
503 - Server ErrorSomething went wrong. (These are rare.)
Header Parameters
X-COREOS-REQUEST-ID
string
*
X-COREOS-TID
string
*
X-COREOS-ACCESS
string
*
X-COREOS-USERINFO
string
Query Parameters
limit
integer
offset
integer
size
integer
page
integer
select
string[]
query
ContainerTypeFilterQuery
sortKey
SortKey
sortBy
SortBy
Responses
200
OK
ContainerTypesResponse
data
object
request
Request
400
Bad Request
ErrorResponse
error
Error
request
Request
401
Unauthorized
ErrorResponse
error
Error
request
Request
404
Not Found
ErrorResponse
error
Error
request
Request
503
Server Error
ErrorResponse
error
Error
request
Request
Curl
JS
Ruby
Python
curl --location --globoff 'https://{tenantSubdomain}.io/core/api/v2/containers/container-types' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json'
curl --location --globoff 'https://{tenantSubdomain}.io/core/api/v2/containers/container-types' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json'
Responses
200
400
401
404
503
// OK 
{
  "data": {
    "meta": {
      "totalElements": 0
    },
    "containerTypes": [
      ""
    ]
  },
  "request": {
    "uri": "",
    "method": "",
    "queryString": "",
    "body": {}
  }
}
// OK 
{
  "data": {
    "meta": {
      "totalElements": 0
    },
    "containerTypes": [
      ""
    ]
  },
  "request": {
    "uri": "",
    "method": "",
    "queryString": "",
    "body": {}
  }
}
﻿
﻿

HEADER/QUERY PARAMETER	DESCRIPTION	TYPE	VALIDATION
`X-COREOS-REQUEST-ID`*(header)	Unique request ID.	string
`X-COREOS-TID`*(header)	Tenant ID.	string
`X-COREOS-ACCESS`*(header)	Core-OS access token.	string
`limit`(query)	Number of items to return.	integer	Default value: 50
`offset`(query)	The number of items to skip from the start.	integer	Default value: 0
`select`(query)	Specifies the list of attributes to be included in the response. If not specified, all attributes are included in the response.	array[string]	Available values: name, isSystem, isActive, allowedOwner, ttl
`query`(query)	Query criteria.	object	Refer following links for more details: ㅤ1. match ㅤ2. term ㅤ3. terms ㅤ4. range ㅤ5. regexp ㅤ6. exists ㅤ7. prefix
`sortKey`(query)	Key to be used for sorting data.	string	Default value: createdAt
`sortBy`(query)	Fetching data in ascending (asc) or descending (desc) order.	string	Default value: descAvailable values: desc, asc
*This is required.

HTTP Status Code Summary

Code	Description
200 - OK	Everything worked as expected.
400 - Bad Request	The request was unacceptable, often due to missing a required parameter.
401 - Unauthorized	No valid API key provided.
404 - Not Found	The requested resource doesn't exist.
503 - Server Error	Something went wrong. (These are rare.)

Updated 24 Aug 2023

Did this page help you?

Create a new container type

Get container type deatils by containerTypeName