• EnglishEspañol日本語한국어Português
  • ログイン今すぐ開始

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

英語版と翻訳版に矛盾がある場合は、英語版が優先されます。詳細については、このページを参照してください。

問題を作成する

NerdGraphチュートリアル。APIキーの管理

このドキュメントには、 NerdGraph をNew RelicAPI 使用して、ライセンスキー、 キー、 などの キーをプログラムで管理する方法に関するチュートリアルが含まれています。browserキーに関する一般的な情報については、 APIキーを参照してください。

機能説明の概要

API キー UIを使用してキーを作成および管理できます。または、 NerdGraphApiAccessフィールドを使用して、次のタイプのキーをプログラムで作成および管理できます。

  • ユーザーキー, NerdGraphを使用するために必要です。

  • などのデータインジェストキー。

    • : データとデータを除くほとんどのデータを New Relic に取り込むために必要です
    • ブラウザキー: ブラウザモニタリングデータの取り込みに必要です。

この機能の一般的な使用例としては、セキュリティのためにキーを回転させる機能があります。なお、このNerdGraphの機能を使って、あるアカウントで最初に作成されたライセンス・キーやブラウザ・キーを削除することはできないので、オリジナルのキーを削除することはできません。追加ライセンス・キーの作成と、作成したライセンス・キーの管理のみ可能です。

この機能についての注意事項

  • すべてのミューテーションは、複数のキーを引数として受け取ることができ、変更の成功とエラーに関する詳細を返します。詳細は以下の例を参照してください。

  • すべてのミューテーション (作成、更新、および削除) は、監査目的で照会できるNrAuditEventになります。詳細については、「 監査イベント」を参照してください。

  • ライセンスキーについて

    • ライセンスキーはNerdGraphによってingest keysに分類されます。 これは、主な用途がデータの取り込みを可能にすることだからです。
    • ライセンスキーの種類ごとに最大1,000個のキーを作成することができ、キーのローテーションが可能です。
    • オリジナルのライセンスキーを管理・削除することはできず、追加のライセンスキーを作成したり、作成したキーを管理することのみが可能です。

使用例の前に

これらのサンプルクエリを使用する前に注意すべきことがあります。

キーの作成

ヒント

NerdGraph GraphiQL explorer そのインターフェースの上部にある、ユーザーキーの検索と生成を行うことができます。

複数のアカウントとキータイプに対して、1回のミューテーションで複数のキー(ユーザーキーまたはライセンスキー)を作成すること。なお、ミューテーションでは、正常に作成されたキーだけでなく、キーの作成時に発生したエラーも返すことができます。

キーの作成例

mutation {
apiAccessCreateKeys(keys: {ingest: {accountId: YOUR_ACCOUNT_ID, ingestType:
BROWSER, name: "Browser Key", notes: "A note."}}) {
createdKeys {
id
key
name
notes
type
... on ApiAccessIngestKey {
ingestType
}
}
errors {
message
type
... on ApiAccessIngestKeyError {
accountId
errorType
ingestType
}
}
}
}

結果はあなたのデータによって異なります。 GraphiQL explorer を使って、ミューテーションやクエリーを試してみてください。

このクエリを使って、 ユーザーキー を作成する例を示します。

キーの更新

アップデート・ミューテーションでは、キー文字列ではなく、キーIDを使ってキーを識別します。

mutation {
apiAccessUpdateKeys(keys: {ingest: {keyId: KEY_ID, name: "Updated name", notes:
"A new note!"}}) {
updatedKeys {
id
key
type
name
notes
}
errors {
message
}
}
}

結果はあなたのデータによって異なります。 GraphiQL explorer を使って、ミューテーションやクエリーを試してみてください。

削除キー

削除変異では、キーの識別にキー文字列ではなくキーIDを使用します。削除されたキーは、New Relic システムへのアクセスが許可されなくなり、API アクセス GraphQL API への問い合わせで返されなくなります。

mutation {
apiAccessDeleteKeys(keys: {ingestKeyIds: INGEST_KEY_ID}) {
deletedKeys {
id
}
errors {
message
}
}
}

結果はあなたのデータによって異なります。 GraphiQL explorer を使って、ミューテーションやクエリーを試してみてください。

検索キー

インジェストキーやユーザーキーにアクセスするには、アクターにスコープされた単一のキーまたはすべてのキーを照会します。単一のキーを照会する場合は、キーの ID とタイプ(INGEST または USER)を指定する必要があります。複数のキーを照会する場合は、キー検索を使用します。キー検索では、必須のタイプリストとオプションのスコープを使用して結果をフィルタリングします。他のユーザーに属するユーザーキーは、結果が難読化されます。

シングルキーの例のクエリです。

query {
actor {
apiAccess {
key(id: "INGEST_KEY_ID", keyType: INGEST) {
key
name
type
... on ApiAccessIngestKey {
ingestType
}
}
}
}
}

主要な検索例クエリ。

query {
actor {
apiAccess {
keySearch(query: {types: INGEST, scope: {ingestTypes: BROWSER}}) {
keys {
name
key
type
... on ApiAccessIngestKey {
ingestType
}
}
}
}
}
}

結果はあなたのデータによって異なります。 GraphiQL explorer を使って、ミューテーションやクエリーを試してみてください。

Copyright © 2024 New Relic株式会社。

This site is protected by reCAPTCHA and the Google Privacy Policy and Terms of Service apply.