Updated on 2026-09-21 GMT+08:00

Importing Resources in On-premises IDCs

Function

This API is used to manage resources from multiple cloud vendors and IDCs, including importing device resources in IDCs in batches.

Authorization Information

Each account has all the permissions required to call all APIs, but IAM users must be assigned the required permissions.

  • If you are using role/policy-based authorization, see Permissions Policies and Supported Actions for details on the required permissions.
  • If you are using identity policy-based authorization, the following identity policy-based permissions are required.

    Action

    Access Level

    Resource Type (*: required)

    Condition Key

    Alias

    Dependencies

    coc:instance:syncResources

    Write

    -

    -

    -

    -

URI

POST /v1/other-resources/import

Request Parameters

Table 1 Request body parameters

Parameter

Mandatory

Type

Description

file

Yes

File

Definition

Download template Excel file (related device information) for the uploaded PMs, VMs, or middleware devices.

Constraints

N/A

Range

Download template Excel file (related device information) for PMs, VMs, or middleware devices.

Default value

N/A

type

Yes

String

Definition

Import type.

Constraints

N/A

Range

vm: VMs

  • PM: physical machines

  • Middleware: middleware devices

Default value

N/A

region_id

Yes

String

Definition

Region ID.

Constraints

N/A

Range

The value is a string. It contains 0 to 64 characters.

Default value

N/A

Response Parameters

Status code: 200

Table 2 Response body parameters

Parameter

Type

Description

success

Integer

Definition

Number of successful records, that is, number of data records that pass the verification in the Excel file.

Range

N/A

total

Integer

Definition

Total number of records, that is, the total number of data records in the Excel file.

Range

N/A

error_list

Array of strings

Definition

Failed information set, that is, error information collection of verification failures in the Excel file.

Range

N/A

Example Requests

Import resources of on-premises IDCs.

POST https://{endpoint}/v1/other-resources/import

Example Responses

None

Status Codes

Status Code

Description

200

The resources are imported.

Error Codes

See Error Codes.