エッジapikeyコマンド

日本語翻訳に関する免責事項

このページの翻訳はAIによって自動的に行われました。可能な限り正確な翻訳を心掛けていますが、原文と異なる表現や解釈が含まれる場合があります。正確で公式な情報については、必ず英語の原文をご参照ください。

Sitecore CLIのExperience Edgeプラグインは、Experience Edgeのキー管理を助けるedge apikeyコマンドAPI提供しています。

用途とオプション

edge apikeyコマンドは以下の通りに使えます:

dotnet sitecore edge apikey subcommand options

サブコマンドやオプションなしでコマンドを使用すると、現在選択中のテナントのアクティブなAPIキーのリストが返されます。例えば:

dotnet sitecore edge apikey

edge apikeyコマンドで以下のオプションを利用できます:

オプション

概要

--トークン

Experience Edge API重要な価値観です。

--ハッシュ

Experience Edge APIキーハッシュ。APIキーに関する情報をJSON形式で返します。

--ページサイズ

1つのチャンク/ページで返すAPIキーの数。デフォルト

--ページ番号

結果に複数ページが含まれている場合に返すページ番号。デフォルト

――すべて、――ショーオール

提供されている場合、キーのリストには取り消されたキーも含まれます。取り消されたAPIキーには[REVOKED]インジケーターが付けられます。

--環境、--環境

ターゲットにするExperience Edge環境を指定します。可能な値

、prodデフォルト

-?, -、助けて

開発者のヘルプやコマンドの使用情報を表示します。

例えば、現在のテナントの5つのAPIキーの第2ページ(取り消されたキーを含む)を表示するには、以下のコマンドを実行します。

dotnet sitecore edge apikey --pageSize 5 --pageNumber 2 --all

APIキーの詳細情報を得るには、以下のコマンドを実行します。

dotnet sitecore edge apikey --hash

このコマンドはAPIキーに関するJSON形式の情報を表示します:

{ "Hash": "XXXXX", "IsRevoked": <false|true>, "Label": "", "Scopes": "audience-preview", "content-#everything#" , "CreatedBy": "", "Created": "" }

!注日付は現地時間で表示されます。

サブコマンド

以下のサブコマンドを使用できます:

  • create - 新しいExperience Edge APIキーを作成します。
  • revoke - Experience Edge API鍵を取り消す。

createサブコマンド

createサブコマンドは、提供されたオプションに基づいて新しいExperience Edge APIキーを作成します。例えば:

dotnet sitecore edge apikey create -l Main

このコマンドは新たに作成されたAPIキーを印刷します。

!重要Experience EdgeはAPIキーをプレーンテキストで保存しません。したがって、APIキーを出力からコピーし、安全に保管することが非常に重要です。

createサブコマンドで以下のオプションを使用できます:

オプション

概要

-l、--ラベル

必須。Experience Edge APIキーラベル。

-s、--スコープ

Experience Edge APIキーのスコープ。デフォルト:オーディエンス-デリバリー-コンテンツ-#everything#

-by --createdBy

APIキーの作成者として割り当てるユーザー。デフォルト

--環境、--環境

ターゲットにするExperience Edge環境を指定します。可能な値

、prodデフォルト

-?, -、助けて

開発者のヘルプやコマンドの使用情報を表示します。

撤退サブコマンド

revokeサブコマンドはExperience Edge APIキーの使用を妨げるために無効化します。例えば:

dotnet sitecore edge apikey revoke --hash

revokeサブコマンドで以下のオプションを使用できます:

オプション

概要

--トークン

Experience Edge API重要な価値観です。

--ハッシュ

Experience Edge APIキーハッシュ。

--環境、--環境

ターゲットにするExperience Edge環境を指定します。可能な値

、prodデフォルト

-?, -、助けて

開発者のヘルプやコマンドの使用情報を表示します。

この記事を改善するための提案がある場合は、 お知らせください!