NerdGraphチュートリアル: データアクセスポリシーの管理

NerdGraph API を使用して、データアクセスポリシーを作成、クエリ、更新、削除できます。データアクセスポリシーは、ユーザーがアクセスできるログパーティションを制御し、ユーザーグループに基づいて機密ログデータへのアクセスを制限できます。

要件

NerdGraph 経由でデータアクセスポリシーを管理するには、次のものが必要です。

あなたが始める前に

データアクセスポリシーに NerdGraph API を使用する前に、データアクセス制御の仕組みを理解し、 NerdGraphに慣れておいてください。

共通の属性

次の属性は、データアクセスポリシーのクエリとミューテーションでよく使用されます。

属性	説明
`organizationId`	ポリシーに関連付けられている組織の ID。ポリシーをフィルタリングしたり、ポリシー作成の範囲を限定したりするために使用されます。
`id`	ポリシーの一意の識別子。特定のポリシーを更新または削除するときに必要です。
`name`	データアクセスポリシーのユーザーフレンドリな名前。
`policy`	ポリシーのルールを定義する JSON オブジェクト。含まれるもの: `rules`: ルールオブジェクトの配列。 `operations`: 許可または拒否する操作 (例: `SELECT` 、 `` )。 `eventTypes`: どのイベントタイプを`allow` (例: `[""]` ) または`except` (例: `["Log_accessible"]` ) にするかを指定するオブジェクト。
`accountId`	ロールがアクセスを許可するアカウント ID。
`dataAccessPolicyId`	アカウント内のどのデータが許可されるかを定義するデータアクセスポリシー ID。
`roleId`	アクセスレベルを定義するロール ID。

一般的な操作

データアクセスポリシーを管理するための最も一般的な操作は次のとおりです。

このクエリは、組織内のすべてのアクセス許可とそれに関連付けられたデータアクセスポリシーを取得します。これを使用して、現在どのポリシーが許可に割り当てられているかを取得します。

サンプルクエリ

{
  customerAdministration {
    grants(filter: { organizationId: { eq: "YOUR_ORG_ID" } }) {
      items {
        dataAccessPolicy {
          id
          name
        }
      }
    }
  }
}

パラメータ	説明
`organizationId`	必須。助成金が属する組織 ID。フィルタリングするには、等号 ( `eq` ) 演算子を使用します。

サンプル回答

{
  "data": {
    "customerAdministration": {
      "grants": {
        "items": [
          {
            "dataAccessPolicy": {
              "id": "DATA_ACCESS_POLICY_ID",
              "name": "DATA_ACCESS_POLICY_NAME"
            }
          }
        ]
      }
    }
  }
}

応答フィールド	説明
`items`	組織内の助成金のリスト。
`dataAccessPolicy`	各許可に関連付けられたデータアクセスポリシー。
`id`	データアクセスポリシーの一意の識別子。
`name`	データアクセスポリシーの名前。

このクエリは、組織内のすべてのデータアクセスポリシーを取得します。

サンプルクエリ

{
  customerAdministration {
    dataAccessPolicies(filter: { organizationId: { eq: "YOUR_ORG_ID" } }) {
      items {
        id
        name
        policy
        status
        version
      }
    }
  }
}

パラメータ	説明
`organizationId`	必須。ポリシーが属する組織 ID。フィルタリングするには、等号 ( `eq` ) 演算子を使用します。

サンプル回答

{
  "data": {
    "customerAdministration": {
      "dataAccessPolicies": {
        "items": [
          {
            "id": "ddadbdd2-183b-42d9-8a1a-41ec7692fb4c",
            "name": "Log Operations",
            "policy": {
              "rules": [
                {
                  "eventTypes": {
                    "allow": ["*"],
                    "except": ["Log_Operations"]
                  },
                  "operations": ["*"]
                }
              ]
            },
            "status": "VALID",
            "version": "1.0-logs"
          },
          {
            "id": "bb8efcf5-3127-4a4d-b25f-114505a0a68d",
            "name": "Restrict Log_Security",
            "policy": {
              "rules": [
                {
                  "eventTypes": {
                    "allow": ["*"],
                    "except": ["Log_Sec%"]
                  },
                  "operations": ["*"]
                }
              ]
            },
            "status": "VALID",
            "version": "1.0-logs"
          }
        ]
      }
    }
  }
}

応答フィールド	説明
`items`	組織内のデータアクセスポリシーのリスト。
`id`	データアクセスポリシーの一意の識別子。
`name`	データアクセスポリシーの名前。
`policy`	`operations`と`eventTypes`を含むポリシールールを含む JSON オブジェクト。
`status`	ポリシーの現在のステータス (例: `VALID` )。
`version`	ポリシーのバージョン (現在は`1.0-logs` )。

この変更により、ログパーティションへのアクセスを制御する新しいデータアクセスポリシーが作成されます。

サンプル変異

mutation createMyPolicy {
  dataAccessPolicyCreate(
    policy: {
      rules: [
        {
          operations: ["SELECT"]
          eventTypes: { allow: ["*"], except: ["Log_accessible"] }
        }
      ]
    }
    name: "Test"
    organizationId: "YOUR_ORG_ID"
  ) {
    dataAccessPolicy {
      id
    }
  }
}

次の変数も使用できます。

mutation createMyPolicy($policy: DataAccessPolicyRawDocument!) {
  dataAccessPolicyCreate(
    policy: $policy
    name: "Test"
    organizationId: "YOUR_ORG_ID"
  ) {
    dataAccessPolicy {
      id
    }
  }
}

{
  "policy": {
    "rules": [
      {
        "operations": ["SELECT"],
        "eventTypes": { "allow": ["*"], "except": [] }
      }
    ]
  }
}

パラメータ	説明
`organizationId`	必須。New Relic 組織 ID。
`name`	必須。ポリシーの分かりやすい名前。
`policy`	必須。`operations`と`eventTypes`を使用してポリシールールを定義する JSON オブジェクト。

サンプル回答

{
  "data": {
    "dataAccessPolicyCreate": {
      "dataAccessPolicy": {
        "id": "YOUR_DATA_POLICY_ID",
        "name": "Test",
        "policy": {
          "rules": [
            {
              "eventTypes": {
                "allow": ["*"],
                "except": ["Log"]
              },
              "operations": ["*"]
            }
          ]
        },
        "status": "VALID"
      }
    }
  }
}

応答フィールド	説明
`id`	新しく作成されたデータアクセスポリシーの一意の識別子。
`name`	データアクセスポリシーの名前。
`policy`	`operations`と`eventTypes`を含むポリシールールを含む JSON オブジェクト。
`status`	ポリシーのステータス (例: `VALID` )。

このミューテーションは、既存のデータアクセスポリシーを更新して、そのルールまたは名前を変更します。

サンプル変異

mutation {
  dataAccessPolicyUpdate(
    policy: {
      rules: [
        {
          operations: ["SELECT"]
          eventTypes: { allow: ["*"], except: ["Log_inaccessible"] }
        }
      ]
    }
    name: "Test"
    id: "YOUR_DATA_POLICY_ID"
  ) {
    dataAccessPolicy {
      name
      id
    }
  }
}

パラメータ	説明
`id`	必須。更新するポリシーの ID。
`name`	オプション。ポリシーの名前が更新されました。
`policy`	オプション。`operations`と`eventTypes`を使用して更新されたポリシールールを定義する JSON オブジェクト。

サンプル回答

{
  "data": {
    "dataAccessPolicyUpdate": {
      "dataAccessPolicy": {
        "assigned": "UNASSIGNED",
        "id": "YOUR_DATA_POLICY_ID",
        "name": "Test",
        "policy": {
          "rules": [
            {
              "eventTypes": {
                "allow": ["*"],
                "except": ["Log_inaccessible"]
              },
              "operations": ["SELECT"]
            }
          ]
        },
        "status": "VALID"
      }
    }
  }
}

応答フィールド	説明
`assigned`	ポリシーがいずれかの許可に割り当てられているかどうかを示します (例: `UNASSIGNED` )。
`id`	更新されたデータアクセスポリシーの一意の識別子。
`name`	データアクセスポリシーの名前。
`policy`	`operations`と`eventTypes`を含む更新されたポリシールールを含む JSON オブジェクト。
`status`	ポリシーのステータス (例: `VALID` )。

この変更により、既存のデータアクセスポリシーが削除されます。

重要

ポリシーを削除すると、割り当てられたすべての許可からそのポリシーが削除されます。これらの権限を持つグループ内のユーザーは、ポリシーで定義されたデータアクセス制限を失います。

サンプル変異

mutation {
  dataAccessPolicyDelete(id: "YOUR_DATA_POLICY_ID") {
    dataAccessPolicy {
      name
      id
      policy
      status
    }
  }
}

パラメータ	説明
`id`	必須。削除するポリシーの ID。

サンプル回答

{
  "data": {
    "dataAccessPolicyDelete": {
      "dataAccessPolicy": {
        "id": "YOUR_DATA_POLICY_ID",
        "name": "Test",
        "policy": {
          "rules": [
            {
              "eventTypes": {
                "allow": ["*"],
                "except": ["Log_inaccessible"]
              },
              "operations": ["SELECT"]
            }
          ]
        },
        "status": "VALID"
      }
    }
  }
}

応答フィールド	説明
`id`	削除されたデータアクセスポリシーの一意の識別子。
`name`	削除されたデータアクセスポリシーの名前。
`policy`	削除されたポリシールールを含む JSON オブジェクト。
`status`	ポリシーのステータス (例: `VALID` )。

このミューテーションにより、データアクセスポリシーを含む新しいアクセス許可が作成され、特定のアカウントとロールに割り当てられます。

サンプル変異

mutation {
  authorizationManagementGrantAccess(
    grantAccessOptions: {
      accountAccessGrants: {
        accountId: YOUR_ACCOUNT_ID
        dataAccessPolicyId: "YOUR_DATA_POLICY_ID"
        roleId: "YOUR_ROLE_ID"
      }
    }
  ) {
    accessGrants {
      id
    }
  }
}

パラメータ	説明
`accountId`	必須。アクセスを許可するアカウント ID。
`dataAccessPolicyId`	必須。適用するデータアクセスポリシー ID。
`roleId`	必須。権限を定義するロール ID。

レスポンス

応答には、新しく作成されたアクセス許可とその ID が表示されます。

このミューテーションは、既存のアクセス許可を更新して、データアクセスポリシーを追加または変更します。

サンプル変異

mutation {
  authorizationManagementUpdateAccess(
    updateAccessOptions: {
      accountAccessGrant: { dataAccessPolicyId: "YOUR_DATA_POLICY_ID" }
      ids: YOUR_GRANT_ID
    }
  ) {
    grants {
      dataAccessPolicy {
        id
      }
      id
    }
  }
}

パラメータ	説明
`ids`	必須。更新する許可 ID。
`dataAccessPolicyId`	必須。許可に適用するデータアクセスポリシー ID。

サンプル回答

{
  "data": {
    "authorizationManagementUpdateAccess": {
      "grants": [
        {
          "dataAccessPolicy": {
            "id": "YOUR_DATA_POLICY_ID"
          },
          "id": "YOUR_GRANT_ID"
        }
      ]
    }
  }
}

応答フィールド	説明
`grants`	更新された助成金のリスト。
`dataAccessPolicy.id`	許可に現在割り当てられているデータアクセスポリシーの ID。
`id`	更新された許可の ID。

この変更により、データアクセスポリシーを含むアクセス許可が削除されます。

サンプル変異

mutation {
  authorizationManagementRevokeAccess(
    revokeAccessOptions: {
      accountAccessGrants: {
        accountId: YOUR_ACCOUNT_ID
        dataAccessPolicyId: "YOUR_DATA_POLICY_ID"
        roleId: "YOUR_ROLE_ID"
      }
    }
  ) {
    accessGrants {
      id
    }
  }
}

パラメータ	説明
`accountId`	必須。取り消す許可のアカウント ID。
`dataAccessPolicyId`	必須。取り消す許可のデータアクセスポリシー ID。
`roleId`	必須。取り消す付与のロール ID。

レスポンス

応答には、取り消されたアクセス許可とその ID が表示されます。

データアクセス制御UIガイド

New Relic UI を通じてデータアクセスポリシーを管理する方法を学びます。

ユーザー管理の概念

ユーザーの種類、ロール、アクセス管理を理解します。

NerdGraphでユーザーを管理する

NerdGraph API を使用して、ユーザーとアクセス権限をプログラムで管理します。

ログパーティション

ログデータをパーティションに整理する方法を学びます。

この機械翻訳は、参考として提供されています。

NerdGraphチュートリアル: データアクセスポリシーの管理

要件

あなたが始める前に

共通の属性

一般的な操作

アクセス許可に関連付けられたデータアクセスポリシーを作成する

サンプルクエリ

サンプル回答

組織のデータアクセスポリシーを決定する

サンプルクエリ

サンプル回答

データアクセスポリシーを作成する

サンプル変異

サンプル回答

データアクセスポリシーを更新する

サンプル変異

サンプル回答

データアクセスポリシーを削除する

重要

サンプル変異

サンプル回答

データアクセスポリシーを使用してアクセス許可を作成する

サンプル変異

レスポンス

データアクセスポリシーを使用してアクセス許可を更新する

サンプル変異

サンプル回答

データアクセスポリシーを使用してアクセス許可を取り消す

サンプル変異

レスポンス

データアクセス制御UIガイド

ユーザー管理の概念

NerdGraphでユーザーを管理する

ログパーティション

この機械翻訳は、参考として提供されています。

NerdGraphチュートリアル: データアクセスポリシーの管理

要件 .css-21sua1{background:none;border:none;width:0;padding:0;}

あなたが始める前に

共通の属性

一般的な操作

組織のデータ アクセス ポリシーを決定する

データアクセスポリシーを作成する

データアクセスポリシーを更新する

データアクセスポリシーを削除する

データアクセスポリシーを使用してアクセス許可を作成する

データ アクセス ポリシーを使用してアクセス許可を更新する

データ アクセス ポリシーを使用してアクセス許可を取り消す

関連トピック

データアクセス制御UIガイド

ユーザー管理の概念

NerdGraphでユーザーを管理する

ログパーティション

要件

組織のデータアクセスポリシーを決定する

データアクセスポリシーを使用してアクセス許可を更新する

データアクセスポリシーを使用してアクセス許可を取り消す