RemoteGymp · API v1

データの書き込み

カスタムフィールドとメンテナンスウィンドウを更新し、自動化を実行して書き込みを安全に再試行してください。

APIおよびMCPは、キューに入ったジョブ、スケジュールされた電源、エージェントのアンインストール、エンドポイント診断、コマンドキャンセル、およびサードパーティのパッチポリシーをサポートします。冪等性キーを再利用し、受領書を確認してください。一時的な管理者資格情報は一度返されます。トラフィック監視には既存の権利が必要で、課金は引き続きアプリケーション内で行われます。

  1. 権限を確認してください。

    プリセットは個々の機能を選択するものであり、アクセスレベルを変更するものではありません。設定で新規に作成した認証情報は、デフォルトでFullAccessを使用しますが、選択された機能のみが許可されます。以前のReadWrite認証情報では、承認済みのカスタムフィールドとメンテナンスの変更が許可されます。自動化とデバイス制御には、FullAccessに加えて、それぞれの固有の機能が必要です。書き込み前にGETと/v1/operations/capabilitiesを確認してください。会社スコープと現在の所有者の権限は引き続き適用されます。

  2. 他の変更を上書きしないようにしてください。

    カスタムフィールドとそのバージョンを確認してください。新しい値と読み取ったバージョンを PATCH /v1/custom-fields/{fieldId}. に送信してください。409 version_conflict は、誰かが先に変更したことを意味します。再度読み取り、更新が適切かどうかを判断してください。

  3. 安全に再試行してください。

    POST /v1/maintenance-windows の場合、Idempotency-Key ヘッダーを送信してください。結果が不確実な場合は、同じキーとボディを繰り返して、複製を作成するのではなく元のウィンドウを取得してください。同じキーでボディが変更されている場合は拒否されます。DELETE /v1/maintenance-windows/{windowId} はウィンドウをキャンセルします。

  4. アクションレシートに従ってください。

    自動化および管理書き込みでは、JSON ボディで idempotencyKey を使用し、操作レシートを返します。 Completedはリクエストハンドラが完了したことを意味します。デバイスが処理を完了したかどうかを確認するには、結果またはドメイン実行を確認してください。OutcomeUnknownの場合は、処理を決定する前に受信確認と現在の状態を確認してください。新しいキーで自動的に再送信しないでください。処理が二重に実行される可能性があります。

APIリファレンス →

内容改訂3f225a253 · OpenAPI SHA-256: b12c42306a89