List Workspaces with Pagination & RAM Auth via API - E-MapReduce - Alibaba Cloud - E-MapReduce

Call ListWorkspaces to get a list of workspaces.

Try it now

Try this API in OpenAPI Explorer, no manual signing needed. Successful calls auto-generate SDK code matching your parameters. Download it with built-in credential security for local usage.

Test

RAM authorization

The table below describes the authorization required to call this API. You can define it in a Resource Access Management (RAM) policy. The table's columns are detailed below:

Action: The actions can be used in the Action element of RAM permission policy statements to grant permissions to perform the operation.
API: The API that you can call to perform the action.
Access level: The predefined level of access granted for each API. Valid values: create, list, get, update, and delete.
Resource type: The type of the resource that supports authorization to perform the action. It indicates if the action supports resource-level permission. The specified resource must be compatible with the action. Otherwise, the policy will be ineffective.
- For APIs with resource-level permissions, required resource types are marked with an asterisk (*). Specify the corresponding Alibaba Cloud Resource Name (ARN) in the Resource element of the policy.
- For APIs without resource-level permissions, it is shown as All Resources. Use an asterisk (*) in the Resource element of the policy.
Condition key: The condition keys defined by the service. The key allows for granular control, applying to either actions alone or actions associated with specific resources. In addition to service-specific condition keys, Alibaba Cloud provides a set of common condition keys applicable across all RAM-supported services.
Dependent action: The dependent actions required to run the action. To complete the action, the RAM user or the RAM role must have the permissions to perform all dependent actions.

Action

Access level

Resource type

Condition key

Dependent action

emr-serverless-spark:ListWorkspaces

list

*All Resource

*

None

Request syntax

GET /api/v1/workspaces HTTP/1.1

Request parameters

Parameter	Type	Required	Description	Example
nextToken	string	No	The token for the next page of results.	1
maxResults	integer	No	The maximum number of results per page.	20
name	string	No	The name of the workspace. Fuzzy search is supported.	test_workspace
state	string	No	The state of the workspace.	running
regionId	string	No	The ID of the region.	cn-hangzhou
tag	array<object>	No	Filters the results by one or more tags.
	object	No	A tag object.
key	string	No	The tag key.	cn-shenzhen-finance.edas.config.server
value	string	No	The tag value.	iPhone disk space remaining rate
resourceGroupId	string	No	The ID of the resource group.	rg-aek2thxggoqhmhq

Response elements

Element	Type	Description	Example
	object	The returned data.
workspaces	array<object>	Workspace list.
	array<object>	Workspace details.
workspaceId	string	Workspace ID.	w-******
workspaceName	string	Workspace name.	Spark batch workspace-1
resourceSpec	string	Resource specification.	100cu
storage	string	OSS path.	spark-result
dlfCatalogId	string	DLF Catalog information.	default
paymentType	string	Billing method.	PayAsYouGo or Subscription
paymentDurationUnit	string	Subscription period (Required for the prepaid billing method).	YEAR, MONTH, WEEK, DAY, HOUR, MINUTE
duration	integer	The subscription period quantity is required for the prepaid billing method.	1
autoRenew	boolean	Specifies whether to enable auto-renewal (required for the prepaid billing method).	true
autoRenewPeriod	integer	Auto-renewal duration (Required for the prepaid billing method).	1
autoRenewPeriodUnit	string	Auto-renewal period (Required for the prepaid billing method).	YEAR, MONTH, WEEK, DAY, HOUR, MINUTE
workspaceStatus	string	Workspace status.	STARTING,RUNNING,TERMINATED
failReason	string	Failure reason.	out of stock
paymentStatus	string	Payment status.	PAID/UNPAID
regionId	string	Region ID.	cn-shanghai
createTime	integer	Workspace creation time.	1684115879955
endTime	integer	Workspace release time.	1687103999999
stateChangeReason	object	Information about changes to the workspace status.
code	string	Error code.	0
message	string	Error message.	Success
releaseType	string	Workspace release reason.	SERVICE_RELEASE
dlfType	string	Bind a dlf type.	1.0
prePaidQuota	object	Information about prepaid resource quotas.
usedResource	string	The amount of resources currently in use.	{\"cpu\":\"0\",\"memory\":\"0Gi\",\"cu\":\"0\"}
maxResource	string	The maximum amount of resources.	{\"cpu\":\"1\",\"memory\":\"4Gi\",\"cu\":\"1\"}
allocatedResource	string	The amount of resources that are currently allocated.	{\"cpu\":\"1\",\"memory\":\"4Gi\",\"cu\":\"1\"}
createTime	integer	The creation time of the resource quota.	1745683200000
expireTime	integer	The expiration time of the resource quota.	1740537153000
autoRenewal	boolean	Whether auto-renewal is enabled for the resource. true: Enables auto-renewal. The resource is automatically renewed after it expires. false: Auto-renewal is disabled. The resource is stopped upon expiration.	true
paymentStatus	string	The payment status of the current resource. The possible values are as follows: NORMAL: Active. WAIT_FOR_EXPIRE: Will expire. EXPIRED: The item has expired.	NORMAL
instanceId	string	The resource instance ID that is associated with the quota.	i-abc12345
orderId	string
tags	array<object>
	object
tagKey	string
tagValue	string
resourceGroupId	string		rg-xxxxxxxxxx
gpuSpec	array
	string		ecs.gn7i-c8g1.2xlarge
ipWhiteList	array
	string		0.0.0.1
requestId	string	Request ID.	DD6B1B2A-5837-5237-ABE4-FF0C8944****
nextToken	string	Next page token.	1
maxResults	integer	The maximum number of records to retrieve at one time.	20
totalCount	integer	Total number of records.	200

Examples

Success response

JSON format

{
  "workspaces": [
    {
      "workspaceId": "w-******",
      "workspaceName": "Spark batch workspace-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"
      ],
      "ipWhiteList": [
        "0.0.0.1"
      ]
    }
  ],
  "requestId": "DD6B1B2A-5837-5237-ABE4-FF0C8944****",
  "nextToken": "1",
  "maxResults": 20,
  "totalCount": 200
}

Error codes

See Error Codes for a complete list.

Release notes

See Release Notes for a complete list.