OceanBase logo

OceanBase

A unified distributed database ready for your transactional, analytical, and AI workloads.

Product Overview
DEPLOY YOUR WAY

OceanBase Cloud

The best way to deploy and scale OceanBase

OceanBase Enterprise

Run and manage OceanBase on your infra

TRY OPEN SOURCE

OceanBase Community Edition

The free, open-source distributed database

OceanBase seekdb

Open source AI native search database

Customer Stories

Real-world success stories from enterprises across diverse industries.

View All
BY USE CASES

Mission-Critical Transactions

Global & Multicloud Application

Elastic Scaling for Peak Traffic

Real-time Analytics

Active Geo-redundancy

Database Consolidation

Resources

Comprehensive knowledge hub for OceanBase.

Blog

Live Demos

Training & Certification

Documentation

Official technical guides, tutorials, API references, and manuals for all OceanBase products.

View All
PRODUCTS

OceanBase Cloud

OceanBase Database

Tools

Connectors and Middleware

QUICK START

OceanBase Cloud

OceanBase Database

BEST PRACTICES

Practical guides for utilizing OceanBase more effectively and conveniently

Company

Learn more about OceanBase – our company, partnerships, and trust and security initiatives.

About OceanBase

Partner

Trust Center

Contact Us

International - English
中国站 - 简体中文
日本 - 日本語
Sign In
Start on Cloud

OceanBase

A unified distributed database ready for your transactional, analytical, and AI workloads.

Product Overview
DEPLOY YOUR WAY

OceanBase Cloud

The best way to deploy and scale OceanBase

OceanBase Enterprise

Run and manage OceanBase on your infra

TRY OPEN SOURCE

OceanBase Community Edition

The free, open-source distributed database

OceanBase seekdb

Open source AI native search database

Customer Stories

Real-world success stories from enterprises across diverse industries.

View All
BY USE CASES

Mission-Critical Transactions

Global & Multicloud Application

Elastic Scaling for Peak Traffic

Real-time Analytics

Active Geo-redundancy

Database Consolidation

Comprehensive knowledge hub for OceanBase.

Blog

Live Demos

Training & Certification

Documentation

Official technical guides, tutorials, API references, and manuals for all OceanBase products.

View All
PRODUCTS
OceanBase CloudOceanBase Database
ToolsConnectors and Middleware
QUICK START
OceanBase CloudOceanBase Database
BEST PRACTICES

Practical guides for utilizing OceanBase more effectively and conveniently

Learn more about OceanBase – our company, partnerships, and trust and security initiatives.

About OceanBase

Partner

Trust Center

Contact Us

Start on Cloud
编组
All Products
    • Databases
    • iconOceanBase Database
    • iconOceanBase Cloud
    • iconOceanBase Tugraph
    • iconInteractive Tutorials
    • iconOceanBase Best Practices
    • Tools
    • iconOceanBase Cloud Platform
    • iconOceanBase Migration Service
    • iconOceanBase Developer Center
    • iconOceanBase Migration Assessment
    • iconOceanBase Admin Tool
    • iconOceanBase Loader and Dumper
    • iconOceanBase Deployer
    • iconKubernetes operator for OceanBase
    • iconOceanBase Diagnostic Tool
    • iconOceanBase Binlog Service
    • Connectors and Middleware
    • iconOceanBase Database Proxy
    • iconEmbedded SQL in C for OceanBase
    • iconOceanBase Call Interface
    • iconOceanBase Connector/C
    • iconOceanBase Connector/J
    • iconOceanBase Connector/ODBC
    • iconOceanBase Connector/NET
icon

OceanBase Cloud

    Download PDF

    OceanBase logo

    The Unified Distributed Database for the AI Era.

    Follow Us
    Products
    OceanBase CloudOceanBase EnterpriseOceanBase Community EditionOceanBase seekdb
    Resources
    DocsBlogLive DemosTraining & Certification
    Company
    About OceanBaseTrust CenterLegalPartnerContact Us
    Follow Us

    © OceanBase 2026. All rights reserved

    Cloud Service AgreementPrivacy PolicySecurity
    Contact Us
    Document Feedback
    1. Documentation Center
    2. OceanBase Cloud
    iconOceanBase Cloud

      AddPrivatelinkServiceUser

      Last Updated:2026-04-14 07:33:37  Updated
      share
      What is on this page
      Overview
      API details
      Constraints
      Request path
      Request parameters
      Response parameters
      Examples
      Request example
      Response example

      folded

      share

      Overview

      You can call this API to add a user to the allowlist of the PrivateLink service for a tenant. This allows the specified account to access the private network service of the tenant, enhancing access control and security.

      Note

      This API is not supported for Alibaba Cloud instances.

      API details

      Constraints

      The caller must have an AccessKey for accessing the multi-cloud API. For information about how to obtain the AccessKey ID and AccessKey secret, see Manage AccessKeys.

      Currently, the allowlist is open. If you need to use it, please contact technical support.

      Request path

      POST /api/v2/instances/{instanceId}/tenants/{tenantId}/privatelink/user

      Request parameters

      Name Type Required Description Example value
      instanceId String Yes The ID of the OceanBase Cloud instance. ob317v4uif****
      tenantId String Yes The ID of the tenant. t33h8y08k****
      requestId String Yes The request ID, used for tracking. dc302d76-66b5-48d8-ab53-a035********
      userAccount String Yes The user account. user123
      addressId String Yes The ID of the address. rs-praivate-********

      Response parameters

      Name Type Description Example value
      requestId string The request ID. 167140a8-****-****-9ca1c646ae25
      success string Indicates whether the query was successful. Valid values:
    • true: successful
    • false: failed
    • true

      Examples

      Request example

      curl --digest -u '<your ak:sk>' \
      --request POST \
      -H 'X-Ob-Project-Id: <Project ID>' \
      -H 'Content-Type: application/json' \
      --data '{"userAccount": "user123", "addressId": "rs-praivate-********"}' \
      'https://api-cloud.oceanbase.com/api/v2/instances/{instanceId}/tenants/{tenantId}/privatelink/user?requestId={requestId}'
      

      Note

      • A project ID uniquely identifies a project. For information about how to obtain the project ID of an instance, see Manage projects.
      • Make sure that the project ID corresponding to the specified instanceId is consistent with the specified project ID.

      Response example

      JSON format

      {
        "data":{},
        "requestId":"167140a8-****-****-****-9ca1c646ae25",
        "success":true
      }
      

      Previous topic

      ConnectPrivatelinkService
      Last

      Next topic

      BatchKillProcessList
      Next
      What is on this page
      Overview
      API details
      Constraints
      Request path
      Request parameters
      Response parameters
      Examples
      Request example
      Response example