All Products
Search
Document Center

Microservices Engine:GetNacosConfig

Last Updated:Jun 10, 2026

Mengambil konfigurasi Pusat Registrasi Nacos.

Deskripsi operasi

Catatan

This OpenAPI is not the Nacos-SDK API. For information related to the Nacos-SDK API, please refer to the official documentation.

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:GetNacosConfig

get

*EngineNamespace

acs:mse:{#regionId}:{#accountId}:instance/{#InstanceId}/{#NamespaceId}

None None

Parameter permintaan

Parameter

Type

Required

Description

Example

InstanceId

string

Yes

ID instans.

mse-cn-i7m2h0****

DataId

string

Yes

ID data.

halvie-mp-item****

Group

string

Yes

Kelompok konfigurasi.

common

NamespaceId

string

No

ID namespace.

ddaf8f12-****-b1c1-86e7c72e266b

Beta

boolean

No

Apakah konfigurasi merupakan rilis beta. Nilai valid:

  • true: Konfigurasi merupakan rilis beta.

  • false: Konfigurasi bukan rilis beta.

true

AcceptLanguage

string

No

Bahasa informasi yang dikembalikan. Nilai valid:

  • zh: Cina.

  • en: Inggris.

zh

Elemen respons

Element

Type

Description

Example

object

Data structure.

Message

string

Message.

success

RequestId

string

Request ID.

B4EAB48C-BB4B-5B8D-B33B-35D69606C5AD

Configuration

object

Configuration information.

Type

string

Format of the configuration content.

text

AppName

string

Application name.

test

Tags

string

Tags of the configuration.

context

Md5

string

Message digest of the configuration.

123rfsdf3

DataId

string

Configuration ID.

log.yaml

Content

string

Configuration content.

log.level=error

Group

string

Configuration group name.

test

Desc

string

Configuration description.

For testing

EncryptedDataKey

string

Encrypted key.

key

BetaIps

string

List of IPs for Beta release.

1.1.XX.XX,2.2.XX.XX

GrayVersions

array<object>

Current gray version information

object

Type

string

Gray type

Valid values:

  • Tags :

    Tags

  • Beta :

    Beta

Beta

Name

string

Gray version name

test

Rule

string

Rules of the current gray version

a=b

Priority

integer

The priority of the current gray rule.

20

ErrorCode

string

Error code.

mse-100-000

Success

boolean

The result of the request, with values as follows:

  • true: The request was successful.

  • false: The request failed.

true

Contoh

Respons sukses

JSONformat

{
  "Message": "success",
  "RequestId": "B4EAB48C-BB4B-5B8D-B33B-35D69606C5AD",
  "Configuration": {
    "Type": "text",
    "AppName": "test",
    "Tags": "context",
    "Md5": "123rfsdf3",
    "DataId": "log.yaml",
    "Content": "log.level=error",
    "Group": "test",
    "Desc": "For testing\n",
    "EncryptedDataKey": "key",
    "BetaIps": "1.1.XX.XX,2.2.XX.XX",
    "GrayVersions": [
      {
        "Type": "Beta",
        "Name": "test",
        "Rule": "a=b",
        "Priority": 20
      }
    ]
  },
  "ErrorCode": "mse-100-000",
  "Success": true
}

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.