# Shared Resources の再試行と完了マトリクス

Shared Resources の 26 件の操作に対する再試行、冪等性、完了のポリシーです。うち 12 件がエンドポイント固有のビジネスエラーコードを記載しています。

> 状態を変える操作では、HTTP タイムアウトは結果が不明という意味であり、失敗の証拠ではありません。再試行の前に現在の状態を照会してください。


ポリシーの定義と他の製品は[エンドポイント再試行マトリクス](/ja/api-reference/getting-started/endpoint-behavior)、機械可読版は[操作動作マニフェスト](/assets/operation-behavior.8a452a27fdb2398e4085aaff39b0d6f29825844e56ccba51c7fceb4bcf57c29c.ec0bf2e0.yaml)を参照してください。

## Shared Resources Local API

| 操作 | 再試行ポリシー | 冪等性 | 完了 / 復旧 |
|  --- | --- | --- | --- |
| `POST /api/proxyInfo/page``queryProxyInfoPageUsingPOST` | 上限付き指数バックオフとジッターで安全に再試行できます。 | 読み取り専用。リクエストを繰り返してもリソースの状態は変わりません。 | レスポンスが唯一の文書化された完了シグナルであり、非同期契約は定義されていません。 エンドポイント固有のビジネスエラーは文書化されていません。共通エラー契約を使用してください。 |
| `POST /api/proxyInfo/add``addUsingPOST` | 自動的に再試行しないでください。まずリソース、アップロード、タスクが作成されたかを照会します。 | 公開された冪等キーの契約は文書化されていません。 | レスポンスが唯一の文書化された完了シグナルであり、非同期契約は定義されていません。 文書化されたビジネスエラー: `14023`。 |
| `POST /api/proxyInfo/update``updateProxyUsingPOST` | タイムアウトや通信障害の後は、再試行の前に現在の状態を照会してください。 | 結果はすでに適用されている可能性があります。繰り返しの実行は契約上冪等ではありません。 | レスポンスが唯一の文書化された完了シグナルであり、非同期契約は定義されていません。 文書化されたビジネスエラー: `14003`, `14023`。 |
| `POST /api/proxyInfo/delete``deleteProxyUsingPOST` | タイムアウトや通信障害の後は、再試行の前に現在の状態を照会してください。 | 結果はすでに適用されている可能性があります。繰り返しの実行は契約上冪等ではありません。 | レスポンスが唯一の文書化された完了シグナルであり、非同期契約は定義されていません。 文書化されたビジネスエラー: `14017`, `14024`。 |
| `POST /api/envgroup/page``apiEnvgroupPagePost` | 上限付き指数バックオフとジッターで安全に再試行できます。 | 読み取り専用。リクエストを繰り返してもリソースの状態は変わりません。 | レスポンスが唯一の文書化された完了シグナルであり、非同期契約は定義されていません。 エンドポイント固有のビジネスエラーは文書化されていません。共通エラー契約を使用してください。 |
| `POST /api/envgroup/edit``apiEnvgroupEditPost` | タイムアウトや通信障害の後は、再試行の前に現在の状態を照会してください。 | 結果はすでに適用されている可能性があります。繰り返しの実行は契約上冪等ではありません。 | レスポンスが唯一の文書化された完了シグナルであり、非同期契約は定義されていません。 エンドポイント固有のビジネスエラーは文書化されていません。共通エラー契約を使用してください。 |
| `POST /api/envgroup/create``apiEnvgroupCreatePost` | 自動的に再試行しないでください。まずリソース、アップロード、タスクが作成されたかを照会します。 | 公開された冪等キーの契約は文書化されていません。 | レスポンスが唯一の文書化された完了シグナルであり、非同期契約は定義されていません。 エンドポイント固有のビジネスエラーは文書化されていません。共通エラー契約を使用してください。 |
| `POST /api/envgroup/delete``apiEnvgroupDeletePost` | タイムアウトや通信障害の後は、再試行の前に現在の状態を照会してください。 | 結果はすでに適用されている可能性があります。繰り返しの実行は契約上冪等ではありません。 | レスポンスが唯一の文書化された完了シグナルであり、非同期契約は定義されていません。 文書化されたビジネスエラー: `19064`。 |
| `GET /api/envtag/all``apiEnvtagAllGet` | 上限付き指数バックオフとジッターで安全に再試行できます。 | 読み取り専用。リクエストを繰り返してもリソースの状態は変わりません。 | レスポンスが唯一の文書化された完了シグナルであり、非同期契約は定義されていません。 エンドポイント固有のビジネスエラーは文書化されていません。共通エラー契約を使用してください。 |
| `POST /api/envtag/create``apiEnvtagCreatePost` | 自動的に再試行しないでください。まずリソース、アップロード、タスクが作成されたかを照会します。 | 公開された冪等キーの契約は文書化されていません。 | レスポンスが唯一の文書化された完了シグナルであり、非同期契約は定義されていません。 エンドポイント固有のビジネスエラーは文書化されていません。共通エラー契約を使用してください。 |
| `POST /api/envtag/edit``apiEnvtagEditPost` | タイムアウトや通信障害の後は、再試行の前に現在の状態を照会してください。 | 結果はすでに適用されている可能性があります。繰り返しの実行は契約上冪等ではありません。 | レスポンスが唯一の文書化された完了シグナルであり、非同期契約は定義されていません。 エンドポイント固有のビジネスエラーは文書化されていません。共通エラー契約を使用してください。 |
| `POST /api/envtag/delete``apiEnvtagDeletePost` | タイムアウトや通信障害の後は、再試行の前に現在の状態を照会してください。 | 結果はすでに適用されている可能性があります。繰り返しの実行は契約上冪等ではありません。 | レスポンスが唯一の文書化された完了シグナルであり、非同期契約は定義されていません。 文書化されたビジネスエラー: `19105`。 |
| `POST /api/webhook/config``apiWebhookConfigPost` | 上限付き指数バックオフとジッターで安全に再試行できます。 | チーム単位の upsert です。同じリクエストを繰り返しても同じ保存済み設定に収束します。 | レスポンスが唯一の文書化された完了シグナルであり、非同期契約は定義されていません。 文書化されたビジネスエラー: `41001`。 |


## Shared Resources Open API

| 操作 | 再試行ポリシー | 冪等性 | 完了 / 復旧 |
|  --- | --- | --- | --- |
| `POST /proxyInfo/page``queryProxyInfoPageUsingPOST` | 上限付き指数バックオフとジッターで安全に再試行できます。 | 読み取り専用。リクエストを繰り返してもリソースの状態は変わりません。 | レスポンスが唯一の文書化された完了シグナルであり、非同期契約は定義されていません。 エンドポイント固有のビジネスエラーは文書化されていません。共通エラー契約を使用してください。 |
| `POST /proxyInfo/add``addUsingPOST` | 自動的に再試行しないでください。まずリソース、アップロード、タスクが作成されたかを照会します。 | 公開された冪等キーの契約は文書化されていません。 | レスポンスが唯一の文書化された完了シグナルであり、非同期契約は定義されていません。 文書化されたビジネスエラー: `14023`。 |
| `POST /proxyInfo/update``updateProxyUsingPOST` | タイムアウトや通信障害の後は、再試行の前に現在の状態を照会してください。 | 結果はすでに適用されている可能性があります。繰り返しの実行は契約上冪等ではありません。 | レスポンスが唯一の文書化された完了シグナルであり、非同期契約は定義されていません。 文書化されたビジネスエラー: `14003`, `14023`。 |
| `POST /proxyInfo/delete``deleteProxyUsingPOST` | タイムアウトや通信障害の後は、再試行の前に現在の状態を照会してください。 | 結果はすでに適用されている可能性があります。繰り返しの実行は契約上冪等ではありません。 | レスポンスが唯一の文書化された完了シグナルであり、非同期契約は定義されていません。 文書化されたビジネスエラー: `14017`, `14024`。 |
| `POST /envgroup/page``envgroupPagePost` | 上限付き指数バックオフとジッターで安全に再試行できます。 | 読み取り専用。リクエストを繰り返してもリソースの状態は変わりません。 | レスポンスが唯一の文書化された完了シグナルであり、非同期契約は定義されていません。 エンドポイント固有のビジネスエラーは文書化されていません。共通エラー契約を使用してください。 |
| `POST /envgroup/edit``envgroupEditPost` | タイムアウトや通信障害の後は、再試行の前に現在の状態を照会してください。 | 結果はすでに適用されている可能性があります。繰り返しの実行は契約上冪等ではありません。 | レスポンスが唯一の文書化された完了シグナルであり、非同期契約は定義されていません。 エンドポイント固有のビジネスエラーは文書化されていません。共通エラー契約を使用してください。 |
| `POST /envgroup/create``envgroupCreatePost` | 自動的に再試行しないでください。まずリソース、アップロード、タスクが作成されたかを照会します。 | 公開された冪等キーの契約は文書化されていません。 | レスポンスが唯一の文書化された完了シグナルであり、非同期契約は定義されていません。 エンドポイント固有のビジネスエラーは文書化されていません。共通エラー契約を使用してください。 |
| `POST /envgroup/delete``envgroupDeletePost` | タイムアウトや通信障害の後は、再試行の前に現在の状態を照会してください。 | 結果はすでに適用されている可能性があります。繰り返しの実行は契約上冪等ではありません。 | レスポンスが唯一の文書化された完了シグナルであり、非同期契約は定義されていません。 文書化されたビジネスエラー: `19064`。 |
| `GET /envtag/all``envtagAllGet` | 上限付き指数バックオフとジッターで安全に再試行できます。 | 読み取り専用。リクエストを繰り返してもリソースの状態は変わりません。 | レスポンスが唯一の文書化された完了シグナルであり、非同期契約は定義されていません。 エンドポイント固有のビジネスエラーは文書化されていません。共通エラー契約を使用してください。 |
| `POST /envtag/create``envtagCreatePost` | 自動的に再試行しないでください。まずリソース、アップロード、タスクが作成されたかを照会します。 | 公開された冪等キーの契約は文書化されていません。 | レスポンスが唯一の文書化された完了シグナルであり、非同期契約は定義されていません。 エンドポイント固有のビジネスエラーは文書化されていません。共通エラー契約を使用してください。 |
| `POST /envtag/edit``envtagEditPost` | タイムアウトや通信障害の後は、再試行の前に現在の状態を照会してください。 | 結果はすでに適用されている可能性があります。繰り返しの実行は契約上冪等ではありません。 | レスポンスが唯一の文書化された完了シグナルであり、非同期契約は定義されていません。 エンドポイント固有のビジネスエラーは文書化されていません。共通エラー契約を使用してください。 |
| `POST /envtag/delete``envtagDeletePost` | タイムアウトや通信障害の後は、再試行の前に現在の状態を照会してください。 | 結果はすでに適用されている可能性があります。繰り返しの実行は契約上冪等ではありません。 | レスポンスが唯一の文書化された完了シグナルであり、非同期契約は定義されていません。 文書化されたビジネスエラー: `19105`。 |
| `POST /webhook/config``webhookConfigPost` | 上限付き指数バックオフとジッターで安全に再試行できます。 | チーム単位の upsert です。同じリクエストを繰り返しても同じ保存済み設定に収束します。 | レスポンスが唯一の文書化された完了シグナルであり、非同期契約は定義されていません。 文書化されたビジネスエラー: `41001`。 |