7.5.2. OpenShift Container Platform コンソール API
useActivePerspective
現在アクティブなパースペクティブとアクティブなパースペクティブを設定するためのコールバックを提供するフック。現在アクティブなパースペクティブとセッターコールバックを含むタプルを返します。
const Component: React.FC = (props) => {
const [activePerspective, setActivePerspective] = useActivePerspective();
return <select
value={activePerspective}
onChange={(e) => setActivePerspective(e.target.value)}
>
{
// ...perspective options
}
</select>
}
GreenCheckCircleIcon
緑色のチェックマークの円形アイコンを表示するためのコンポーネント。
<GreenCheckCircleIcon title="Healthy" />
| パラメーター名 | 説明 |
|---|---|
|
| (オプション) コンポーネントの追加クラス名 |
|
| (オプション) アイコンのタイトル |
|
| (オプション) アイコンのサイズ: ('sm'、'md'、'lg'、'xl') |
RedExclamationCircleIcon
赤い感嘆符の円形アイコンを表示するためのコンポーネント。
<RedExclamationCircleIcon title="Failed" />
| パラメーター名 | 説明 |
|---|---|
|
| (オプション) コンポーネントの追加クラス名 |
|
| (オプション) アイコンのタイトル |
|
| (オプション) アイコンのサイズ: ('sm'、'md'、'lg'、'xl') |
YellowExclamationTriangleIcon
黄色の三角形の感嘆符アイコンを表示するためのコンポーネント。
<YellowExclamationTriangleIcon title="Warning" />
| パラメーター名 | 説明 |
|---|---|
|
| (オプション) コンポーネントの追加クラス名 |
|
| (オプション) アイコンのタイトル |
|
| (オプション) アイコンのサイズ: ('sm'、'md'、'lg'、'xl') |
BlueInfoCircleIcon
青い情報円形アイコンを表示するためのコンポーネント。
<BlueInfoCircleIcon title="Info" />
| パラメーター名 | 説明 |
|---|---|
|
| (オプション) コンポーネントの追加クラス名 |
|
| (オプション) アイコンのタイトル |
|
| (オプション) アイコンのサイズ: ('sm'、'md'、'lg'、'xl') |
ErrorStatus
エラーステータスのポップオーバーを表示するためのコンポーネント。
<ErrorStatus title={errorMsg} />
| パラメーター名 | 説明 |
|---|---|
|
| (オプション) ステータステキスト |
|
| (オプション) true の場合、アイコンのみを表示します |
|
| (オプション) true の場合、ツールチップは表示されません |
|
| (オプション) コンポーネントの追加クラス名 |
|
| (オプション) ポップオーバーのタイトル |
InfoStatus
情報ステータスのポップオーバーを表示するためのコンポーネント。
<InfoStatus title={infoMsg} />
| パラメーター名 | 説明 |
|---|---|
|
| (オプション) ステータステキスト |
|
| (オプション) true の場合、アイコンのみを表示します |
|
| (オプション) true の場合、ツールチップは表示されません |
|
| (オプション) コンポーネントの追加クラス名 |
|
| (オプション) ポップオーバーのタイトル |
ProgressStatus
進行状況のポップオーバーを表示するためのコンポーネント。
<ProgressStatus title={progressMsg} />
| パラメーター名 | 説明 |
|---|---|
|
| (オプション) ステータステキスト |
|
| (オプション) true の場合、アイコンのみを表示します |
|
| (オプション) true の場合、ツールチップは表示されません |
|
| (オプション) コンポーネントの追加クラス名 |
|
| (オプション) ポップオーバーのタイトル |
SuccessStatus
成功ステータスのポップオーバーを表示するためのコンポーネント。
<SuccessStatus title={successMsg} />
| パラメーター名 | 説明 |
|---|---|
|
| (オプション) ステータステキスト |
|
| (オプション) true の場合、アイコンのみを表示します |
|
| (オプション) true の場合、ツールチップは表示されません |
|
| (オプション) コンポーネントの追加クラス名 |
|
| (オプション) ポップオーバーのタイトル |
checkAccess
特定のリソースへのユーザーアクセスに関する情報を提供します。リソースアクセス情報を含むオブジェクトを返します。
| パラメーター名 | 説明 |
|---|---|
|
| アクセスレビューのリソース属性 |
|
| 権限借用の詳細 |
useAccessReview
特定のリソースへのユーザーアクセスに関する情報を提供するフック。isAllowed と loading 値を含む配列を返します。
| パラメーター名 | 説明 |
|---|---|
|
| アクセスレビューのリソース属性 |
|
| 権限借用の詳細 |
useResolvedExtensions
解決された CodeRef プロパティーで Console 拡張機能を使用するための React フック。このフックは、useExtensions フックと同じ引数を受け入れ、拡張インスタンスの適合したリストを返し、各拡張のプロパティー内のすべてのコード参照を解決します。最初に、フックは空の配列を返します。解決が完了すると、React コンポーネントが再レンダリングされ、適合した拡張機能のリストが返されます。一致する拡張子のリストが変更されると、解決が再開されます。解決が完了するまで、フックは前の結果を返し続けます。フックの結果要素は、再レンダリング全体で参照的に安定していることが保証されています。解決されたコード参照、解決が完了したかどうかを示すブール値フラグ、および解決中に検出されたエラーのリストを含む適応拡張インスタンスのリストを含むタプルを返します。
const [navItemExtensions, navItemsResolved] = useResolvedExtensions<NavItem>(isNavItem);
// process adapted extensions and render your component
| パラメーター名 | 説明 |
|---|---|
|
| それぞれが動的プラグイン拡張機能を引数として受け入れ、拡張機能が目的の型制約を満たしているかどうかを示すブール値フラグを返すコールバックのリスト |
HorizontalNav
ページのナビゲーションバーを作成するコンポーネント。ルーティングはコンポーネントの一部として処理されます。console.tab/horizontalNav を使用して、任意の水平ナビゲーションにコンテンツを追加できます。
const HomePage: React.FC = (props) => {
const page = {
href: '/home',
name: 'Home',
component: () => <>Home</>
}
return <HorizontalNav match={props.match} pages={[page]} />
}
| パラメーター名 | 説明 |
|---|---|
|
| K8sResourceCommon タイプのオブジェクトである、このナビゲーションに関連付けられたリソース |
|
| ページオブジェクトの配列 |
|
| React Router が提供する match オブジェクト |
VirtualizedTable
仮想化されたテーブルを作成するためのコンポーネント。
const MachineList: React.FC<MachineListProps> = (props) => {
return (
<VirtualizedTable<MachineKind>
{...props}
aria-label='Machines'
columns={getMachineColumns}
Row={getMachineTableRow}
/>
);
}
| パラメーター名 | 説明 |
|---|---|
|
| テーブルのデータ |
|
| データがロードされたことを示すフラグ |
|
| データのロードで問題が発生した場合のエラーオブジェクト |
|
| 列の設定 |
|
| 行の設定 |
|
| フィルターなしの元のデータ |
|
| (オプション) データのない空のメッセージコンポーネント |
|
| (オプション) 空のメッセージコンポーネント |
|
| (オプション) スクロールを処理する関数 |
|
| (オプション) テーブルのラベル |
|
| (オプション) aria ラベル |
|
| 応答性のためにグリッドを分割する方法のサイジング |
|
| (オプション) テーブルの選択を処理する関数 |
|
| (オプション) 行に固有のデータ |
TableData
テーブル行内にテーブルデータを表示するためのコンポーネント。
const PodRow: React.FC<RowProps<K8sResourceCommon>> = ({ obj, activeColumnIDs }) => {
return (
<>
<TableData id={columns[0].id} activeColumnIDs={activeColumnIDs}>
<ResourceLink kind="Pod" name={obj.metadata.name} namespace={obj.metadata.namespace} />
</TableData>
<TableData id={columns[1].id} activeColumnIDs={activeColumnIDs}>
<ResourceLink kind="Namespace" name={obj.metadata.namespace} />
</TableData>
</>
);
};
| パラメーター名 | 説明 |
|---|---|
|
| テーブルの一意の ID |
|
| アクティブな列 |
|
| (オプション) スタイリングのオプションクラス名 |
useActiveColumns
ユーザーが選択したアクティブな TableColumns のリストを提供するフック。
// See implementation for more details on TableColumn type
const [activeColumns, userSettingsLoaded] = useActiveColumns({
columns,
showNamespaceOverride: false,
columnManagementID,
});
return userSettingsAreLoaded ? <VirtualizedTable columns= {activeColumns} {...otherProps} /> : null
| パラメーター名 | 説明 |
|---|---|
|
| キーと値のマップとして渡されるもの。 |
| `` | \{TableColumn[]} options.columns - 利用可能なすべての TableColumn の配列 |
| `` | {boolean} [options.showNamespaceOverride] - (オプション) true の場合、列管理の選択に関係なく、namespace 列が含まれます。 |
| `` | {string} [options.columnManagementID] - (オプション) ユーザー設定との間で列管理の選択を保持および取得するために使用される一意の ID。通常、リソースの groupverionkind 文字列。 |
現在のユーザーが選択したアクティブな列 (options.columns のサブセット) と、ユーザー設定がロードされたかどうかを示すブール値フラグを含むタプル。
ListPageHeader
ページヘッダーを生成するためのコンポーネント。
const exampleList: React.FC = () => {
return (
<>
<ListPageHeader title="Example List Page"/>
</>
);
};
| パラメーター名 | 説明 |
|---|---|
|
| 見出しタイトル |
|
| (オプション) 反応ノードとしてのヘルプセクション |
|
| (オプション) 反応ノードとしてのバッジアイコン |
ListPageCreate
特定のリソースの種類に対して、そのリソースの作成用 YAML へのリンクを自動的に生成する作成ボタンを追加するためのコンポーネント。
const exampleList: React.FC<MyProps> = () => {
return (
<>
<ListPageHeader title="Example Pod List Page"/>
<ListPageCreate groupVersionKind="Pod">Create Pod</ListPageCreate>
</ListPageHeader>
</>
);
};
| パラメーター名 | 説明 |
|---|---|
|
| 表すためのリソースグループ/バージョン/種類 |
ListPageCreateLink
定型化されたリンクを作成するためのコンポーネント。
const exampleList: React.FC<MyProps> = () => {
return (
<>
<ListPageHeader title="Example Pod List Page"/>
<ListPageCreateLink to={'/link/to/my/page'}>Create Item</ListPageCreateLink>
</ListPageHeader>
</>
);
};
| パラメーター名 | 説明 |
|---|---|
|
| リンク先の文字列の場所 |
|
| (オプション) アクセスを決定するために使用される namespace と種類を持つオブジェクト |
|
| (オプション) コンポーネントの子 |
ListPageCreateButton
ボタンを作成するためのコンポーネント。
const exampleList: React.FC<MyProps> = () => {
return (
<>
<ListPageHeader title="Example Pod List Page"/>
<ListPageCreateButton createAccessReview={access}>Create Pod</ListPageCreateButton>
</ListPageHeader>
</>
);
};
| パラメーター名 | 説明 |
|---|---|
|
| (オプション) アクセスを決定するために使用される namespace と種類を持つオブジェクト |
|
| (オプション) Patternfly Button のプロパティー |
ListPageCreateDropdown
権限チェックでラップされたドロップダウンを作成するためのコンポーネント。
const exampleList: React.FC<MyProps> = () => {
const items = {
SAVE: 'Save',
DELETE: 'Delete',
}
return (
<>
<ListPageHeader title="Example Pod List Page"/>
<ListPageCreateDropdown createAccessReview={access} items={items}>Actions</ListPageCreateDropdown>
</ListPageHeader>
</>
);
};
| パラメーター名 | 説明 |
|---|---|
|
| key: ドロップダウンコンポーネントに表示する項目の ReactNode のペア |
|
| ドロップダウン項目をクリックするためのコールバック関数 |
|
| (オプション) アクセスを決定するために使用される namespace と種類を持つオブジェクト |
|
| (オプション) ドロップダウントグルの子 |
ListPageFilter
リストページのフィルターを生成するコンポーネント。
// See implementation for more details on RowFilter and FilterValue types
const [staticData, filteredData, onFilterChange] = useListPageFilter(
data,
rowFilters,
staticFilters,
);
// ListPageFilter updates filter state based on user interaction and resulting filtered data can be rendered in an independent component.
return (
<>
<ListPageHeader .../>
<ListPagBody>
<ListPageFilter data={staticData} onFilterChange={onFilterChange} />
<List data={filteredData} />
</ListPageBody>
</>
)
| パラメーター名 | 説明 |
|---|---|
|
| データポイントの配列 |
|
| データがロードされたことを示します |
|
| フィルター更新時のコールバック関数 |
|
| (オプション) 利用可能なフィルターオプションを定義する RowFilter 要素の配列 |
|
| (オプション) 名前フィルターのプレースホルダー |
|
| (オプション) ラベルフィルターのプレースホルダー |
|
| (オプション) 名前フィルターとラベルフィルターの両方ではなく、名前フィルターのみを表示します。 |
|
| (オプション) 名前フィルターとラベルフィルターの両方を非表示にします。 |
|
| (オプション) 列レイアウトオブジェクト |
|
| (オプション) 列管理を非表示にするフラグ |
useListPageFilter
ListPageFilter コンポーネントのフィルター状態を管理するフック。すべての静的フィルターによってフィルター処理されたデータ、すべての静的フィルターと行フィルターによってフィルター処理されたデータ、および rowFilters を更新するコールバックを含むタプルを返します。
// See implementation for more details on RowFilter and FilterValue types
const [staticData, filteredData, onFilterChange] = useListPageFilter(
data,
rowFilters,
staticFilters,
);
// ListPageFilter updates filter state based on user interaction and resulting filtered data can be rendered in an independent component.
return (
<>
<ListPageHeader .../>
<ListPagBody>
<ListPageFilter data={staticData} onFilterChange={onFilterChange} />
<List data={filteredData} />
</ListPageBody>
</>
)
| パラメーター名 | 説明 |
|---|---|
|
| データポイントの配列 |
|
| (オプション) 利用可能なフィルターオプションを定義する RowFilter 要素の配列 |
|
| (オプション) データに静的に適用される FilterValue 要素の配列 |
ResourceLink
アイコンバッジを使用して特定のリソースタイプへのリンクを作成するコンポーネント。
<ResourceLink
kind="Pod"
name="testPod"
title={metadata.uid}
/>
| パラメーター名 | 説明 |
|---|---|
|
| (オプション) リソースの種類、つまり Pod、Deployment、Namespace |
|
| (オプション) groupd、version、kind を持つオブジェクト |
|
| (オプション) コンポーネントのクラススタイル |
|
| (オプション) コンポーネントの表示名。設定されている場合は、リソース名を上書きします。 |
|
| (オプション) アイコンバッジを作成し、子とインラインで名前を付けるためのフラグ |
|
| (オプション) Link オブジェクトを作成するためのフラグ - デフォルトは true |
|
| (オプション) リソースの名前 |
|
| (オプション) リンク先の種類のリソースの特定の namespace |
|
| (オプション) アイコンバッジを非表示にするフラグ |
|
| (オプション) リンクオブジェクトのタイトル (非表示) |
|
| (オプション) テスト用の識別子 |
|
| (オプション) コンポーネントがクリックされたときのコールバック関数 |
|
| (オプション) リンクが長すぎる場合に切り捨てるフラグ |
ResourceIcon
特定のリソースタイプのアイコンバッジを作成するコンポーネント。
<ResourceIcon kind="Pod"/>
| パラメーター名 | 説明 |
|---|---|
|
| (オプション) リソースの種類、つまり Pod、Deployment、Namespace |
|
| (オプション) グループ、バージョン、および種類を含むオブジェクト |
|
| (オプション) コンポーネントのクラススタイル |
useK8sModel
指定された K8sGroupVersionKind の k8s モデルを redux から取得するフック。最初の項目が k8s モデル、2 番目の項目が inFlight ステータスの配列を返します。
const Component: React.FC = () => {
const [model, inFlight] = useK8sModel({ group: 'app'; version: 'v1'; kind: 'Deployment' });
return ...
}
| パラメーター名 | 説明 |
|---|---|
|
|
k8s リソースのグループ、バージョン、種類 \{@link K8sGroupVersionKind} が推奨されます。代わりに、非推奨のグループ、バージョン、種類の参照を渡すこともできます。つまり、 |
useK8sModels
redux から現在のすべての k8s モデルを取得するフック。最初の項目が k8s モデルのリストで、2 番目の項目が inFlight ステータスの配列を返します。
const Component: React.FC = () => {
const [models, inFlight] = UseK8sModels();
return ...
}
useK8sWatchResource
ロード済みおよびエラーのステータスとともに k8s リソースを取得するフック。最初の項目がリソース、2 番目の項目がロード済みステータス、3 番目の項目がエラー状態 (存在する場合) の配列を返します。
const Component: React.FC = () => {
const watchRes = {
...
}
const [data, loaded, error] = useK8sWatchResource(watchRes)
return ...
}
| パラメーター名 | 説明 |
|---|---|
|
| リソースを監視するために必要なオプション。 |
useK8sWatchResources
ロード済みおよびエラーのそれぞれのステータスとともに k8s リソースを取得するフック。キーが initResouces で提供され、値が data、loaded、error の 3 つのプロパティーを持つマップを返します。
const Component: React.FC = () => {
const watchResources = {
'deployment': {...},
'pod': {...}
...
}
const {deployment, pod} = useK8sWatchResources(watchResources)
return ...
}
| パラメーター名 | 説明 |
|---|---|
|
| リソースはキーと値のペアとして監視する必要があります。ここで、キーはリソースに固有であり、値はそれぞれのリソースを監視するために必要なオプションです。 |
consoleFetch
コンソール固有のヘッダーを追加し、再試行とタイムアウトを可能にする fetch のカスタムラッパー。また、レスポンスステータスコードを検証し、適切なエラーを出力するか、必要に応じてユーザーをログアウトします。レスポンスに解決される promise を返します。
| パラメーター名 | 説明 |
|---|---|
|
| 取得する URL |
|
| フェッチに渡すオプション |
|
| ミリ秒単位のタイムアウト |
consoleFetchJSON
コンソール固有のヘッダーを追加し、再試行とタイムアウトを可能にする fetch のカスタムラッパー。また、レスポンスステータスコードを検証し、適切なエラーを出力するか、必要に応じてユーザーをログアウトします。レスポンスを JSON オブジェクトとして返します。内部で consoleFetch を使用します。JSON オブジェクトとしてレスポンスに解決される promise を返します。
| パラメーター名 | 説明 |
|---|---|
|
| 取得する URL |
|
| 使用する HTTP メソッドデフォルトは GET です。 |
|
| フェッチに渡すオプション |
|
| ミリ秒単位のタイムアウト |
|
| リクエストを行うクラスターの名前。デフォルトは、ユーザーが選択したアクティブなクラスターです |
consoleFetchText
コンソール固有のヘッダーを追加し、再試行とタイムアウトを可能にする fetch のカスタムラッパー。また、レスポンスステータスコードを検証し、適切なエラーを出力するか、必要に応じてユーザーをログアウトします。レスポンスをテキストとして返します。内部で consoleFetch を使用します。テキストとしてレスポンスに解決される promise を返します。
| パラメーター名 | 説明 |
|---|---|
|
| 取得する URL |
|
| フェッチに渡すオプション |
|
| ミリ秒単位のタイムアウト |
|
| リクエストを行うクラスターの名前。デフォルトは、ユーザーが選択したアクティブなクラスターです |
getConsoleRequestHeaders
現在の redux 状態を使用して、API リクエストの権限借用およびマルチクラスター関連ヘッダーを作成する関数。redux 状態に基づいて、適切な権限借用ヘッダーとクラスター要求ヘッダーを含むオブジェクトを返します。
| パラメーター名 | 説明 |
|---|---|
|
| 指定された targetCluster で現在アクティブなクラスターをオーバーライドします |
k8sGetResource
指定されたオプションに基づいて、クラスターからリソースを取得します。名前が指定されている場合は、1 つのリソースが返されます。それ以外の場合は、モデルに一致するすべてのリソースが返されます。名前が指定されている場合、リソースを含む JSON オブジェクトとしてレスポンスに解決される promise を返します。それ以外の場合は、モデルに一致するすべてのリソースを返します。失敗した場合、promise は HTTP エラーレスポンスで拒否されます。
| パラメーター名 | 説明 |
|---|---|
|
| マップでキーと値のペアとして渡されるもの。 |
| `` | options.model - k8s モデル |
| `` | options.name - リソースの名前。指定されていない場合は、モデルに一致するすべてのリソースが検索されます。 |
| `` | options.ns - 調べる namespace。クラスタースコープのリソースには指定しないでください。 |
| `` | options.path - 提供された場合、サブパスとして追加します |
| `` | options.queryParams - URL に含まれるクエリーパラメーター。 |
| `` | options.requestInit - 使用するフェッチ初期化オブジェクト。これには、リクエストヘッダー、メソッド、リダイレクトなどを含めることができます。詳細 (リンク: https://microsoft.github.io/PowerBI-JavaScript/interfaces/node_modules_typedoc_node_modules_typescript_lib_lib_dom_d.requestinit.html) |
k8sCreateResource
指定されたオプションに基づいて、クラスター内にリソースを作成します。作成されたリソースのレスポンスに解決される promise を返します。失敗した場合、promise は HTTP エラーレスポンスで拒否されます。
| パラメーター名 | 説明 |
|---|---|
|
| マップでキーと値のペアとして渡されるもの。 |
| `` | options.model - k8s モデル |
| `` | options.data - 作成されるリソースのペイロード |
| `` | options.path - 提供された場合、サブパスとして追加します |
| `` | options.queryParams - URL に含まれるクエリーパラメーター。 |
k8sUpdateResource
指定されたオプションに基づいて、クラスター内のリソース全体を更新します。クライアントが既存のリソースを完全に置き換える必要がある場合、k8sUpdate を使用できます。または、k8sPatch を使用して部分的な更新を実行することもできます。更新されたリソースのレスポンスに解決される promise を返します。失敗した場合、promise は HTTP エラーレスポンスで拒否されます。
| パラメーター名 | 説明 |
|---|---|
|
| マップでキーと値のペアとして渡されるもの。 |
| `` | options.model - k8s モデル |
| `` | options.data - 更新する k8s リソースのペイロード |
| `` | options.ns - 調べる namespace。クラスタースコープのリソースには指定しないでください。 |
| `` | options.name - 更新するリソース名。 |
| `` | options.path - 提供された場合、サブパスとして追加します |
| `` | options.queryParams - URL に含まれるクエリーパラメーター。 |
k8sPatchResource
指定されたオプションに基づいて、クラスター内の任意のリソースにパッチを適用します。クライアントが部分的な更新を実行する必要がある場合、k8sPatch を使用できます。または、k8sUpdate を使用して、既存のリソースを完全に置き換えることもできます。詳細については、データトラッカー を参照してください。パッチが適用されたリソースの応答に解決される promise を返します。失敗した場合、promise は HTTP エラーレスポンスで拒否されます。
| パラメーター名 | 説明 |
|---|---|
|
| マップでキーと値のペアとして渡されるもの。 |
| `` | options.model - k8s モデル |
| `` | options.resource - パッチを適用するリソース。 |
| `` | options.data - 操作、パス、および値を使用して、既存のリソースにパッチを適用するデータのみ。 |
| `` | options.path - 提供された場合、サブパスとして追加します。 |
| `` | options.queryParams - URL に含まれるクエリーパラメーター。 |
k8sDeleteResource
指定されたモデル、リソースに基づいて、クラスターからリソースを削除します。ガベージコレクションは 'Foreground'|'Background' に基づいて機能し、提供されたモデルの propagationPolicy プロパティーで設定するか、json で渡すことができます。種類が Status のレスポンスに解決される promise を返します。失敗した場合、promise は HTTP エラー応答で拒否されます。
{ kind: 'DeleteOptions', apiVersion: 'v1', propagationPolicy }
| パラメーター名 | 説明 |
|---|---|
|
| マップでキーと値のペアとして渡されるもの。 |
| `` | options.model - k8s モデル |
| `` | options.resource - 削除するリソース。 |
| `` | options.path - 提供された場合、サブパスとして追加します |
| `` | options.queryParams - URL に含まれるクエリーパラメーター。 |
| `` | options.requestInit - 使用するフェッチ初期化オブジェクト。これには、リクエストヘッダー、メソッド、リダイレクトなどを含めることができます。詳細 \{@link https://microsoft.github.io/PowerBI-JavaScript/interfaces/node_modules_typedoc_node_modules_typescript_lib_lib_dom_d.requestinit.html } |
| `` | options.json - リソースのガベージコレクションを明示的に制御できます。それ以外の場合は、モデルの propagationPolicy がデフォルトになります。 |
k8sListResource
指定されたオプションに基づいて、リソースをクラスター内の配列として一覧表示します。レスポンスに解決される promise を返します。
| パラメーター名 | 説明 |
|---|---|
|
| マップでキーと値のペアとして渡されるもの。 |
| `` | options.model - k8s モデル |
| `` | options.queryParams - URL に含まれるクエリーパラメーター。ラベルセレクターとキー labelSelector を渡すことができます。 |
| `` | options.requestInit - 使用するフェッチ初期化オブジェクト。これには、リクエストヘッダー、メソッド、リダイレクトなどを含めることができます。詳細 \{@link https://microsoft.github.io/PowerBI-JavaScript/interfaces/node_modules_typedoc_node_modules_typescript_lib_lib_dom_d.requestinit.html } |
k8sListResourceItems
\{@link k8sListResource} と同じインターフェイスですが、サブ項目を返します。モデルの apiVersion、つまり group/version を返します。
getAPIVersionForModel
k8s モデルの apiVersion を提供します。
| パラメーター名 | 説明 |
|---|---|
|
| k8s モデル |
getGroupVersionKindForResource
リソースのグループ、バージョン、および種類を提供します。指定されたリソースのグループ、バージョン、種類を返します。リソースに API グループがない場合、グループ core が返されます。リソースに無効な apiVersion がある場合、エラーが出力されます。
| パラメーター名 | 説明 |
|---|---|
|
| k8s リソース |
getGroupVersionKindForModel
k8s モデルのグループ、バージョン、および種類を提供します。これは、提供されたモデルのグループ、バージョン、種類を返します。モデルに apiGroup がない場合、グループ core が返されます。
| パラメーター名 | 説明 |
|---|---|
|
| k8s モデル |
StatusPopupSection
ポップアップウィンドウでステータスを表示するコンポーネント。console.dashboards/overview/health/resource 拡張機能を構築するための便利なコンポーネント。
<StatusPopupSection
firstColumn={
<>
<span>{title}</span>
<span className="text-secondary">
My Example Item
</span>
</>
}
secondColumn='Status'
>
| パラメーター名 | 説明 |
|---|---|
|
| ポップアップの最初の列の値 |
|
| (オプション) ポップアップの 2 列目の値 |
|
| (オプション) ポップアップの子 |
StatusPopupItem
ステータスポップアップで使用されるステータス要素。StatusPopupSection で使用されます。
<StatusPopupSection
firstColumn='Example'
secondColumn='Status'
>
<StatusPopupItem icon={healthStateMapping[MCGMetrics.state]?.icon}>
Complete
</StatusPopupItem>
<StatusPopupItem icon={healthStateMapping[RGWMetrics.state]?.icon}>
Pending
</StatusPopupItem>
</StatusPopupSection>
| パラメーター名 | 説明 |
|---|---|
|
| (オプション) 表示するテキスト値 |
|
| (オプション) 表示するアイコン |
|
| 子要素 |
概要
ダッシュボードのラッパーコンポーネントを作成します。
<Overview>
<OverviewGrid mainCards={mainCards} leftCards={leftCards} rightCards={rightCards} />
</Overview>
| パラメーター名 | 説明 |
|---|---|
|
| (オプション) div のスタイルクラス |
|
| (オプション) ダッシュボードの要素 |
OverviewGrid
ダッシュボードのカード要素のグリッドを作成します。Overview 内で使用されます。
<Overview>
<OverviewGrid mainCards={mainCards} leftCards={leftCards} rightCards={rightCards} />
</Overview>
| パラメーター名 | 説明 |
|---|---|
|
| グリッド用カード |
|
| (オプション) グリッドの左側のカード |
|
| (オプション) グリッドの右側のカード |
InventoryItem
インベントリーカード項目を作成します。
return (
<InventoryItem>
<InventoryItemTitle>{title}</InventoryItemTitle>
<InventoryItemBody error={loadError}>
{loaded && <InventoryItemStatus count={workerNodes.length} icon={<MonitoringIcon />} />}
</InventoryItemBody>
</InventoryItem>
)
| パラメーター名 | 説明 |
|---|---|
|
| 項目内でレンダリングする要素 |
InventoryItemTitle
インベントリーカード項目のタイトルを作成します。InventoryItem 内で使用されます。
return (
<InventoryItem>
<InventoryItemTitle>{title}</InventoryItemTitle>
<InventoryItemBody error={loadError}>
{loaded && <InventoryItemStatus count={workerNodes.length} icon={<MonitoringIcon />} />}
</InventoryItemBody>
</InventoryItem>
)
| パラメーター名 | 説明 |
|---|---|
|
| タイトル内にレンダリングする要素 |
InventoryItemBody
インベントリーカードの本文を作成します。InventoryCard 内で使用され、InventoryTitle と使用できます。
return (
<InventoryItem>
<InventoryItemTitle>{title}</InventoryItemTitle>
<InventoryItemBody error={loadError}>
{loaded && <InventoryItemStatus count={workerNodes.length} icon={<MonitoringIcon />} />}
</InventoryItemBody>
</InventoryItem>
)
| パラメーター名 | 説明 |
|---|---|
|
| インベントリーカードまたはタイトル内でレンダリングする要素 |
|
| div の要素 |
InventoryItemStatus
オプションのリンクアドレスを使用してインベントリーカードのカウントとアイコンを作成します。InventoryItemBody 内で使用されます。
return (
<InventoryItem>
<InventoryItemTitle>{title}</InventoryItemTitle>
<InventoryItemBody error={loadError}>
{loaded && <InventoryItemStatus count={workerNodes.length} icon={<MonitoringIcon />} />}
</InventoryItemBody>
</InventoryItem>
)
| パラメーター名 | 説明 |
|---|---|
|
| 表示用カウント |
|
| 表示用アイコン |
|
| (オプション) リンクアドレス |
InventoryItemLoading
インベントリーカードのロード時にスケルトンコンテナーを作成します。InventoryItem および関連コンポーネントで使用されます。
if (loadError) {
title = <Link to={workerNodesLink}>{t('Worker Nodes')}</Link>;
} else if (!loaded) {
title = <><InventoryItemLoading /><Link to={workerNodesLink}>{t('Worker Nodes')}</Link></>;
}
return (
<InventoryItem>
<InventoryItemTitle>{title}</InventoryItemTitle>
</InventoryItem>
)
useFlag
FLAGS redux 状態から指定された機能フラグを返すフック。要求された機能フラグまたは未定義のブール値を返します。
| パラメーター名 | 説明 |
|---|---|
|
| 返す機能フラグ |
YAMLEditor
ホバーヘルプと補完機能を備えた基本的な遅延ロード YAML エディター。
<React.Suspense fallback={<LoadingBox />}>
<YAMLEditor
value={code}
/>
</React.Suspense>
| パラメーター名 | 説明 |
|---|---|
|
| レンダリングする yaml コードを表す文字列。 |
|
| Monaco エディターのオプション。詳細については、https://microsoft.github.io/monaco-editor/api/interfaces/monaco.editor.IStandaloneEditorConstructionOptions.html にアクセスしてください。 |
|
| 有効な CSS の高さの値における最小のエディターの高さ。 |
|
| エディターの上にショートカットを表示するためのブール値。 |
|
| エディター上部のツールバーリンクセクションにレンダリングされる ReactNode の配列。 |
|
| コード変更イベントのコールバック。 |
|
| コマンド CTRL / CMD + S がトリガーされたときに呼び出されるコールバック。 |
|
|
|
ResourceYAMLEditor
ホバーヘルプと補完機能を備えた Kubernetes リソース用の遅延ロード YAML エディター。このコンポーネントは YAMLEditor を使用し、その上にリソースの更新処理、アラート、保存、キャンセル、リロードボタン、アクセシビリティなどの機能を追加します。onSave コールバックが提供されないかぎり、リソースの更新は自動的に処理されます。React.Suspense コンポーネントでラップする必要があります。
<React.Suspense fallback={<LoadingBox />}>
<ResourceYAMLEditor
initialResource={resource}
header="Create resource"
onSave={(content) => updateResource(content)}
/>
</React.Suspense>
| パラメーター名 | 説明 |
|---|---|
|
| エディターによって表示されるリソースを表す YAML/オブジェクト。この prop は、最初のレンダリング中にのみ使用されます |
|
| YAML エディターの上にヘッダーを追加する |
|
| Save ボタンのコールバック。これを渡すと、エディターによってリソースに対して実行されたデフォルトの更新が上書きされます |
ResourceEventStream
特定のリソースに関連するイベントを表示するコンポーネント。
const [resource, loaded, loadError] = useK8sWatchResource(clusterResource);
return <ResourceEventStream resource={resource} />
| パラメーター名 | 説明 |
|---|---|
|
| 関連イベントを表示するオブジェクト。 |
usePrometheusPoll
単一のクエリーに対して Prometheus へのポーリングを設定します。クエリーレスポンス、レスポンスが完了したかどうかを示すブール値フラグ、および要求中または要求の後処理中に発生したエラーを含むタプルを返します。
| パラメーター名 | 説明 |
|---|---|
| `` | {PrometheusEndpoint} props.endpoint - PrometheusEndpoint の 1 つ (ラベル、クエリー、範囲、ルール、ターゲット) |
| `` | {string} [props.query] - (オプション) Prometheus クエリー文字列。空または未定義の場合、ポーリングは開始されません。 |
| `` | {number} [props.delay] - (オプション) ポーリング遅延間隔 (ミリ秒) |
| `` | {number} [props.endTime] - (オプション) QUERY_RANGE エンドポイント用、クエリー範囲の終わり |
| `` | {number} [props.samples] - (オプション) QUERY_RANGE エンポイント用 |
| `` | {number} [options.timespan] - (オプション) QUERY_RANGE エンドポイント用 |
| `` | {string} [options.namespace] - (オプション) 追加する検索パラメーター |
| `` | {string} [options.timeout] - (オプション) 追加する検索パラメーター |
タイムスタンプ
タイムスタンプをレンダリングするコンポーネント。タイムスタンプは、Timestamp コンポーネントの個々のインスタンス間で同期されます。指定されたタイムスタンプは、ユーザーロケールに従ってフォーマットされます。
| パラメーター名 | 説明 |
|---|---|
|
| レンダリングするタイムスタンプ。形式は、ISO 8601 (Kubernetes で使用)、エポックタイムスタンプ、または日付のインスタンスであることが期待されます。 |
|
| アイコンとツールチップを省略したシンプルなバージョンのコンポーネントをレンダリングします。 |
|
| 接尾辞を省略して日付をフォーマットします。 |
|
| コンポーネントの追加のクラス名。 |
useModal
モーダルを起動するためのフック。
const context: AppPage: React.FC = () => {<br/> const [launchModal] = useModal();<br/> const onClick = () => launchModal(ModalComponent);<br/> return (<br/> <Button onClick={onClick}>Launch a Modal</Button><br/> )<br/>}<br/>`
ActionServiceProvider
console.action/provider 拡張タイプの他のプラグインからのコントリビューションを受け取ることを可能にするコンポーネント。
const context: ActionContext = { 'a-context-id': { dataFromDynamicPlugin } };
...
<ActionServiceProvider context={context}>
{({ actions, options, loaded }) =>
loaded && (
<ActionMenu actions={actions} options={options} variant={ActionMenuVariant.DROPDOWN} />
)
}
</ActionServiceProvider>
| パラメーター名 | 説明 |
|---|---|
|
| contextId とオプションのプラグインデータを含むオブジェクト |
NamespaceBar
namespace のドロップダウンメニューが左端にある水平ツールバーをレンダリングするコンポーネント。追加のコンポーネントを子として渡すことができ、namespace ドロップダウンの右側にレンダリングされます。このコンポーネントは、ページの上部で使用するように設計されています。k8s リソースを含むページなど、ユーザーがアクティブな namespace を変更できる必要があるページで使用する必要があります。
const logNamespaceChange = (namespace) => console.log(`New namespace: ${namespace}`);
...
<NamespaceBar onNamespaceChange={logNamespaceChange}>
<NamespaceBarApplicationSelector />
</NamespaceBar>
<Page>
...
| パラメーター名 | 説明 |
|---|---|
|
| (オプション) namespace オプションが選択されたときに実行される関数。唯一の引数として、文字列の形式で新しい namespace を受け入れます。オプションが選択されると、アクティブな namespace が自動的に更新されますが、この関数を介して追加のロジックを適用できます。namespace が変更されると、URL の namespace パラメーターが以前の namespace から新しく選択された namespace に変更されます。 |
|
| (オプション) true に設定されている場合、namespace のドロップダウンを無効にするブール値フラグ。このオプションは namespace ドロップダウンにのみ適用され、子コンポーネントには影響しません。 |
|
| (オプション) namespace ドロップダウンの右側にあるツールバー内にレンダリングされる追加の要素。 |
ErrorBoundaryFallbackPage
フルページの ErrorBoundaryFallbackPage コンポーネントを作成して、"Oh no!Something went wrong." というメッセージと、スタックトレースおよびその他の役立つデバッグ情報を表示します。これは、コンポーネントと組み合わせて使用されます。
//in ErrorBoundary component
return (
if (this.state.hasError) {
return <ErrorBoundaryFallbackPage errorMessage={errorString} componentStack={componentStackString}
stack={stackTraceString} title={errorString}/>;
}
return this.props.children;
)
| パラメーター名 | 説明 |
|---|---|
|
| エラーメッセージのテキスト説明 |
|
| 例外のコンポーネントトレース |
|
| 例外のスタックトレース |
|
| エラー境界ページのヘッダーとしてレンダリングするタイトル |
PerspectiveContext
@deprecated - 代わりに提供された usePerspectiveContext を使用して、パースペクティブコンテキストを作成します。
| パラメーター名 | 説明 |
|---|---|
|
| アクティブなパースペクティブとセッターを含むオブジェクト |
useAccessReviewAllowed
@deprecated - 代わりに @console/dynamic-plugin-sdk の useAccessReview を使用します。特定のリソースへのユーザーアクセスに関する許可ステータスを提供するフック。isAllowed ブール値を返します。
| パラメーター名 | 説明 |
|---|---|
|
| アクセスレビューのリソース属性 |
|
| 権限借用の詳細 |
useSafetyFirst
@deprecated - このフックは、コンソール機能とは関係ありません。特定のコンポーネントがアンマウントされる可能性がある場合に備えて、React 状態の安全な非同期設定を保証するフックです。状態値とその set 関数のペアを含む配列を返します。
| パラメーター名 | 説明 |
|---|---|
|
| 初期状態値 |