Gunakan ListProjects untuk kueri project-MaxCompute-Alibaba Cloud

Mengambil daftar proyek MaxCompute.

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

odps:ListProjects

list

Project

acs:odps:{#regionId}:{#accountId}:projects/*

None

Sintaks permintaan

GET /api/v1/projects HTTP/1.1

Parameter permintaan

Parameter	Type	Required	Description	Example
tenantId	string	No	ID tenant. Anda dapat login ke Konsol MaxCompute, lalu memilih Tenants > Tenant Property dari panel navigasi sebelah kiri untuk melihat ID tenant.	549532154333697
region	string	No	ID wilayah.	cn-beijing
quotaNickName	string	No	Nama panggilan kuota. Anda dapat login ke Konsol MaxCompute, memilih Workspace > Quotas dari panel navigasi sebelah kiri, lalu melihat nama panggilan kuota pada halaman Quotas.	quotaA
quotaName	string	No	Nama kuota yang dihasilkan secara otomatis. Anda dapat login ke Konsol MaxCompute, memilih Workspace > Quotas dari panel navigasi sebelah kiri, lalu melihat nama kuota pada halaman Quotas.	"hsajkdgbkaubh"
prefix	string	No	Menentukan penanda setelah mana daftar yang dikembalikan dimulai.	a
marker	string	No	Jumlah maksimum entri yang dikembalikan per halaman.	cHlvZHBzX3VkZl8xMDExNV8xNDU3NDI4NDkzKg==
maxItem	integer	No	Jumlah maksimum entri per halaman. Nilai default: 10.	10
saleTags	string	No	ID instans dan metode penagihan dari kuota komputasi default.	"aaaa-bbbb"
type	string	No	Tipe proyek. Nilai yang valid: managed: proyek internal external: proyek eksternal	"managed"
listSystemCatalog	boolean	No	Menentukan apakah akan mencantumkan proyek SYSTEM_CATALOG bawaan yang digunakan untuk menyediakan data seperti metadata proyek dan data penggunaan historis. Untuk informasi selengkapnya, lihat Tenant-level Information Schema. Nilai yang valid: true: Proyek SYSTEM_CATALOG bawaan dicantumkan. false: Proyek SYSTEM_CATALOG bawaan tidak dicantumkan. Valid values: true : false :	true

Elemen respons

Element	Type	Description	Example
	object	Parameter respons.
requestId	string	ID permintaan.	0b16399216671970335563173e2340
data	object	Data yang dikembalikan.
projects	array<object>	Daftar proyek.
	array<object>	Informasi proyek.
name	string	Nama proyek.	odps_project
owner	string	Informasi akun pemilik proyek.	1139815775606813
type	string	Tipe proyek. Nilai yang valid: managed: proyek internal external: proyek eksternal	managed
comment	string	Deskripsi proyek.	maxcompute projects
defaultQuota	string	Kuota komputasi default yang digunakan untuk mengalokasikan resource komputasi. Jika Anda tidak menentukan kuota komputasi untuk proyek Anda, pekerjaan yang diinisiasi oleh proyek Anda akan mengonsumsi resource komputasi dalam kuota default. Untuk informasi selengkapnya tentang penggunaan resource komputasi, lihat Use quota groups for computing resources	quotaA
status	string	Status proyek. Nilai yang valid: AVAILABLE READONLY FROZEN DELETING	AVAILABLE
costStorage	string	Total penggunaan penyimpanan. Storage space yang ditempati oleh proyek Anda, yaitu storage space logis setelah data proyek Anda dikumpulkan dan dikompresi.	16489027
regionId	string	ID wilayah.	cn-beijing
createdTime	integer	Waktu pembuatan.	1704380838000
properties	object	Properti dasar proyek.
timezone	string	Zona waktu yang digunakan oleh proyek Anda. Zona waktu ini sama dengan zona waktu yang ditentukan oleh `odps.sql.timezone`.	Asia/Shanghai
retentionDays	integer	Periode retensi untuk data backup. Satuan: hari. Selama periode retensi, Anda dapat memulihkan data versi yang sedang digunakan ke data backup versi apa pun. Nilai yang valid: [0,30]. Nilai default: 1. Nilai 0 menunjukkan bahwa fitur backup dinonaktifkan.	1
allowFullScan	boolean	Menunjukkan apakah pemindaian tabel penuh diizinkan dalam proyek. Pemindaian tabel penuh menghabiskan banyak resource, sehingga mengurangi efisiensi pemrosesan data. Secara default, fitur pemindaian tabel penuh dinonaktifkan.	false
typeSystem	string	Edisi tipe data. Nilai yang valid: 1: Edisi tipe data MaxCompute V1.0 2: Edisi tipe data MaxCompute V2.0 hive: Edisi tipe data kompatibel Hive Untuk informasi selengkapnya tentang perbedaan ketiga edisi tipe data tersebut, lihat Data type editions.	2
enableDecimal2	boolean	Menunjukkan apakah tipe DECIMAL dari edisi tipe data MaxCompute V2.0 diaktifkan.	true
sqlMeteringMax	string	Ambang batas konsumsi maksimum untuk satu pernyataan SQL. Rumus: Jumlah data yang dipindai (GB) × Kompleksitas.	1500
tableLifecycle	object	Properti siklus hidup tabel.
type	string	Tipe siklus hidup. Nilai yang valid: mandatory: Klausul siklus hidup wajib dalam pernyataan pembuatan tabel. optional: Klausul siklus hidup opsional dalam pernyataan pembuatan tabel. Jika Anda tidak mengonfigurasi siklus hidup untuk tabel, tabel tersebut tidak kedaluwarsa. inherit: Jika Anda tidak mengonfigurasi siklus hidup untuk tabel saat membuatnya, nilai parameter odps.table.lifecycle.value digunakan sebagai siklus hidup tabel secara default.	optional
value	string	Siklus hidup tabel. Satuan: hari. Nilai yang valid: 1 hingga 37231. Nilai default: 37231.	37231
encryption	object	Properti enkripsi penyimpanan.
enable	boolean	Menunjukkan apakah fitur enkripsi data perlu diaktifkan untuk proyek. Untuk informasi selengkapnya tentang enkripsi data, lihat Storage encryption.	true
algorithm	string	Algoritma enkripsi data yang didukung oleh kunci. Nilai yang valid: AES256, AESCTR, dan RC4.	SHA1
key	string	Tipe kunci yang digunakan untuk enkripsi data. Anda dapat memilih MaxCompute Default Key atau Bring Your Own Key (BYOK) sebagai tipe kunci. Jika Anda memilih MaxCompute Default Key, kunci default yang dibuat oleh MaxCompute akan digunakan.	dafault
tunnelQuota	string	Tunnel kelompok sumber daya yang terikat ke proyek. Kelompok sumber daya default: Kelompok sumber daya Tunnel bersama digunakan. Anda tidak dapat menggunakan kelompok sumber daya Tunnel berbasis langganan untuk proyek. Kelompok sumber daya default secara otomatis digunakan oleh layanan Tunnel proyek Anda, terlepas dari pengaturan parameter. Kelompok sumber daya Tunnel berbasis langganan: Anda dapat menggunakan kelompok sumber daya Tunnel berbasis langganan untuk proyek.	quota_tunnel
enableTunnelQuotaRoute	boolean	Menunjukkan apakah routing kelompok sumber daya Tunnel diaktifkan. true: Tugas transfer data yang dikirimkan oleh proyek secara default menggunakan kelompok sumber daya Tunnel yang terikat ke proyek. false: Tugas transfer data yang dikirimkan oleh proyek secara default menggunakan kelompok sumber daya Tunnel bersama.	true
externalProjectProperties	object	Properti proyek eksternal.
isExternalCatalogBound	string	Menunjukkan apakah proyek eksternal merupakan proyek eksternal untuk solusi danau data terpadu 2.0.	true
securityProperties	object	Properti izin.
usingAcl	boolean	Menunjukkan apakah fitur kontrol akses berbasis ACL diaktifkan. Secara default, fitur ini diaktifkan.	true
usingPolicy	boolean	Menunjukkan apakah fitur kontrol akses berbasis kebijakan diaktifkan. Secara default, fitur ini diaktifkan.	true
objectCreatorHasAccessPermission	boolean	Menunjukkan apakah pencipta objek memiliki izin akses terhadap objek tersebut. Nilai default adalah true, yang berarti pencipta objek memiliki izin akses terhadap objek tersebut.	true
objectCreatorHasGrantPermission	boolean	Menunjukkan apakah pencipta objek memiliki izin otorisasi terhadap objek tersebut. Nilai default adalah true, yang berarti pencipta objek memiliki izin otorisasi terhadap objek tersebut.	true
labelSecurity	boolean	Menunjukkan apakah fitur kontrol akses berbasis label diaktifkan. Secara default, fitur ini dinonaktifkan.	false
enableDownloadPrivilege	boolean	Menunjukkan apakah fitur kontrol unduhan diaktifkan. Secara default, fitur ini dinonaktifkan.	false
projectProtection	object	Properti mekanisme perlindungan data.
protected	boolean	Menunjukkan apakah mekanisme perlindungan data diaktifkan untuk proyek. Ini mengizinkan atau menolak transfer data lintas proyek. Secara default, mekanisme perlindungan data dinonaktifkan.	true
exceptionPolicy	string	Jika Anda mengaktifkan mekanisme perlindungan data proyek, Anda dapat mengonfigurasi proyek pengecualian atau proyek tepercaya. Ini memungkinkan pengguna tertentu mentransfer data objek tertentu ke proyek tertentu. Mekanisme perlindungan data proyek tidak berlaku dalam semua situasi yang ditentukan dalam kebijakan pengecualian.	{ "Version": "1", "Statement": [ { "Effect": "Allow", "Principal": "", "Action": [ "odps:[, , ...]" ], "Resource": "acs:odps:*:", "Condition": { "StringEquals": { "odps:TaskType": [ "" ] } } } ] }
ipWhiteList	object	Informasi tentang daftar putih alamat IP.
ipList	string	Daftar putih alamat IP untuk akses melalui Internet atau jaringan interkoneksi dengan layanan Alibaba Cloud lainnya. Catatan Jika Anda hanya mengonfigurasi daftar putih alamat IP untuk akses melalui Internet atau jaringan interkoneksi dengan layanan Alibaba Cloud lainnya, akses melalui Internet atau jaringan tersebut tunduk pada konfigurasi, dan akses melalui virtual private cloud (VPC) tidak diizinkan.	10.88.111.3
vpcIpList	string	Daftar putih alamat IP untuk akses melalui VPC. Catatan Jika Anda hanya mengonfigurasi daftar putih alamat IP untuk akses melalui VPC, akses melalui VPC tunduk pada konfigurasi, dan akses melalui Internet atau jaringan interkoneksi dengan layanan Alibaba Cloud lainnya tidak diizinkan.	10.88.111.3
saleTag	object	ID instans dan metode penagihan dari kuota komputasi default.
resourceId	string	ID instans dari kuota komputasi default.	"aaaa-bbbb"
resourceType	string	Metode penagihan dari kuota komputasi default.	"project"
threeTierModel	boolean	Menunjukkan apakah penyimpanan data berbasis skema didukung. MaxCompute mendukung fitur skema. Fitur ini memungkinkan Anda mengklasifikasikan objek seperti tabel, resource, dan user-defined function (UDF) dalam proyek berdasarkan skema. Anda dapat membuat beberapa skema dalam satu proyek. Untuk informasi selengkapnya, lihat Schema-related operations. Nilai yang valid: true: didukung false: tidak didukung Valid values: true : false :	true
marker	string	Menunjukkan penanda setelah mana daftar yang dikembalikan dimulai.	cHlvZHBzX3VkZl8xMDExNV8xNDU3NDI4NDkzKg==
maxItem	integer	Jumlah maksimum entri yang dikembalikan per halaman.	10
NextToken	string	Token paginasi. Hanya dukungan pergantian halaman berkelanjutan. Jika NextToken tidak kosong, halaman berikutnya tersedia. Nilai NextToken dapat digunakan dalam permintaan berikutnya untuk mengambil halaman hasil baru.	AAAAAV3MpHK1AP0pfERHZN5pu6kvikyUl3ChyRxN+qLPvtOb

Contoh

Respons sukses

JSONformat

{
  "requestId": "0b16399216671970335563173e2340",
  "data": {
    "projects": [
      {
        "name": "odps_project",
        "owner": "1139815775606813",
        "type": "managed",
        "comment": "maxcompute projects\n",
        "defaultQuota": "quotaA",
        "status": "AVAILABLE",
        "costStorage": "16489027",
        "regionId": "cn-beijing",
        "createdTime": 1704380838000,
        "properties": {
          "timezone": "Asia/Shanghai\n",
          "retentionDays": 1,
          "allowFullScan": false,
          "typeSystem": "2",
          "enableDecimal2": true,
          "sqlMeteringMax": "1500",
          "tableLifecycle": {
            "type": "optional",
            "value": "37231\n"
          },
          "encryption": {
            "enable": true,
            "algorithm": "SHA1",
            "key": "dafault"
          },
          "tunnelQuota": "quota_tunnel",
          "enableTunnelQuotaRoute": true,
          "externalProjectProperties": {
            "isExternalCatalogBound": "true"
          }
        },
        "securityProperties": {
          "usingAcl": true,
          "usingPolicy": true,
          "objectCreatorHasAccessPermission": true,
          "objectCreatorHasGrantPermission": true,
          "labelSecurity": false,
          "enableDownloadPrivilege": false,
          "projectProtection": {
            "protected": true,
            "exceptionPolicy": "{\n      \"Version\": \"1\",\n      \"Statement\": [\n            {\n                  \"Effect\": \"Allow\",\n                  \"Principal\": \"\",\n                  \"Action\": [\n                        \"odps:[, , ...]\"\n                  ],\n                  \"Resource\": \"acs:odps:*:\",\n                  \"Condition\": {\n                        \"StringEquals\": {\n                              \"odps:TaskType\": [\n                                    \"\"\n                              ]\n                        }\n                  }\n            }\n      ]\n}"
          }
        },
        "ipWhiteList": {
          "ipList": "10.88.111.3",
          "vpcIpList": "10.88.111.3"
        },
        "saleTag": {
          "resourceId": "\"aaaa-bbbb\"",
          "resourceType": "\"project\""
        },
        "threeTierModel": true
      }
    ],
    "marker": "cHlvZHBzX3VkZl8xMDExNV8xNDU3NDI4NDkzKg==",
    "maxItem": 10,
    "NextToken": "AAAAAV3MpHK1AP0pfERHZN5pu6kvikyUl3ChyRxN+qLPvtOb"
  }
}

Kode kesalahan

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.