Todos os produtos
Search

Este produto

    DataWorks:CreateDataset

    Central de documentação

    DataWorks:CreateDataset

    Última atualização: Sep 03, 2026

    Cria um conjunto de dados. Você pode criar um conjunto de dados apenas em um workspace do qual tenha participado. Apenas conjuntos de dados do DataWorks são suportados. O número máximo de conjuntos de dados por locatário é 2000.

    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. Apenas DataWorks é suportado.

    Valores válidos:

    • DataWorks :

      DataWorks.

    DataWorks
    Name

    string

    Sim

    O nome do conjunto de dados. O valor deve ser uma string não vazia com até 128 caracteres de comprimento.

    test_oss_dataset
    Comment

    string

    Não

    A descrição do conjunto de dados. O valor pode ter até 1024 caracteres de comprimento.

    este é um comentário
    DataType

    string

    Não

    O tipo de dados. Valores válidos:

    • COMMON: uso geral (padrão).

    • PIC: imagem.

    • TEXT: texto.

    • TABLE: tabela.

    • VIDEO: vídeo.

    • AUDIO: áudio.

    • INDEX: índice.

    Valores válidos:

    • TABLE :

      tabela.

    • VIDEO :

      vídeo.

    • COMMON :

      uso geral.

    • TEXT :

      texto.

    • PIC :

      imagem.

    • INDEX :

      índice.

    • AUDIO :

      áudio.

    COMMON
    StorageType

    string

    Sim

    O tipo de armazenamento. Valores válidos:

    • OSS: Object Storage Service.

    • NAS: armazenamento de arquivos NAS de uso geral.

    • EXTREMENAS: armazenamento de arquivos NAS Extreme.

    • DLF_LANCE: Data Lake Formation.

    Valores válidos:

    • NAS :

      armazenamento de arquivos NAS de uso geral.

    • EXTREMENAS :

      armazenamento de arquivos NAS Extreme.

    • OSS :

      Object Storage Service.

    • DLF_LANCE :

      Data Lake Formation.

    OSS
    InitVersion

    object

    Sim

    A versão inicial do conjunto de dados.

    Comment

    string

    Não

    A descrição. O valor pode ter até 1024 caracteres de comprimento.

    Versão inicial
    Url

    string

    Sim

    A URL.

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

    object

    Não

    A configuração de importação de armazenamento do conjunto de dados. A configuração necessária varia dependendo do tipo de armazenamento.

    NAS

    Os valores podem ser obtidos na resposta da operação DescribeFileSystems da API do File Storage NAS. 
    {
  "fileSystemId": "3b6XXX89c9", // ID do sistema de arquivos
  "fileSystemStorageType": "Performance", // Especificação de armazenamento do sistema de arquivos
  "vpcId": "vpc-uf66oxxxrqge1t2gson7s" // ID da VPC do ponto de montagem
}

    string

    Não

    A configuração de importação de armazenamento do conjunto de dados.

    None
    MountPath

    string

    Não

    O caminho de montagem. O valor 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 o conjunto de dados foi criado.

    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.