Todos os produtos
Search
Central de documentação

MaxCompute:UpdateProjectBasicMeta

Última atualização: Jul 04, 2026

Modifica as informações básicas de um projeto.

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:UpdateProjectBasicMeta

update

*Project

acs:odps:{#regionId}:{#accountId}:projects/{#ProjectName}

Nenhuma Nenhuma

Sintaxe da solicitação

PUT /api/v1/projects/{projectName}/meta HTTP/1.1

Parâmetros de caminho

Parâmetro

Tipo

Obrigatório

Descrição

Exemplo

projectName

string

Sim

O nome do projeto.

odps_project

Parâmetros da solicitação

Parâmetro

Tipo

Obrigatório

Descrição

Exemplo

body

object

Não

Os parâmetros do corpo da solicitação.

{ "status":"", // AVAILABLE: restore the project, FROZEN: freeze the project "comment": "", "properties": {} } - Note: If you do not want to update the comment, set it to null. If you set it to an empty string, the comment will be cleared. The properties key-value pairs are the same as those returned by GetProject. Submit only the properties that need to be modified. Do not submit the full property list every time. To reset a property, set the corresponding value to an empty string.

comment

string

Não

A descrição do projeto.

BI_Analysis

properties

object

Não

As propriedades básicas do projeto.

allowFullScan

boolean

Não

Specifies whether to allow full table scans in the project. Full table scans consume a large amount of resources. To improve processing efficiency, this feature is disabled by default.

false

enableDecimal2

boolean

Não

Specifies whether to enable the Decimal data type of MaxCompute 2.0 for the project.

true

enableTunnelQuotaRoute

boolean

Não

Specifies whether to enable resource group routing for the data transfer service.

  • true: The data transfer tasks submitted by this project use the bound data transfer service resource group by default.

  • false: The data transfer tasks submitted by this project use the shared data transfer service resource group by default.

true

encryption

object

Não

The storage encryption properties.

enable

boolean

Não

Specifies whether to enable data encryption for the project. For more information about data encryption, see Storage Encryption.

true

key

string

Não

The type of key used for data encryption, including the default key (MaxCompute Default Key) and Bring Your Own Key (BYOK). The default key (MaxCompute Default Key) is a default key created internally by MaxCompute.

default

algorithm

string

Não

The data encryption algorithm. The supported encryption algorithms include AES256, AESCTR, and RC4.

AES256

retentionDays

integer

Não

The number of days to retain backup data. During this period, you can restore the current version to any backed-up data version. Valid values: [0, 30]. Default value: 1. A value of 0 indicates that the backup feature is disabled.

1

sqlMeteringMax

string

Não

The maximum threshold for a single SQL statement consumption. Unit: scan volume (GB) × complexity.

1500

tableLifecycle

object

Não

The lifecycle properties of tables.

type

string

Não

The lifecycle type. Valid values:

  • mandatory: The Lifecycle clause is required. You must configure the lifecycle of a table.

  • optional: The Lifecycle clause is optional when you create a table. If the lifecycle of a table is not configured, the table is permanently valid.

  • inherit: If the lifecycle of a table is not configured when you create a table, the lifecycle of the table is set to the value of odps.table.lifecycle.value.

optional

value

string

Não

The lifecycle of a table. Unit: days. Valid values: 1 to 37231. Default value: 37231.

37231

timezone

string

Não

The time zone of the project, which is the odps.sql.timezone property.

Asia/Shanghai

tunnelQuota

string

Não

The Data Transfer Service resource group bound to the project.

  • Default (shared data transfer service resource group): The project is not allowed to use subscription-based data transfer service resource groups. Regardless of the default data transfer service resource group setting, data transfer tasks submitted by this project automatically use the Default resource group.

  • Subscription-based data transfer service resource group: The project is allowed to use subscription-based data transfer service resource groups.

Default

typeSystem

string

Não

The data type edition. Valid values:

  • 1: Edition 1.0

  • 2: Edition 2.0

  • hive: Hive-compatible type

For more information about the differences among the three data type editions, see Data Type Editions.

2.0

enableDr

boolean

Não

enableDataMasking

boolean

Não

Elementos de resposta

Elemento

Tipo

Descrição

Exemplo

object

Os parâmetros de resposta.

requestId

string

O ID da solicitação.

0b87b7e216652820458545253e8b0a

httpCode

integer

O código de status HTTP.

  • 1xx: respostas informativas - a solicitação foi recebida e está sendo processada.

  • 2xx: sucesso - a solicitação foi recebida, compreendida e aceita com sucesso pelo servidor.

  • 3xx: redirecionamento - a solicitação foi redirecionada. É necessária uma ação adicional para concluir a solicitação.

  • 4xx: erro do cliente - a solicitação contém parâmetros inválidos, erros de sintaxe ou condições específicas de solicitação que não podem ser atendidas.

  • 5xx: erro do servidor - o servidor não consegue atender a solicitação devido a outros motivos.

200

errorCode

string

O código de erro.

OBJECT_NOT_EXIST

errorMsg

string

A mensagem de erro.

This object does not exist.

data

string

O resultado da resposta.

success

Exemplos

Resposta de sucesso

JSON formato

{
  "requestId": "0b87b7e216652820458545253e8b0a",
  "httpCode": 200,
  "errorCode": "OBJECT_NOT_EXIST",
  "errorMsg": "This object does not exist.\n",
  "data": "success"
}

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.