主页
产品
Red Hat Advanced Cluster Security for Kubernetes
4.7
API 参考
1.38. NetworkPolicyService

1.38. NetworkPolicyService

1.38.1. GetAllowedPeersFromCurrentPolicyForDeployment

GET /v1/networkpolicies/allowedpeers/{id}

1.38.1.1. 描述

1.38.1.2. 参数

1.38.1.2.1. 路径参数

Name	描述	必填	default	pattern
id		X	null

1.38.1.3. 返回类型

V1GetAllowedPeersFromCurrentPolicyForDeploymentResponse

1.38.1.4. 内容类型

application/json

1.38.1.5. 响应

表 1.175. HTTP 响应代码
代码	消息	datatype
200	成功响应。	V1GetAllowedPeersFromCurrentPolicyForDeploymentResponse
0	意外错误响应。	GooglerpcStatus

1.38.1.6. Samples

1.38.1.7. 常规对象参考

1.38.1.7.1. GooglerpcStatus

字段名称	类型	格式
code	整数	int32
message	字符串
详情	ProtobufAny列表

1.38.1.7.2. ProtobufAny

any 包含任意序列化协议缓冲区消息，以及一个描述序列化消息的类型的 URL。

protobuf 库以实用程序函数形式提供对 pack/unpack Any 值的支持，或者对 Any 类型的其他生成的方法提供其他生成的方法。

示例 1: Pack 并在 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，解包方法只使用类型 URL 中的完全限定类型名称，如 "foo.bar.com/x/x/y.z"。

1.38.1.7.2.1. JSON 表示

any 值的 JSON 表示使用反序列化的、嵌入式消息的常规表示，以及包含类型 URL 的附加字段 @type。Example:

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"
}

字段名称	必填	nullable	类型	描述	格式
@type			字符串	唯一标识序列化协议缓冲消息的 URL/资源名称。此字符串必须至少包含一个 \"/\" 字符。URL 路径的最后一部分必须代表类型的完全限定名称（如 `path/google.protobuf.Duration`）。名称应采用规范形式（例如，未接受前面的 \".\"）。在实践中，团队通常会预编译到期望其在任意上下文中使用的所有类型的二进制代码。但是，对于使用方案 `http`、`https` 或无方案的 URL，可以选择设置一个类型服务器，将类型 URL 映射到消息定义，如下所示：* 如果没有提供方案，则假设 `https`。* URL 上的 HTTP GET 必须以二进制格式生成一个 [google.protobuf.Type][] 值，或者产生错误。* 应用程序允许根据 URL 缓存查找结果，或者预先编译到二进制文件以避免出现任何查找。因此，为了更改类型，二进制兼容性需要保留。（使用版本控制类型名称来管理中断的更改。）注意：这个功能目前在官方 protobuf 版本中可用，它不用于以 type.googleapis.com 开头的类型 URL。自 2023 年 5 月起，没有广泛使用的类型服务器实施，没有计划实施。`http` 之外的方案（或空方案）可以与实施特定语义一起使用。

1.38.1.7.3. StorageL4Protocol

Enum 值
L4_PROTOCOL_UNKNOWN
L4_PROTOCOL_TCP
L4_PROTOCOL_UDP
L4_PROTOCOL_ICMP
L4_PROTOCOL_RAW
L4_PROTOCOL_SCTP
L4_PROTOCOL_ANY

1.38.1.7.4. StorageNetworkEntityInfoType

INTERNAL_ENTITIES：INTERNAL_ENTITIES 用于在单一网络图形节点下对所有内部实体进行分组

Enum 值
UNKNOWN_TYPE
部署
互联网
LISTEN_ENDPOINT
EXTERNAL_SOURCE
INTERNAL_ENTITIES

1.38.1.7.5. V1GetAllowedPeersFromCurrentPolicyForDeploymentResponse

字段名称	必填	nullable	类型	描述	格式
allowedPeers			V1NetworkBaselineStatusPeer列表

1.38.1.7.6. V1NetworkBaselinePeerEntity

字段名称	必填	nullable	类型	描述	格式
id			字符串
type			StorageNetworkEntityInfoType		UNKNOWN_TYPE, DEPLOYMENT, INTERNET, LISTEN_ENDPOINT, EXTERNAL_SOURCE, INTERNAL_ENTITIES,

1.38.1.7.7. V1NetworkBaselineStatusPeer

字段名称	类型	描述	格式
实体	V1NetworkBaselinePeerEntity
port	Long	给定连接目的地的端口和协议。	int64
protocol	StorageL4Protocol		L4_PROTOCOL_UNKNOWN, L4_PROTOCOL_TCP, L4_PROTOCOL_UDP, L4_PROTOCOL_ICMP, L4_PROTOCOL_RAW, L4_PROTOCOL_SCTP, L4_PROTOCOL_ANY,
ingress	布尔值	代表查询是否用于入口连接或出口连接的布尔值。这根据当前部署定义。因此： - 如果问题中的连接位于当前部署的 outEdges 中，这应该是 false。- 如果它处于对等部署的 outEdges 中，则这应为 true。

1.38.2. ApplyNetworkPolicy

POST /v1/networkpolicies/apply/{clusterId}

1.38.2.1. 描述

1.38.2.2. 参数

1.38.2.2.1. 路径参数

Name	描述	必填	default	pattern
clusterId		X	null

1.38.2.2.2. 正文参数

Name	描述	必填	default	pattern
修改	StorageNetworkPolicyModification	X

1.38.2.3. 返回类型

对象

1.38.2.4. 内容类型

application/json

1.38.2.5. 响应

表 1.176. HTTP 响应代码
代码	消息	datatype
200	成功响应。	`对象`
0	意外错误响应。	GooglerpcStatus

1.38.2.6. Samples

1.38.2.7. 常规对象参考

1.38.2.7.1. GooglerpcStatus

字段名称	类型	格式
code	整数	int32
message	字符串
详情	ProtobufAny列表

1.38.2.7.2. ProtobufAny

any 包含任意序列化协议缓冲区消息，以及一个描述序列化消息的类型的 URL。

protobuf 库以实用程序函数形式提供对 pack/unpack Any 值的支持，或者对 Any 类型的其他生成的方法提供其他生成的方法。

示例 1: Pack 并在 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 {
  ...
}

1.38.2.7.2.1. JSON 表示

any 值的 JSON 表示使用反序列化的、嵌入式消息的常规表示，以及包含类型 URL 的附加字段 @type。Example:

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

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

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

字段名称	必填	nullable	类型	描述	格式
@type			字符串	唯一标识序列化协议缓冲消息的 URL/资源名称。此字符串必须至少包含一个 \"/\" 字符。URL 路径的最后一部分必须代表类型的完全限定名称（如 `path/google.protobuf.Duration`）。名称应采用规范形式（例如，未接受前面的 \".\"）。在实践中，团队通常会预编译到期望其在任意上下文中使用的所有类型的二进制代码。但是，对于使用方案 `http`、`https` 或无方案的 URL，可以选择设置一个类型服务器，将类型 URL 映射到消息定义，如下所示：* 如果没有提供方案，则假设 `https`。* URL 上的 HTTP GET 必须以二进制格式生成一个 [google.protobuf.Type][] 值，或者产生错误。* 应用程序允许根据 URL 缓存查找结果，或者预先编译到二进制文件以避免出现任何查找。因此，为了更改类型，二进制兼容性需要保留。（使用版本控制类型名称来管理中断的更改。）注意：这个功能目前在官方 protobuf 版本中可用，它不用于以 type.googleapis.com 开头的类型 URL。自 2023 年 5 月起，没有广泛使用的类型服务器实施，没有计划实施。`http` 之外的方案（或空方案）可以与实施特定语义一起使用。

1.38.2.7.3. StorageNetworkPolicyModification

Next available tag: 3

字段名称	必填	nullable	类型	描述	格式
applyYaml			字符串
toDelete			StorageNetworkPolicyReference列表

1.38.2.7.4. StorageNetworkPolicyReference

Next available tag: 3

字段名称	必填	nullable	类型	描述	格式
namespace			字符串
name			字符串

1.38.3. ApplyNetworkPolicyYamlForDeployment

POST /v1/networkpolicies/apply/deployment/{deploymentId}

1.38.3.1. 描述

1.38.3.2. 参数

1.38.3.2.1. 路径参数

Name	描述	必填	default	pattern
deploymentId		X	null

1.38.3.2.2. 正文参数

Name	描述	必填	default	pattern
正文（body）	NetworkPolicyServiceApplyNetworkPolicyYamlForDeploymentBody	X

1.38.3.3. 返回类型

对象

1.38.3.4. 内容类型

application/json

1.38.3.5. 响应

表 1.177. HTTP 响应代码
代码	消息	datatype
200	成功响应。	`对象`
0	意外错误响应。	GooglerpcStatus

1.38.3.6. Samples

1.38.3.7. 常规对象参考

1.38.3.7.1. GooglerpcStatus

字段名称	类型	格式
code	整数	int32
message	字符串
详情	ProtobufAny列表

1.38.3.7.2. NetworkPolicyServiceApplyNetworkPolicyYamlForDeploymentBody

字段名称	必填	nullable	类型	描述	格式
修改			StorageNetworkPolicyModification

1.38.3.7.3. ProtobufAny

any 包含任意序列化协议缓冲区消息，以及一个描述序列化消息的类型的 URL。

protobuf 库以实用程序函数形式提供对 pack/unpack Any 值的支持，或者对 Any 类型的其他生成的方法提供其他生成的方法。

示例 1: Pack 并在 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 {
  ...
}

1.38.3.7.3.1. JSON 表示

any 值的 JSON 表示使用反序列化的、嵌入式消息的常规表示，以及包含类型 URL 的附加字段 @type。Example:

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

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

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

字段名称	必填	nullable	类型	描述	格式
@type			字符串	唯一标识序列化协议缓冲消息的 URL/资源名称。此字符串必须至少包含一个 \"/\" 字符。URL 路径的最后一部分必须代表类型的完全限定名称（如 `path/google.protobuf.Duration`）。名称应采用规范形式（例如，未接受前面的 \".\"）。在实践中，团队通常会预编译到期望其在任意上下文中使用的所有类型的二进制代码。但是，对于使用方案 `http`、`https` 或无方案的 URL，可以选择设置一个类型服务器，将类型 URL 映射到消息定义，如下所示：* 如果没有提供方案，则假设 `https`。* URL 上的 HTTP GET 必须以二进制格式生成一个 [google.protobuf.Type][] 值，或者产生错误。* 应用程序允许根据 URL 缓存查找结果，或者预先编译到二进制文件以避免出现任何查找。因此，为了更改类型，二进制兼容性需要保留。（使用版本控制类型名称来管理中断的更改。）注意：这个功能目前在官方 protobuf 版本中可用，它不用于以 type.googleapis.com 开头的类型 URL。自 2023 年 5 月起，没有广泛使用的类型服务器实施，没有计划实施。`http` 之外的方案（或空方案）可以与实施特定语义一起使用。

1.38.3.7.4. StorageNetworkPolicyModification

Next available tag: 3

字段名称	必填	nullable	类型	描述	格式
applyYaml			字符串
toDelete			StorageNetworkPolicyReference列表

1.38.3.7.5. StorageNetworkPolicyReference

Next available tag: 3

字段名称	必填	nullable	类型	描述	格式
namespace			字符串
name			字符串

1.38.4. GetDiffFlowsBetweenPolicyAndBaselineForDeployment

GET /v1/networkpolicies/baselinecomparison/{id}

1.38.4.1. 描述

1.38.4.2. 参数

1.38.4.2.1. 路径参数

Name	描述	必填	default	pattern
id		X	null

1.38.4.3. 返回类型

V1GetDiffFlowsResponse

1.38.4.4. 内容类型

application/json

1.38.4.5. 响应

表 1.178. HTTP 响应代码
代码	消息	datatype
200	成功响应。	V1GetDiffFlowsResponse
0	意外错误响应。	GooglerpcStatus

1.38.4.6. Samples

1.38.4.7. 常规对象参考

1.38.4.7.1. DeploymentListenPort

字段名称	必填	nullable	类型	描述	格式
port			Long		int64
l4protocol			StorageL4Protocol		L4_PROTOCOL_UNKNOWN, L4_PROTOCOL_TCP, L4_PROTOCOL_UDP, L4_PROTOCOL_ICMP, L4_PROTOCOL_RAW, L4_PROTOCOL_SCTP, L4_PROTOCOL_ANY,

1.38.4.7.2. GooglerpcStatus

字段名称	类型	格式
code	整数	int32
message	字符串
详情	ProtobufAny列表

1.38.4.7.3. NetworkEntityInfoExternalSource

每当更新此消息时，更新 central/networkgraph/aggregator/aggregator.go 中的 normalizeDupNameExtSrcs (…)。

字段名称	类型	描述
name	字符串
cidr	字符串
default	布尔值	`default` 指示外部源是用户生成的还是系统生成的。
Discoveredd	布尔值	`Discovered` d 表示外部源是否来自受监控的流量。

1.38.4.7.4. ProtobufAny

any 包含任意序列化协议缓冲区消息，以及一个描述序列化消息的类型的 URL。

protobuf 库以实用程序函数形式提供对 pack/unpack Any 值的支持，或者对 Any 类型的其他生成的方法提供其他生成的方法。

示例 1: Pack 并在 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 {
  ...
}

1.38.4.7.4.1. JSON 表示

any 值的 JSON 表示使用反序列化的、嵌入式消息的常规表示，以及包含类型 URL 的附加字段 @type。Example:

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

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

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

字段名称	必填	nullable	类型	描述	格式
@type			字符串	唯一标识序列化协议缓冲消息的 URL/资源名称。此字符串必须至少包含一个 \"/\" 字符。URL 路径的最后一部分必须代表类型的完全限定名称（如 `path/google.protobuf.Duration`）。名称应采用规范形式（例如，未接受前面的 \".\"）。在实践中，团队通常会预编译到期望其在任意上下文中使用的所有类型的二进制代码。但是，对于使用方案 `http`、`https` 或无方案的 URL，可以选择设置一个类型服务器，将类型 URL 映射到消息定义，如下所示：* 如果没有提供方案，则假设 `https`。* URL 上的 HTTP GET 必须以二进制格式生成一个 [google.protobuf.Type][] 值，或者产生错误。* 应用程序允许根据 URL 缓存查找结果，或者预先编译到二进制文件以避免出现任何查找。因此，为了更改类型，二进制兼容性需要保留。（使用版本控制类型名称来管理中断的更改。）注意：这个功能目前在官方 protobuf 版本中可用，它不用于以 type.googleapis.com 开头的类型 URL。自 2023 年 5 月起，没有广泛使用的类型服务器实施，没有计划实施。`http` 之外的方案（或空方案）可以与实施特定语义一起使用。

1.38.4.7.5. StorageL4Protocol

Enum 值
L4_PROTOCOL_UNKNOWN
L4_PROTOCOL_TCP
L4_PROTOCOL_UDP
L4_PROTOCOL_ICMP
L4_PROTOCOL_RAW
L4_PROTOCOL_SCTP
L4_PROTOCOL_ANY

1.38.4.7.6. StorageNetworkBaselineConnectionProperties

NetworkBaselineConnectionProperties represents information about a baseline connection next available tag: 4

字段名称	类型	格式
ingress	布尔值
port	Long	int64
protocol	StorageL4Protocol	L4_PROTOCOL_UNKNOWN, L4_PROTOCOL_TCP, L4_PROTOCOL_UDP, L4_PROTOCOL_ICMP, L4_PROTOCOL_RAW, L4_PROTOCOL_SCTP, L4_PROTOCOL_ANY,

1.38.4.7.7. StorageNetworkEntityInfo

字段名称	类型	格式
type	StorageNetworkEntityInfoType	UNKNOWN_TYPE, DEPLOYMENT, INTERNET, LISTEN_ENDPOINT, EXTERNAL_SOURCE, INTERNAL_ENTITIES,
id	字符串
部署	StorageNetworkEntityInfoDeployment
externalSource	NetworkEntityInfoExternalSource

1.38.4.7.8. StorageNetworkEntityInfoDeployment

字段名称	必填	nullable	类型	描述	格式
name			字符串
namespace			字符串
cluster			字符串
listenPorts			DeploymentListenPort列表

1.38.4.7.9. StorageNetworkEntityInfoType

INTERNAL_ENTITIES：INTERNAL_ENTITIES 用于在单一网络图形节点下对所有内部实体进行分组

Enum 值
UNKNOWN_TYPE
部署
互联网
LISTEN_ENDPOINT
EXTERNAL_SOURCE
INTERNAL_ENTITIES

1.38.4.7.10. V1GetDiffFlowsGroupedFlow

字段名称	必填	nullable	类型	描述	格式
实体			StorageNetworkEntityInfo
属性			StorageNetworkBaselineConnectionProperties列表

1.38.4.7.11. V1GetDiffFlowsReconciledFlow

字段名称	必填	nullable	类型	描述	格式
实体			StorageNetworkEntityInfo
已添加			StorageNetworkBaselineConnectionProperties列表
删除			StorageNetworkBaselineConnectionProperties列表
Unchanged			StorageNetworkBaselineConnectionProperties列表

1.38.4.7.12. V1GetDiffFlowsResponse

字段名称	必填	nullable	类型	描述	格式
已添加			V1GetDiffFlowsGroupedFlow列表
删除			V1GetDiffFlowsGroupedFlow列表
协调			V1GetDiffFlowsReconciledFlow列表

1.38.5. GetNetworkGraph

GET /v1/networkpolicies/cluster/{clusterId}

1.38.5.1. 描述

1.38.5.2. 参数

1.38.5.2.1. 路径参数

Name	描述	必填	default	pattern
clusterId		X	null

1.38.5.2.2. 查询参数

Name	描述	必填	default
query		-	null
includePorts	如果设置为 true，请在网络策略图中包含端口级别信息。	-	null
scope.query		-	null

1.38.5.3. 返回类型

V1NetworkGraph

1.38.5.4. 内容类型

application/json

1.38.5.5. 响应

表 1.179. HTTP 响应代码
代码	消息	datatype
200	成功响应。	V1NetworkGraph
0	意外错误响应。	GooglerpcStatus

1.38.5.6. Samples

1.38.5.7. 常规对象参考

1.38.5.7.1. DeploymentListenPort

字段名称	必填	nullable	类型	描述	格式
port			Long		int64
l4protocol			StorageL4Protocol		L4_PROTOCOL_UNKNOWN, L4_PROTOCOL_TCP, L4_PROTOCOL_UDP, L4_PROTOCOL_ICMP, L4_PROTOCOL_RAW, L4_PROTOCOL_SCTP, L4_PROTOCOL_ANY,

1.38.5.7.2. GooglerpcStatus

字段名称	类型	格式
code	整数	int32
message	字符串
详情	ProtobufAny列表

1.38.5.7.3. NetworkEntityInfoExternalSource

每当更新此消息时，更新 central/networkgraph/aggregator/aggregator.go 中的 normalizeDupNameExtSrcs (…)。

字段名称	类型	描述
name	字符串
cidr	字符串
default	布尔值	`default` 指示外部源是用户生成的还是系统生成的。
Discoveredd	布尔值	`Discovered` d 表示外部源是否来自受监控的流量。

1.38.5.7.4. ProtobufAny

any 包含任意序列化协议缓冲区消息，以及一个描述序列化消息的类型的 URL。

protobuf 库以实用程序函数形式提供对 pack/unpack Any 值的支持，或者对 Any 类型的其他生成的方法提供其他生成的方法。

示例 1: Pack 并在 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 {
  ...
}

1.38.5.7.4.1. JSON 表示

any 值的 JSON 表示使用反序列化的、嵌入式消息的常规表示，以及包含类型 URL 的附加字段 @type。Example:

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

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

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

字段名称	必填	nullable	类型	描述	格式
@type			字符串	唯一标识序列化协议缓冲消息的 URL/资源名称。此字符串必须至少包含一个 \"/\" 字符。URL 路径的最后一部分必须代表类型的完全限定名称（如 `path/google.protobuf.Duration`）。名称应采用规范形式（例如，未接受前面的 \".\"）。在实践中，团队通常会预编译到期望其在任意上下文中使用的所有类型的二进制代码。但是，对于使用方案 `http`、`https` 或无方案的 URL，可以选择设置一个类型服务器，将类型 URL 映射到消息定义，如下所示：* 如果没有提供方案，则假设 `https`。* URL 上的 HTTP GET 必须以二进制格式生成一个 [google.protobuf.Type][] 值，或者产生错误。* 应用程序允许根据 URL 缓存查找结果，或者预先编译到二进制文件以避免出现任何查找。因此，为了更改类型，二进制兼容性需要保留。（使用版本控制类型名称来管理中断的更改。）注意：这个功能目前在官方 protobuf 版本中可用，它不用于以 type.googleapis.com 开头的类型 URL。自 2023 年 5 月起，没有广泛使用的类型服务器实施，没有计划实施。`http` 之外的方案（或空方案）可以与实施特定语义一起使用。

1.38.5.7.5. StorageL4Protocol

Enum 值
L4_PROTOCOL_UNKNOWN
L4_PROTOCOL_TCP
L4_PROTOCOL_UDP
L4_PROTOCOL_ICMP
L4_PROTOCOL_RAW
L4_PROTOCOL_SCTP
L4_PROTOCOL_ANY

1.38.5.7.6. StorageNetworkEntityInfo

字段名称	类型	格式
type	StorageNetworkEntityInfoType	UNKNOWN_TYPE, DEPLOYMENT, INTERNET, LISTEN_ENDPOINT, EXTERNAL_SOURCE, INTERNAL_ENTITIES,
id	字符串
部署	StorageNetworkEntityInfoDeployment
externalSource	NetworkEntityInfoExternalSource

1.38.5.7.7. StorageNetworkEntityInfoDeployment

字段名称	必填	nullable	类型	描述	格式
name			字符串
namespace			字符串
cluster			字符串
listenPorts			DeploymentListenPort列表

1.38.5.7.8. StorageNetworkEntityInfoType

INTERNAL_ENTITIES：INTERNAL_ENTITIES 用于在单一网络图形节点下对所有内部实体进行分组

Enum 值
UNKNOWN_TYPE
部署
互联网
LISTEN_ENDPOINT
EXTERNAL_SOURCE
INTERNAL_ENTITIES

1.38.5.7.9. V1NetworkEdgeProperties

字段名称	类型	格式
port	Long	int64
protocol	StorageL4Protocol	L4_PROTOCOL_UNKNOWN, L4_PROTOCOL_TCP, L4_PROTOCOL_UDP, L4_PROTOCOL_ICMP, L4_PROTOCOL_RAW, L4_PROTOCOL_SCTP, L4_PROTOCOL_ANY,
lastActiveTimestamp	Date	date-time

1.38.5.7.10. V1NetworkEdgePropertiesBundle

字段名称	必填	nullable	类型	描述	格式
属性			V1NetworkEdgeProperties列表

1.38.5.7.11. V1NetworkGraph

字段名称	必填	nullable	类型	描述	格式
epoch			Long		int64
节点			V1NetworkNode列表

1.38.5.7.12. V1NetworkNode

字段名称	必填	nullable	类型	描述	格式
实体			StorageNetworkEntityInfo
internetAccess			布尔值
policyIds			`字符串列表`
nonIsolatedIngress			布尔值
nonIsolatedEgress			布尔值
queryMatch			布尔值
outEdges			V1NetworkEdgePropertiesBundle的映射

1.38.6. GetBaselineGeneratedNetworkPolicyForDeployment

POST /v1/networkpolicies/generate/baseline/{deploymentId}

1.38.6.1. 描述

1.38.6.2. 参数

1.38.6.2.1. 路径参数

Name	描述	必填	default	pattern
deploymentId		X	null

1.38.6.2.2. 正文参数

Name	描述	必填	default	pattern
正文（body）	NetworkPolicyServiceGetBaselineGeneratedNetworkPolicyForDeploymentBody	X

1.38.6.3. 返回类型

V1GetBaselineGeneratedPolicyForDeploymentResponse

1.38.6.4. 内容类型

application/json

1.38.6.5. 响应

表 1.180. HTTP 响应代码
代码	消息	datatype
200	成功响应。	V1GetBaselineGeneratedPolicyForDeploymentResponse
0	意外错误响应。	GooglerpcStatus

1.38.6.6. Samples

1.38.6.7. 常规对象参考

1.38.6.7.1. GenerateNetworkPoliciesRequestDeleteExistingPoliciesMode

NONE ：不删除任何现有网络策略。
GENERATED_ONLY ：删除任何现有 自动生成的 网络策略。
ALL ：删除对应命名空间中的所有现有网络策略。

Enum 值
UNKNOWN
NONE
GENERATED_ONLY
ALL

1.38.6.7.2. GooglerpcStatus

字段名称	类型	格式
code	整数	int32
message	字符串
详情	ProtobufAny列表

1.38.6.7.3. NetworkPolicyServiceGetBaselineGeneratedNetworkPolicyForDeploymentBody

字段名称	必填	nullable	类型	描述	格式
deleteExisting			GenerateNetworkPoliciesRequestDeleteExistingPoliciesMode		UNKNOWN, NONE, GENERATED_ONLY, ALL,
includePorts			布尔值

1.38.6.7.4. ProtobufAny

any 包含任意序列化协议缓冲区消息，以及一个描述序列化消息的类型的 URL。

protobuf 库以实用程序函数形式提供对 pack/unpack Any 值的支持，或者对 Any 类型的其他生成的方法提供其他生成的方法。

示例 1: Pack 并在 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 {
  ...
}

1.38.6.7.4.1. JSON 表示

any 值的 JSON 表示使用反序列化的、嵌入式消息的常规表示，以及包含类型 URL 的附加字段 @type。Example:

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

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

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

字段名称	必填	nullable	类型	描述	格式
@type			字符串	唯一标识序列化协议缓冲消息的 URL/资源名称。此字符串必须至少包含一个 \"/\" 字符。URL 路径的最后一部分必须代表类型的完全限定名称（如 `path/google.protobuf.Duration`）。名称应采用规范形式（例如，未接受前面的 \".\"）。在实践中，团队通常会预编译到期望其在任意上下文中使用的所有类型的二进制代码。但是，对于使用方案 `http`、`https` 或无方案的 URL，可以选择设置一个类型服务器，将类型 URL 映射到消息定义，如下所示：* 如果没有提供方案，则假设 `https`。* URL 上的 HTTP GET 必须以二进制格式生成一个 [google.protobuf.Type][] 值，或者产生错误。* 应用程序允许根据 URL 缓存查找结果，或者预先编译到二进制文件以避免出现任何查找。因此，为了更改类型，二进制兼容性需要保留。（使用版本控制类型名称来管理中断的更改。）注意：这个功能目前在官方 protobuf 版本中可用，它不用于以 type.googleapis.com 开头的类型 URL。自 2023 年 5 月起，没有广泛使用的类型服务器实施，没有计划实施。`http` 之外的方案（或空方案）可以与实施特定语义一起使用。

1.38.6.7.5. StorageNetworkPolicyModification

Next available tag: 3

字段名称	必填	nullable	类型	描述	格式
applyYaml			字符串
toDelete			StorageNetworkPolicyReference列表

1.38.6.7.6. StorageNetworkPolicyReference

Next available tag: 3

字段名称	必填	nullable	类型	描述	格式
namespace			字符串
name			字符串

1.38.6.7.7. V1GetBaselineGeneratedPolicyForDeploymentResponse

字段名称	必填	nullable	类型	描述	格式
修改			StorageNetworkPolicyModification

1.38.7. GenerateNetworkPolicies

GET /v1/networkpolicies/generate/{clusterId}

1.38.7.1. 描述

1.38.7.2. 参数

1.38.7.2.1. 路径参数

Name	描述	必填	default	pattern
clusterId		X	null

1.38.7.2.2. 查询参数

Name	描述	必填	default
query		-	null
deleteExisting	- NONE: 不删除任何现有网络策略。- GENERATED_ONLY: 删除任何现有自动生成的网络策略。- ALL：删除对应命名空间中的所有网络策略。	-	UNKNOWN
networkDataSince		-	null
includePorts		-	null

1.38.7.3. 返回类型

V1GenerateNetworkPoliciesResponse

1.38.7.4. 内容类型

application/json

1.38.7.5. 响应

表 1.181. HTTP 响应代码
代码	消息	datatype
200	成功响应。	V1GenerateNetworkPoliciesResponse
0	意外错误响应。	GooglerpcStatus

1.38.7.6. Samples

1.38.7.7. 常规对象参考

1.38.7.7.1. GooglerpcStatus

字段名称	类型	格式
code	整数	int32
message	字符串
详情	ProtobufAny列表

1.38.7.7.2. ProtobufAny

any 包含任意序列化协议缓冲区消息，以及一个描述序列化消息的类型的 URL。

protobuf 库以实用程序函数形式提供对 pack/unpack Any 值的支持，或者对 Any 类型的其他生成的方法提供其他生成的方法。

示例 1: Pack 并在 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 {
  ...
}

1.38.7.7.2.1. JSON 表示

any 值的 JSON 表示使用反序列化的、嵌入式消息的常规表示，以及包含类型 URL 的附加字段 @type。Example:

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

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

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

字段名称	必填	nullable	类型	描述	格式
@type			字符串	唯一标识序列化协议缓冲消息的 URL/资源名称。此字符串必须至少包含一个 \"/\" 字符。URL 路径的最后一部分必须代表类型的完全限定名称（如 `path/google.protobuf.Duration`）。名称应采用规范形式（例如，未接受前面的 \".\"）。在实践中，团队通常会预编译到期望其在任意上下文中使用的所有类型的二进制代码。但是，对于使用方案 `http`、`https` 或无方案的 URL，可以选择设置一个类型服务器，将类型 URL 映射到消息定义，如下所示：* 如果没有提供方案，则假设 `https`。* URL 上的 HTTP GET 必须以二进制格式生成一个 [google.protobuf.Type][] 值，或者产生错误。* 应用程序允许根据 URL 缓存查找结果，或者预先编译到二进制文件以避免出现任何查找。因此，为了更改类型，二进制兼容性需要保留。（使用版本控制类型名称来管理中断的更改。）注意：这个功能目前在官方 protobuf 版本中可用，它不用于以 type.googleapis.com 开头的类型 URL。自 2023 年 5 月起，没有广泛使用的类型服务器实施，没有计划实施。`http` 之外的方案（或空方案）可以与实施特定语义一起使用。

1.38.7.7.3. StorageNetworkPolicyModification

Next available tag: 3

字段名称	必填	nullable	类型	描述	格式
applyYaml			字符串
toDelete			StorageNetworkPolicyReference列表

1.38.7.7.4. StorageNetworkPolicyReference

Next available tag: 3

字段名称	必填	nullable	类型	描述	格式
namespace			字符串
name			字符串

1.38.7.7.5. V1GenerateNetworkPoliciesResponse

Next available tag: 2

字段名称	必填	nullable	类型	描述	格式
修改			StorageNetworkPolicyModification

1.38.8. GetNetworkPolicies

GET /v1/networkpolicies

1.38.8.1. 描述

1.38.8.2. 参数

1.38.8.2.1. 查询参数

Name	必填	default
clusterId	-	null
deploymentQuery	-	null
namespace	-	null

1.38.8.3. 返回类型

V1NetworkPoliciesResponse

1.38.8.4. 内容类型

application/json

1.38.8.5. 响应

表 1.182. HTTP 响应代码
代码	消息	datatype
200	成功响应。	V1NetworkPoliciesResponse
0	意外错误响应。	GooglerpcStatus

1.38.8.6. Samples

1.38.8.7. 常规对象参考

1.38.8.7.1. GooglerpcStatus

字段名称	类型	格式
code	整数	int32
message	字符串
详情	ProtobufAny列表

1.38.8.7.2. ProtobufAny

any 包含任意序列化协议缓冲区消息，以及一个描述序列化消息的类型的 URL。

protobuf 库以实用程序函数形式提供对 pack/unpack Any 值的支持，或者对 Any 类型的其他生成的方法提供其他生成的方法。

示例 1: Pack 并在 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 {
  ...
}

1.38.8.7.2.1. JSON 表示

any 值的 JSON 表示使用反序列化的、嵌入式消息的常规表示，以及包含类型 URL 的附加字段 @type。Example:

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

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

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

字段名称	必填	nullable	类型	描述	格式
@type			字符串	唯一标识序列化协议缓冲消息的 URL/资源名称。此字符串必须至少包含一个 \"/\" 字符。URL 路径的最后一部分必须代表类型的完全限定名称（如 `path/google.protobuf.Duration`）。名称应采用规范形式（例如，未接受前面的 \".\"）。在实践中，团队通常会预编译到期望其在任意上下文中使用的所有类型的二进制代码。但是，对于使用方案 `http`、`https` 或无方案的 URL，可以选择设置一个类型服务器，将类型 URL 映射到消息定义，如下所示：* 如果没有提供方案，则假设 `https`。* URL 上的 HTTP GET 必须以二进制格式生成一个 [google.protobuf.Type][] 值，或者产生错误。* 应用程序允许根据 URL 缓存查找结果，或者预先编译到二进制文件以避免出现任何查找。因此，为了更改类型，二进制兼容性需要保留。（使用版本控制类型名称来管理中断的更改。）注意：这个功能目前在官方 protobuf 版本中可用，它不用于以 type.googleapis.com 开头的类型 URL。自 2023 年 5 月起，没有广泛使用的类型服务器实施，没有计划实施。`http` 之外的方案（或空方案）可以与实施特定语义一起使用。

1.38.8.7.3. StorageIPBlock

字段名称	必填	nullable	类型	描述	格式
cidr			字符串
例外			`字符串列表`

1.38.8.7.4. StorageLabelSelector

Label selector components are joined with logical AND, see     https://kubernetes.io/docs/concepts/overview/working-with-objects/labels/

下一个可用标签：3

字段名称	必填	nullable	类型	描述	格式
matchLabels			`字符串`映射	这实际上是一个，但由于向后兼容性限制，我们不能使其成为一种。
要求			StorageLabelSelectorRequirement列表

1.38.8.7.5. StorageLabelSelectorOperator

Enum 值
UNKNOWN
IN
NOT_IN
EXISTS
NOT_EXISTS

1.38.8.7.6. StorageLabelSelectorRequirement

Next available tag: 4

字段名称	类型	格式
key	字符串
op	StorageLabelSelectorOperator	UNKNOWN, IN, NOT_IN, EXISTS, NOT_EXISTS,
values	`字符串列表`

1.38.8.7.7. StorageNetworkPolicy

字段名称	类型	格式
id	字符串
name	字符串
clusterId	字符串
clusterName	字符串
namespace	字符串
labels	`字符串`映射
annotations	`字符串`映射
spec	StorageNetworkPolicySpec
yaml	字符串
apiVersion	字符串
created	Date	date-time

1.38.8.7.8. StorageNetworkPolicyEgressRule

字段名称	必填	nullable	类型	描述	格式
ports			StorageNetworkPolicyPort列表
至			StorageNetworkPolicyPeer列表

1.38.8.7.9. StorageNetworkPolicyIngressRule

字段名称	必填	nullable	类型	描述	格式
ports			StorageNetworkPolicyPort列表
from			StorageNetworkPolicyPeer列表

1.38.8.7.10. StorageNetworkPolicyPeer

字段名称	必填	nullable	类型	描述	格式
podSelector			StorageLabelSelector
namespaceSelector			StorageLabelSelector
ipBlock			StorageIPBlock

1.38.8.7.11. StorageNetworkPolicyPort

字段名称	类型	格式
protocol	StorageProtocol	UNSET_PROTOCOL, TCP_PROTOCOL, UDP_PROTOCOL, SCTP_PROTOCOL,
port	整数	int32
portName	字符串

1.38.8.7.12. StorageNetworkPolicySpec

字段名称	必填	nullable	类型	描述	格式
podSelector			StorageLabelSelector
ingress			StorageNetworkPolicyIngressRule列表
egress			StorageNetworkPolicyEgressRule列表
policyTypes			StorageNetworkPolicyType列表

1.38.8.7.13. StorageNetworkPolicyType

Enum 值
UNSET_NETWORK_POLICY_TYPE
INGRESS_NETWORK_POLICY_TYPE
EGRESS_NETWORK_POLICY_TYPE

1.38.8.7.14. StorageProtocol

Enum 值
UNSET_PROTOCOL
TCP_PROTOCOL
UDP_PROTOCOL
SCTP_PROTOCOL

1.38.8.7.15. V1NetworkPoliciesResponse

字段名称	必填	nullable	类型	描述	格式
networkPolicies			StorageNetworkPolicy列表

1.38.9. GetNetworkGraphEpoch

GET /v1/networkpolicies/graph/epoch

1.38.9.1. 描述

1.38.9.2. 参数

1.38.9.2.1. 查询参数

Name	描述	必填	default	pattern
clusterId		-	null

1.38.9.3. 返回类型

V1NetworkGraphEpoch

1.38.9.4. 内容类型

application/json

1.38.9.5. 响应

表 1.183. HTTP 响应代码
代码	消息	datatype
200	成功响应。	V1NetworkGraphEpoch
0	意外错误响应。	GooglerpcStatus

1.38.9.6. Samples

1.38.9.7. 常规对象参考

1.38.9.7.1. GooglerpcStatus

字段名称	类型	格式
code	整数	int32
message	字符串
详情	ProtobufAny列表

1.38.9.7.2. ProtobufAny

any 包含任意序列化协议缓冲区消息，以及一个描述序列化消息的类型的 URL。

protobuf 库以实用程序函数形式提供对 pack/unpack Any 值的支持，或者对 Any 类型的其他生成的方法提供其他生成的方法。

示例 1: Pack 并在 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 {
  ...
}

1.38.9.7.2.1. JSON 表示

any 值的 JSON 表示使用反序列化的、嵌入式消息的常规表示，以及包含类型 URL 的附加字段 @type。Example:

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

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

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

字段名称	必填	nullable	类型	描述	格式
@type			字符串	唯一标识序列化协议缓冲消息的 URL/资源名称。此字符串必须至少包含一个 \"/\" 字符。URL 路径的最后一部分必须代表类型的完全限定名称（如 `path/google.protobuf.Duration`）。名称应采用规范形式（例如，未接受前面的 \".\"）。在实践中，团队通常会预编译到期望其在任意上下文中使用的所有类型的二进制代码。但是，对于使用方案 `http`、`https` 或无方案的 URL，可以选择设置一个类型服务器，将类型 URL 映射到消息定义，如下所示：* 如果没有提供方案，则假设 `https`。* URL 上的 HTTP GET 必须以二进制格式生成一个 [google.protobuf.Type][] 值，或者产生错误。* 应用程序允许根据 URL 缓存查找结果，或者预先编译到二进制文件以避免出现任何查找。因此，为了更改类型，二进制兼容性需要保留。（使用版本控制类型名称来管理中断的更改。）注意：这个功能目前在官方 protobuf 版本中可用，它不用于以 type.googleapis.com 开头的类型 URL。自 2023 年 5 月起，没有广泛使用的类型服务器实施，没有计划实施。`http` 之外的方案（或空方案）可以与实施特定语义一起使用。

1.38.9.7.3. V1NetworkGraphEpoch

字段名称	必填	nullable	类型	描述	格式
epoch			Long		int64

1.38.10. GetNetworkPolicy

GET /v1/networkpolicies/{id}

1.38.10.1. 描述

1.38.10.2. 参数

1.38.10.2.1. 路径参数

Name	描述	必填	default	pattern
id		X	null

1.38.10.3. 返回类型

StorageNetworkPolicy

1.38.10.4. 内容类型

application/json

1.38.10.5. 响应

表 1.184. HTTP 响应代码
代码	消息	datatype
200	成功响应。	StorageNetworkPolicy
0	意外错误响应。	GooglerpcStatus

1.38.10.6. Samples

1.38.10.7. 常规对象参考

1.38.10.7.1. GooglerpcStatus

字段名称	类型	格式
code	整数	int32
message	字符串
详情	ProtobufAny列表

1.38.10.7.2. ProtobufAny

any 包含任意序列化协议缓冲区消息，以及一个描述序列化消息的类型的 URL。

protobuf 库以实用程序函数形式提供对 pack/unpack Any 值的支持，或者对 Any 类型的其他生成的方法提供其他生成的方法。

示例 1: Pack 并在 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 {
  ...
}

1.38.10.7.2.1. JSON 表示

any 值的 JSON 表示使用反序列化的、嵌入式消息的常规表示，以及包含类型 URL 的附加字段 @type。Example:

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

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

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

字段名称	必填	nullable	类型	描述	格式
@type			字符串	唯一标识序列化协议缓冲消息的 URL/资源名称。此字符串必须至少包含一个 \"/\" 字符。URL 路径的最后一部分必须代表类型的完全限定名称（如 `path/google.protobuf.Duration`）。名称应采用规范形式（例如，未接受前面的 \".\"）。在实践中，团队通常会预编译到期望其在任意上下文中使用的所有类型的二进制代码。但是，对于使用方案 `http`、`https` 或无方案的 URL，可以选择设置一个类型服务器，将类型 URL 映射到消息定义，如下所示：* 如果没有提供方案，则假设 `https`。* URL 上的 HTTP GET 必须以二进制格式生成一个 [google.protobuf.Type][] 值，或者产生错误。* 应用程序允许根据 URL 缓存查找结果，或者预先编译到二进制文件以避免出现任何查找。因此，为了更改类型，二进制兼容性需要保留。（使用版本控制类型名称来管理中断的更改。）注意：这个功能目前在官方 protobuf 版本中可用，它不用于以 type.googleapis.com 开头的类型 URL。自 2023 年 5 月起，没有广泛使用的类型服务器实施，没有计划实施。`http` 之外的方案（或空方案）可以与实施特定语义一起使用。

1.38.10.7.3. StorageIPBlock

字段名称	必填	nullable	类型	描述	格式
cidr			字符串
例外			`字符串列表`

1.38.10.7.4. StorageLabelSelector

Label selector components are joined with logical AND, see     https://kubernetes.io/docs/concepts/overview/working-with-objects/labels/

下一个可用标签：3

字段名称	必填	nullable	类型	描述	格式
matchLabels			`字符串`映射	这实际上是一个，但由于向后兼容性限制，我们不能使其成为一种。
要求			StorageLabelSelectorRequirement列表

1.38.10.7.5. StorageLabelSelectorOperator

Enum 值
UNKNOWN
IN
NOT_IN
EXISTS
NOT_EXISTS

1.38.10.7.6. StorageLabelSelectorRequirement

Next available tag: 4

字段名称	类型	格式
key	字符串
op	StorageLabelSelectorOperator	UNKNOWN, IN, NOT_IN, EXISTS, NOT_EXISTS,
values	`字符串列表`

1.38.10.7.7. StorageNetworkPolicy

字段名称	类型	格式
id	字符串
name	字符串
clusterId	字符串
clusterName	字符串
namespace	字符串
labels	`字符串`映射
annotations	`字符串`映射
spec	StorageNetworkPolicySpec
yaml	字符串
apiVersion	字符串
created	Date	date-time

1.38.10.7.8. StorageNetworkPolicyEgressRule

字段名称	必填	nullable	类型	描述	格式
ports			StorageNetworkPolicyPort列表
至			StorageNetworkPolicyPeer列表

1.38.10.7.9. StorageNetworkPolicyIngressRule

字段名称	必填	nullable	类型	描述	格式
ports			StorageNetworkPolicyPort列表
from			StorageNetworkPolicyPeer列表

1.38.10.7.10. StorageNetworkPolicyPeer

字段名称	必填	nullable	类型	描述	格式
podSelector			StorageLabelSelector
namespaceSelector			StorageLabelSelector
ipBlock			StorageIPBlock

1.38.10.7.11. StorageNetworkPolicyPort

字段名称	类型	格式
protocol	StorageProtocol	UNSET_PROTOCOL, TCP_PROTOCOL, UDP_PROTOCOL, SCTP_PROTOCOL,
port	整数	int32
portName	字符串

1.38.10.7.12. StorageNetworkPolicySpec

字段名称	必填	nullable	类型	描述	格式
podSelector			StorageLabelSelector
ingress			StorageNetworkPolicyIngressRule列表
egress			StorageNetworkPolicyEgressRule列表
policyTypes			StorageNetworkPolicyType列表

1.38.10.7.13. StorageNetworkPolicyType

Enum 值
UNSET_NETWORK_POLICY_TYPE
INGRESS_NETWORK_POLICY_TYPE
EGRESS_NETWORK_POLICY_TYPE

1.38.10.7.14. StorageProtocol

Enum 值
UNSET_PROTOCOL
TCP_PROTOCOL
UDP_PROTOCOL
SCTP_PROTOCOL

1.38.11. SendNetworkPolicyYAML

POST /v1/networkpolicies/simulate/{clusterId}/notify

1.38.11.1. 描述

1.38.11.2. 参数

1.38.11.2.1. 路径参数

Name	描述	必填	default	pattern
clusterId		X	null

1.38.11.2.2. 正文参数

Name	描述	必填	default	pattern
修改	StorageNetworkPolicyModification	X

1.38.11.2.3. 查询参数

Name	描述	必填	default	pattern
notifierIds	`字符串`	-	null

1.38.11.3. 返回类型

对象

1.38.11.4. 内容类型

application/json

1.38.11.5. 响应

表 1.185. HTTP 响应代码
代码	消息	datatype
200	成功响应。	`对象`
0	意外错误响应。	GooglerpcStatus

1.38.11.6. Samples

1.38.11.7. 常规对象参考

1.38.11.7.1. GooglerpcStatus

字段名称	类型	格式
code	整数	int32
message	字符串
详情	ProtobufAny列表

1.38.11.7.2. ProtobufAny

any 包含任意序列化协议缓冲区消息，以及一个描述序列化消息的类型的 URL。

protobuf 库以实用程序函数形式提供对 pack/unpack Any 值的支持，或者对 Any 类型的其他生成的方法提供其他生成的方法。

示例 1: Pack 并在 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 {
  ...
}

1.38.11.7.2.1. JSON 表示

any 值的 JSON 表示使用反序列化的、嵌入式消息的常规表示，以及包含类型 URL 的附加字段 @type。Example:

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

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

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

字段名称	必填	nullable	类型	描述	格式
@type			字符串	唯一标识序列化协议缓冲消息的 URL/资源名称。此字符串必须至少包含一个 \"/\" 字符。URL 路径的最后一部分必须代表类型的完全限定名称（如 `path/google.protobuf.Duration`）。名称应采用规范形式（例如，未接受前面的 \".\"）。在实践中，团队通常会预编译到期望其在任意上下文中使用的所有类型的二进制代码。但是，对于使用方案 `http`、`https` 或无方案的 URL，可以选择设置一个类型服务器，将类型 URL 映射到消息定义，如下所示：* 如果没有提供方案，则假设 `https`。* URL 上的 HTTP GET 必须以二进制格式生成一个 [google.protobuf.Type][] 值，或者产生错误。* 应用程序允许根据 URL 缓存查找结果，或者预先编译到二进制文件以避免出现任何查找。因此，为了更改类型，二进制兼容性需要保留。（使用版本控制类型名称来管理中断的更改。）注意：这个功能目前在官方 protobuf 版本中可用，它不用于以 type.googleapis.com 开头的类型 URL。自 2023 年 5 月起，没有广泛使用的类型服务器实施，没有计划实施。`http` 之外的方案（或空方案）可以与实施特定语义一起使用。

1.38.11.7.3. StorageNetworkPolicyModification

Next available tag: 3

字段名称	必填	nullable	类型	描述	格式
applyYaml			字符串
toDelete			StorageNetworkPolicyReference列表

1.38.11.7.4. StorageNetworkPolicyReference

Next available tag: 3

字段名称	必填	nullable	类型	描述	格式
namespace			字符串
name			字符串

1.38.12. SimulateNetworkGraph

POST /v1/networkpolicies/simulate/{clusterId}

1.38.12.1. 描述

1.38.12.2. 参数

1.38.12.2.1. 路径参数

Name	描述	必填	default	pattern
clusterId		X	null

1.38.12.2.2. 正文参数

Name	描述	必填	default	pattern
修改	StorageNetworkPolicyModification	X

1.38.12.2.3. 查询参数

Name	描述	必填	default
query		-	null
includePorts	如果设置为 true，请在网络策略图中包含端口级别信息。	-	null
includeNodeDiff		-	null
scope.query		-	null

1.38.12.3. 返回类型

V1SimulateNetworkGraphResponse

1.38.12.4. 内容类型

application/json

1.38.12.5. 响应

表 1.186. HTTP 响应代码
代码	消息	datatype
200	成功响应。	V1SimulateNetworkGraphResponse
0	意外错误响应。	GooglerpcStatus

1.38.12.6. Samples

1.38.12.7. 常规对象参考

1.38.12.7.1. DeploymentListenPort

字段名称	必填	nullable	类型	描述	格式
port			Long		int64
l4protocol			StorageL4Protocol		L4_PROTOCOL_UNKNOWN, L4_PROTOCOL_TCP, L4_PROTOCOL_UDP, L4_PROTOCOL_ICMP, L4_PROTOCOL_RAW, L4_PROTOCOL_SCTP, L4_PROTOCOL_ANY,

1.38.12.7.2. GooglerpcStatus

字段名称	类型	格式
code	整数	int32
message	字符串
详情	ProtobufAny列表

1.38.12.7.3. NetworkEntityInfoExternalSource

每当更新此消息时，更新 central/networkgraph/aggregator/aggregator.go 中的 normalizeDupNameExtSrcs (…)。

字段名称	类型	描述
name	字符串
cidr	字符串
default	布尔值	`default` 指示外部源是用户生成的还是系统生成的。
Discoveredd	布尔值	`Discovered` d 表示外部源是否来自受监控的流量。

1.38.12.7.4. ProtobufAny

any 包含任意序列化协议缓冲区消息，以及一个描述序列化消息的类型的 URL。

protobuf 库以实用程序函数形式提供对 pack/unpack Any 值的支持，或者对 Any 类型的其他生成的方法提供其他生成的方法。

示例 1: Pack 并在 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 {
  ...
}

1.38.12.7.4.1. JSON 表示

any 值的 JSON 表示使用反序列化的、嵌入式消息的常规表示，以及包含类型 URL 的附加字段 @type。Example:

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

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

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

字段名称	必填	nullable	类型	描述	格式
@type			字符串	唯一标识序列化协议缓冲消息的 URL/资源名称。此字符串必须至少包含一个 \"/\" 字符。URL 路径的最后一部分必须代表类型的完全限定名称（如 `path/google.protobuf.Duration`）。名称应采用规范形式（例如，未接受前面的 \".\"）。在实践中，团队通常会预编译到期望其在任意上下文中使用的所有类型的二进制代码。但是，对于使用方案 `http`、`https` 或无方案的 URL，可以选择设置一个类型服务器，将类型 URL 映射到消息定义，如下所示：* 如果没有提供方案，则假设 `https`。* URL 上的 HTTP GET 必须以二进制格式生成一个 [google.protobuf.Type][] 值，或者产生错误。* 应用程序允许根据 URL 缓存查找结果，或者预先编译到二进制文件以避免出现任何查找。因此，为了更改类型，二进制兼容性需要保留。（使用版本控制类型名称来管理中断的更改。）注意：这个功能目前在官方 protobuf 版本中可用，它不用于以 type.googleapis.com 开头的类型 URL。自 2023 年 5 月起，没有广泛使用的类型服务器实施，没有计划实施。`http` 之外的方案（或空方案）可以与实施特定语义一起使用。

1.38.12.7.5. StorageIPBlock

字段名称	必填	nullable	类型	描述	格式
cidr			字符串
例外			`字符串列表`

1.38.12.7.6. StorageL4Protocol

Enum 值
L4_PROTOCOL_UNKNOWN
L4_PROTOCOL_TCP
L4_PROTOCOL_UDP
L4_PROTOCOL_ICMP
L4_PROTOCOL_RAW
L4_PROTOCOL_SCTP
L4_PROTOCOL_ANY

1.38.12.7.7. StorageLabelSelector

Label selector components are joined with logical AND, see     https://kubernetes.io/docs/concepts/overview/working-with-objects/labels/

下一个可用标签：3

字段名称	必填	nullable	类型	描述	格式
matchLabels			`字符串`映射	这实际上是一个，但由于向后兼容性限制，我们不能使其成为一种。
要求			StorageLabelSelectorRequirement列表

1.38.12.7.8. StorageLabelSelectorOperator

Enum 值
UNKNOWN
IN
NOT_IN
EXISTS
NOT_EXISTS

1.38.12.7.9. StorageLabelSelectorRequirement

Next available tag: 4

字段名称	类型	格式
key	字符串
op	StorageLabelSelectorOperator	UNKNOWN, IN, NOT_IN, EXISTS, NOT_EXISTS,
values	`字符串列表`

1.38.12.7.10. StorageNetworkEntityInfo

字段名称	类型	格式
type	StorageNetworkEntityInfoType	UNKNOWN_TYPE, DEPLOYMENT, INTERNET, LISTEN_ENDPOINT, EXTERNAL_SOURCE, INTERNAL_ENTITIES,
id	字符串
部署	StorageNetworkEntityInfoDeployment
externalSource	NetworkEntityInfoExternalSource

1.38.12.7.11. StorageNetworkEntityInfoDeployment

字段名称	必填	nullable	类型	描述	格式
name			字符串
namespace			字符串
cluster			字符串
listenPorts			DeploymentListenPort列表

1.38.12.7.12. StorageNetworkEntityInfoType

INTERNAL_ENTITIES：INTERNAL_ENTITIES 用于在单一网络图形节点下对所有内部实体进行分组

Enum 值
UNKNOWN_TYPE
部署
互联网
LISTEN_ENDPOINT
EXTERNAL_SOURCE
INTERNAL_ENTITIES

1.38.12.7.13. StorageNetworkPolicy

字段名称	类型	格式
id	字符串
name	字符串
clusterId	字符串
clusterName	字符串
namespace	字符串
labels	`字符串`映射
annotations	`字符串`映射
spec	StorageNetworkPolicySpec
yaml	字符串
apiVersion	字符串
created	Date	date-time

1.38.12.7.14. StorageNetworkPolicyEgressRule

字段名称	必填	nullable	类型	描述	格式
ports			StorageNetworkPolicyPort列表
至			StorageNetworkPolicyPeer列表

1.38.12.7.15. StorageNetworkPolicyIngressRule

字段名称	必填	nullable	类型	描述	格式
ports			StorageNetworkPolicyPort列表
from			StorageNetworkPolicyPeer列表

1.38.12.7.16. StorageNetworkPolicyModification

Next available tag: 3

字段名称	必填	nullable	类型	描述	格式
applyYaml			字符串
toDelete			StorageNetworkPolicyReference列表

1.38.12.7.17. StorageNetworkPolicyPeer

字段名称	必填	nullable	类型	描述	格式
podSelector			StorageLabelSelector
namespaceSelector			StorageLabelSelector
ipBlock			StorageIPBlock

1.38.12.7.18. StorageNetworkPolicyPort

字段名称	类型	格式
protocol	StorageProtocol	UNSET_PROTOCOL, TCP_PROTOCOL, UDP_PROTOCOL, SCTP_PROTOCOL,
port	整数	int32
portName	字符串

1.38.12.7.19. StorageNetworkPolicyReference

Next available tag: 3

字段名称	必填	nullable	类型	描述	格式
namespace			字符串
name			字符串

1.38.12.7.20. StorageNetworkPolicySpec

字段名称	必填	nullable	类型	描述	格式
podSelector			StorageLabelSelector
ingress			StorageNetworkPolicyIngressRule列表
egress			StorageNetworkPolicyEgressRule列表
policyTypes			StorageNetworkPolicyType列表

1.38.12.7.21. StorageNetworkPolicyType

Enum 值
UNSET_NETWORK_POLICY_TYPE
INGRESS_NETWORK_POLICY_TYPE
EGRESS_NETWORK_POLICY_TYPE

1.38.12.7.22. StorageProtocol

Enum 值
UNSET_PROTOCOL
TCP_PROTOCOL
UDP_PROTOCOL
SCTP_PROTOCOL

1.38.12.7.23. V1NetworkEdgeProperties

字段名称	类型	格式
port	Long	int64
protocol	StorageL4Protocol	L4_PROTOCOL_UNKNOWN, L4_PROTOCOL_TCP, L4_PROTOCOL_UDP, L4_PROTOCOL_ICMP, L4_PROTOCOL_RAW, L4_PROTOCOL_SCTP, L4_PROTOCOL_ANY,
lastActiveTimestamp	Date	date-time

1.38.12.7.24. V1NetworkEdgePropertiesBundle

字段名称	必填	nullable	类型	描述	格式
属性			V1NetworkEdgeProperties列表

1.38.12.7.25. V1NetworkGraph

字段名称	必填	nullable	类型	描述	格式
epoch			Long		int64
节点			V1NetworkNode列表

1.38.12.7.26. V1NetworkGraphDiff

字段名称	必填	nullable	类型	描述	格式
DEPRECATEDNodeDiffs			V1NetworkNodeDiff的映射
nodeDiffs			V1NetworkNodeDiff的映射

1.38.12.7.27. V1NetworkNode

字段名称	必填	nullable	类型	描述	格式
实体			StorageNetworkEntityInfo
internetAccess			布尔值
policyIds			`字符串列表`
nonIsolatedIngress			布尔值
nonIsolatedEgress			布尔值
queryMatch			布尔值
outEdges			V1NetworkEdgePropertiesBundle的映射

1.38.12.7.28. V1NetworkNodeDiff

字段名称	必填	nullable	类型	描述	格式
policyIds			`字符串列表`
DEPRECATEDOutEdges			V1NetworkEdgePropertiesBundle的映射
outEdges			V1NetworkEdgePropertiesBundle的映射
nonIsolatedIngress			布尔值
nonIsolatedEgress			布尔值

1.38.12.7.29. V1NetworkPolicyInSimulation

字段名称	类型	格式
policy	StorageNetworkPolicy
status	V1NetworkPolicyInSimulationStatus	无效的、未更改、修改、添加、删除、
oldPolicy	StorageNetworkPolicy

1.38.12.7.30. V1NetworkPolicyInSimulationStatus

Enum 值
无效
UNCHANGED
修改
ADDED
已删除

1.38.12.7.31. V1SimulateNetworkGraphResponse

字段名称	必填	nullable	类型	描述	格式
simulatedGraph			V1NetworkGraph
policies			V1NetworkPolicyInSimulation列表
已添加			V1NetworkGraphDiff
删除			V1NetworkGraphDiff

1.38.13. GetDiffFlowsFromUndoModificationForDeployment

GET /v1/networkpolicies/undobaselinecomparison/{id}

1.38.13.1. 描述

1.38.13.2. 参数

1.38.13.2.1. 路径参数

Name	描述	必填	default	pattern
id		X	null

1.38.13.3. 返回类型

V1GetDiffFlowsResponse

1.38.13.4. 内容类型

application/json

1.38.13.5. 响应

表 1.187. HTTP 响应代码
代码	消息	datatype
200	成功响应。	V1GetDiffFlowsResponse
0	意外错误响应。	GooglerpcStatus

1.38.13.6. Samples

1.38.13.7. 常规对象参考

1.38.13.7.1. DeploymentListenPort

字段名称	必填	nullable	类型	描述	格式
port			Long		int64
l4protocol			StorageL4Protocol		L4_PROTOCOL_UNKNOWN, L4_PROTOCOL_TCP, L4_PROTOCOL_UDP, L4_PROTOCOL_ICMP, L4_PROTOCOL_RAW, L4_PROTOCOL_SCTP, L4_PROTOCOL_ANY,

1.38.13.7.2. GooglerpcStatus

字段名称	类型	格式
code	整数	int32
message	字符串
详情	ProtobufAny列表

1.38.13.7.3. NetworkEntityInfoExternalSource

每当更新此消息时，更新 central/networkgraph/aggregator/aggregator.go 中的 normalizeDupNameExtSrcs (…)。

字段名称	类型	描述
name	字符串
cidr	字符串
default	布尔值	`default` 指示外部源是用户生成的还是系统生成的。
Discoveredd	布尔值	`Discovered` d 表示外部源是否来自受监控的流量。

1.38.13.7.4. ProtobufAny

any 包含任意序列化协议缓冲区消息，以及一个描述序列化消息的类型的 URL。

protobuf 库以实用程序函数形式提供对 pack/unpack Any 值的支持，或者对 Any 类型的其他生成的方法提供其他生成的方法。

示例 1: Pack 并在 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 {
  ...
}

1.38.13.7.4.1. JSON 表示

any 值的 JSON 表示使用反序列化的、嵌入式消息的常规表示，以及包含类型 URL 的附加字段 @type。Example:

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

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

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

字段名称	必填	nullable	类型	描述	格式
@type			字符串	唯一标识序列化协议缓冲消息的 URL/资源名称。此字符串必须至少包含一个 \"/\" 字符。URL 路径的最后一部分必须代表类型的完全限定名称（如 `path/google.protobuf.Duration`）。名称应采用规范形式（例如，未接受前面的 \".\"）。在实践中，团队通常会预编译到期望其在任意上下文中使用的所有类型的二进制代码。但是，对于使用方案 `http`、`https` 或无方案的 URL，可以选择设置一个类型服务器，将类型 URL 映射到消息定义，如下所示：* 如果没有提供方案，则假设 `https`。* URL 上的 HTTP GET 必须以二进制格式生成一个 [google.protobuf.Type][] 值，或者产生错误。* 应用程序允许根据 URL 缓存查找结果，或者预先编译到二进制文件以避免出现任何查找。因此，为了更改类型，二进制兼容性需要保留。（使用版本控制类型名称来管理中断的更改。）注意：这个功能目前在官方 protobuf 版本中可用，它不用于以 type.googleapis.com 开头的类型 URL。自 2023 年 5 月起，没有广泛使用的类型服务器实施，没有计划实施。`http` 之外的方案（或空方案）可以与实施特定语义一起使用。

1.38.13.7.5. StorageL4Protocol

Enum 值
L4_PROTOCOL_UNKNOWN
L4_PROTOCOL_TCP
L4_PROTOCOL_UDP
L4_PROTOCOL_ICMP
L4_PROTOCOL_RAW
L4_PROTOCOL_SCTP
L4_PROTOCOL_ANY

1.38.13.7.6. StorageNetworkBaselineConnectionProperties

NetworkBaselineConnectionProperties represents information about a baseline connection next available tag: 4

字段名称	类型	格式
ingress	布尔值
port	Long	int64
protocol	StorageL4Protocol	L4_PROTOCOL_UNKNOWN, L4_PROTOCOL_TCP, L4_PROTOCOL_UDP, L4_PROTOCOL_ICMP, L4_PROTOCOL_RAW, L4_PROTOCOL_SCTP, L4_PROTOCOL_ANY,

1.38.13.7.7. StorageNetworkEntityInfo

字段名称	类型	格式
type	StorageNetworkEntityInfoType	UNKNOWN_TYPE, DEPLOYMENT, INTERNET, LISTEN_ENDPOINT, EXTERNAL_SOURCE, INTERNAL_ENTITIES,
id	字符串
部署	StorageNetworkEntityInfoDeployment
externalSource	NetworkEntityInfoExternalSource

1.38.13.7.8. StorageNetworkEntityInfoDeployment

字段名称	必填	nullable	类型	描述	格式
name			字符串
namespace			字符串
cluster			字符串
listenPorts			DeploymentListenPort列表

1.38.13.7.9. StorageNetworkEntityInfoType

INTERNAL_ENTITIES：INTERNAL_ENTITIES 用于在单一网络图形节点下对所有内部实体进行分组

Enum 值
UNKNOWN_TYPE
部署
互联网
LISTEN_ENDPOINT
EXTERNAL_SOURCE
INTERNAL_ENTITIES

1.38.13.7.10. V1GetDiffFlowsGroupedFlow

字段名称	必填	nullable	类型	描述	格式
实体			StorageNetworkEntityInfo
属性			StorageNetworkBaselineConnectionProperties列表

1.38.13.7.11. V1GetDiffFlowsReconciledFlow

字段名称	必填	nullable	类型	描述	格式
实体			StorageNetworkEntityInfo
已添加			StorageNetworkBaselineConnectionProperties列表
删除			StorageNetworkBaselineConnectionProperties列表
Unchanged			StorageNetworkBaselineConnectionProperties列表

1.38.13.7.12. V1GetDiffFlowsResponse

字段名称	必填	nullable	类型	描述	格式
已添加			V1GetDiffFlowsGroupedFlow列表
删除			V1GetDiffFlowsGroupedFlow列表
协调			V1GetDiffFlowsReconciledFlow列表

1.38.14. GetUndoModification

GET /v1/networkpolicies/undo/{clusterId}

1.38.14.1. 描述

1.38.14.2. 参数

1.38.14.2.1. 路径参数

Name	描述	必填	default	pattern
clusterId		X	null

1.38.14.3. 返回类型

V1GetUndoModificationResponse

1.38.14.4. 内容类型

application/json

1.38.14.5. 响应

表 1.188. HTTP 响应代码
代码	消息	datatype
200	成功响应。	V1GetUndoModificationResponse
0	意外错误响应。	GooglerpcStatus

1.38.14.6. Samples

1.38.14.7. 常规对象参考

1.38.14.7.1. GooglerpcStatus

字段名称	类型	格式
code	整数	int32
message	字符串
详情	ProtobufAny列表

1.38.14.7.2. ProtobufAny

any 包含任意序列化协议缓冲区消息，以及一个描述序列化消息的类型的 URL。

protobuf 库以实用程序函数形式提供对 pack/unpack Any 值的支持，或者对 Any 类型的其他生成的方法提供其他生成的方法。

示例 1: Pack 并在 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 {
  ...
}

1.38.14.7.2.1. JSON 表示

any 值的 JSON 表示使用反序列化的、嵌入式消息的常规表示，以及包含类型 URL 的附加字段 @type。Example:

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

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

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

字段名称	必填	nullable	类型	描述	格式
@type			字符串	唯一标识序列化协议缓冲消息的 URL/资源名称。此字符串必须至少包含一个 \"/\" 字符。URL 路径的最后一部分必须代表类型的完全限定名称（如 `path/google.protobuf.Duration`）。名称应采用规范形式（例如，未接受前面的 \".\"）。在实践中，团队通常会预编译到期望其在任意上下文中使用的所有类型的二进制代码。但是，对于使用方案 `http`、`https` 或无方案的 URL，可以选择设置一个类型服务器，将类型 URL 映射到消息定义，如下所示：* 如果没有提供方案，则假设 `https`。* URL 上的 HTTP GET 必须以二进制格式生成一个 [google.protobuf.Type][] 值，或者产生错误。* 应用程序允许根据 URL 缓存查找结果，或者预先编译到二进制文件以避免出现任何查找。因此，为了更改类型，二进制兼容性需要保留。（使用版本控制类型名称来管理中断的更改。）注意：这个功能目前在官方 protobuf 版本中可用，它不用于以 type.googleapis.com 开头的类型 URL。自 2023 年 5 月起，没有广泛使用的类型服务器实施，没有计划实施。`http` 之外的方案（或空方案）可以与实施特定语义一起使用。

1.38.14.7.3. StorageNetworkPolicyApplicationUndoRecord

字段名称	类型	格式
clusterId	字符串
user	字符串
applyTimestamp	Date	date-time
originalModification	StorageNetworkPolicyModification
undoModification	StorageNetworkPolicyModification

1.38.14.7.4. StorageNetworkPolicyModification

Next available tag: 3

字段名称	必填	nullable	类型	描述	格式
applyYaml			字符串
toDelete			StorageNetworkPolicyReference列表

1.38.14.7.5. StorageNetworkPolicyReference

Next available tag: 3

字段名称	必填	nullable	类型	描述	格式
namespace			字符串
name			字符串

1.38.14.7.6. V1GetUndoModificationResponse

字段名称	必填	nullable	类型	描述	格式
undoRecord			StorageNetworkPolicyApplicationUndoRecord

1.38.15. GetUndoModificationForDeployment

GET /v1/networkpolicies/undo/deployment/{id}

1.38.15.1. 描述

1.38.15.2. 参数

1.38.15.2.1. 路径参数

Name	描述	必填	default	pattern
id		X	null

1.38.15.3. 返回类型

V1GetUndoModificationForDeploymentResponse

1.38.15.4. 内容类型

application/json

1.38.15.5. 响应

表 1.189. HTTP 响应代码
代码	消息	datatype
200	成功响应。	V1GetUndoModificationForDeploymentResponse
0	意外错误响应。	GooglerpcStatus

1.38.15.6. Samples

1.38.15.7. 常规对象参考

1.38.15.7.1. GooglerpcStatus

字段名称	类型	格式
code	整数	int32
message	字符串
详情	ProtobufAny列表

1.38.15.7.2. ProtobufAny

any 包含任意序列化协议缓冲区消息，以及一个描述序列化消息的类型的 URL。

protobuf 库以实用程序函数形式提供对 pack/unpack Any 值的支持，或者对 Any 类型的其他生成的方法提供其他生成的方法。

示例 1: Pack 并在 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 {
  ...
}

1.38.15.7.2.1. JSON 表示

any 值的 JSON 表示使用反序列化的、嵌入式消息的常规表示，以及包含类型 URL 的附加字段 @type。Example:

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

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

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

字段名称	必填	nullable	类型	描述	格式
@type			字符串	唯一标识序列化协议缓冲消息的 URL/资源名称。此字符串必须至少包含一个 \"/\" 字符。URL 路径的最后一部分必须代表类型的完全限定名称（如 `path/google.protobuf.Duration`）。名称应采用规范形式（例如，未接受前面的 \".\"）。在实践中，团队通常会预编译到期望其在任意上下文中使用的所有类型的二进制代码。但是，对于使用方案 `http`、`https` 或无方案的 URL，可以选择设置一个类型服务器，将类型 URL 映射到消息定义，如下所示：* 如果没有提供方案，则假设 `https`。* URL 上的 HTTP GET 必须以二进制格式生成一个 [google.protobuf.Type][] 值，或者产生错误。* 应用程序允许根据 URL 缓存查找结果，或者预先编译到二进制文件以避免出现任何查找。因此，为了更改类型，二进制兼容性需要保留。（使用版本控制类型名称来管理中断的更改。）注意：这个功能目前在官方 protobuf 版本中可用，它不用于以 type.googleapis.com 开头的类型 URL。自 2023 年 5 月起，没有广泛使用的类型服务器实施，没有计划实施。`http` 之外的方案（或空方案）可以与实施特定语义一起使用。

1.38.15.7.3. StorageNetworkPolicyApplicationUndoRecord

字段名称	类型	格式
clusterId	字符串
user	字符串
applyTimestamp	Date	date-time
originalModification	StorageNetworkPolicyModification
undoModification	StorageNetworkPolicyModification

1.38.15.7.4. StorageNetworkPolicyModification

Next available tag: 3

字段名称	必填	nullable	类型	描述	格式
applyYaml			字符串
toDelete			StorageNetworkPolicyReference列表

1.38.15.7.5. StorageNetworkPolicyReference

Next available tag: 3

字段名称	必填	nullable	类型	描述	格式
namespace			字符串
name			字符串

1.38.15.7.6. V1GetUndoModificationForDeploymentResponse

字段名称	必填	nullable	类型	描述	格式
undoRecord			StorageNetworkPolicyApplicationUndoRecord

返回顶部