Next tag: 28
×
PutPolicy
PUT /v1/policies/{id}
PutPolicy 修改现有策略。
通用对象引用
GooglerpcStatus
| 字段名 | 必填 | 可为空 | 类型 | 描述 | 格式 |
|---|---|---|---|---|---|
code |
整数 |
int32 |
|||
message |
字符串 |
||||
details |
ProtobufAny 列表 |
PolicyServicePutPolicyBody
| 字段名 | 必填 | 可为空 | 类型 | 描述 | 格式 |
|---|---|---|---|---|---|
name |
字符串 |
策略名称。必须唯一。 |
|||
description |
字符串 |
此策略的自由格式文本描述。 |
|||
rationale |
字符串 |
||||
remediation |
字符串 |
描述如何修复此策略的违规行为。 |
|||
disabled |
布尔值 |
切换此策略是否执行并主动触发警报。 |
|||
categories |
|
此策略所属的类别列表。类别名称必须已存在于中心。 |
|||
lifecycleStages |
描述此策略适用的策略生命周期阶段。选项包括 DEPLOY、BUILD 和 RUNTIME。 |
||||
eventSource |
NOT_APPLICABLE, DEPLOYMENT_EVENT, AUDIT_LOG_EVENT, |
||||
exclusions |
定义应从此策略中排除的部署或镜像。 |
||||
scope |
StorageScope 列表 |
定义应包含在此策略中的集群、命名空间和部署。未定义范围表示包含所有内容。 |
|||
severity |
UNSET_SEVERITY, LOW_SEVERITY, MEDIUM_SEVERITY, HIGH_SEVERITY, CRITICAL_SEVERITY, |
||||
enforcementActions |
FAIL_DEPLOYMENT_CREATE_ENFORCEMENT 仅当准入控制 Webhook 配置为强制执行对象创建/更新时才生效。FAIL_KUBE_REQUEST_ENFORCEMENT 仅当启用准入控制 Webhook 以侦听 exec 和端口转发事件时才生效。FAIL_DEPLOYMENT_UPDATE_ENFORCEMENT 仅当准入控制 Webhook 配置为强制执行对象更新时才生效。列出当识别到此策略的违规行为时要采取的强制执行操作。可能的值包括 UNSET_ENFORCEMENT、SCALE_TO_ZERO_ENFORCEMENT、UNSATISFIABLE_NODE_CONSTRAINT_ENFORCEMENT、KILL_POD_ENFORCEMENT、FAIL_BUILD_ENFORCEMENT、FAIL_KUBE_REQUEST_ENFORCEMENT 和 FAIL_DEPLOYMENT_CREATE_ENFORCEMENT 以及 FAIL_DEPLOYMENT_UPDATE_ENFORCEMENT。 |
||||
notifiers |
|
应在识别到此策略的违规行为时触发的通知程序 ID 列表。ID 应为 UUID 格式，可通过中央 API 找到。 |
|||
lastUpdated |
日期 |
日期时间 |
|||
SORTName |
字符串 |
仅供内部使用。 |
|||
SORTLifecycleStage |
字符串 |
仅供内部使用。 |
|||
SORTEnforcement |
布尔值 |
仅供内部使用。 |
|||
policyVersion |
字符串 |
||||
policySections |
PolicySections 定义此策略的违规条件。 |
||||
mitreAttackVectors |
|||||
criteriaLocked |
布尔值 |
只读字段。如果为 true，则策略的条件字段将被设置为只读。 |
|||
mitreVectorsLocked |
布尔值 |
只读字段。如果为 true，则策略的 MITRE ATT&CK 字段将被设置为只读。 |
|||
isDefault |
布尔值 |
只读字段。如果为 true，则表示该策略是默认策略；如果为 false，则表示该策略是自定义策略。 |
|||
source |
IMPERATIVE，DECLARATIVE， |
ProtobufAny
Any 包含任意序列化的协议缓冲区消息以及描述序列化消息类型的 URL。
Protobuf 库提供支持，以实用程序函数或 Any 类型的附加生成方法的形式打包/解包 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，解包方法仅使用类型 URL 中最后一个“/”后的完全限定类型名称，例如“foo.bar.com/x/y.z”将产生类型名称“y.z”。
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 表示，则该表示将被嵌入，并添加一个字段value，该字段除了@type字段外还包含自定义 JSON。示例（对于消息[google.protobuf.Duration][]）
{
"@type": "type.googleapis.com/google.protobuf.Duration",
"value": "1.212s"
}
| 字段名 | 必填 | 可为空 | 类型 | 描述 | 格式 |
|---|---|---|---|---|---|
@type |
字符串 |
唯一标识序列化协议缓冲区消息类型的 URL/资源名称。此字符串必须包含至少一个“/”字符。URL 路径的最后一部分必须表示类型的完全限定名称（如 |
StorageEnforcementAction
-
FAIL_KUBE_REQUEST_ENFORCEMENT：仅当启用准入控制 Webhook 以侦听 exec 和端口转发事件时，FAIL_KUBE_REQUEST_ENFORCEMENT 才生效。
-
FAIL_DEPLOYMENT_CREATE_ENFORCEMENT：仅当准入控制 Webhook 配置为强制执行对象创建时，FAIL_DEPLOYMENT_CREATE_ENFORCEMENT 才生效。
-
FAIL_DEPLOYMENT_UPDATE_ENFORCEMENT：仅当准入控制 Webhook 配置为强制执行对象更新时，FAIL_DEPLOYMENT_UPDATE_ENFORCEMENT 才生效。
| 枚举值 |
|---|
UNSET_ENFORCEMENT |
SCALE_TO_ZERO_ENFORCEMENT |
UNSATISFIABLE_NODE_CONSTRAINT_ENFORCEMENT |
KILL_POD_ENFORCEMENT |
FAIL_BUILD_ENFORCEMENT |
FAIL_KUBE_REQUEST_ENFORCEMENT |
FAIL_DEPLOYMENT_CREATE_ENFORCEMENT |
FAIL_DEPLOYMENT_UPDATE_ENFORCEMENT |
StoragePolicyGroup
| 字段名 | 必填 | 可为空 | 类型 | 描述 | 格式 |
|---|---|---|---|---|---|
fieldName |
字符串 |
定义此 PolicyGroup 在部署或镜像上评估的字段。有关可能值的完整列表，请参阅http://docs.openshift.org.cn/acs/operating/manage-security-policies.html#policy-criteria_manage-security-policies。 |
|||
booleanOperator |
OR，AND， |
||||
negate |
布尔值 |
确定此 PolicyGroup 的评估是否被否定。默认为 false。 |
|||
values |