ListWorkspaceQueues - E-MapReduce: Central de Documentação do Alibaba Cloud

Consulta as filas em um workspace.

Experimente agora

Experimente esta API no OpenAPI Explorer, sem necessidade de assinatura manual. Chamadas bem-sucedidas geram automaticamente código SDK correspondente aos seus parâmetros. Faça o download com segurança de credenciais integrada para uso local.

Testar

Autorização RAM

A tabela abaixo descreve a autorização necessária para chamar esta API. Você pode defini-la em uma política do Resource Access Management (RAM). As colunas da tabela estão detalhadas abaixo:

Ação: As ações que podem ser usadas no elemento Action das instruções de política de permissão do RAM para conceder permissões para executar a operação.
API: A API que você pode chamar para executar a ação.
Nível de acesso: O nível de acesso predefinido concedido para cada API. Valores válidos: create, list, get, update e delete.
Tipo de recurso: O tipo de recurso que suporta autorização para executar a ação. Indica se a ação suporta permissão em nível de recurso. O recurso especificado deve ser compatível com a ação. Caso contrário, a política será ineficaz.
- Para APIs com permissões em nível de recurso, os tipos de recursos obrigatórios são marcados com um asterisco (*). Especifique o Nome de Recurso Alibaba Cloud (ARN) correspondente no elemento Resource da política.
- Para APIs sem permissões em nível de recurso, é exibido como Todos os Recursos. Use um asterisco (*) no elemento Resource da política.
Chave de condição: As chaves de condição definidas pelo serviço. A chave permite controle granular, aplicando-se somente a ações ou a ações associadas a recursos específicos. Além das chaves de condição específicas do serviço, o Alibaba Cloud fornece um conjunto de chaves de condição comuns aplicáveis a todos os serviços compatíveis com RAM.
Ação dependente: As ações dependentes necessárias para executar a ação. Para concluir a ação, o usuário RAM ou a função RAM deve ter permissões para executar todas as ações dependentes.

Ação

Nível de acesso

Tipo de recurso

Chave de condição

Ação dependente

emr-serverless-spark:ListWorkspaceQueues

none

*Todos os recursos.

*

Nenhuma

Sintaxe da solicitação

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

Parâmetros de caminho

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
workspaceId	string	Não	O ID do workspace.	w-26ca1703f6d7****

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
environment	string	Não	O tipo de ambiente. Valores válidos: dev : dev. production : production.	production
regionId	string	Não	O ID da região.	cn-hangzhou

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object	Os dados da resposta.
queues	array<object>	A lista de filas.
	array<object>	Os detalhes da fila.
regionId	string	O ID da região.	cn-hangzhou
queueName	string	O nome da fila.	dev_queue
workspaceId	string	O ID do workspace.	w-1234abcd
queueType	string	O tipo de fila. Valores válidos: instance: tipo de tarefa única instanceChildren: tipo de tarefa pai	instance
properties	string	O rótulo da fila.	dev_queue
queueScope	string	A arquitetura da fila.	{"arch": "x86"}
maxResource	string	A capacidade máxima de recursos da fila.	{"cpu": "2","memory": "2Gi"}
minResource	string	A capacidade mínima de recursos da fila.	{"cpu": "2","memory": "2Gi"}
usedResource	string	A capacidade de recursos utilizados da fila.	{"cpu": "2","memory": "2Gi"}
queueStatus	string	O status da fila.	RUNNING
creator	string	O UID do criador.	237109
allowActions	array<object>	A lista de operações permitidas para a fila.
	object	A operação permitida para a fila.
actionArn	string	O ARN da ação.	acs:emr::workspaceId:action/create_queue
actionName	string	O nome da permissão.	view
displayName	string	O nome de exibição da permissão.	Directory traversal and file browsing
description	string	A descrição da ação.	Directory traversal and file browsing
dependencies	array	A lista de dependências da ação.	["view"]
	string	A dependência da ação.	view
environments	array	A lista de tipos de ambiente para a fila.
	string	O tipo de ambiente da fila.	production
paymentType	string	O método de cobrança. Valores válidos: PayAsYouGo: pós-pago Pre: assinatura	PayAsYouGo
createTime	integer	A hora em que o workspace foi criado. O valor é um carimbo de data/hora UNIX em milissegundos.	1684115879955
preheat	boolean	Especifica se a pré-busca de recursos é realizada.	true
queueCategory	string	A categoria da fila, como CPU ou GPU.	CPU
gpuSpec	array	A lista de tipos de instância GPU.
	string	O tipo de instância GPU.	ecs.gn7i-c8g1.2xlarge
gpuMachineNum	integer	O número de máquinas GPU.	0
instanceId	string	O ID da instância de recurso associada à fila.
description	string	A descrição.	test queue
requestId	string	O ID da solicitação.	DD6B1B2A-5837-5237-ABE4-FF0C8944****
nextToken	string	O token para a próxima página.	1
maxResults	integer	O número máximo de registros a serem retornados por solicitação.	20
totalCount	integer	O número total de registros.	200

Exemplos

Resposta de sucesso

JSON formato

{
  "queues": [
    {
      "regionId": "cn-hangzhou",
      "queueName": "dev_queue",
      "workspaceId": "w-1234abcd",
      "queueType": "instance",
      "properties": "dev_queue",
      "queueScope": "{\"arch\": \"x86\"}",
      "maxResource": "{\"cpu\": \"2\",\"memory\": \"2Gi\"}",
      "minResource": "{\"cpu\": \"2\",\"memory\": \"2Gi\"}",
      "usedResource": "{\"cpu\": \"2\",\"memory\": \"2Gi\"}",
      "queueStatus": "RUNNING",
      "creator": "237109",
      "allowActions": [
        {
          "actionArn": "acs:emr::workspaceId:action/create_queue",
          "actionName": "view",
          "displayName": "Directory traversal and file browsing",
          "description": "Directory traversal and file browsing",
          "dependencies": [
            "view"
          ]
        }
      ],
      "environments": [
        "production"
      ],
      "paymentType": "PayAsYouGo",
      "createTime": 1684115879955,
      "preheat": true,
      "queueCategory": "CPU",
      "gpuSpec": [
        "ecs.gn7i-c8g1.2xlarge"
      ],
      "gpuMachineNum": 0,
      "instanceId": "",
      "description": "test queue"
    }
  ],
  "requestId": "DD6B1B2A-5837-5237-ABE4-FF0C8944****",
  "nextToken": "1",
  "maxResults": 20,
  "totalCount": 200
}

Códigos de erro

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.