Ringkasan DescribeSDG API untuk Shared Data Group ENS - ENS - Alibaba Cloud - ENS

Mengkueri informasi dasar SDG, termasuk informasi preload node.

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

ens:DescribeSDG

none

*Semua sumber daya.

*

None

Parameter permintaan

Parameter	Type	Required	Description	Example
SDGIds	array	No	ID SDG yang akan dikueri. Secara default, semua SDG akan dikueri.
	string	No	ID SDG yang akan dikueri. Secara default, semua SDG akan dikueri.	["sdg-1", "sdg-2", "sdg-3"]
PageNumber	integer	No	Nomor halaman untuk paging.	1
PageSize	integer	No	Jumlah baris per halaman dalam kueri paging. Nilai default: 10.	10
SameDiskId	boolean	No

Elemen respons

Element	Type	Description	Example
	object
RequestId	string	ID permintaan.	F3B261DD-3858-4D3C-877D-303ADF374600
SDGs	array<object>	Daftar informasi SDG.
	array<object>
AvaliableRegionIds	array<object>	Daftar Node Tepi tempat snapshot SDG berada.
	object
CreationTime	string	Waktu pembuatan SDG di Node Tepi.	2023-02-27 15:13:26
RegionId	string	ID Node Tepi.	cn-hangzhou-26
SnapshotId	string	ID snapshot.	sp-517qu0tgznrg622he7nf4wd7n
Status	string	Status SDG di Node Tepi. Nilai valid: sdg_making: Sedang dibuat. sdg_saving: Sedang disimpan. sdg_copying: Sedang disinkronkan antar Node Tepi. failed: Pembuatan gagal. success: Pembuatan berhasil.	success
CreationInstanceId	string	ID instans tempat SDG dibuat.	aic-5x20dyeos****
CreationDiskType	string	Tipe disk sumber yang digunakan untuk membuat SDG.	standard
CreationTime	string	Waktu saat SDG pertama kali dibuat.	2023-02-27 15:07:21
Description	string	Deskripsi SDG.	Test SDG
ParentSDGId	string	ID SDG sumber untuk pembuatan inkremental. Ini adalah parameter FromSDGId yang ditentukan saat Anda memanggil CreateSDG.	sdg-xxxxx
SDGId	string	ID SDG.	sdg-30e1fdba7196bc****
Size	integer	Ukuran SDG. Unit: GB.	20
Status	string	Status pembuatan SDG. Nilai valid: sdg_making: Sedang dibuat. sdg_saving: Sedang disimpan. failed: Pembuatan gagal. success: Pembuatan berhasil.	success
PerformanceLevel	string	Rasio berbagi SDG.	100
UpdateTime	string	Waktu saat SDG terakhir diperbarui.	2023-02-27 16:04:39
PreloadInfos	array<object>	Informasi konfigurasi preload.
	object
RegionId	string	ID Node Tepi.	cn-hangzhou
Namespace	string	Namespace.	test-20000
RedundantNum	integer	Jumlah salinan redundan untuk tanggapan mounting bersama yang cepat.	2
DiskType	string	Tipe disk disk bersama redundan.	standard
CreationTime	string	Waktu pembuatan. Waktu mengikuti standar ISO 8601 dalam format yyyy-MM-ddTHH:mm:ssZ. Waktu ditampilkan dalam UTC.	2023-02-16T06:18:40Z
UpdateTime	string	Waktu pembaruan status terbaru.	2021-01-22T08:17Z
CreationRegionId	string	ID Node Tepi tempat SDG dibuat.	cn-hangzhou-26
BillingType	string	Tipe penagihan.	Open
BillingCycle	string	Siklus penagihan disk bersama.	Day
PageNumber	integer	Nomor halaman saat ini.	1
PageSize	integer	Jumlah entri per halaman untuk kueri saat ini.	10
TotalCount	integer	Jumlah total entri.	49

Contoh

Respons sukses

JSONformat

{
  "RequestId": "F3B261DD-3858-4D3C-877D-303ADF374600",
  "SDGs": [
    {
      "AvaliableRegionIds": [
        {
          "CreationTime": "2023-02-27 15:13:26",
          "RegionId": "cn-hangzhou-26",
          "SnapshotId": "sp-517qu0tgznrg622he7nf4wd7n",
          "Status": "success"
        }
      ],
      "CreationInstanceId": "aic-5x20dyeos****",
      "CreationDiskType": "standard",
      "CreationTime": "2023-02-27 15:07:21",
      "Description": "Test SDG",
      "ParentSDGId": "sdg-xxxxx",
      "SDGId": "sdg-30e1fdba7196bc****",
      "Size": 20,
      "Status": "success",
      "PerformanceLevel": "100",
      "UpdateTime": "2023-02-27 16:04:39",
      "PreloadInfos": [
        {
          "RegionId": "cn-hangzhou",
          "Namespace": "test-20000",
          "RedundantNum": 2,
          "DiskType": "standard",
          "CreationTime": "2023-02-16T06:18:40Z",
          "UpdateTime": "2021-01-22T08:17Z"
        }
      ],
      "CreationRegionId": "cn-hangzhou-26",
      "BillingType": "Open",
      "BillingCycle": "Day"
    }
  ],
  "PageNumber": 1,
  "PageSize": 10,
  "TotalCount": 49
}

Kode kesalahan

HTTP status code	Error code	Error message
400	Interface.Call.Failed	%s.
400	Parameter.Invalid	The parameter is invalid. Please check your parameters and try it again.
400	NoPermission	Permission denied.
400	InvalidParameter.%s	The specified field %s invalid. Please check it again.

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.