Database Role

List database roles

GET/api/v2/databases/{database}/database-roles
List database roles

자세한 내용

SQL 명령 페이지로 이동하여 인자, 옵션, 권한 요구 사항 및 사용 지침에 대한 자세한 정보를 확인할 수 있습니다.

경로 매개 변수

매개 변수설명
database string
Identifier (i.e. name) for the database to which the resource belongs. You can use the `/api/v2/databases` GET request to get a list of available databases.

쿼리 매개 변수

매개 변수설명
showLimit integer
Query parameter to limit the maximum number of rows returned by a command.
fromName string
Query parameter to enable fetching rows only following the first row whose object name matches the specified string. Case-sensitive and does not have to be the full name.

응답

코드설명
200
successful
202
Successfully accepted the request, but it is not completed yet.

Create a database role

POST/api/v2/databases/{database}/database-roles
Create a database role

자세한 내용

SQL 명령 페이지로 이동하여 인자, 옵션, 권한 요구 사항 및 사용 지침에 대한 자세한 정보를 확인할 수 있습니다.

쿼리 매개 변수

매개 변수설명
createMode string
Query parameter allowing support for different modes of resource creation. Possible values include:
  • errorIfExists: Throws an error if you try to create a resource that already exists.
  • orReplace: Automatically replaces the existing resource with the current one.
  • ifNotExists: Creates a new resource when an alter is requested for a non-existent resource.

응답

코드설명
200
Successful request.
202

Delete a database role

DELETE/api/v2/databases/{database}/database-roles/{name}
Delete a database role

자세한 내용

SQL 명령 페이지로 이동하여 인자, 옵션, 권한 요구 사항 및 사용 지침에 대한 자세한 정보를 확인할 수 있습니다.

경로 매개 변수

매개 변수설명
name 
Identifier (i.e. name) for the resource.

쿼리 매개 변수

매개 변수설명
ifExists boolean
Query parameter that specifies how to handle the request for a resource that does not exist:
  • true: The endpoint does not throw an error if the resource does not exist. It returns a 200 success response, but does not take any action on the resource.
  • false: The endpoint throws an error if the resource doesn't exist.

응답

코드설명
200
202

Create a new database role by cloning from the specified resource

POST/api/v2/databases/{database}/database-roles/{name}:clone
Create a new database role by cloning from the specified resource

자세한 내용

SQL 명령 페이지로 이동하여 인자, 옵션, 권한 요구 사항 및 사용 지침에 대한 자세한 정보를 확인할 수 있습니다.

쿼리 매개 변수

매개 변수설명
targetDatabase string
Database of the target resource. Defaults to the source's database

응답

코드설명
200
202

List all grants to the role

GET/api/v2/databases/{database}/database-roles/{name}/grants
List all grants to the role

자세한 내용

SQL 명령 페이지로 이동하여 인자, 옵션, 권한 요구 사항 및 사용 지침에 대한 자세한 정보를 확인할 수 있습니다.

응답

코드설명
200
successful
202

Grant privileges to the role

POST/api/v2/databases/{database}/database-roles/{name}/grants
Grant privileges to the role

자세한 내용

SQL 명령 페이지로 이동하여 인자, 옵션, 권한 요구 사항 및 사용 지침에 대한 자세한 정보를 확인할 수 있습니다.

응답

코드설명
200
202

Revoke grants from the role

POST/api/v2/databases/{database}/database-roles/{name}/grants:revoke
Revoke grants from the role

자세한 내용

SQL 명령 페이지로 이동하여 인자, 옵션, 권한 요구 사항 및 사용 지침에 대한 자세한 정보를 확인할 수 있습니다.

쿼리 매개 변수

매개 변수설명
mode string
Query parameter determines whether the revoke operation succeeds or fails for the privileges, based on the whether the privileges had been re-granted to another role.
  • restrict: If the privilege being revoked has been re-granted to another role, the REVOKE command fails.
  • cascade: If the privilege being revoked has been re-granted, the REVOKE command recursively revokes these dependent grants. If the same privilege on an object has been granted to the target role by a different grantor (parallel grant), that grant is not affected and the target role retains the privilege.

응답

코드설명
200
202

List all future grants to the role

GET/api/v2/databases/{database}/database-roles/{name}/future-grants
List all future grants to the role

자세한 내용

SQL 명령 페이지로 이동하여 인자, 옵션, 권한 요구 사항 및 사용 지침에 대한 자세한 정보를 확인할 수 있습니다.

응답

코드설명
200
successful
202

Grant future privileges to the role

POST/api/v2/databases/{database}/database-roles/{name}/future-grants
Grant future privileges to the role

자세한 내용

SQL 명령 페이지로 이동하여 인자, 옵션, 권한 요구 사항 및 사용 지침에 대한 자세한 정보를 확인할 수 있습니다.

응답

코드설명
200
202

Revoke future grants from the role

POST/api/v2/databases/{database}/database-roles/{name}/future-grants:revoke
Revoke future grants from the role

자세한 내용

SQL 명령 페이지로 이동하여 인자, 옵션, 권한 요구 사항 및 사용 지침에 대한 자세한 정보를 확인할 수 있습니다.

응답

코드설명
200
202