Create metalake

POST 
http://localhost:8090/api/metalakes

Creates a new metalake

Request

application/json

Body

name stringrequired

The name of the metalake

comment stringnullable

A comment about the metalake

properties

object

nullable

Configured string to string map of properties for the metalake

property name* string

Responses

200

Returns included metalake object.

application/vnd.gravitino.v1+json

Schema

Schema

code int32

Possible values: [0]

Status code of the response

metalake

object

Gravitino Metalake is the top-level metadata repository for users. It contains a list of catalogs as sub-level metadata collections. With GravitinoMetaLake, users can list, create, load, alter and drop a catalog with specified identifier.

name stringrequired

The name of the Metalake

comment stringnullable

A comment about the Metalake

audit

object

Audit information for a Gravitino resource.

creator string

The user who created the resource

createTime date-time

The time the resource was created

lastModifier string

The user who last modified the resource

lastModifiedTime date-time

The time the resource was last modified

properties

object

Configured string to string map of properties for the Metalake

property name* string

Example (from schema)

{
  "code": 0,
  "metalake": {
    "name": "my_metalake",
    "comment": "This is my metalake",
    "properties": {
      "key1": "value1",
      "key2": "value2",
      "gravitino.identifier": "gravitino.v1.uid4516733622157792920"
    },
    "audit": {
      "creator": "gravitino",
      "createTime": "2023-12-07T14:04:17.349Z"
    }
  }
}

MetalakeResponse

{
  "code": 0,
  "metalake": {
    "name": "my_metalake",
    "comment": "This is my metalake",
    "properties": {
      "key1": "value1",
      "key2": "value2",
      "gravitino.identifier": "gravitino.v1.uid2062071866014250017"
    },
    "audit": {
      "creator": "gravitino",
      "createTime": "2023-12-06T14:21:24.982Z"
    }
  }
}

409

Conflict - The target metalake already exists

application/vnd.gravitino.v1+json

Schema

Schema

code integerrequired

Possible values: >= 1000 and <= 1100

HTTP response code

type stringrequired

Internal type definition of the error

message stringrequired

A human-readable message

stack string[]

Example (from schema)

{
  "code": 1002,
  "type": "string",
  "message": "string",
  "stack": [
    "string"
  ]
}

MetalakeAlreadyExistsException

{
  "code": 1004,
  "type": "MetalakeAlreadyExistsException",
  "message": "Failed to operate metalake(s) [my_metalake] operation [CREATE], reason [MetalakeAlreadyExistsException]",
  "stack": [
    "org.apache.gravitino.exceptions.MetalakeAlreadyExistsException: Metalake my_metalake already exists",
    "..."
  ]
}

5xx

A server-side problem that might not be addressable from the client side. Used for server 5xx errors without more specific documentation in individual routes.

application/vnd.gravitino.v1+json

Schema

Schema

code integerrequired

Possible values: >= 1000 and <= 1100

HTTP response code

type stringrequired

Internal type definition of the error

message stringrequired

A human-readable message

stack string[]

Example (from schema)

{
  "code": 1002,
  "type": "string",
  "message": "string",
  "stack": [
    "string"
  ]
}

Example

{
  "code": 1002,
  "type": "RuntimeException",
  "message": "Internal Server Error",
  "stack": [
    "java.lang.RuntimeException: Internal Server Error"
  ]
}

• curl
• python
• go
• nodejs
• ruby
• csharp
• php
• java
• powershell

• CURL

curl -L -X POST 'http://localhost:8090/api/metalakes' \
-H 'Content-Type: application/json' \
-H 'Accept: application/vnd.gravitino.v1+json' \
-H 'Authorization: Bearer <TOKEN>' \
--data-raw '{
  "name": "string",
  "comment": "string",
  "properties": {}
}'

Request Collapse all

Base URL

http://localhost:8090/api

Auth

Security Scheme

OAuth2WithJWTBasicAuth

Bearer Token

Body

• Example (from schema)
• MetalakeCreate

{
  "name": "string",
  "comment": "string",
  "properties": {}
}

ResponseClear

Click the Send API Request button above and see the response here!