All Products
Search
Document Center

Microservices Engine:ImportNacosConfig

Last Updated:Jun 10, 2026

Mengimpor konfigurasi Nacos sebagai file.

Deskripsi operasi

Catatan

OpenAPI saat ini bukan API Nacos-SDK. Untuk informasi tentang API Nacos-SDK, lihat Dokumentasi Resmi.

Coba sekarang

Coba API ini di OpenAPI Explorer tanpa perlu penandatanganan manual. Panggilan yang berhasil akan secara otomatis menghasilkan contoh kode SDK sesuai dengan parameter Anda. Unduh kode tersebut dengan kredensial bawaan yang aman untuk penggunaan lokal.

Test

RAM authorization

Tabel berikut menjelaskan otorisasi yang diperlukan untuk memanggil API ini. Anda dapat menentukannya dalam kebijakan Resource Access Management (RAM). Kolom pada tabel dijelaskan sebagai berikut:

  • Action: Aksi yang dapat digunakan dalam elemen Action pada pernyataan kebijakan izin RAM untuk memberikan izin guna melakukan operasi tersebut.

  • API: API yang dapat Anda panggil untuk melakukan aksi tersebut.

  • Access level: Tingkat akses yang telah ditentukan untuk setiap API. Nilai yang valid: create, list, get, update, dan delete.

  • Resource type: Jenis resource yang mendukung otorisasi untuk melakukan aksi tersebut. Ini menunjukkan apakah aksi tersebut mendukung izin tingkat resource. Resource yang ditentukan harus kompatibel dengan aksi tersebut. Jika tidak, kebijakan tersebut tidak akan berlaku.

    • Untuk API dengan izin tingkat resource, jenis resource yang diperlukan ditandai dengan tanda bintang (*). Tentukan Nama Sumber Daya Alibaba Cloud (ARN) yang sesuai dalam elemen Resource pada kebijakan.

    • Untuk API tanpa izin tingkat resource, ditampilkan sebagai All Resources. Gunakan tanda bintang (*) dalam elemen Resource pada kebijakan.

  • Condition key: Kunci kondisi yang didefinisikan oleh layanan. Kunci ini memungkinkan kontrol granular, berlaku baik hanya untuk aksi maupun untuk aksi yang terkait dengan resource tertentu. Selain kunci kondisi spesifik layanan, Alibaba Cloud menyediakan serangkaian common condition keys yang berlaku di semua layanan yang didukung RAM.

  • Dependent action: Aksi dependen yang diperlukan untuk menjalankan aksi tersebut. Untuk menyelesaikan aksi tersebut, pengguna RAM atau role RAM harus memiliki izin untuk melakukan semua aksi dependen.

Action

Access level

Resource type

Condition key

Dependent action

mse:ImportNacosConfig

create

*All Resource

*

None None

Parameter permintaan

Parameter

Type

Required

Description

Example

InstanceId

string

Yes

ID instans.

mse_prepaid_public_cn-****

NamespaceId

string

No

ID namespace. Nilai default: public

f5cdc80a-****-8094-282f5650fc00

Policy

string

No

Kebijakan.

Valid values:

  • ABORT :

    ABORT

  • OVERWRITE :

    OVERWRITE

  • SKIP :

    SKIP

OVERWRITE

FileUrl

string

Yes

URL file yang ingin Anda impor. Parameter ini harus diatur ke URL yang dihasilkan oleh Microservices Engine (MSE). Jika tidak, informasi kesalahan akan dikembalikan, yang menunjukkan bahwa izin yang diperlukan tidak diberikan. Lakukan langkah-langkah berikut untuk memperoleh URL:

1. Panggil operasi GetImportFileUrl untuk memperoleh URL.

2. Gunakan metode HTTP PUT untuk mengunggah file ke URL HTTP yang dikembalikan oleh langkah sebelumnya.

3. Panggil operasi ImportNacosConfig untuk mengimpor konfigurasi Nacos.

http://mse-shared.oss-xxx.aliyuncs.com/cfg/import/xxxx/2021/01/11/xxxx.zip

AcceptLanguage

string

No

Bahasa respons. Nilai yang valid:

  • zh: Bahasa Mandarin.

  • en: Bahasa Inggris.

zh

Elemen respons

Element

Type

Description

Example

object

Struktur data.

HttpStatusCode

integer

Kode status HTTP.

200

RequestId

string

ID permintaan.

AF21683A-29C7-4853-AC0F-B5ADEE4****

Success

boolean

Menunjukkan apakah panggilan berhasil. Nilai yang valid:

  • true: Permintaan berhasil.

  • false: Permintaan gagal.

true

ErrorCode

string

Kode kesalahan.

mse-100-100

Code

integer

Kode.

1

Message

string

Pesan yang dikembalikan untuk permintaan.

请求处理成功

DynamicMessage

string

Pesan kesalahan dinamis, digunakan untuk menggantikan %s pada parameter ErrMessage.

Catatan

Jika ErrMessage mengembalikan The Value of Input Parameter %s is not valid, dan DynamicMessage mengembalikan DtsJobId, artinya parameter permintaan DtsJobId tidak valid.

The specified parameter is invalid.

Data

object

Data yang dikembalikan.

SuccCount

integer

Jumlah konfigurasi yang diimpor.

100

SkipCount

integer

Jumlah konfigurasi yang dilewati.

10

SkipData

array<object>

Informasi tentang konfigurasi yang dilewati.

object

Struktur data.

DataId

string

The ID of the data.

test.yaml

Group

string

The group ID.

public

FailData

array<object>

Informasi tentang konfigurasi yang gagal diimpor.

object

Struktur data.

DataId

string

The ID of the data.

test2.yaml

Group

string

The group ID.

test

Reason

string

The failure reason

导入配置格式错误

Contoh

Respons sukses

JSONformat

{
  "HttpStatusCode": 200,
  "RequestId": "AF21683A-29C7-4853-AC0F-B5ADEE4****",
  "Success": true,
  "ErrorCode": "mse-100-100",
  "Code": 1,
  "Message": "请求处理成功",
  "DynamicMessage": "The specified parameter is invalid.",
  "Data": {
    "SuccCount": 100,
    "SkipCount": 10,
    "SkipData": [
      {
        "DataId": "test.yaml",
        "Group": "public "
      }
    ],
    "FailData": [
      {
        "DataId": "test2.yaml",
        "Group": "test",
        "Reason": "导入配置格式错误"
      }
    ]
  }
}

Kode kesalahan

HTTP status code

Error code

Error message

Description

400 IllegalRequest Invalid request:%s Invalid request: %s
400 InvalidParameter Parameter error:%s Request parameter error: %s
500 InternalError Console error. Try again later:%s Console error. Try again later: %s
403 NoPermission You are not authorized to perform this operation:%s You do not have the permission to use this interface:%s
404 NotFound Not found:%s The resource does not exist:%s

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.