Todos os produtos
Search

Este produto

    DataWorks:CreateDataset

    Central de documentação

    DataWorks:CreateDataset

    Última atualização: Jun 26, 2026

    Cria um conjunto de dados. Esta operação é suportada apenas em workspaces dos quais o usuário participou. Atualmente, apenas conjuntos de dados do DataWorks são suportados. O número máximo de conjuntos de dados permitidos por tenant é 2.000.

    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

    dataworks:CreateDataset

    create

    *All Resource

    *

    		 Nenhuma Nenhuma

    Sintaxe da solicitação

    POST  HTTP/1.1

    Parâmetros da solicitação

    Parâmetro

    Tipo

    Obrigatório

    Descrição

    Exemplo
    ProjectId

    integer

    Sim

    O ID do workspace do DataWorks.

    12345
    Origin

    string

    Não

    A origem do conjunto de dados. Atualmente, apenas o DataWorks é suportado.

    Valores válidos:

    • DataWorks :

      DataWorks.

    DataWorks
    Name

    string

    Sim

    O nome do conjunto de dados. Não pode ser uma string vazia e não deve exceder 128 caracteres de comprimento.

    test_oss_dataset
    Comment

    string

    Não

    A descrição do conjunto de dados. Não deve exceder 1.024 caracteres de comprimento.

    this is a comment
    DataType

    string

    Não

    O tipo de dados. Valores válidos:

    • COMMON: Comum (Padrão)

    • PIC

    • TEXT

    • TABLE

    • VIDEO

    • AUDIO

    • INDEX.

    Valores válidos:

    • TABLE :
    • VIDEO :
    • COMMON :
    • TEXT :
    • PIC :
    • INDEX :
    • AUDIO :

    COMMON
    StorageType

    string

    Sim

    O tipo de armazenamento. Valores suportados atualmente:

    • OSS

    • NAS: Sistemas de arquivos NAS de uso geral

    • EXTREMENAS: Sistemas de arquivos NAS Extreme

    • DLF_LANCE: Data Lake Formation

    Valores válidos:

    • NAS: Sistemas de arquivos NAS de uso geral

    • MAXCOMPUTE: Tabela do MaxCompute

    • CPFS: Cloud Parallel File Storage

    • BMCPFS: CPFS para Lingjun

    • EXTREMENAS: Sistemas de arquivos NAS Extreme

    • OSS: Object Storage Service

    • DLF_LANCE: Data Lake Formation.

    Valores válidos:

    • NAS :
    • EXTREMENAS :
    • OSS :
    • DLF_LANCE :

    OSS
    InitVersion

    object

    Sim

    A versão inicial do conjunto de dados.

    Comment

    string

    Não

    A descrição. Não deve exceder 1.024 caracteres de comprimento.

    Initial Version
    Url

    string

    Sim

    URL.

    oss://test-oss-bucket/test_dir/
    ImportInfo

    object

    Não

    A configuração de importação de armazenamento para o conjunto de dados. As informações de configuração necessárias variam de acordo com o tipo de armazenamento.

    NAS

    Para valores válidos, consulte a resposta da API de armazenamento de arquivos DescribeFileSystems.

    {
"fileSystemId": "3b6XXX89c9", // O ID do sistema de arquivos.
"fileSystemStorageType":  "Performance" // A especificação de armazenamento do sistema de arquivos.
"vpcId": "vpc-uf66oxxxrqge1t2gson7s" // O ID da VPC do ponto de montagem.
}
```.

    string

    Não

    The storage import configuration information for the dataset.

    None
    MountPath

    string

    Não

    O caminho de montagem. Deve começar com /mnt/. Valor padrão: /mnt/data.

    /mnt/data

    Elementos de resposta

    Elemento

    Tipo

    Descrição

    Exemplo

    object

    Esquema da resposta.

    RequestId

    string

    O ID da solicitação.

    99EBE7CF-69C0-5089-BE3E-79563C31XXXX
    Success

    boolean

    Indica se a criação foi bem-sucedida.

    true
    Id

    string

    ID

    dataworks-dataset:3pXXXb8o0ngr07njhps1

    Exemplos

    Resposta de sucesso

    JSON formato

    {
  "RequestId": "99EBE7CF-69C0-5089-BE3E-79563C31XXXX",
  "Success": true,
  "Id": "dataworks-dataset:3pXXXb8o0ngr07njhps1"
}

    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.