ListQuotas - MaxCompute: Central de Documentação do Alibaba Cloud

Obtém uma lista de cotas.

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

odps:ListQuotas

get

*Quota

acs:odps:{#regionId}:{#accountId}:quotas/*

Nenhuma

Sintaxe da solicitação

GET /api/v1/quotas HTTP/1.1

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
tenantId `deprecated`	string	Não
region `deprecated`	string	Não
productId `deprecated`	string	Não
billingType	string	Não	O método de cobrança.	subscription
saleTags	string	Não	As tags de alocação de custos usadas para filtrar cotas. Você pode criar tags de alocação de custos no serviço Tag.	{"tag":"this_is_tag_demo"}
marker	string	Não	O token que especifica a posição a partir da qual começar a retornar os resultados. Os resultados são classificados em ordem alfabética.	cHlvZHBzX3VkZl8xMDExNV8xNDU3NDI4NDkzKg==
maxItem	integer	Não	O número máximo de entradas a serem retornadas em cada página.	100

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object	PopCompatibleResult.
requestId	string	O ID da solicitação.	0bc12e6f16677875480593081d2956
quotaInfoList	array<object>	A lista de cotas.
	array<object>	A lista de cotas.
billingPolicy	object	As informações de cobrança.
billingMethod	string	The billing method. subscription: The subscription billing method. payasyougo: The pay-as-you-go billing method.	subscription
odpsSpecCode	string	The specifications of the order.	OdpsStandard
orderId	string	The ID of the order.	45245678
saleTag	object	A tag de vendas da cota. Esta tag é igual ao identificador de cobrança e é usada para alocação de custos.
resourceIds	array	The IDs of the resources. This ID is also used in the billing system. You can use this ID to associate the costs of a quota with a tag.
	string	The ID of the MaxCompute quota.	"aaaaaaa-bbbb-4fd0-a8eb-50861590f7dd"
resourceType	string	The type of the resource. Valid values: quota and project.	"project"
cluster	string	O ID do cluster.	AT-120N
createTime	integer	A hora em que a cota foi criada.	2022-09-06T02:14:44Z
creatorId	string	O ID da conta que criou a cota. Este ID é um UID de conta Alibaba Cloud.	672863518
id	string	O ID da cota.	0
name	string	O nome da cota.	quota_a
nickName	string	O alias da cota.	quota_nickname
parameter	object	Os parâmetros da cota.	{"minCU":10, "adhocCU":0, "maxCU":10, "schedulerType":"Fair", }
parentId	string	O ID do recurso pai.	null
regionId	string	O ID da região.	cn-beijing
scheduleInfo	object	As informações de agendamento baseadas em tempo.
currPlan	string	The quota plan that is currently in effect.	planA
currTime	string	The time when the current plan took effect.	0800
nextPlan	string	The next quota plan that is scheduled to take effect.	planB
nextTime	string	The time when the next plan is scheduled to take effect.	1700
oncePlan	string	The quota plan that takes effect immediately. This parameter is returned only when a user triggers an immediate plan that is different from the current plan.	planC
onceTime	string	The time when the immediate plan was triggered.	1500
operatorName	string	The name of the operator.	userA
timezone	string	The time zone.	UTC+8
status	string	O status da cota.	ON
subQuotaInfoList	array<object>	As informações sobre as subcotas.
	array<object>	As informações sobre as subcotas.
saleTag	object	The sales tag of the quota. This tag is the same as the billing identifier and is used for cost allocation.
resourceIds	array	The IDs of the resources. This ID is also used in the billing system. You can use this ID to associate the costs of a quota with a tag.
	string	The ID of the MaxCompute quota.	"aaaaaaa-bbbb-4fd0-a8eb-50861590f7dd"
resourceType	string	The type of the resource. Valid values: quota and project.	"quota"
billingPolicy	object	The billing information.
billingMethod	string	The billing method. subscription: The subscription billing method. payasyougo: The pay-as-you-go billing method.	subscription
odpsSpecCode	string	The specifications of the order.	OdpsStandard
orderId	string	The ID of the order.	45245678
cluster	string	The ID of the cluster.	AT-120N
createTime	integer	The time when the quota was created.	2022-09-06T02:14:44Z
creatorId	string	The ID of the account that created the quota. This ID is an Alibaba Cloud account UID.	672863518
id	string	The ID of the sub-quota.	1000048
name	string	The name of the sub-quota.	subquotaA
nickName	string	The alias of the sub-quota.	subquotaA
parameter	object	The quota description.	{"minCU":10, "adhocCU":0, "maxCU":10, "schedulerType":"Fair", }
enablePriority	boolean	Indicates whether to enable priority-based scheduling.	true
forceReservedMin	boolean	Indicates whether the resource is exclusive.	true
maxCU	integer	The maximum reserved computing units (CUs).	50
minCU	integer	The minimum reserved CUs.	50
schedulerType	string	The scheduling policy.	Fifo/Fair
singleJobCULimit	integer	The maximum CUs for a single job.	10
elasticReservedCU	integer	The elastically reserved CUs.	50
slotNum	integer
adhocSlot	integer
minGu	integer
maxGu	integer
autoScaleCPULimit	integer
parentId	string	The ID of the parent resource.	0
regionId	string	The ID of the region.	cn-beijing
scheduleInfo	object	The time-based scheduling information.
currPlan	string	The quota plan that is currently in effect.	planA
currTime	string	The time when the current plan took effect.	0800
nextPlan	string	The next quota plan that is scheduled to take effect.	planB
nextTime	string	The time when the next plan is scheduled to take effect.	1700
oncePlan	string	The quota plan that takes effect immediately. This parameter is returned only when a user triggers an immediate plan that is different from the current plan.	planC
onceTime	string	The time when the immediate plan was triggered.	1500
operatorName	string	The name of the operator.	userA
timezone	string	The time zone.	UTC+8
status	string	The status of the quota.	ON
tag	string	The tag of the quota.	abc
tenantId	string	The ID of the tenant.	280747109771520
type	string	The type of the resource system. This parameter corresponds to the resourceSystemType parameter of the control cluster.	FUXI_ONLINE
version	string	The version number.	1
tag	string	A tag da cota.	abc
tenantId	string	O ID do tenant.	280747109771520
type	string	O tipo do sistema de recursos. Este parâmetro corresponde ao parâmetro resourceSystemType do cluster de controle.	FUXI_ONLINE
version	string	O número da versão.	1
Tags	array<object>	As tags.
	object	As tags.
TagValue	string	The value of the tag.	1
TagKey	string	The key of the tag.	Department
marker	string	O token que especifica a posição a partir da qual começar a retornar os resultados. Os resultados são classificados em ordem alfabética.	cHlvZHBzX3VkZl8xMDExNV8xNDU3NDI4NDkzKg==
maxItem	integer	O número máximo de entradas retornadas em cada página.	10
data	object	Os dados retornados.
quotaInfoList	array<object>	A lista de cotas.
	array<object>	A lista de cotas.
id	string	The ID of the quota.	0
name	string	The name of the quota.	quota_a
nickName	string	The alias of the quota.	quota_nickname
type	string	The type of the resource system. This parameter corresponds to the resourceSystemType parameter of the control cluster.	FUXI_ONLINE
status	string	The status of the quota.	ON
tenantId	string	The ID of the tenant.	280747109771520
regionId	string	The ID of the region.	cn-beijing
parentId	string	The ID of the parent resource.	null
cluster	string	The ID of the cluster.	AT-120N
version	string	The version number.	1
billingPolicy	object	The billing information.
odpsSpecCode	string	The specifications of the order.	OdpsStandard
orderId	string	The ID of the order.	45245678
billingMethod	string	The billing method. subscription: The subscription billing method. payasyougo: The pay-as-you-go billing method.	subscription
scheduleInfo	object	The time-based scheduling information.
currPlan	string	The quota plan that is currently in effect.	planA
currTime	string	The time when the current plan took effect.	0800
nextPlan	string	The next quota plan that is scheduled to take effect.	planB
nextTime	string	The time when the next plan is scheduled to take effect.	1700
oncePlan	string	The quota plan that takes effect immediately. This parameter is returned only when a user triggers an immediate plan that is different from the current plan.	planC
onceTime	string	The time when the immediate plan was triggered.	1500
operatorName	string	The name of the operator.	userA
timezone	string	The time zone.	UTC+8
parameter	object	The quota description.	{"minCU":10, "adhocCU":0, "maxCU":10, "schedulerType":"Fair", }
tag	string	The tag of the quota.	abc
createTime	integer	The time when the quota was created.	2022-09-06T02:14:44Z
creatorId	string	The ID of the account that created the quota. This ID is an Alibaba Cloud account UID.	672863518
saleTag	object	The sales tag of the quota. This tag is the same as the billing identifier and is used for cost allocation.
resourceIds	array	The IDs of the resources. This ID is also used in the billing system. You can use this ID to associate the costs of a quota with a tag.
	string	The ID of the MaxCompute quota.	"aaaaaaa-bbbb-4fd0-a8eb-50861590f7dd"
resourceType	string	The type of the resource. Valid values: quota and project.	"quota"
subQuotaInfoList	array<object>	The information about the sub-quotas.
	array<object>	The information about the sub-quotas.
id	string	The ID of the sub-quota.	1000048
name	string	The name of the sub-quota.	subquotaA
nickName	string	The alias of the sub-quota.	subquotaA
type	string	The type of the resource system. This parameter corresponds to the resourceSystemType parameter of the control cluster.	FUXI_ONLINE
status	string	The status of the quota.	ON
tenantId	string	The ID of the tenant.	280747109771520
regionId	string	The ID of the region.	cn-beijing
parentId	string	The ID of the parent resource.	0
cluster	string	The ID of the cluster.	AT-120N
version	string	The version number.	1
billingPolicy	object	The billing information.
odpsSpecCode	string	The specifications of the order.	OdpsStandard
orderId	string	The ID of the order.	45245678
billingMethod	string	The billing method. subscription: The subscription billing method. payasyougo: The pay-as-you-go billing method.	subscription
scheduleInfo	object	The time-based scheduling information.
currPlan	string	The quota plan that is currently in effect.	planA
currTime	string	The time when the current plan took effect.	0800
nextPlan	string	The next quota plan that is scheduled to take effect.	planB
nextTime	string	The time when the next plan is scheduled to take effect.	1700
oncePlan	string	The quota plan that takes effect immediately. This parameter is returned only if a user triggers an immediate plan that is different from `currPlan`.	planC
onceTime	string	The time when the immediate-effect plan was triggered.	1500
operatorName	string	The name of the operator.	userA
timezone	string	The time zone.	UTC+8
parameter	object	The description of the quota.	{"minCU":10, "adhocCU":0, "maxCU":10, "schedulerType":"Fair", }
enablePriority	boolean	Specifies whether to enable priority-based scheduling.	true
forceReservedMin	boolean	Specifies whether the resource is exclusive.	true
maxCU	integer	The upper limit of reserved CUs.	50
minCU	integer	The minimum number of guaranteed reserved CUs.	50
schedulerType	string	The scheduling policy.	Fifo/Fair
singleJobCULimit	integer	The upper limit of CUs for a single job.	10
elasticReservedCU	integer	The value of elastically reserved CUs.	50
slotNum	integer
adhocSlot	integer
autoScaleCPULimit	integer
minGu	integer
maxGu	integer
tag	string	The resource tag of the quota.	abc
createTime	integer	The time when the resource was created.	2022-09-06T02:14:44Z
creatorId	string	The creator of the resource. This is the UID of an Alibaba Cloud account.	672863518
saleTag	object	The identifier of the MaxCompute quota object. This identifier is the same as the one in the Alibaba Cloud bill and is used in tagging scenarios.
resourceIds	array	The identifier of the MaxCompute quota object. This identifier also exists in the Alibaba Cloud sales subsystem. It associates the costs of the quota object with a tag.
	string	The identifier of the MaxCompute quota object.	"aaaaaaa-bbbb-4fd0-a8eb-50861590f7dd"
resourceType	string	The type of the object. Only `quota` and `project` are supported.	"quota"
Tags	array<object>	The tags.
	object	The tag.
TagValue	string	The tag value.	a12351qHDP6YEQMt
TagKey	string	The tag key.	Department
marker	string	Os resultados são retornados em ordem alfabética, começando a partir da entrada após o marker.	cHlvZHBzX3VkZl8xMDExNV8xNDU3NDI4NDkzKg==
maxItem	integer	O número máximo de entradas retornadas por página.	10
NextToken	string	O token para a próxima página de resultados. Se este parâmetro tiver um valor, mais resultados estarão disponíveis. Para obter a próxima página, inclua este valor no parâmetro NextToken da próxima solicitação.	"abcde"
NextToken	string	O token para a próxima página de resultados. Esta operação suporta apenas paginação consecutiva. Se o valor retornado não estiver vazio, mais dados estarão disponíveis. Para obter a próxima página, use o valor retornado na sua próxima solicitação.	AAAAAdDWBF2w6Olxc+cMPjUtUMo/CvPe4IK7f7kIQFrIZjyc

Exemplos

Resposta de sucesso

JSON formato

{
  "requestId": "0bc12e6f16677875480593081d2956",
  "quotaInfoList": [
    {
      "billingPolicy": {
        "billingMethod": "subscription",
        "odpsSpecCode": "OdpsStandard ",
        "orderId": "45245678"
      },
      "saleTag": {
        "resourceIds": [
          "\"aaaaaaa-bbbb-4fd0-a8eb-50861590f7dd\""
        ],
        "resourceType": "\"project\""
      },
      "cluster": "AT-120N\n",
      "createTime": 0,
      "creatorId": "672863518\n",
      "id": "0",
      "name": "quota_a\n",
      "nickName": "quota_nickname\n",
      "parameter": {
        "test": "test",
        "test2": 1
      },
      "parentId": "null",
      "regionId": "cn-beijing",
      "scheduleInfo": {
        "currPlan": "planA",
        "currTime": "0800",
        "nextPlan": "planB",
        "nextTime": "1700",
        "oncePlan": "planC",
        "onceTime": "1500",
        "operatorName": "userA",
        "timezone": "UTC+8"
      },
      "status": "ON \n",
      "subQuotaInfoList": [
        {
          "saleTag": {
            "resourceIds": [
              "\"aaaaaaa-bbbb-4fd0-a8eb-50861590f7dd\"\n"
            ],
            "resourceType": "\"quota\""
          },
          "billingPolicy": {
            "billingMethod": "subscription\n",
            "odpsSpecCode": "OdpsStandard ",
            "orderId": "45245678\n"
          },
          "cluster": "AT-120N",
          "createTime": 0,
          "creatorId": "672863518\n",
          "id": "1000048",
          "name": "subquotaA\n",
          "nickName": "subquotaA\n",
          "parameter": {
            "enablePriority": true,
            "forceReservedMin": true,
            "maxCU": 50,
            "minCU": 50,
            "schedulerType": "Fifo/Fair\n",
            "singleJobCULimit": 10,
            "elasticReservedCU": 50,
            "slotNum": 0,
            "adhocSlot": 0,
            "minGu": 0,
            "maxGu": 0,
            "autoScaleCPULimit": 0
          },
          "parentId": "0",
          "regionId": "cn-beijing",
          "scheduleInfo": {
            "currPlan": "planA",
            "currTime": "0800",
            "nextPlan": "planB",
            "nextTime": "1700",
            "oncePlan": "planC",
            "onceTime": "1500",
            "operatorName": "userA",
            "timezone": "UTC+8"
          },
          "status": "ON",
          "tag": "abc",
          "tenantId": "280747109771520\n",
          "type": "FUXI_ONLINE\n",
          "version": "1"
        }
      ],
      "tag": "abc",
      "tenantId": "280747109771520\n",
      "type": "FUXI_ONLINE\n",
      "version": "1",
      "Tags": [
        {
          "TagValue": "1",
          "TagKey": "Department"
        }
      ]
    }
  ],
  "marker": "cHlvZHBzX3VkZl8xMDExNV8xNDU3NDI4NDkzKg==",
  "maxItem": 10,
  "data": {
    "quotaInfoList": [
      {
        "id": "0\n",
        "name": "quota_a\n",
        "nickName": "quota_nickname",
        "type": "FUXI_ONLINE",
        "status": "ON",
        "tenantId": "280747109771520",
        "regionId": "cn-beijing",
        "parentId": "null",
        "cluster": "AT-120N",
        "version": "1",
        "billingPolicy": {
          "odpsSpecCode": "OdpsStandard ",
          "orderId": "45245678\n",
          "billingMethod": "subscription"
        },
        "scheduleInfo": {
          "currPlan": "planA\n",
          "currTime": "0800",
          "nextPlan": "planB",
          "nextTime": "1700",
          "oncePlan": "planC",
          "onceTime": "1500",
          "operatorName": "userA",
          "timezone": "UTC+8"
        },
        "parameter": {
          "test": "test",
          "test2": 1
        },
        "tag": "abc",
        "createTime": 0,
        "creatorId": "672863518\n",
        "saleTag": {
          "resourceIds": [
            "\"aaaaaaa-bbbb-4fd0-a8eb-50861590f7dd\"\n"
          ],
          "resourceType": "\"quota\"\n"
        },
        "subQuotaInfoList": [
          {
            "id": "1000048",
            "name": "subquotaA\n",
            "nickName": "subquotaA\n",
            "type": "FUXI_ONLINE\n",
            "status": "ON",
            "tenantId": "280747109771520\n",
            "regionId": "cn-beijing",
            "parentId": "0",
            "cluster": "AT-120N",
            "version": "1",
            "billingPolicy": {
              "odpsSpecCode": "OdpsStandard ",
              "orderId": "45245678\n",
              "billingMethod": "subscription"
            },
            "scheduleInfo": {
              "currPlan": "planA",
              "currTime": "0800",
              "nextPlan": "planB",
              "nextTime": "1700",
              "oncePlan": "planC",
              "onceTime": "1500",
              "operatorName": "userA",
              "timezone": "UTC+8"
            },
            "parameter": {
              "enablePriority": true,
              "forceReservedMin": true,
              "maxCU": 50,
              "minCU": 50,
              "schedulerType": "Fifo/Fair\n",
              "singleJobCULimit": 10,
              "elasticReservedCU": 50,
              "slotNum": 0,
              "adhocSlot": 0,
              "autoScaleCPULimit": 0,
              "minGu": 0,
              "maxGu": 0
            },
            "tag": "abc",
            "createTime": 0,
            "creatorId": "672863518\n",
            "saleTag": {
              "resourceIds": [
                "\"aaaaaaa-bbbb-4fd0-a8eb-50861590f7dd\"\n"
              ],
              "resourceType": "\"quota\"\n"
            }
          }
        ],
        "Tags": [
          {
            "TagValue": "a12351qHDP6YEQMt",
            "TagKey": "Department"
          }
        ]
      }
    ],
    "marker": "cHlvZHBzX3VkZl8xMDExNV8xNDU3NDI4NDkzKg==",
    "maxItem": 10,
    "NextToken": "\"abcde\""
  },
  "NextToken": "AAAAAdDWBF2w6Olxc+cMPjUtUMo/CvPe4IK7f7kIQFrIZjyc"
}

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.