All Products
Search
Document Center

E-MapReduce:ListWorkspaces

Last Updated:Jun 11, 2026

Panggil `ListWorkspaces` untuk mendapatkan daftar ruang kerja.

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

emr-serverless-spark:ListWorkspaces

list

*全部资源

*

None None

Sintaks permintaan

GET /api/v1/workspaces HTTP/1.1

Parameter permintaan

Parameter

Type

Required

Description

Example

nextToken

string

No

Token untuk halaman hasil berikutnya.

1

maxResults

integer

No

Jumlah maksimum hasil per halaman.

20

name

string

No

Nama ruang kerja. Pencarian fuzzy didukung.

test_workspace

state

string

No

Status ruang kerja.

running

regionId

string

No

ID region.

cn-hangzhou

tag

array<object>

No

Memfilter hasil berdasarkan satu atau lebih tag.

object

No

Objek tag.

key

string

No

Kunci tag.

cn-shenzhen-finance.edas.config.server

value

string

No

Nilai tag.

iphone磁盘空间剩余率

resourceGroupId

string

No

rg-aek2thxggoqhmhq

Elemen respons

Element

Type

Description

Example

object

Data yang dikembalikan.

workspaces

array<object>

Daftar ruang kerja.

array<object>

Detail ruang kerja.

workspaceId

string

ID ruang kerja.

w-******

workspaceName

string

Nama ruang kerja.

spark批作业空间-1

resourceSpec

string

Spesifikasi sumber daya.

100cu

storage

string

Jalur OSS.

spark-result

dlfCatalogId

string

Informasi DLF Catalog.

default

paymentType

string

Metode penagihan.

PayAsYouGo or Subscription

paymentDurationUnit

string

Periode langganan (Diperlukan untuk metode penagihan prabayar).

YEAR, MONTH, WEEK, DAY, HOUR, MINUTE

duration

integer

Jumlah periode langganan diperlukan untuk metode penagihan prabayar.

1

autoRenew

boolean

Menentukan apakah akan mengaktifkan perpanjangan otomatis (diperlukan untuk metode penagihan prabayar).

true

autoRenewPeriod

integer

Durasi perpanjangan otomatis (Diperlukan untuk metode penagihan prabayar).

1

autoRenewPeriodUnit

string

Periode perpanjangan otomatis (Diperlukan untuk metode penagihan prabayar).

YEAR, MONTH, WEEK, DAY, HOUR, MINUTE

workspaceStatus

string

Status ruang kerja.

STARTING,RUNNING,TERMINATED

failReason

string

Alasan kegagalan.

out of stock

paymentStatus

string

Status pembayaran.

PAID/UNPAID

regionId

string

ID region.

cn-shanghai

createTime

integer

Waktu pembuatan ruang kerja.

1684115879955

endTime

integer

Waktu pelepasan ruang kerja.

1687103999999

stateChangeReason

object

Informasi tentang perubahan status ruang kerja.

code

string

The error code.

0

message

string

The error message.

Success

releaseType

string

Alasan pelepasan ruang kerja.

SERVICE_RELEASE

dlfType

string

Mengikat tipe dlf.

1.0

prePaidQuota

object

Informasi tentang kuota sumber daya prabayar.

usedResource

string

The amount of resources that are used.

{\"cpu\":\"0\",\"memory\":\"0Gi\",\"cu\":\"0\"}

maxResource

string

The maximum amount of resources that can be used.

{\"cpu\":\"1\",\"memory\":\"4Gi\",\"cu\":\"1\"}

allocatedResource

string

The amount of resources that are allocated.

{\"cpu\":\"1\",\"memory\":\"4Gi\",\"cu\":\"1\"}

createTime

integer

The time when the resource quota was created.

1745683200000

expireTime

integer

The time when the resource quota expires.

1740537153000

autoRenewal

boolean

Indicates whether auto-renewal is enabled for the resource.

  • true: Auto-renewal is enabled. The resource is automatically renewed after it expires.

  • false: Auto-renewal is disabled. The resource becomes unavailable after it expires.

true

paymentStatus

string

The payment status of the resource. Valid values:

  • NORMAL: The resource is active.

  • WAIT_FOR_EXPIRE: The resource is about to expire.

  • EXPIRED: The resource has expired.

NORMAL

instanceId

string

The ID of the resource instance that is associated with the quota.

i-abc12345

orderId

string

tags

array<object>

Tag dari ruang kerja.

object

Tag.

tagKey

string

tagValue

string

resourceGroupId

string

rg-xxxxxxxxxx

gpuSpec

array

string

ecs.gn7i-c8g1.2xlarge

ipWhiteList

array

string

0.0.0.1

requestId

string

ID permintaan.

DD6B1B2A-5837-5237-ABE4-FF0C8944****

nextToken

string

Token halaman berikutnya.

1

maxResults

integer

Jumlah maksimum record yang dapat diambil sekaligus.

20

totalCount

integer

Jumlah total record.

200

Contoh

Respons sukses

JSONformat

{
  "workspaces": [
    {
      "workspaceId": "w-******",
      "workspaceName": "spark批作业空间-1",
      "resourceSpec": "100cu",
      "storage": "spark-result",
      "dlfCatalogId": "default",
      "paymentType": "PayAsYouGo or Subscription",
      "paymentDurationUnit": "YEAR, MONTH, WEEK, DAY, HOUR, MINUTE",
      "duration": 1,
      "autoRenew": true,
      "autoRenewPeriod": 1,
      "autoRenewPeriodUnit": "YEAR, MONTH, WEEK, DAY, HOUR, MINUTE",
      "workspaceStatus": "STARTING,RUNNING,TERMINATED",
      "failReason": "out of stock",
      "paymentStatus": "PAID/UNPAID",
      "regionId": "cn-shanghai",
      "createTime": 1684115879955,
      "endTime": 1687103999999,
      "stateChangeReason": {
        "code": "0",
        "message": "Success"
      },
      "releaseType": "SERVICE_RELEASE",
      "dlfType": "1.0",
      "prePaidQuota": {
        "usedResource": "{\\\"cpu\\\":\\\"0\\\",\\\"memory\\\":\\\"0Gi\\\",\\\"cu\\\":\\\"0\\\"}",
        "maxResource": "{\\\"cpu\\\":\\\"1\\\",\\\"memory\\\":\\\"4Gi\\\",\\\"cu\\\":\\\"1\\\"}",
        "allocatedResource": "{\\\"cpu\\\":\\\"1\\\",\\\"memory\\\":\\\"4Gi\\\",\\\"cu\\\":\\\"1\\\"}",
        "createTime": 1745683200000,
        "expireTime": 1740537153000,
        "autoRenewal": true,
        "paymentStatus": "NORMAL",
        "instanceId": "i-abc12345",
        "orderId": ""
      },
      "tags": [
        {
          "tagKey": "",
          "tagValue": ""
        }
      ],
      "resourceGroupId": "rg-xxxxxxxxxx",
      "gpuSpec": [
        "ecs.gn7i-c8g1.2xlarge"
      ]
    }
  ],
  "requestId": "DD6B1B2A-5837-5237-ABE4-FF0C8944****",
  "nextToken": "1",
  "maxResults": 20,
  "totalCount": 200
}

Kode kesalahan

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.