第40章 NodeService

名前	説明	必須	デフォルト	Pattern
timeout		-	null
query		-	null

表40.1 HTTP 応答コード
コード	メッセージ	データタイプ
200	正常な応答。（ストリーミング応答）	Stream_result_of_v1ExportNodeResponse
0	予期しないエラーの応答です。	RuntimeError

40.1.7.1. CVSSV2AccessComplexity

Enum 値
ACCESS_HIGH
ACCESS_MEDIUM
ACCESS_LOW

40.1.7.2. CVSSV2Authentication

Enum 値
AUTH_MULTIPLE
AUTH_SINGLE
AUTH_NONE

40.1.7.3. CVSSV3Complexity

Enum 値
COMPLEXITY_LOW
COMPLEXITY_HIGH

40.1.7.4. CVSSV3Privileges

Enum 値
PRIVILEGE_NONE
PRIVILEGE_LOW
PRIVILEGE_HIGH

40.1.7.5. CVSSV3UserInteraction

Enum 値
UI_NONE
UI_REQUIRED

40.1.7.6. EmbeddedVulnerabilityVulnerabilityType

Enum 値
UNKNOWN_VULNERABILITY
IMAGE_VULNERABILITY
K8S_VULNERABILITY
ISTIO_VULNERABILITY
NODE_VULNERABILITY
OPENSHIFT_VULNERABILITY

40.1.7.7. ProtobufAny

any には、シリアライズされたメッセージの型を記述する URL とともに、任意のシリアライズされたプロトコルバッファーメッセージが含まれます。

Protobuf ライブラリーは、パック/アンパックをサポートします。任意の値は、ユーティリティー関数の形式で、または Any タイプの追加の生成されたメソッドになります。

例 1: C++ のメッセージをパックして展開します。

Foo foo = ...;
Any any;
any.PackFrom(foo);
...
if (any.UnpackTo(&foo)) {
  ...
}

例 2: Java でメッセージをパックして解凍します。

Foo foo = ...;
Any any = Any.pack(foo);
...
if (any.is(Foo.class)) {
  foo = any.unpack(Foo.class);
}
// or ...
if (any.isSameTypeAs(Foo.getDefaultInstance())) {
  foo = any.unpack(Foo.getDefaultInstance());
}

Example 3: Pack and unpack a message in Python.

foo = Foo(...)
any = Any()
any.Pack(foo)
...
if any.Is(Foo.DESCRIPTOR):
  any.Unpack(foo)
  ...

Example 4: Pack and unpack a message in Go

foo := &pb.Foo{...}
any, err := anypb.New(foo)
if err != nil {
  ...
}
...
foo := &pb.Foo{}
if err := any.UnmarshalTo(foo); err != nil {
  ...
}

protobuf ライブラリーが提供するパックメソッドは、デフォルトで type.googleapis.com/full.type.name をタイプ URL として使用し、unzip メソッドは、タイプ URL の最後の//のみを使用します。たとえば、"foo.bar.com/x/y.z" のように、"foo.bar.com/x/y.z" の型名 "y.z" が生成されます。

40.1.7.7.1. JSON 表現

Any 値の JSON 表現は、デシリアライズされた埋め込みメッセージの通常の表現を使用し、タイプ URL が含まれる追加のフィールド @type を使用します。以下に例を示します。

package google.profile;
message Person {
  string first_name = 1;
  string last_name = 2;
}

{
  "@type": "type.googleapis.com/google.profile.Person",
  "firstName": <string>,
  "lastName": <string>
}

埋め込みメッセージタイプがよく知られていて、カスタム JSON 表現がある場合、その表現は埋め込みされ、@type フィールドに加えてカスタム JSON を保持するフィールド 値 が追加されます。例（メッセージ [google.protobuf.Duration][] の場合）:

{
  "@type": "type.googleapis.com/google.protobuf.Duration",
  "value": "1.212s"
}

フィールド名	必須	Null 許容型	型	説明	形式
typeUrl			String	シリアライズされたプロトコルバッファーメッセージのタイプを一意に識別する URL/リソース名。この文字列には最低でも 1 つの \"/\" 文字を含める必要があります。URL のパスの最後のセグメントは、タイプの完全修飾名( `path/google.protobuf.Duration`にあるように)を表す必要があります。名前は正規の形式である必要があります（たとえば、先頭 \".\" は受け入れられません）。実際には、チームは通常、バイナリーにプリコンパイルして、任意のコンテキストで使用することを期待しているすべてのタイプにプレコンパイルします。ただし、スキーム `http`、`https`、またはスキームを使用しない URL の場合、以下のようにタイプ URL をメッセージ定義にマップするタイプサーバーを設定できます。* スキームが指定されていない場合、`https` は想定されます。* URL の HTTP GET はバイナリー形式の [google.protobuf.Type][] 値を生成するか、エラーを生成する必要があります。* アプリケーションは、URL に基づいてルックアップ結果をキャッシュするか、ルックアップを回避するためにバイナリーにプリコンパイルして使用できます。したがって、タイプへの変更時にバイナリー互換性を保持する必要があります。（バージョン付けされたタイプ名を使用して、重大な変更を管理します。）注記：この機能は現在、公式の protobuf リリースでは利用できないため、type.googleapis.com で始まるタイプ URL には使用されません。2023 年 5 月時点では、広く使用されているタイプサーバー実装はもう 1 つも実装する予定はありません。`http` 以外のスキーム、`https` （または空のスキーム）は、実装固有のセマンティクスで使用できます。
value			byte[]	上記の指定されたタイプの有効なシリアライズされたプロトコルバッファーである必要があります。	byte

40.1.7.8. RuntimeError

フィールド名	型	形式
error	String
code	Integer	int32
message	String
details	ProtobufAnyのリスト

40.1.7.9. RuntimeStreamError

フィールド名	型	形式
grpcCode	Integer	int32
httpCode	Integer	int32
message	String
httpStatus	String
details	ProtobufAnyのリスト

40.1.7.10. StorageCVEInfo

フィールド名	型	説明	形式
cve	String
summary	String
link	String
publishedOn	Date	これは、cve フィードで最初に公開されたときのタイムスタンプを示します。	date-time
createdAt	Date	CVE がシステムに初めて見られた時間。	date-time
lastModified	Date		date-time
scoreVersion	StorageCVEInfoScoreVersion		V2、V3、UNKNOWN、
cvssV2	StorageCVSSV2
cvssV3	StorageCVSSV3
references	StorageCVEInfoReferenceのリスト

40.1.7.11. StorageCVEInfoReference

フィールド名	必須	Null 許容型	型	説明	形式
URI			String
tags			`string` のリスト

40.1.7.12. StorageCVEInfoScoreVersion

Enum 値
V2
V3
UNKNOWN

40.1.7.13. StorageCVSSV2

フィールド名	型	形式
vector	String
attackVector	StorageCVSSV2AttackVector	ATTACK_LOCAL, ATTACK_ADJACENT, ATTACK_NETWORK,
accessComplexity	CVSSV2AccessComplexity	ACCESS_HIGH、ACCESS_MEDIUM、ACCESS_LOW、
認証	CVSSV2Authentication	AUTH_MULTIPLE, AUTH_SINGLE, AUTH_NONE,
confidentiality	StorageCVSSV2Impact	IMPACT_NONE, IMPACT_PARTIAL, IMPACT_COMPLETE,
integrity	StorageCVSSV2Impact	IMPACT_NONE, IMPACT_PARTIAL, IMPACT_COMPLETE,
availability	StorageCVSSV2Impact	IMPACT_NONE, IMPACT_PARTIAL, IMPACT_COMPLETE,
exploitabilityScore	Float	float
impactScore	Float	float
score	Float	float
severity	StorageCVSSV2Severity	UNKNOWN、LOW、MEDIUM、HIGH

40.1.7.14. StorageCVSSV2AttackVector

Enum 値
ATTACK_LOCAL
ATTACK_ADJACENT
ATTACK_NETWORK

40.1.7.15. StorageCVSSV2Impact

Enum 値
IMPACT_NONE
IMPACT_PARTIAL
IMPACT_COMPLETE

40.1.7.16. StorageCVSSV2Severity

Enum 値
UNKNOWN
LOW
MEDIUM
HIGH

40.1.7.17. StorageCVSSV3

フィールド名	型	形式
vector	String
exploitabilityScore	Float	float
impactScore	Float	float
attackVector	StorageCVSSV3AttackVector	ATTACK_LOCAL, ATTACK_ADJACENT, ATTACK_NETWORK, ATTACK_PHYSICAL,
attackComplexity	CVSSV3Complexity	COMPLEXITY_LOW、COMPLEXITY_HIGH、
privilegesRequired	CVSSV3Privileges	PRIVILEGE_NONE、PRIVILEGE_LOW、PRIVILEGE_HIGH、
userInteraction	CVSSV3UserInteraction	UI_NONE, UI_REQUIRED,
scope	StorageCVSSV3Scope	変更、変更、
confidentiality	StorageCVSSV3Impact	IMPACT_NONE, IMPACT_LOW, IMPACT_HIGH,
integrity	StorageCVSSV3Impact	IMPACT_NONE, IMPACT_LOW, IMPACT_HIGH,
availability	StorageCVSSV3Impact	IMPACT_NONE, IMPACT_LOW, IMPACT_HIGH,
score	Float	float
severity	StorageCVSSV3Severity	UNKNOWN、NONE、LOW、MEDIUM、HIGH、CRITICAL、

40.1.7.18. StorageCVSSV3AttackVector

Enum 値
ATTACK_LOCAL
ATTACK_ADJACENT
ATTACK_NETWORK
ATTACK_PHYSICAL

40.1.7.19. StorageCVSSV3Impact

Enum 値
IMPACT_NONE
IMPACT_LOW
IMPACT_HIGH

40.1.7.20. StorageCVSSV3Scope

Enum 値
変更なし
CHANGED

40.1.7.21. StorageCVSSV3Severity

Enum 値
UNKNOWN
NONE
LOW
MEDIUM
HIGH
CRITICAL

40.1.7.22. StorageContainerRuntime

Enum 値
UNKNOWN_CONTAINER_RUNTIME
DOCKER_CONTAINER_RUNTIME
CRIO_CONTAINER_RUNTIME

40.1.7.23. StorageContainerRuntimeInfo

フィールド名	必須	Null 許容型	型	説明	形式
type			StorageContainerRuntime		UNKNOWN_CONTAINER_RUNTIME, DOCKER_CONTAINER_RUNTIME, CRIO_CONTAINER_RUNTIME,
version			String

40.1.7.24. StorageEmbeddedNodeScanComponent

フィールド名	型	形式
name	String
version	String
vulns	StorageEmbeddedVulnerabilityのリスト
vulnerabilities	StorageNodeVulnerabilityのリスト
priority	String	int64
topCvss	Float	float
riskScore	Float	float

40.1.7.25. StorageEmbeddedVulnerability

Next Tag: 21

フィールド名	型	説明	形式
cve	String
CVSS	Float		float
summary	String
link	String
fixedBy	String
scoreVersion	StorageEmbeddedVulnerabilityScoreVersion		V2, V3,
cvssV2	StorageCVSSV2
cvssV3	StorageCVSSV3
publishedOn	Date		date-time
lastModified	Date		date-time
vulnerabilityType	EmbeddedVulnerabilityVulnerabilityType		UNKNOWN_VULNERABILITY、IMAGE_VULNERABILITY、K8S_VULNERABILITY、ISTIO_VULNERABILITY、NODE_VULNERABILITY、OPENSHIFT_VULNERABILITY、
vulnerabilityTypes	EmbeddedVulnerabilityVulnerabilityTypeのリスト
suppressed	Boolean
suppressActivation	Date		date-time
suppressExpiry	Date		date-time
firstSystemOccurrence	Date	CVE が初めて確認された時刻（この特定のディストリビューションに対して、システムに）。	date-time
firstImageOccurrence	Date	このイメージに CVE が最初に見られた時刻。	date-time
severity	StorageVulnerabilitySeverity		UNKNOWN_VULNERABILITY_SEVERITY, LOW_VULNERABILITY_SEVERITY, MODERATE_VULNERABILITY_SEVERITY, IMPORTANT_VULNERABILITY_SEVERITY, CRITICAL_VULNERABILITY_SEVERITY,
state	StorageVulnerabilityState		OBSERVED、DEFERRED、FALSE_POSITIVE、

40.1.7.26. StorageEmbeddedVulnerabilityScoreVersion

Enum 値
V2
V3

40.1.7.27. StorageNode

Node represents information about a node in the cluster. next available tag: 28

フィールド名	型	説明	形式
id	String	このノードを識別する一意の ID。
name	String	ノードの（ホスト）名。ID と同じでない場合があります。
taints	StorageTaintの一覧
clusterId	String
clusterName	String
labels	`文字列`のマップ
annotations	`文字列`のマップ
joinedAt	Date		date-time
internalIpAddresses	`string` のリスト
externalIpAddresses	`string` のリスト
containerRuntimeVersion	String
containerRuntime	StorageContainerRuntimeInfo
kernelVersion	String
operatingSystem	String	From NodeInfo.ノードによって報告されるオペレーティングシステム（例：linux）。
osImage	String	From NodeInfo./etc/os-release からノードで報告される OS イメージ。
kubeletVersion	String
kubeProxyVersion	String
lastUpdated	Date		date-time
k8sUpdated	Date	Kubernetes から更新を受け取った時間。	date-time
scan	StorageNodeScan
コンポーネント	Integer		int32
cves	Integer		int32
fixableCves	Integer		int32
priority	String		int64
riskScore	Float		float
topCvss	Float		float
notes	StorageNodeNoteのリスト

40.1.7.28. StorageNodeNote

Enum 値
MISSING_SCAN_DATA

40.1.7.29. StorageNodeScan

Next tag: 5

フィールド名	型	形式
scanTime	Date	date-time
operatingSystem	String
コンポーネント	StorageEmbeddedNodeScanComponentの一覧
notes	StorageNodeScanNoteのリスト

40.1.7.30. StorageNodeScanNote

Enum 値
UNSET
サポート対象外
KERNEL_UNSUPPORTED
CERTIFIED_RHEL_CVES_UNAVAILABLE

40.1.7.31. StorageNodeVulnerability

フィールド名	型	形式
cveBaseInfo	StorageCVEInfo
CVSS	Float	float
severity	StorageVulnerabilitySeverity	UNKNOWN_VULNERABILITY_SEVERITY, LOW_VULNERABILITY_SEVERITY, MODERATE_VULNERABILITY_SEVERITY, IMPORTANT_VULNERABILITY_SEVERITY, CRITICAL_VULNERABILITY_SEVERITY,
fixedBy	String
Snoozed	Boolean
snoozeStart	Date	date-time
snoozeExpiry	Date	date-time

40.1.7.32. StorageTaint

フィールド名	型	形式
key	String
value	String
taintEffect	StorageTaintEffect	UNKNOWN_TAINT_EFFECT, NO_SCHEDULE_TAINT_EFFECT, PREFER_NO_SCHEDULE_TAINT_EFFECT, NO_EXECUTE_TAINT_EFFECT,

40.1.7.33. StorageTaintEffect

Enum 値
UNKNOWN_TAINT_EFFECT
NO_SCHEDULE_TAINT_EFFECT
PREFER_NO_SCHEDULE_TAINT_EFFECT
NO_EXECUTE_TAINT_EFFECT

40.1.7.34. StorageVulnerabilitySeverity

Enum 値
UNKNOWN_VULNERABILITY_SEVERITY
LOW_VULNERABILITY_SEVERITY
MODERATE_VULNERABILITY_SEVERITY
IMPORTANT_VULNERABILITY_SEVERITY
CRITICAL_VULNERABILITY_SEVERITY

40.1.7.35. StorageVulnerabilityState

VulnerabilityState は、脆弱性が観察されているか、または遅延している(/suppressed)かどうかを示します。デフォルトでは、脆弱性は観察されます。

Enum 値
OBSERVED
DEFERRED
FALSE_POSITIVE

40.1.7.36. StreamResultOfV1ExportNodeResponse

Stream result of v1ExportNodeResponse

フィールド名	必須	Null 許容型	型	説明	形式
result			V1ExportNodeResponse
error			RuntimeStreamError

40.1.7.37. V1ExportNodeResponse

フィールド名	必須	Null 許容型	型	説明	形式
node			StorageNode

40.1. ExportNodes

40.1.1. 説明

40.1.2. パラメーター

40.1.2.1. クエリーパラメーター

40.1.3. 戻り値のタイプ

40.1.4. コンテンツタイプ

40.1.5. レスポンス

40.1.6. サンプル

40.1.7. 共通のオブジェクト参照