変更¶
POST /api/v1/wksp_share/{wksp_share_uuid}/modify
概要¶
現在のワークスペースが発行した1件の認可設定について、データドメイン、インデックス、条件を全体置換します。
呼び出し前および使用手順¶
作成/変更/削除では、データ認可元ワークスペースの API Key を使用します。読み取りは、現在の Key のワークスペースにおける認可方向に従って操作します。このグループが認可するのはワークスペース間のデータクエリ機能であり、メンバーの招待、アカウントロールの付与、データのコピーではありません。レスポンスの workspaceUUID は認可元、toWorkspaceUUID は認可先です。Body で新たに workspaceUUID を指定した場合に限り、認可対象のターゲットワークスペースを表し、レスポンスの同名フィールドとは方向が異なります。クエリが有効になるかは、データドメイン、ログインデックス、フィルター条件、実際の認可状態、およびソースワークスペースの状態によっても制限されます。
作成/変更/削除には dataRightsManage.workspaceConfigManage が必要です。まず認可リストで type=grant を指定して、現在のワークスペース自身が発行したレコードを読み取り、content.data[].uuid を取得します。認可先リスト内の他のソースワークスペースの UUID を、自分が変更できる設定と見なさないでください。結果が不明な場合は、まず設定を読み戻し、重複認可や、失敗してまったく実行されなかったという誤認を避けてください。
変更できるのは、現在のワークスペースが認可元であり、モデルの status=0 であるレコードのみです。grantStatus=active を追加で要求しません。pending/expired のレコードも一致する可能性があります。不明な設定や他ワークスペースの設定は 404 を返します。ターゲットワークスペースとサイトは、この公開 Body では変更できません。workspaceUUID/regionCode/roleUUIDs は本ページの Body で宣言されていません。type/indexes は完全に送信する必要があり、conditions を省略するとデフォルトの {} となり古い条件がクリアされます。PATCH のようなマージセマンティクスはありません。
既存の同一サイト/クロスサイト認可レコードに対するローカルスコープ更新をサポートします。クロスサイト更新を送信した後は、ローカル関連サイトの認証キャッシュのみを無効化し、旧リモート同期チェーンを積極的に呼び出しません。認可先で即時に収束することは保証しません。実際のクエリ/認可状態で確認してください。保存後は元のモデルフィールドを返し、一覧の grantMode/grantStatus/サイト名/ID 概要などの派生フィールドは補完しません。一部の認証関連拡張は読み取りインターフェースのようにクリーンアップされない可能性があるため、完全な書き込みレスポンスを外部に共有しないでください。
conditions を省略するか {} を指定すると、追加条件がないことを意味します。変更時に省略すると古い条件がクリアされ、維持されません。公開されるのは metric/tracing/rum の3つの配列のみです。lineage サブ条件は公開されません(共有の内部バリデーターがこの名前を認識する場合でも)。追加の Body フィールドは拒否されます。配列要素はオブジェクトを推奨します。op は in/not in でなければならず、value は配列でなければなりません。同一カテゴリ内の logic は一致している必要があり、and/or を推奨します。現在、logic の列挙値、name の必須チェック、配列要素のオブジェクト形状は厳密に検証されません。不正な形式の要素は 500 になる可能性があるため、保存成功によって条件が必ず有効であると証明することはできません。異なるデータドメインの条件は相互に認可するものではなく、条件が設定されていないデータドメインを禁止するものでもありません。
ルートパラメータ¶
| パラメータ名 | 型 | 必須 | 説明 |
|---|---|---|---|
| wksp_share_uuid | string | Y | 実際の URL パスパラメータです。通常は grant_ プレフィックスが付き、ワークスペース UUID ではありません。 例: grant_example取得または入力方法: 認可リスト の content.data[].uuid から設定 ID を取得します。 |
リクエストヘッダー¶
| パラメータ名 | 型 | 必須 | 説明 |
|---|---|---|---|
| DF-API-KEY | string | Y | ワークスペースの OpenAPI 認証情報です。 例: <DF-API-KEY>取得または入力方法: 対象ワークスペースの API Key 管理から、この操作権限を持つ OpenAPI Key を取得します。 |
Body リクエストパラメータ¶
| パラメータ名 | 型 | 必須 | 説明 |
|---|---|---|---|
| conditions.metric[*] | json | 1つの条件オブジェクトです。以下のサブフィールドは意味上のガイドであり、現在は完全な事前の項目別検証はありません。 例: {"name": "host", "op": "in", "logic": "and", "value": ["example-value"]}取得または入力方法: 配列内の各項目に1組の条件を入力します。 |
|
| conditions.metric[*].name | string | 実際のフィールド名であり、フィールド設定 UUID ではありません。 例: host取得または入力方法: そのドメインのフィールドおよび業務上許可された値に従って構成します。 |
|
| conditions.metric[*].op | string | 条件付き必須 | in または not in である必要があります。省略またはその他の値は 406 になります。 例: in取得または入力方法: そのドメインのフィールドおよび業務上許可された値に従って構成します。 |
| conditions.metric[*].logic | string | and/or を推奨します。同一ドメイン内では一致している必要があります。現在、列挙値は厳密に検証されませんが、省略値も一致性比較の対象になります。 例: and取得または入力方法: そのドメインのフィールドおよび業務上許可された値に従って構成します。 |
|
| conditions.metric[*].value | array | 条件付き必須 | 配列である必要があり、実際のフィールド型に従って要素を入力します。空配列を「すべて」と解釈することはできません。 例: ["example-value"]取得または入力方法: そのドメインのフィールドおよび業務上許可された値に従って構成します。 |
| conditions.tracing[*] | json | 1つの条件オブジェクトです。以下のサブフィールドは意味上のガイドであり、現在は完全な事前の項目別検証はありません。 例: {"name": "service", "op": "in", "logic": "and", "value": ["example-value"]}取得または入力方法: 配列内の各項目に1組の条件を入力します。 |
|
| conditions.tracing[*].name | string | 実際のフィールド名であり、フィールド設定 UUID ではありません。 例: service取得または入力方法: そのドメインのフィールドおよび業務上許可された値に従って構成します。 |
|
| conditions.tracing[*].op | string | 条件付き必須 | in または not in である必要があります。省略またはその他の値は 406 になります。 例: in取得または入力方法: そのドメインのフィールドおよび業務上許可された値に従って構成します。 |
| conditions.tracing[*].logic | string | and/or を推奨します。同一ドメイン内では一致している必要があります。現在、列挙値は厳密に検証されませんが、省略値も一致性比較の対象になります。 例: and取得または入力方法: そのドメインのフィールドおよび業務上許可された値に従って構成します。 |
|
| conditions.tracing[*].value | array | 条件付き必須 | 配列である必要があり、実際のフィールド型に従って要素を入力します。空配列を「すべて」と解釈することはできません。 例: ["example-value"]取得または入力方法: そのドメインのフィールドおよび業務上許可された値に従って構成します。 |
| conditions.rum[*] | json | 1つの条件オブジェクトです。以下のサブフィールドは意味上のガイドであり、現在は完全な事前の項目別検証はありません。 例: {"name": "app_id", "op": "in", "logic": "and", "value": ["example-value"]}取得または入力方法: 配列内の各項目に1組の条件を入力します。 |
|
| conditions.rum[*].name | string | 実際のフィールド名であり、フィールド設定 UUID ではありません。 例: app_id取得または入力方法: そのドメインのフィールドおよび業務上許可された値に従って構成します。 |
|
| conditions.rum[*].op | string | 条件付き必須 | in または not in である必要があります。省略またはその他の値は 406 になります。 例: in取得または入力方法: そのドメインのフィールドおよび業務上許可された値に従って構成します。 |
| conditions.rum[*].logic | string | and/or を推奨します。同一ドメイン内では一致している必要があります。現在、列挙値は厳密に検証されませんが、省略値も一致性比較の対象になります。 例: and取得または入力方法: そのドメインのフィールドおよび業務上許可された値に従って構成します。 |
|
| conditions.rum[*].value | array | 条件付き必須 | 配列である必要があり、実際のフィールド型に従って要素を入力します。空配列を「すべて」と解釈することはできません。 例: ["example-value"]取得または入力方法: そのドメインのフィールドおよび業務上許可された値に従って構成します。 |
| conditions | json | conditions を省略するか {} を指定すると、追加条件がないことを意味します。変更時に省略すると古い条件はクリアされ、維持されません。公開されるのは metric/tracing/rum の3つの配列のみです。lineage サブ条件は公開されません(共有の内部バリデーターがこの名前を認識する場合でも)。追加の Body フィールドは拒否されます。配列要素はオブジェクトを推奨します。op は in/not in でなければならず、value は配列でなければなりません。同一カテゴリ内の logic は一致している必要があり、and/or を推奨します。現在、logic の列挙値、name の必須チェック、配列要素のオブジェクト形状は厳密に検証されません。不正な形式の要素は 500 になる可能性があるため、保存成功によって条件が必ず有効であると証明することはできません。異なるデータドメインの条件は相互に認可するものではなく、条件が設定されていないデータドメインを禁止するものでもありません。 null 許可: False 例: {"metric": [{"name": "host", "op": "in", "logic": "and", "value": ["host-example"]}]}取得または入力方法: 認可元の実際のフィールドと値に従って、最小限の許可範囲を構成します。 |
|
| conditions.metric | array | 任意条件配列です。省略または [] の場合、そのカテゴリにフィルターを追加しません。変更時は conditions 全体が送信値で置換されます。 null 許可: False 例: [{"name": "host", "op": "in", "logic": "and", "value": ["example-value"]}]取得または入力方法: metric の実際のフィールドと値からフィルター条件を選択します。 |
|
| conditions.rum | array | 任意条件配列です。省略または [] の場合、そのカテゴリにフィルターを追加しません。変更時は conditions 全体が送信値で置換されます。 null 許可: False 例: [{"name": "app_id", "op": "in", "logic": "and", "value": ["example-value"]}]取得または入力方法: rum の実際のフィールドと値からフィルター条件を選択します。 |
|
| conditions.tracing | array | 任意条件配列です。省略または [] の場合、そのカテゴリにフィルターを追加しません。変更時は conditions 全体が送信値で置換されます。 null 許可: False 例: [{"name": "service", "op": "in", "logic": "and", "value": ["example-value"]}]取得または入力方法: tracing の実際のフィールドと値からフィルター条件を選択します。 |
|
| indexes | array | Y | 必須配列です。type に * または logging が含まれる場合は保存され、それ以外では強制的に [] にクリアされます。* はすべてのインデックスを表し、[] は「すべて」と等しくありません。保存時に各インデックスが実際に存在するかは確認しません。null 許可: False 例: ["default"]取得または入力方法: 認可元のログインデックス一覧から name を取得します。設定 UUID ではありません。明示的なページング時はパスが content.data[].name で、ページングしない場合は元の content[].name です。 |
| type | array | Y | 必須配列です。* はすべてを表し、[] は「すべて」ではありません。公開宣言では null が許可されていますが、後続の業務処理で 500 になる可能性があるため、必ず配列を送信してください。列挙値は項目別に検証されないため、任意の未知の値は推奨しません。 null 許可: True 例: ["metric", "logging"]取得または入力方法: 実際に認可するドメインに応じて選択します(metric/logging/tracing/rum/object/custom_object/lineage など)。ターゲットのクエリ機能がサポートしている必要があります。 |
リクエスト例¶
curl --request POST 'https://openapi.guance.com/api/v1/wksp_share/grant_example/modify' \
-H 'DF-API-KEY: <DF-API-KEY>' \
-H 'Content-Type: application/json' \
--data-raw '{"type":["metric","logging"],"indexes":["default"],"conditions":{"metric":[{"name":"host","op":"in","logic":"and","value":["host-example"]}]}}'
レスポンス¶
HTTP 200、application/json。以下の例は、直接読み取れる主要フィールドを示しています。
| フィールド | 型 | 説明 |
|---|---|---|
| content.id | integer | 内部行番号であり、API リソース識別子ではありません。 |
| content.uuid | string | 認可設定 UUID です。通常は grant_ プレフィックスが付き、詳細/変更/削除ではこの値を使用します。 |
| content.workspaceUUID | string | データ認可元ワークスペースです。必ずしも現在のクエリ Key のワークスペースとは限りません(認可先リストの場合は他のソースワークスペースです)。 |
| content.workspaceName | string | 認可元ワークスペース名。 |
| content.toWorkspaceUUID | string | データクエリの認可を受けるターゲットワークスペース。 |
| content.toWorkspaceName | string | 認可先ワークスペース名。 |
| content.regionCode | string | 認可元サイト識別子。 |
| content.toRegionCode | string | ターゲットサイト識別子。読み取り時、古い空値は互換ルールに従って補完されます。 |
| content.siteRelationType | string | same_site/same_org_cross_site/external_org_cross_site などのサイト関係。履歴レコードでは空の場合があります。 |
| content.sourceBaseUrl | string | 一部のクロスサイトレコードにおけるソースアドレス。通常の同一サイトでは空の場合があり、今回の API Endpoint ではありません。 |
| content.targetBaseUrl | string | 一部のクロスサイトレコードにおけるターゲットアドレス。通常の同一サイトでは空の場合があります。 |
| content.type | array/string または null | 保存された認可データドメイン。* はすべてを表します。履歴データは正規化されていない可能性があり、status 0 のみで有効と判断することはできません。 |
| content.type[] | JSON | 通常はデータドメイン文字列です。現在、旧エントリポイントでは要素の列挙値を完全にはチェックしません。 |
| content.indexes | array または null | 認可されたログインデックス名の集合で、インデックス UUID ではありません。* はすべてを表し、ログドメインが認可されていない場合は [] として保存されます。 |
| content.indexes[] | string | 1つのインデックス名(例: default)。 |
| content.conditions | object または null | metric/tracing/rum ごとに保存されたフィルター設定。データ権限そのものやクエリ結果ではありません。 |
| content.extra | object または null | ロール、認可状態、クロスサイト拡張を記録します。読み取りと書き込みレスポンスではクリーンアップルールが異なるため、認証診断を含む生の書き込みレスポンスを外部に共有しないでください。 |
| content.extra.recordRole | string | authority/mirror など。一部のレコードにのみ存在します。 |
| content.extra.grantStatus | string | レコードに保存された状態。読み取り時、pending を時間に基づいて expired として表示する場合があります。 |
| content.delayDeleteAt | integer | 削除予定時刻。-1 は通常、予定なしを表します。レコードが必ず有効であることを意味するものではありません。 |
| content.status | integer | モデル状態。0 は未削除、削除は通常 3 です。業務上の認可については grantStatus なども確認する必要があります。 |
| content.creator | string | 作成者識別子。API Key UUID または履歴アカウント/システム ID の場合があります。 |
| content.updator | string | 最新の操作者。空の場合があります。 |
| content.createAt | integer | 作成 Unix 秒。 |
| content.updateAt | integer | 更新 Unix 秒。初期値は -1 の場合があります。 |
| content.deleteAt | integer | ソフト削除 Unix 秒。未削除の場合は通常 -1 です。 |
| content.conditions.metric | array | metric カテゴリの条件配列。 |
| content.conditions.metric[] | object | 1組の条件。現在、要素には完全な事前構造検証がありません。 |
| content.conditions.metric[].name | string | 実際のフィールド名。 |
| content.conditions.metric[].op | string | in または not in。 |
| content.conditions.metric[].logic | string | and/or を推奨します。同一カテゴリ内では一致している必要があります。現在、列挙値は厳密に検証されません。 |
| content.conditions.metric[].value | array | 条件値の配列。要素は実際のフィールド型に従います。 |
| content.conditions.tracing | array | tracing カテゴリの条件配列。 |
| content.conditions.tracing[] | object | 1組の条件。現在、要素には完全な事前構造検証がありません。 |
| content.conditions.tracing[].name | string | 実際のフィールド名。 |
| content.conditions.tracing[].op | string | in または not in。 |
| content.conditions.tracing[].logic | string | and/or を推奨します。同一カテゴリ内では一致している必要があります。現在、列挙値は厳密に検証されません。 |
| content.conditions.tracing[].value | array | 条件値の配列。要素は実際のフィールド型に従います。 |
| content.conditions.rum | array | rum カテゴリの条件配列。 |
| content.conditions.rum[] | object | 1組の条件。現在、要素には完全な事前構造検証がありません。 |
| content.conditions.rum[].name | string | 実際のフィールド名。 |
| content.conditions.rum[].op | string | in または not in。 |
| content.conditions.rum[].logic | string | and/or を推奨します。同一カテゴリ内では一致している必要があります。現在、列挙値は厳密に検証されません。 |
| content.conditions.rum[].value | array | 条件値の配列。要素は実際のフィールド型に従います。 |
| content.authorizationCode | string または null | 元のモデル認証互換フィールド。存在する場合がありますが、通常の業務呼び出し用の認証情報ではありません。 |
| content.declaration | object または null | 最外層の共通宣言。 |
| content.extra.tempAuthCodeExpireAt | integer | 一時認可パッケージの有効期限 Unix 秒。省略可能ですが、そのまま使用できる認証コードではありません。 |
| content.extra.pendingTargetWorkspaceUUID | string | pending レコードが想定するターゲットワークスペース。省略可能です。 |
| content.extra.metaUUID | string | 認可パッケージ識別子。省略可能で、grant 設定 UUID ではありません。 |
| content.extra.grantScopeFingerprint | string | 認可範囲のダイジェスト。省略可能で、顧客認証パラメータとしては使用されません。 |
| content.extra.createdAt | integer | 拡張レコードの作成 Unix 秒。省略可能です。 |
| content.extra.authorityGrantUUID | string | mirror レコードに関連するソース認可設定 UUID。省略可能で、現在の Key のワークスペースが所有する設定として直接扱うことはできません。 |
| content.extra.sourceKid | string | ソースサイトの公開鍵識別子。省略可能です。 |
| content.extra.sourceJwksUri | string | ソースサイトの公開鍵セット URL。省略可能です。 |
| content.extra.syncStatus | string | クロスサイト同期状態(success/failed または空など)。省略可能です。 |
| content.extra.lastSyncAt | integer | 前回同期の Unix 秒。省略可能です。 |
| content.extra.lastSyncError | string | 適合化された直近の同期エラー概要。省略可能で、今回の API の外層エラーコードではありません。 |
| content.extra.lastSyncErrorAt | integer | 直近の同期失敗 Unix 秒。省略可能です。 |
| content.extra.resourceSummary | object | 一部のクロスサイトレコードで同期保存されるリソース概要。省略可能で、リアルタイムの完全なリソース一覧ではありません。 |
| content.extra.resourceSummary.logging | object | ログリソース概要。省略可能です。 |
| content.extra.resourceSummary.logging.indexes | array | 上流から同期されたログインデックス概要項目。要素は文字列またはオブジェクトで、そのまま保存されます。 |
| content.extra.resourceSummary.logging.indexes[] | JSON | 1つのインデックス概要。固定の uuid/name 形式を前提にすることはできず、インデックスを操作する前に引き続きインデックス一覧から実際のパラメータを取得します。 |
| content.extra.resourceSummary.rum | object | RUM リソース概要。省略可能です。 |
| content.extra.resourceSummary.rum.applications | array | 上流の RUM アプリケーション概要項目。文字列またはオブジェクトとして実際の返却値に従います。 |
| content.extra.resourceSummary.rum.applications[] | JSON | アプリケーション概要。現在のサイトのアプリケーション設定 UUID の代替にはなりません。 |
| content.extra.resourceSummary.updatedAt | number | リソース概要の生成値。単位は上流が決定し、Studio は単位変換や統一を保証しません。 |
| content.extra.resourceSummary.sourceGrantUUID | string | リソース概要に関連するソース認可設定識別子。 |
| content.extra.sourceSite | object | 認可元/ターゲット側のサイトアイデンティティのスナップショット。省略可能で、現在のリクエスト Endpoint の代替にはなりません。 |
| content.extra.sourceSite.siteCode | string | サイトコード。省略可能です。 |
| content.extra.sourceSite.regionCode | string | リージョンコード。省略可能です。 |
| content.extra.sourceSite.name | string | サイト表示名。省略可能です。 |
| content.extra.sourceSite.issuer | string | 署名アイデンティティ。省略可能です。 |
| content.extra.sourceSite.baseUrl | string | サイト API ベース URL。省略可能です。 |
| content.extra.sourceSite.jwksUri | string | 公開鍵セット URL。省略可能です。 |
| content.extra.sourceSite.kid | string | 公開鍵識別子。省略可能です。 |
| content.extra.sourceSite.publicKeys | array | 一部のサイトスナップショットには公開鍵情報が含まれます。省略可能で、秘密鍵はありません。 |
| content.extra.sourceSite.publicKeys[] | object | 任意の公開鍵項目。 |
| content.extra.sourceSite.publicKeys[].kid | string | 公開鍵識別子。 |
| content.extra.sourceSite.publicKeys[].publicKey | string | PEM 公開鍵本文。 |
| content.extra.targetSite | object | 認可元/ターゲット側のサイトアイデンティティのスナップショット。省略可能で、現在のリクエスト Endpoint の代替にはなりません。 |
| content.extra.targetSite.siteCode | string | サイトコード。省略可能です。 |
| content.extra.targetSite.regionCode | string | リージョンコード。省略可能です。 |
| content.extra.targetSite.name | string | サイト表示名。省略可能です。 |
| content.extra.targetSite.issuer | string | 署名アイデンティティ。省略可能です。 |
| content.extra.targetSite.baseUrl | string | サイト API ベース URL。省略可能です。 |
| content.extra.targetSite.jwksUri | string | 公開鍵セット URL。省略可能です。 |
| content.extra.targetSite.kid | string | 公開鍵識別子。省略可能です。 |
| content.extra.targetSite.publicKeys | array | 一部のサイトスナップショットには公開鍵情報が含まれます。省略可能で、秘密鍵はありません。 |
| content.extra.targetSite.publicKeys[] | object | 任意の公開鍵項目。 |
| content.extra.targetSite.publicKeys[].kid | string | 公開鍵識別子。 |
| content.extra.targetSite.publicKeys[].publicKey | string | PEM 公開鍵本文。 |
| content.extra.resourceSummary.metric | object | 対応するドメインのリソース概要。省略可能です。 |
| content.extra.resourceSummary.metric.workspaceUUIDs | array | 同期保存されたソースワークスペース識別子の集合。要素は通常文字列です。現在の Key が任意のワークスペースを操作できるという認可ではありません。 |
| content.extra.resourceSummary.metric.workspaceUUIDs[] | JSON | 個々のワークスペース識別子は上流の実際の返却値に従います。不完全または非正規化の履歴項目は事前に確認する必要があります。 |
| content.extra.resourceSummary.tracing | object | 対応するドメインのリソース概要。省略可能です。 |
| content.extra.resourceSummary.tracing.workspaceUUIDs | array | 同期保存されたソースワークスペース識別子の集合。要素は通常文字列です。現在の Key が任意のワークスペースを操作できるという認可ではありません。 |
| content.extra.resourceSummary.tracing.workspaceUUIDs[] | JSON | 個々のワークスペース識別子は上流の実際の返却値に従います。不完全または非正規化の履歴項目は事前に確認する必要があります。 |
| content.extra.resourceSummary.lineage | object | 対応するドメインのリソース概要。省略可能です。 |
| content.extra.resourceSummary.lineage.workspaceUUIDs | array | 同期保存されたソースワークスペース識別子の集合。要素は通常文字列です。現在の Key が任意のワークスペースを操作できるという認可ではありません。 |
| content.extra.resourceSummary.lineage.workspaceUUIDs[] | JSON | 個々のワークスペース識別子は上流の実際の返却値に従います。不完全または非正規化の履歴項目は事前に確認する必要があります。 |
{
"code": 200,
"content": {
"id": 10,
"uuid": "grant_example",
"workspaceUUID": "wksp_source",
"toWorkspaceUUID": "wksp_target",
"regionCode": "SITE-CODE",
"toRegionCode": "SITE-CODE",
"workspaceName": "授权方示例空间",
"toWorkspaceName": "被授权方示例空间",
"authorizationCode": null,
"siteRelationType": "same_site",
"sourceBaseUrl": "",
"targetBaseUrl": "",
"extra": {
"recordRole": "authority",
"grantStatus": "active"
},
"type": [
"metric",
"logging"
],
"indexes": [
"default"
],
"conditions": {
"metric": [
{
"name": "host",
"op": "in",
"logic": "and",
"value": [
"host-example"
]
}
]
},
"delayDeleteAt": -1,
"status": 0,
"creator": "wsak_example",
"updator": "wsak_example",
"createAt": 1785427200,
"updateAt": 1785429000,
"deleteAt": -1,
"declaration": {}
},
"errorCode": "",
"message": "",
"success": true,
"traceId": "TRACE-EXAMPLE"
}
エラーレスポンス¶
認証、レート制限、共通リクエストエラーについては共通エラー定義を参照してください。
実行時宣言の履歴パスフィールド名に誤記があり、本ページではドキュメント表示のみを修正しています。実際の URL パラメータは wksp_share_uuid です。業務上の帰属および置換動作は現在の実装に従います。
| HTTP ステータス | errorCode | 発生条件 | メッセージまたはレスポンスの説明 | 対処方法 |
|---|---|---|---|---|
| 404 | ft.ObjectNotExists | 現在のワークスペースをソースとし、モデル status=0 の認可レコードが見つからない | 指定されたオブジェクトが存在しません | type=grant の一覧の content.data[].uuid から値を再取得し、ワークスペース UUID で代替しないでください。 |
| 406 | ft.ParameterValidationFailed | リクエストフィールドの欠落、またはフィールド値が宣言された検証条件に違反している | パラメータの解析に失敗しました | パラメータの位置、フィールド名、型、値を確認してください。 |
| 400 | ft.RequestJsonFormatError | リクエスト JSON の構文が無効 | リクエスト JSON の形式エラー | content.reason、line、column に従って JSON を修正してください。 |
| 400 | ft.JsonFormatError | 本文がオブジェクトではない | 一部の JSON ファイル形式エラー | 本ページの JSON オブジェクトを送信してください。 |
| 406 | ft.WorkspaceGrantConditionOperatorInvalid | 条件要素の op が欠落している、または in/not in ではない | 認可範囲 {} 条件の演算子は in または not in のみサポートします | 各項目に in または not in を入力し、フィールドと業務範囲を一致させてください。 |
| 406 | ft.WorkspaceGrantConditionValueMustBeList | 条件要素の value が配列ではない | 認可範囲 {} 条件の value フィールドはリストである必要があります | JSON 配列を使用し、カンマ区切り文字列を送信しないでください。 |
| 406 | ft.WorkspaceGrantConditionLogicMixed | 同一カテゴリの logic に複数の異なる値が出現(省略値と and の混用を含む) | 認可範囲 {} 条件では異なる論理演算子の混用はサポートされません | 同一カテゴリのすべての条件で logic を and または or に統一してください。 |
| 406 | ft.WKSPShareInvalid | 履歴レコードのターゲット UUID が不正、または同一サイトのターゲットワークスペースが存在しない/非アクティブ;今回、既存のクロスサイトレコードを拒否せず、ターゲットの versionType=freeEdition のみを理由に変更を拒否することもしない | 無効なワークスペース uuid | 現在のソースレコードと実際のターゲットワークスペース状態を確認してください。公開 Body がサポートする範囲フィールドを使用し、ターゲットワークスペース/サイトの置換を試みないでください。 |
| 406 | ft.WKSPIllegalAuthorization | 現在の認可元ワークスペースを自身に認可しようとしている | データ認可には現在のワークスペース ID 以外を入力してください。再入力してください | 異なる認可先ターゲットワークスペース UUID を入力してください。 |
| 406 | ft.WKSPRepeatAuthorization | 同じソース/ターゲット/サイトに status=0 のレコードが既に存在(grantStatus は追加確認しない) | ワークスペースは既に認可されています。重複して認可しないでください。 | まず既存設定を読み取り、必要に応じて変更し、重複作成しないでください。 |
| 500 | ft.InternalServerError | type=null が後続コードで処理される、条件要素の構造異常、ストレージエラー、または送信後のキャッシュ/サイト情報準備失敗 | 内部エラー | まず一覧/詳細を読み戻して保存済みか確認し、traceId を保持したうえで再試行を判断してください。操作全体がロールバックされたと見なさないでください。 |