UpdateSkill - DataWorks - Alibaba Cloud Documentation Center

Memperbarui skill tertentu dan menghasilkan versi baru.

Deskripsi operasi

Deskripsi permintaan

API ini memungkinkan Anda memperbarui Skill yang ada dan membuat versi baru berdasarkan versi tertinggi saat ini atau versi yang ditentukan. Bidang yang tidak disediakan dalam permintaan mempertahankan nilai aslinya. Anda dapat memperbarui konten Skill dengan menyediakan SkillMdOverride atau BundleUrl. Anda juga dapat mengatur informasi tambahan seperti cakupan (dalam OAuth) visibilitas.

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

Tabel berikut menjelaskan otorisasi yang diperlukan untuk memanggil API ini. Anda dapat menentukannya dalam kebijakan Resource Access Management (RAM). Kolom pada tabel dijelaskan sebagai berikut:

Action: Aksi yang dapat digunakan dalam elemen Action pada pernyataan kebijakan izin RAM untuk memberikan izin guna melakukan operasi tersebut.
API: API yang dapat Anda panggil untuk melakukan aksi tersebut.
Access level: Tingkat akses yang telah ditentukan untuk setiap API. Nilai yang valid: create, list, get, update, dan delete.
Resource type: Jenis resource yang mendukung otorisasi untuk melakukan aksi tersebut. Ini menunjukkan apakah aksi tersebut mendukung izin tingkat resource. Resource yang ditentukan harus kompatibel dengan aksi tersebut. Jika tidak, kebijakan tersebut tidak akan berlaku.
- Untuk API dengan izin tingkat resource, jenis resource yang diperlukan ditandai dengan tanda bintang (*). Tentukan Nama Sumber Daya Alibaba Cloud (ARN) yang sesuai dalam elemen Resource pada kebijakan.
- Untuk API tanpa izin tingkat resource, ditampilkan sebagai All Resources. Gunakan tanda bintang (*) dalam elemen Resource pada kebijakan.
Condition key: Kunci kondisi yang didefinisikan oleh layanan. Kunci ini memungkinkan kontrol granular, berlaku baik hanya untuk aksi maupun untuk aksi yang terkait dengan resource tertentu. Selain kunci kondisi spesifik layanan, Alibaba Cloud menyediakan serangkaian common condition keys yang berlaku di semua layanan yang didukung RAM.
Dependent action: Aksi dependen yang diperlukan untuk menjalankan aksi tersebut. Untuk menyelesaikan aksi tersebut, pengguna RAM atau role RAM harus memiliki izin untuk melakukan semua aksi dependen.

Action

Access level

Resource type

Condition key

Dependent action

dataworks:UpdateSkill

update

*Semua Sumber daya.

*

None

Parameter permintaan

Parameter	Type	Required	Description	Example
Name	string	Yes	Nama Skill yang akan diperbarui.	my-skill
ExpectedVersion	integer	No	Nomor versi yang diharapkan untuk kunci optimis. Jika tidak ditentukan, pembaruan didasarkan pada versi tertinggi saat ini.	1
Description	string	No	Deskripsi Skill.	Data analytics skill
VersionNote	string	No	Catatan revisi.	Revision note
SkillMdOverride	string	No	Konten isi SKILL.md. Saling eksklusif dengan BundleUrl.	Memasukkan gajah ke dalam kulkas memerlukan tiga langkah: buka pintu kulkas, masukkan gajah, dan tutup pintu kulkas
BundleUrl	string	No	URL yang dapat diunduh (HTTP/HTTPS) dari file bundle.zip. Saling eksklusif dengan SkillMdOverride. Jika disediakan, bundle akan diganti.	https://example.com/skill.zip
Extra	object	No	Metadata tambahan (pasangan kunci-nilai).	{\"appId\":\"APP_Q2SDWKIGFWNZTR68K1GQ\"}
VisibilityScope	object	No	Cakupan (dalam OAuth) visibilitas. Bidang yang sesuai digunakan berdasarkan tingkat visibilitas.
ProjectIds	array	No	Daftar ID proyek yang terlihat.
	string	No	ID proyek.	123456
UserIds	array	No	Daftar ID pengguna yang terlihat.
	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	Detail Skill.
Name	string	Nama Skill.	my-skill
GmtCreateTime	string	Pengatur waktu pembuatan (stempel waktu milidetik).	1780555634000
GmtModifiedTime	string	Pengatur waktu modifikasi terakhir (stempel waktu milidetik).	1780555634000
CreatorId	string	ID pembuat.	123456
ModifierId	string	ID pengubah terakhir.	123456
Description	string	Deskripsi Skill.	Data analytics skill
Visibility	string	Tingkat visibilitas.	TENANT
VisibilityScope	object	Cakupan (dalam OAuth) visibilitas.
ProjectIds	array	Daftar ID proyek yang terlihat.
	string	ID proyek.	-
UserIds	array	Daftar ID pengguna yang terlihat.
	string	ID pengguna.	123456
Body	string	Konten isi SKILL.md.	Memasukkan gajah ke dalam kulkas memerlukan tiga langkah: buka pintu kulkas, masukkan gajah, dan tutup pintu kulkas

Contoh

Respons sukses

JSONformat

{
  "RequestId": "824F80BA-1778-5D8A-BAFF-668A4D9C4CC7",
  "Skill": {
    "Name": "my-skill",
    "GmtCreateTime": "1780555634000",
    "GmtModifiedTime": "1780555634000",
    "CreatorId": "123456",
    "ModifierId": "123456",
    "Description": "数据分析技能",
    "Visibility": "TENANT",
    "VisibilityScope": {
      "ProjectIds": [
        "-"
      ],
      "UserIds": [
        "123456"
      ]
    },
    "Body": "把大象放冰箱分为三步，把冰箱门打开，把大象放进去，把冰箱门关上。"
  }
}

Kode kesalahan

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.