すべてのプロダクト
Search
ドキュメントセンター

DataWorks:CreateSkill

最終更新日:Sep 03, 2026

DataWorks に新しいスキルを作成します。

操作説明

リクエストの説明

  • SkillMdOverride または BundleUrl のいずれかを指定する必要があります。2 つのパラメーターのうち 1 つは必須です。

  • Visibility は TENANT、PROJECT、または USER に設定できます。それぞれ、アカウント内での可視性、指定されたプロジェクトに対する可視性、指定されたユーザーに対する可視性を示します。

  • Visibility が PROJECT に設定されている場合、VisibilityScope.ProjectIds を使用して表示対象のプロジェクト ID のリストを指定します。Visibility が USER に設定されている場合、VisibilityScope.UserIds を使用して表示対象のユーザー ID のリストを指定します。

今すぐお試しください

この API を OpenAPI Explorer でお試しください。手作業による署名は必要ありません。呼び出しに成功すると、入力したパラメーターに基づき、資格情報が組み込まれた SDK コードが自動的に生成されます。このコードをダウンロードしてローカルで使用できます。

テスト

RAM 認証

この操作の認証情報はありません。問題が発生した場合は、アカウントマネージャーにご連絡ください。

リクエストパラメーター

パラメーター

型

必須 / 任意

説明

例

Name

string

必須

スキル名。現在のアカウント内で一意である必要があります。

my-skill。

Description

string

任意

スキルの説明。

データ分析スキル。

Visibility

string

任意

可視性レベル。有効な値:

  • TENANT: アカウント内で可視。

  • PROJECT: 指定されたプロジェクトに対して可視。

  • USER: 指定されたユーザーに対して可視。

TENANT。

VersionNote

string

任意

バージョンノート。

初期バージョン。

SkillMdOverride

string

任意

SKILL.md の本文コンテンツ。このパラメーターは BundleUrl と相互排他です。バンドルが提供されない場合、このフィールドを使用して SKILL.md ファイルのみを含む軽量スキルを作成します。

-

BundleUrl

string

任意

バンドル.zip ファイルのダウンロード可能な URL (HTTP/HTTPS)。このパラメーターは SkillMdOverride と相互排他です。

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

Extra

object

任意

キーと値のペア形式の拡張メタデータ。

{"appId":"APP_CWJMV36CT9SAFW1QEHX7"}

VisibilityScope

object

任意

可視性の範囲。対応するフィールドは Visibility パラメーターによって決定されます。

ProjectIds

array

任意

表示対象のプロジェクト ID のリスト。このパラメーターは、Visibility が PROJECT に設定されている場合にのみ効果がセットされます。

string

任意

プロジェクト ID のリスト。

12345

UserIds

array

任意

表示対象のユーザー ID のリスト。このパラメーターは、Visibility が USER に設定されている場合にのみ効果がセットされます。

string

任意

ユーザー ID。

123456

レスポンスフィールド

フィールド

型

説明

例

object

レスポンスのスキーマ。

RequestId

string

リクエスト ID。

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

Skill

object

Name

string

スキル名。

my-skill。

GmtCreateTime

string

作成時間 (ミリ秒レベルの UNIX タイムスタンプ)。

1780555634000

CreatorId

string

作成者の ID。

123456

ModifierId

string

スキルを最後に変更済みのユーザーの ID。

123456

Description

string

スキルの説明。

データ分析スキル。

Visibility

string

可視性レベル。

TENANT。

VisibilityScope

object

可視性の範囲。

ProjectIds

array

string

123456

UserIds

array

string

123456

Body

string

SKILL.md の本文コンテンツ。

-

GmtModifiedTime

string

最終変更時間 (ミリ秒レベルの UNIX タイムスタンプ)。

12345678901

例

成功レスポンス

JSONJSON

{
  "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"
  }
}

エラーコード

完全なリストについては、「エラーコード」をご参照ください。

変更履歴

完全なリストについては、「変更履歴」をご参照ください。