Updated on 2025-10-24 GMT+08:00

Importing Resources from 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 physical machines, VMs, or middleware devices.

Constraints:

N/A

Value range:

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

Default value:

N/A

type

Yes

String

Definition:

Import type.

Constraints:

N/A

Value range:

vm: indicates virtual machines (VMs)

  • PM: physical machines

  • Middleware: middleware devices

Default value:

N/A

region_id

Yes

String

Definition:

Region ID.

Constraints:

N/A

Value range:

The value is a string. It can contain 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.

Value range:

N/A

total

Integer

Definition:

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

Value range:

N/A

error_list

Array of strings

Definition:

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

Value range:

N/A

Example Requests

This API is used to import resources from 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.