Todos los productos
Search
Centro de documentos

E-MapReduce:CreateWorkspace

Última actualización: Oct 28, 2026

Crea un espacio de trabajo.

Pruébelo ahora

Pruebe esta API en OpenAPI Explorer sin necesidad de firma manual. Las llamadas exitosas generan automáticamente código SDK acorde a sus parámetros. Descárguelo con seguridad de credenciales integrada para uso local.

Test

Autorización de RAM

La siguiente tabla describe la autorización necesaria para invocar esta API. Puede definirla en una directiva de Resource Access Management (RAM). A continuación, se detallan las columnas de la tabla:

  • Action: Estas acciones se utilizan en el elemento Action de las declaraciones de directivas de permisos de RAM para otorgar permisos que permitan realizar la operación.

  • API: La API que debe invocarse para llevar a cabo la acción.

  • Nivel de acceso: Nivel de acceso predefinido que se concede para cada API. Valores válidos: create, list, get, update y delete.

  • Tipo de recurso: Tipo de recurso que admite autorización para ejecutar la acción. Indica si la acción es compatible con permisos a nivel de recurso. El recurso especificado debe ser compatible con la acción; de lo contrario, la directiva no surtirá efecto.

    • En las API con permisos a nivel de recurso, los tipos de recursos obligatorios se marcan con un asterisco (*). Especifique el Alibaba Cloud Resource Name (ARN) correspondiente en el elemento Resource de la directiva.

    • Para las API sin permisos a nivel de recurso, se muestra All Resources. Utilice un asterisco (*) en el elemento Resource de la directiva.

  • Clave de condición: Claves de condición definidas por el servicio. Permiten un control granular y se aplican ya sea solo a acciones o a acciones asociadas con recursos específicos. Además de las claves de condición específicas del servicio, Alibaba Cloud proporciona un conjunto de common condition keys aplicables a todos los servicios compatibles con RAM.

  • Acción dependiente: Acciones dependientes necesarias para ejecutar la acción principal. Para completar la operación, el usuario de RAM o el rol de RAM debe contar con permisos para realizar todas las acciones dependientes.

Action

Nivel de acceso

Tipo de recurso

Clave de condición

Acción dependiente

emr-serverless-spark:CreateWorkspace

create

*Todos los recursos.

*

Ninguna Ninguna

Sintaxis de la solicitud

POST /api/v1/workspaces HTTP/1.1

Parámetros de la solicitud

Parámetro

Tipo

Obligatorio

Descripción

Ejemplo

body

object

No

La estructura de la solicitud.

workspaceName

string

No

El nombre del espacio de trabajo.

default

resourceSpec

object

No

Las especificaciones de recursos.

cu

string

No

El límite de recursos del espacio de trabajo.

1000

gpu

integer

No

El número de GPU.

100

ossBucket

string

No

El bucket de OSS.

oss://test-bucket/

dlfCatalogId

string

No

La información del catálogo de DLF.

123xxxxx

paymentType

string

No

El método de facturación de la instancia. Valores válidos:

  • PayAsYouGo: pago por uso

  • Pre: suscripción

PayAsYouGo

paymentDurationUnit

string

No

La unidad del periodo de suscripción.

1000

duration

string

No

El número de periodos de suscripción. Este parámetro es obligatorio cuando el parámetro paymentType se establece en Pre.

12452

autoRenew

string

No

Especifica si se debe habilitar la renovación automática. Este parámetro es obligatorio cuando el parámetro paymentType se establece en Pre.

false

autoRenewPeriod

string

No

El periodo de renovación automática. Este parámetro es obligatorio cuando el parámetro paymentType se establece en Pre.

100

autoRenewPeriodUnit

string

No

La unidad de renovación automática. Este parámetro es obligatorio cuando el parámetro paymentType se establece en Pre.

month

clientToken

string

No

El token de cliente para la idempotencia.

8e6aae2810c8f67229ca70bb31cd****

ramRoleName

string

No

El nombre del rol de RAM que se utiliza para ejecutar trabajos de Spark.

AliyunEMRSparkJobRunDefaultRole

autoStartSessionCluster

boolean

No

Especifica si se debe iniciar automáticamente una sesión.

false

releaseType

string

No

El tipo de liberación.

pro

dlfType

string

No

El tipo de enlace de DLF.

dlf1.0

tag

array<object>

No

La lista de etiquetas.

object

No

La etiqueta.

key

string

No

La clave de la etiqueta.

key

value

string

No

El valor de la etiqueta.

value

resourceGroupId

string

No

El ID del grupo de recursos.

rg-acfmwpi66knkxny

gpuSpec

array

No

La lista de tipos de instancia de GPU.

string

No

El tipo de instancia de GPU.

ecs.gn7i-c8g1.2xlarge

regionId

string

No

El ID de la región.

cn-hangzhou

Elementos de la respuesta

Elemento

Tipo

Descripción

Ejemplo

object

Los datos de la respuesta.

workspaceId

string

El ID del espacio de trabajo.

w-******

operationId

string

El ID del flujo de operaciones.

op-******

requestId

string

El ID de la solicitud.

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

Ejemplos

Respuesta exitosa

JSON Formato

{
  "workspaceId": "w-******",
  "operationId": "op-******",
  "requestId": "DD6B1B2A-5837-5237-ABE4-FF0C8944****"
}

Códigos de error

Consulte Códigos de error para ver la lista completa.

Notas de la versión

Consulte Notas de la versión para ver la lista completa.