Add group

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

Add group

Request

Path Parameters

metalake stringrequired

The name of the metalake

application/json

Body

name stringrequired

The name of the group

Responses

200

Returns the added group object

application/vnd.gravitino.v1+json

Schema

Schema

code int32

Possible values: [0]

Status code of the response

group

object

name stringrequired

The name of the group

roles string[]

The roles of the group

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

Example (from schema)

{
  "code": 0,
  "group": {
    "name": "string",
    "roles": [
      "string"
    ],
    "audit": {
      "creator": "string",
      "createTime": "2024-11-14T07:54:08.815Z",
      "lastModifier": "string",
      "lastModifiedTime": "2024-11-14T07:54:08.815Z"
    }
  }
}

GroupResponse

{
  "code": 0,
  "group": {
    "name": "group1",
    "roles": [],
    "audit": {
      "creator": "gravitino",
      "createTime": "2023-12-08T06:41:25.595Z"
    }
  }
}

409

Conflict - The target group already exists in the specified metalake

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"
  ]
}

GroupAlreadyExistsException

{
  "code": 1004,
  "type": "GroupAlreadyExistsException",
  "message": "Group already exists",
  "stack": [
    "org.apache.gravitino.exceptions.GroupAlreadyExistsException: Group already exists: group1"
  ]
}

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

Request Collapse all

Base URL

http://localhost:8090/api

Auth

Security Scheme

OAuth2WithJWTBasicAuth

Bearer Token

Parameters

metalake — pathrequired

Body

• Example (from schema)
• GroupAddRequest

{
  "name": "string"
}

ResponseClear

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