Set owner

PUT 
/metalakes/:metalake/owners/:metadataObjectType/:metadataObjectFullName

Makes a user or group the owner of a metadata object, replacing any existing owner. The user or group must already exist in the metalake.

Sign in with a bearer token or a local user's password; see Authentication.

Request

Path Parameters

metalake stringrequired

The name of the metalake

metadataObjectType stringrequired

Possible values: [METALAKE, CATALOG, SCHEMA, FILESET, TABLE, VIEW, TOPIC, COLUMN, ROLE, MODEL, TAG, POLICY, JOB, JOB_TEMPLATE, FUNCTION]

The type of the metadata object. The owner endpoints accept every metadata object type. Gravitino records an owner automatically when it creates any of these objects except a column, so a column has an owner only after one is set explicitly. The server matches the value case-insensitively.

metadataObjectFullName stringrequired

The full name of the metadata object

application/json

Body

name stringrequired

The name of the owner

type stringrequired

Possible values: [user, group]

The type of the owner. Responses return the value in lowercase; requests accept any case.

Responses

200

Returns the set operation result

application/vnd.gravitino.v1+json

Schema

Schema

code int32

Possible values: [0]

Status code of the response

set boolean

Whether the set operation was successful

Example (from schema)

{
  "code": 0,
  "set": true
}

SetResponse

{
  "code": 0,
  "set": true
}

404

The metalake, the metadata object, or the user or group named as the owner does not exist.

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[]deprecated

Deprecated diagnostic stack trace. Enterprise omits it by default because it can expose internal implementation details. Operators can opt in for controlled diagnostics with gravitino.server.webserver.includeErrorStackTrace=true. See OWASP REST Security: Error handling and CWE-209.

Example (from schema)

{
  "code": 1002,
  "type": "string",
  "message": "string"
}

NotFoundException

{
  "code": 1003,
  "type": "NotFoundException",
  "message": "Metadata object or owner does not exist",
  "stack": [
    "org.apache.gravitino.exceptions.NotFoundException: Metadata object or owner does not exist",
    "..."
  ]
}

5xx

The server hit an internal error that the client usually cannot fix by changing the request.

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[]deprecated

Deprecated diagnostic stack trace. Enterprise omits it by default because it can expose internal implementation details. Operators can opt in for controlled diagnostics with gravitino.server.webserver.includeErrorStackTrace=true. See OWASP REST Security: Error handling and CWE-209.

Example (from schema)

{
  "code": 1002,
  "type": "string",
  "message": "string"
}

Example

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

Loading...