DescribeStorageCapacityUnits - Elastic Compute Service - Alibaba Cloud Documentation Center

Mengkueri detail unit kapasitas penyimpanan (SCU). Anda dapat memfilter hasil berdasarkan nama, status, dan kapasitas.

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

ecs:DescribeStorageCapacityUnits

get

StorageCapacityUnit.

acs:ecs:{#regionId}:{#accountId}:scu/*

StorageCapacityUnit.

acs:ecs:{#regionId}:{#accountId}:scu/{#scuId}

None

Parameter permintaan

Parameter	Type	Required	Description	Example
RegionId	string	Yes	ID wilayah SCU. Anda dapat memanggil DescribeRegions untuk mengkueri daftar wilayah terbaru.	cn-hangzhou
PageNumber	integer	No	Nomor halaman daftar SCU. Nilai minimum: 1. Nilai default: 1.	1
PageSize	integer	No	Jumlah entri per halaman untuk kueri berhalaman. Nilai maksimum: 100. Nilai default: 10.	1
Name	string	No	Nama SCU. Panjang nama harus 2 hingga 128 karakter dan dapat berisi huruf, angka, titik dua (:), garis bawah (_), dan tanda hubung (-). Nama harus diawali dengan huruf dan tidak dapat diawali dengan `http://` atau `https://`.	testScuName
Capacity	integer	No	Kapasitas SCU. Unit: GiB. Nilai valid: {20, 40, 100, 200, 500, 1024, 2048, 5120, 10240, 20480, 51200}.	20
AllocationType	string	No	Tipe alokasi. Nilai valid: Normal: mengkueri SCU yang dimiliki akun Alibaba Cloud saat ini. Shared: mengkueri SCU yang dibagikan antara akun Alibaba Cloud dan Pengguna RAM. Nilai default: Normal.	Normal
StorageCapacityUnitId	array	No	ID SCU. Panjang array: 1 hingga 100.	scu-bp67acfmxazb4p****
	string	No	ID SCU.	scu-bp67acfmxazb4p****
Status	array	No	Status SCU. Panjang array: 1 hingga 4.	Active
	string	No	Status SCU. Nilai valid: Creating: sedang dibuat Active: aktif Expired: kedaluwarsa Pending: tertunda	Active
Tag	array<object>	No	Tag. Panjang array: 0 hingga 20.
	object	No
Key	string	No	Kunci tag SCU.	TestKey
Value	string	No	Nilai tag SCU.	TestValue

Elemen respons

Element	Type	Description	Example
	object
PageSize	integer	Jumlah entri per halaman dalam kueri berhalaman.	10
RequestId	string	ID permintaan.	473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E
PageNumber	integer	Nomor halaman daftar SCU.	1
TotalCount	integer	Jumlah total SCU.	1
StorageCapacityUnits	object
StorageCapacityUnit	array<object>	Detail SCU.
	array<object>
CreationTime	string	Waktu pembuatan SCU. Waktu mengikuti standar ISO 8601 dalam UTC.	2021-08-17T02:55Z
Status	string	Status SCU. Nilai valid: Creating: sedang dibuat. Active: aktif. Expired: kedaluwarsa. Pending: tertunda.	Active
StartTime	string	Waktu mulai berlaku SCU. Waktu mengikuti standar ISO 8601 dalam UTC.	2021-08-17T02:55Z
Capacity	integer	Kapasitas SCU.	20
Description	string	Deskripsi SCU.	testScuDescription
AllocationStatus	string	Status alokasi SCU ketika AllocationType diatur ke Shared. Nilai valid: allocated: SCU mengalokasikan ke pengguna lain. beAllocated: SCU mengalokasikan oleh pengguna lain.	allocated
ExpiredTime	string	Waktu kedaluwarsa SCU. Waktu mengikuti standar ISO 8601 dalam UTC.	2021-09-17T16:00Z
StorageCapacityUnitId	string	ID SCU.	scu-bp67acfmxazb4p****
Name	string	Nama SCU.	testScuName
RegionId	string	ID wilayah SCU.	cn-hangzhou
Tags	object
Tag	array<object>	Pasangan kunci dan nilai tag SCU.
	object
TagValue	string	Nilai tag SCU.	TestKey
TagKey	string	Kunci tag SCU.	TestValue

Contoh

Respons sukses

JSONformat

{
  "PageSize": 10,
  "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E",
  "PageNumber": 1,
  "TotalCount": 1,
  "StorageCapacityUnits": {
    "StorageCapacityUnit": [
      {
        "CreationTime": "2021-08-17T02:55Z",
        "Status": "Active",
        "StartTime": "2021-08-17T02:55Z",
        "Capacity": 20,
        "Description": "testScuDescription",
        "AllocationStatus": "allocated",
        "ExpiredTime": "2021-09-17T16:00Z",
        "StorageCapacityUnitId": "scu-bp67acfmxazb4p****",
        "Name": "testScuName",
        "RegionId": "cn-hangzhou",
        "Tags": {
          "Tag": [
            {
              "TagValue": "TestKey",
              "TagKey": "TestValue"
            }
          ]
        }
      }
    ]
  }
}

Kode kesalahan

HTTP status code	Error code	Error message	Description
400	MissingParameter.RegionId	The specified RegionId should not be null.	Parameter RegionId tidak boleh kosong.
400	InvalidParameter.Name	The specified Name is invalid.	Parameter Name yang ditentukan tidak valid.
400	InvalidParameter.CapacityExceed	The specified Capacity exceeds the limitation of quota.	Parameter Capacity yang ditentukan melebihi nilai valid maksimum.
400	InvalidAllocationType.ValueNotSupported	The specified AllocationType is not supported.	Tipe alokasi yang ditentukan tidak valid.

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.