汎用データ構造 - AI Coding Assistant Lingma - Alibaba Cloud ドキュメントセンター

Cloud Agents API 全般で使用される共通エンベロープと再利用可能なオブジェクトです。

このページでは、複数の API グループで使用されるリソース共通の構造を定義します。リソース固有の構造は、各リソースディレクトリの data-structures ページに記載されています。

メタデータオブジェクト

メタデータは、呼び出し元定義の文字列属性のフラットオブジェクトです。

例：

{
  "team": "docs",
  "project": "cloud-agents"
}

リストエンドポイントは、カーソルページネーションのエンベロープを返します。

フィールド	型	説明
`データ`	配列	現在のページに含まれるリソースオブジェクト
`has_more`	ブール値	追加のレコードが存在するかどうか
`first_id`	文字列 \| null	最初に返された項目のカーソル ID、または `data` が空の場合は `null`
`last_id`	文字列 \| null	最後に返された項目のカーソル ID、または `data` が空の場合は `null`

エラーレスポンスでは、このエンベロープを使用します：

{
  "type": "error",
  "error": {
    "type": "invalid_request_error",
    "message": "Field 'name' is required."
  }
}

フィールド	型	説明
`タイプ`	文字列	常に `"error"`
`error.type`	文字列	`invalid_request_error`、`authentication_error`、`permission_error`、`not_found_error`、`conflict_error`、または `api_error` などのエラーカテゴリ
`error.message`	文字列	人間が判読可能なエラーメッセージ

タイムスタンプは、UTC の ISO 8601 / RFC 3339 形式の文字列です (例: "2026-05-18T15:26:39.61669Z")。一部のフィールドは null を許容し、そのことは各リソーススキーマで明示的に示されています。