UpdateSkill - DataWorks - Alibaba Cloud ドキュメントセンター

指定されたスキルを更新し、新しいバージョンを生成します。

操作説明

リクエストの説明

この API を使用すると、既存のスキルを更新し、現在の最新バージョンまたは指定されたバージョンに基づいて新しいバージョンを作成できます。リクエストで指定されていないフィールドは、元の値を保持します。SkillMdOverride または BundleUrl のいずれかを指定してスキルのコンテンツを更新できます。また、可視性範囲などの追加情報を設定することもできます。

今すぐお試しください

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

テスト

RAM 認証

下表に、この API を呼び出すために必要な認証情報を示します。認証情報は、RAM (Resource Access Management) ポリシーを使用して定義できます。以下で各列名について説明します。

アクション：特定のリソースに対して実行可能な操作。ポリシー構文ではAction要素として指定します。
API：アクションを具体的に実行するための API。
アクセスレベル：各 API に対して事前定義されているアクセスの種類。有効な値：create、list、get、update、delete。
リソースタイプ：アクションが作用するリソースの種類。リソースレベルでの権限をサポートするかどうかを示すことができます。ポリシーの有効性を確保するため、アクションの対象として適切なリソースを指定してください。
- リソースレベルの権限を持つ API の場合、必要なリソースタイプはアスタリスク (*) でマークされます。ポリシーのResource要素で対応する ARN を指定してください。
- リソースレベルの権限を持たない API の場合、「すべてのリソース」と表示され、ポリシーのResource要素でアスタリスク (*) でマークされます。
条件キー：サービスによって定義された条件のキー。このキーにより、きめ細やかなアクセス制御が可能になります。この制御は、アクション単体に適用することも、特定のリソースに対するアクションに適用することもできます。Alibaba Cloud は、サービス固有の条件キーに加えて、すべての RAM 統合サービスに適用可能な一連の共通条件キーを提供しています。
依存アクション：ある特定のアクションを実行するために、前提として実行が必要となる他のアクション。依存アクションの権限も RAM ユーザーまたは RAM ロールに付与する必要があります。

アクション

アクセスレベル

リソースタイプ

条件キー

依存アクション

dataworks:UpdateSkill

update

*すべてのリソース。

*

なし

リクエストパラメーター

パラメーター	型	必須 / 任意	説明	例
Name	string	必須	更新するスキルの名前。	my-skill
ExpectedVersion	integer	任意	楽観的ロックに使用する期待されるバージョン番号。指定しない場合、現在の最新バージョンに基づいて更新されます。	1
Description	string	任意	スキルの説明。	データ分析スキル
VersionNote	string	任意	バージョンノート。	リビジョンノート
SkillMdOverride	string	任意	SKILL.md の本文コンテンツ。BundleUrl とは相互排他です。	象を冷蔵庫に入れるには 3 つのステップが必要です。冷蔵庫のドアを開け、象を入れ、冷蔵庫のドアを閉めます
BundleUrl	string	任意	bundle.zip ファイルのダウンロード可能な URL (HTTP/HTTPS)。SkillMdOverride とは相互排他です。指定した場合、バンドルが置き換えられます。	https://example.com/skill.zip
Extra	object	任意	拡張メタデータ (キーと値のペア)。	{\"appId\":\"APP_Q2SDWKIGFWNZTR68K1GQ\"}
VisibilityScope	object	任意	可視性範囲。可視性レベルに基づいて対応するフィールドが使用されます。
ProjectIds	array	任意	可視プロジェクト ID のリスト。
	string	任意	プロジェクト ID。	123456
UserIds	array	任意	可視ユーザー ID のリスト。
	string	任意	ユーザー ID。	123456

レスポンスフィールド

フィールド	型	説明	例
	object	レスポンスのスキーマ。
RequestId	string	リクエスト ID。	824F80BA-1778-5D8A-BAFF-668A4D9C4CC7
Skill	object	スキルの詳細。
Name	string	スキル名。	my-skill
GmtCreateTime	string	作成時間 (ミリ秒単位のタイムスタンプ)。	1780555634000
GmtModifiedTime	string	最終更新時間 (ミリ秒単位のタイムスタンプ)。	1780555634000
CreatorId	string	作成者の ID。	123456
ModifierId	string	最終修飾子の ID。	123456
Description	string	スキルの説明。	データ分析スキル
Visibility	string	可視性レベル。	TENANT
VisibilityScope	object	可視性範囲。
ProjectIds	array	可視プロジェクト ID のリスト。
	string	プロジェクト ID。	-
UserIds	array	可視ユーザー ID のリスト。
	string	ユーザー ID。	123456
Body	string	SKILL.md の本文コンテンツ。	象を冷蔵庫に入れるには 3 つのステップが必要です。冷蔵庫のドアを開け、象を入れ、冷蔵庫のドアを閉めます

例

成功レスポンス

JSONJSON

{
  "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": "把大象放冰箱分为三步，把冰箱门打开，把大象放进去，把冰箱门关上。"
  }
}

エラーコード

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

変更履歴

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