All Products
Search

This Product

    AnalyticDB:CreateAIService

    Document Center

    AnalyticDB:CreateAIService

    Last Updated:Mar 20, 2026

    Creates an AI service.

    Try it now

    Try this API in OpenAPI Explorer, no manual signing needed. Successful calls auto-generate SDK code matching your parameters. Download it with built-in credential security for local usage.

    Test

    RAM authorization

    No authorization for this operation. If you encounter issues with this operation, contact technical support.

    Request parameters

    Parameter

    Type

    Required

    Description

    Example
    DBInstanceId

    string

    Yes

    The instance ID.

    Note

    Call the DescribeDBInstances operation to list all AnalyticDB for PostgreSQL instances in the destination region, including their instance IDs.

    gp-xxxxxxxxx
    Type

    string

    Yes

    The service type. Only drama is supported.

    drama
    ServiceAccount

    string

    Yes

    The service account. It must meet these requirements:

    • Contain only lowercase letters, digits, and underscores.

    • Start with a lowercase letter and end with a lowercase letter or digit.

    • Not start with gp.

    • Be 2 to 16 characters long.

    dramauser
    ServiceAccountPassword

    string

    Yes

    The password for the service account. It must meet these requirements:

    • Contain at least three of the following: uppercase letters, lowercase letters, digits, and special characters.

    • Support these special characters: !@#$%^&*()_+-=.

    • Be 8 to 32 characters long.

    123456Aa!
    Description

    string

    No

    A description of the service.

    dramatest
    SecurityIPList

    string

    No

    A comma-separated list of IP addresses or CIDR blocks in the IP address whitelist. You can specify up to 1000 entries. To block all external IP access, use 127.0.0.1. Valid formats include the following:

    • 10.23.12.24 (an IPv4 address)

    • 10.23.12.24/24 (a CIDR block, where /24 indicates the prefix length, from 1 to 32)

    Note

    After you create the service, call the ModifyAIServiceSecurityIps operation to update the IP address whitelist.

    127.0.0.1

    Response elements

    Element

    Type

    Description

    Example

    object

    RequestId

    string

    The request ID.

    ABB39CC3-4488-4857-905D-2E4A051D0521
    ServiceId

    string

    The service ID.

    drama-123456

    Examples

    Success response

    JSON format

    {
  "RequestId": "ABB39CC3-4488-4857-905D-2E4A051D0521",
  "ServiceId": "drama-123456"
}

    Error codes

    See Error Codes for a complete list.

    Release notes

    See Release Notes for a complete list.