Todos los productos
Search
Centro de documentos

E-MapReduce:GetWorkspace

Última actualización: Nov 02, 2026

Obtiene los detalles de 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:GetWorkspace

get

*All Resource

*

Ninguna Ninguna

Sintaxis de la solicitud

GET /api/v1/workspaces/{workspaceId} HTTP/1.1

Parámetros de ruta

Parámetro

Tipo

Obligatorio

Descripción

Ejemplo

workspaceId

string

Sí

El ID del espacio de trabajo.

w-***

Parámetros de la solicitud

Parámetro

Tipo

Obligatorio

Descripción

Ejemplo

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.

workspace

object

El objeto del espacio de trabajo.

workspaceId

string

El ID del espacio de trabajo.

w-******

workspaceName

string

El nombre del espacio de trabajo.

Spark batch job workspace-1

resourceSpec

string

Las especificaciones de recursos.

{"cu": 100}

storage

string

La ruta de OSS.

spark-result

dlfCatalogId

string

La información del catálogo de DLF.

default

paymentType

string

El método de facturación.

PayAsYouGo or Subscription

paymentDurationUnit

string

La unidad de duración de la suscripción. Este parámetro es obligatorio para las instancias de suscripción.

YEAR, MONTH, WEEK, DAY, HOUR, MINUTE

duration

integer

La duración de la suscripción. Este parámetro es obligatorio para las instancias de suscripción.

1

autoRenew

boolean

Especifica si se debe habilitar la renovación automática. Este parámetro es obligatorio para las instancias de suscripción.

true

autoRenewPeriod

integer

La duración de la renovación automática. Este parámetro es obligatorio para las instancias de suscripción.

1

autoRenewPeriodUnit

string

El ciclo de renovación automática. Este parámetro es obligatorio para las instancias de suscripción.

YEAR, MONTH, WEEK, DAY, HOUR, MINUTE

workspaceStatus

string

El estado del espacio de trabajo.

STARTING,RUNNING,TERMINATED

failReason

string

El motivo del error.

out of stock

paymentStatus

string

El estado del pago.

PAID/UNPAID

regionId

string

El ID de la región.

cn-beijing

createTime

integer

La hora a la que se creó el espacio de trabajo. La hora se muestra como una marca de tiempo UNIX en milisegundos.

1776824869000

endTime

integer

La hora a la que se liberó el espacio de trabajo.

1786586477000

stateChangeReason

object

La información sobre el cambio de estado del espacio de trabajo.

code

string

El código de error.

1000000

message

string

La información de estado del pod de nodo.

ok

releaseType

string

El motivo por el que se liberó el espacio de trabajo.

stable

ramRoleName

string

El nombre del rol de RAM utilizado para ejecutar trabajos de Spark.

Aliyun

dlfType

string

El tipo de DLF vinculado.

DLF-NEXT

prePaidQuota

object

La información sobre la cuota de recursos de suscripción.

usedResource

string

La cantidad de recursos utilizados actualmente.

{"cu": 50}

maxResource

string

La cantidad máxima de recursos que se pueden utilizar.

{"cu": 100}

allocatedResource

string

La cantidad de recursos asignados actualmente.

{"cu": 100}

createTime

integer

La hora a la que se creó el espacio de trabajo. La hora se muestra como una marca de tiempo UNIX en milisegundos.

1791802817000

expireTime

integer

La hora de vencimiento de la cuota de suscripción de GPU. La hora se muestra como una marca de tiempo UNIX en milisegundos.

1779768979586

autoRenewal

boolean

Especifica si la renovación automática está habilitada para el recurso. Valores válidos:

  • true: La renovación automática está habilitada. El recurso se renueva automáticamente al vencer.

  • false: La renovación automática está deshabilitada. El recurso se detiene al vencer.

False

paymentStatus

string

El estado del pedido.

NORMAL

instanceId

string

El ID de la instancia.

ray-df0tghlhat1776wy-klbifz8l

orderId

string

El ID del pedido.

298581757170384

prePaidQuotaGpu

array<object>

La lista de recursos de suscripción de GPU.

object

El recurso de suscripción de GPU.

orderId

string

El ID del pedido.

2345634254

instanceId

string

El ID de la instancia.

w-xxxxxx-quota-gpu-xxxx

createTime

integer

La hora a la que se creó el recurso.

1782292672000

expireTime

integer

La hora de vencimiento del recurso.

1782292772000

autoRenewal

boolean

Especifica si la renovación automática está habilitada.

False

paymentStatus

string

El estado del pedido.

NORMAL

gpuSpec

string

El modelo de GPU.

ecs.gn7i-c8g1.2xlarge

gpuNum

integer

El número de instancias de GPU.

8

instanceTypeId

string

El ID del tipo de instancia.

ecs.g5.small

instanceTypeFamily

string

La familia de instancias.

ecs.g5

cpuCoreCount

string

El número de núcleos de CPU.

1

gpuAmount

integer

El número de GPU.

1

memorySize

string

El tamaño de memoria.

4096

gpuMemorySize

integer

El tamaño de memoria de GPU.

4096

gpuMachineNum

integer

El número de instancias de GPU.

1

tags

array<object>

La clave de la etiqueta.

object

La clave de la etiqueta.

tagKey

string

La clave de la etiqueta.

[\"COST\"]

tagValue

string

El valor de la etiqueta.

3d775731-9ec1-4fe2-a00d-061d51fce677

resourceGroupId

string

El ID del grupo de recursos.

rg-aek4f7uj74wdthi

resourceOwnerId

string

El UID del creador.

13*************

gpuSpec

array

La lista de tipos de instancia de GPU.

string

El modelo de GPU.

ecs.gn6e-c12g1.3xlarge

ipWhiteList

array

La lista blanca de IP del espacio de trabajo.

string

La lista blanca de IP del espacio de trabajo.

10.0.0.1

requestId

string

El ID de la solicitud.

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

Ejemplos

Respuesta exitosa

JSON Formato

{
  "workspace": {
    "workspaceId": "w-******",
    "workspaceName": "Spark batch job workspace-1",
    "resourceSpec": "{\"cu\": 100}",
    "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-beijing",
    "createTime": 1776824869000,
    "endTime": 1786586477000,
    "stateChangeReason": {
      "code": "1000000",
      "message": "ok"
    },
    "releaseType": "stable",
    "ramRoleName": "Aliyun",
    "dlfType": "DLF-NEXT",
    "prePaidQuota": {
      "usedResource": "{\"cu\": 50}",
      "maxResource": "{\"cu\": 100}",
      "allocatedResource": "{\"cu\": 100}",
      "createTime": 1791802817000,
      "expireTime": 1779768979586,
      "autoRenewal": true,
      "paymentStatus": "NORMAL",
      "instanceId": "ray-df0tghlhat1776wy-klbifz8l",
      "orderId": "298581757170384"
    },
    "prePaidQuotaGpu": [
      {
        "orderId": "2345634254",
        "instanceId": "w-xxxxxx-quota-gpu-xxxx",
        "createTime": 1782292672000,
        "expireTime": 1782292772000,
        "autoRenewal": true,
        "paymentStatus": "NORMAL",
        "gpuSpec": "ecs.gn7i-c8g1.2xlarge",
        "gpuNum": 8,
        "instanceTypeId": "ecs.g5.small",
        "instanceTypeFamily": "ecs.g5",
        "cpuCoreCount": "1",
        "gpuAmount": 1,
        "memorySize": "4096",
        "gpuMemorySize": 4096,
        "gpuMachineNum": 1
      }
    ],
    "tags": [
      {
        "tagKey": "[\\\"COST\\\"]",
        "tagValue": "3d775731-9ec1-4fe2-a00d-061d51fce677"
      }
    ],
    "resourceGroupId": "rg-aek4f7uj74wdthi",
    "resourceOwnerId": "13*************",
    "gpuSpec": [
      "ecs.gn6e-c12g1.3xlarge"
    ],
    "ipWhiteList": [
      "10.0.0.1"
    ]
  },
  "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.