Skip to main content
ZStack
Platform Operations/Platforms

TestConnectionForCreate

Test a connection request before it is saved.

POST/api/v1/platforms/actions/test-connection

Operation ID

TestConnectionForCreate

Since

1.2.0

Execution Mode

Synchronous

Auth Context

Auth Required

Auth Context

Send these values as request headers when calling this API.

AuthorizationstringRequired

Bearer Token

X-Tenant-IDstring

X-Tenant-ID

Request Inputs

application/json

Body Fields

  • productType
    StringRequired

    Product type to test

    Example: zns

  • hostIp
    StringRequired

    Optional legacy host field. For ZNS vip mode, endpoint.host is preferred

    Example: 172.31.6.104

  • hostPort
    IntegerRequired

    Optional legacy port field. For ZNS, default is 7278

    Example: 7278

  • username
    StringRequired

    Username used for connection testing

    Example: zcf-federation-admin

  • password
    StringRequired

    Password used for connection testing

    Example: s3cret

Responses

200 OK
200 OK

On success, this API returns the following response structure.

  • success
    Boolean

    Whether the overall connection test passed

    Example: true

  • items
    List

    Ordered list of step-by-step test results

    Example: (nested array)

    • name
      String

      Name of the test step (e.g. dns_lookup, tcp_connect)

      Example: tcp_connect

    • status
      String

      Step result status (success, failure)

      Example: success

    • latencyMs
      String

      Latency in milliseconds for this step

      Example: 45

    • errorMsg
      String

      Error message if this step failed

      Example: connection refused

  • recommendation
    String

    Actionable recommendation to resolve any failures

    Example: Check firewall rules for port 8080

  • productType
    String

    Product type that was tested

    Example: zns

  • scope
    String

    Connection scope resolved for the tested product

    Example: global

  • regionUuid
    String

    Region UUID resolved for the tested product. Empty for global products

    Example: value

  • sourceDetection
    String

    Source detection mode. ZNS is not source-detected in this release

    Example: not_applicable