All Products
Search
Document Center

DataWorks:CreateSkill

Last Updated:Jul 20, 2026

Membuat Skill baru di DataWorks.

Deskripsi operasi

Deskripsi permintaan

  • Anda harus menyediakan SkillMdOverride atau BundleUrl. Salah satu dari dua parameter tersebut wajib diisi.

  • Visibility dapat diatur ke TENANT, PROJECT, atau USER, yang masing-masing menunjukkan visibilitas dalam akun, visibilitas untuk proyek tertentu, atau visibilitas untuk pengguna tertentu.

  • Ketika Visibility diatur ke PROJECT, tentukan daftar ID proyek yang terlihat dengan menggunakan VisibilityScope.ProjectIds. Ketika Visibility diatur ke USER, tentukan daftar ID pengguna yang terlihat dengan menggunakan VisibilityScope.UserIds.

Coba sekarang

Coba API ini di OpenAPI Explorer tanpa perlu penandatanganan manual. Panggilan yang berhasil akan secara otomatis menghasilkan contoh kode SDK sesuai dengan parameter Anda. Unduh kode tersebut dengan kredensial bawaan yang aman untuk penggunaan lokal.

Test

RAM authorization

Tidak ada otorisasi untuk operasi ini. Jika Anda mengalami masalah saat menjalankan operasi ini, hubungi dukungan teknis.

Parameter permintaan

Parameter

Type

Required

Description

Example

Name

string

Yes

Nama Skill, yang harus unik dalam akun saat ini.

my-skill.

Description

string

No

Deskripsi Skill.

Skill analisis data.

Visibility

string

No

Tingkat visibilitas. Nilai valid:

  • TENANT: Terlihat dalam akun.

  • PROJECT: Terlihat untuk proyek tertentu.

  • USER: Terlihat untuk pengguna tertentu.

TENANT.

VersionNote

string

No

Catatan versi.

Versi awal.

SkillMdOverride

string

No

Konten isi SKILL.md. Parameter ini saling eksklusif dengan BundleUrl. Jika tidak ada bundle yang disediakan, gunakan bidang ini untuk membuat Skill ringan yang hanya berisi file SKILL.md.

-

BundleUrl

string

No

URL yang dapat diunduh (HTTP/HTTPS) dari file bundle.zip. Parameter ini saling eksklusif dengan SkillMdOverride.

https://example.com/skill.zip.

Extra

object

No

Metadata ekstensi dalam pasangan kunci-nilai.

{"appId":"APP_CWJMV36CT9SAFW1QEHX7"}

VisibilityScope

object

No

Cakupan (dalam OAuth) visibilitas. Bidang yang sesuai ditentukan oleh parameter Visibility.

ProjectIds

array

No

Daftar ID proyek yang terlihat. Parameter ini hanya berlaku ketika Visibility diatur ke PROJECT.

string

No

Daftar ID proyek.

12345

UserIds

array

No

Daftar ID pengguna yang terlihat. Parameter ini hanya berlaku ketika Visibility diatur ke USER.

string

No

ID pengguna.

123456

Elemen respons

Element

Type

Description

Example

object

Skema Respons.

RequestId

string

ID permintaan.

824F80BA-1778-5D8A-BAFF-668A4D9C4CC7

Skill

object

Name

string

Nama Skill.

my-skill.

GmtCreateTime

string

Pengatur waktu pembuatan, dalam stempel waktu UNIX tingkat milidetik.

1780555634000

CreatorId

string

ID pembuat.

123456

ModifierId

string

ID pengguna yang terakhir memodifikasi Skill.

123456

Description

string

Deskripsi Skill.

Skill analisis data.

Visibility

string

Tingkat visibilitas.

TENANT.

VisibilityScope

object

Cakupan (dalam OAuth) visibilitas.

ProjectIds

array

string

123456

UserIds

array

string

123456

Body

string

Konten isi SKILL.md.

-

GmtModifiedTime

string

Pengatur waktu modifikasi terakhir, dalam stempel waktu UNIX tingkat milidetik.

12345678901

Contoh

Respons sukses

JSONformat

{
  "RequestId": "824F80BA-1778-5D8A-BAFF-668A4D9C4CC7",
  "Skill": {
    "Name": "my-skill",
    "GmtCreateTime": "1780555634000",
    "CreatorId": "123456",
    "ModifierId": "123456",
    "Description": "数据分析技能",
    "Visibility": "TENANT",
    "VisibilityScope": {
      "ProjectIds": [
        "123456"
      ],
      "UserIds": [
        "123456"
      ]
    },
    "Body": "-",
    "GmtModifiedTime": "12345678901"
  }
}

Kode kesalahan

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.