List namespaces

Retrieve a list of namespaces in the project and region. Each namespace includes its associated functions and their deployment status.

GET /cloud/v1/faas/namespaces/{project_id}/{region_id}

List namespaces

cURL

curl --request GET \
  --url https://api.gcore.com/cloud/v1/faas/namespaces/{project_id}/{region_id} \
  --header 'Authorization: <api-key>'

200

{
  "count": 1,
  "results": [
    {
      "created_at": "<string>",
      "functions": [
        {
          "autoscaling": {
            "max_instances": 25,
            "min_instances": 25
          },
          "build_message": "<string>",
          "build_status": "<string>",
          "code_text": "<string>",
          "created_at": "<string>",
          "dependencies": "<string>",
          "deploy_status": {},
          "description": "<string>",
          "endpoint": "<string>",
          "flavor": "<string>",
          "id": "<string>",
          "main_method": "<string>",
          "name": "<string>",
          "runtime": "<string>",
          "status": "<string>",
          "timeout": 90,
          "enable_api_key": true,
          "envs": {
            "ENV_VAR": "value"
          }
        }
      ],
      "functions_deploy_status": {},
      "name": "<string>",
      "status": "<string>",
      "description": "This is a sample namespace.",
      "envs": {
        "ENV_VAR": "value"
      }
    }
  ]
}

Authorizations

Authorization · string · header · required

API key for authentication. Make sure to include the word apikey, followed by a single space and then your token. Example: apikey 1234$abcdef

Path Parameters

project_id · integer · required

Project ID

Example:

1

region_id · integer · required

Region ID

Example:

1

Query Parameters

limit · integer · default: 1000

Optional. Limit the number of returned items

Required range: x <= 1000

Example:

1000

offset · integer · default: 0

Optional. Offset value is used to exclude the first set of records from the result

Required range: x >= 0

Example:

0

order_by · enum<string> · default: created_at.desc

Ordering fields and directions.

Available options: created_at.asc, created_at.desc, name.asc, name.desc

Example:

"created_at.desc"

search · string

Search through which value

Example:

"search-value"

Response

200 - application/json

OK

count · integer · required

Number of objects

Required range: x >= 0

Example:

1

results · NamespaceSerializer · object[] · required

Objects

Show child attributes