UIP エージェント ファイル

uip agent file は、Studio Web プロジェクト内の個々のファイル ( uip agent pull / pushのきめ細かい親戚にあたるファイル) を操作し、 .uis アーカイブ全体を移動します。file は、ソリューション全体をプルして再パックすることなく、特定のファイル (たとえば、パッチ agent.json適用箇所) を読み取ったり上書きしたりする場合に使用します。

すべてのサブコマンドには、アクティブなCLIセッション(uip login)が必要です。すべてのサブコマンドは、 グローバルオプション (--output、 --output-filter、 --log-level、 --log-file) を優先します。終了コードは 標準コントラクトに従います。

概要

uip agent file list <projectId>                                    [--login-validity <minutes>]
uip agent file get  <projectId> <fileId> [-d <path>]               [--login-validity <minutes>]
uip agent file put  <projectId> <fileId> <localPath>               [--login-validity <minutes>]

<projectId> は Studio Web プロジェクトの UUID です。これはソリューションの内部プロジェクトであり、ソリューションそのものではありません。1 つは、uip agent pushの CloudProjectId フィールド、uip agent listの projects[] 配列、またはプッシュされたプロジェクトのSolutionStorage.jsonから取得します。

UIP エージェントのファイル一覧

Studio Web プロジェクト内のファイルをフラット ツリーとしてリストします。

引数

• <projectId> (必須) — Studio Web プロジェクトの UUID。

オプション

フラグ	既定 (Default)	目的
--login-validity <minutes>	10	トークンの有効期間は、最小時間 (分) です。

例

uip agent file list a1b2c3d4-0000-0000-0000-000000000001

データシェイプ(--output json)

{
  "Code": "AgentFileList",
  "Data": [
    {
      "Path": "Agent/agent.json",
      "Id": "a1b2c3d4-0000-0000-0000-000000000201",
      "Name": "agent.json",
      "FileType": "json",
      "IsMain": "true",
      "IsEntryPoint": "true"
    }
  ]
}

Path は、プロジェクトのルートからのスラッシュで区切られた完全なパスです。入れ子になったフォルダー名も含まれます。IsMain と IsEntryPoint は文字列化されたブール値 ("true" / "false") です。空のプロジェクトは [ Data: { "Message": "No files found in project" }を返します。

uip エージェント ファイル取得

単一のファイルをダウンロードします。ディスクに書き込むか、base64 でエンコードして応答に書き込みます。

引数

• <projectId> (必須) — プロジェクト UUID。
• <fileId> (必須) — ファイル UUID ( file listから)。

オプション

フラグ	既定 (Default)	目的
-d, --destination <path>	— (応答に書き込む)	ファイルの書き込み先のローカル パスです。親ディレクトリは自動的に作成されます。
--login-validity <minutes>	10	トークンの有効期間は、最小時間 (分) です。

例

# Download to a specific file path
uip agent file get \
  a1b2c3d4-0000-0000-0000-000000000001 \
  a1b2c3d4-0000-0000-0000-000000000201 \
  -d ./agent.json

# Fetch without writing to disk (content is inlined base64)
uip agent file get \
  a1b2c3d4-0000-0000-0000-000000000001 \
  a1b2c3d4-0000-0000-0000-000000000201

データシェイプ(--output json)

と -d

{
  "Code": "AgentFileGet",
  "Data": {
    "Status": "File downloaded",
    "ProjectId": "a1b2c3d4-0000-0000-0000-000000000001",
    "FileId": "a1b2c3d4-0000-0000-0000-000000000201",
    "Output": "/abs/path/agent.json"
  }
}

-dなし (インライン):

{
  "Code": "AgentFileGet",
  "Data": {
    "Status": "File downloaded",
    "ProjectId": "…",
    "FileId": "…",
    "Content": "<base64>",
    "Encoding": "base64"
  }
}

uip エージェント ファイル put

Studio Web プロジェクト内のファイルをアップロード/上書きします。ファイルはマルチパート フォーム データとして PUT /api/Project/<projectId>/FileOperations/File/<fileId>に送信されます。

引数

• <projectId> (必須) — プロジェクト UUID。
• <fileId> (必須) — 上書きするファイル UUID。
• <localPath> (必須) — アップロードするローカル ファイル パスです。

オプション

フラグ	既定 (Default)	目的
--login-validity <minutes>	10	トークンの有効期間は、最小時間 (分) です。

例

uip agent file put \
  a1b2c3d4-0000-0000-0000-000000000001 \
  a1b2c3d4-0000-0000-0000-000000000201 \
  ./agent.json

データシェイプ(--output json)

{
  "Code": "AgentFilePut",
  "Data": {
    "Status": "File uploaded",
    "ProjectId": "a1b2c3d4-0000-0000-0000-000000000001",
    "FileId": "a1b2c3d4-0000-0000-0000-000000000201",
    "LocalPath": "/abs/path/agent.json"
  }
}

関連

• uip agent pull — ソリューション全体を.uisアーカイブとしてダウンロードします。
• uip agent push — プロジェクトをインポートする (新規または上書き)。
• uip agent list — ソリューション(およびそのプロジェクト)を列挙します。

参照

• 認証 — セッションと --login-validity。
• グローバル オプション、 終了コード。