PutImageIntegration - ImageIntegrationService | API 参考 | Red Hat Advanced Cluster Security for Kubernetes 4.6

PUT /v1/imageintegrations/{id}

PutImageIntegration 修改给定的镜像集成，无需使用存储的凭证协调。

描述 (Description)

参数 (Parameters)

路径参数 (Path Parameters)

名称 (Name)	描述 (Description)	必填 (Required)	默认值 (Default)	模式 (Pattern)
id		是 (X)	空 (null)

名称 (Name)

描述 (Description)

必填 (Required)

默认值 (Default)

模式 (Pattern)

是 (X)

空 (null)

主体参数 (Body Parameter)

名称 (Name)	描述 (Description)	必填 (Required)	默认值 (Default)	模式 (Pattern)
body	ImageIntegrationServicePutImageIntegrationBody	是 (X)

名称 (Name)

描述 (Description)

必填 (Required)

默认值 (Default)

模式 (Pattern)

body

ImageIntegrationServicePutImageIntegrationBody

是 (X)

返回类型 (Return Type)

对象 (Object)

内容类型 (Content Type)

application/json

响应 (Responses)

表 1. HTTP 响应代码 (Table 1. HTTP Response Codes)
代码 (Code)	消息 (Message)	数据类型 (Datatype)
200	成功的响应。(A successful response.)	`对象 (Object)`
0	意外的错误响应。(An unexpected error response.)	GooglerpcStatus

示例 (Samples)

常用对象引用 (Common object reference)

ECRConfigAuthorizationData

授权数据表示 IAM 身份验证凭据，可用于访问 IAM 主体有权访问的任何 Amazon ECR 注册表。(An authorization data represents the IAM authentication credentials and can be used to access any Amazon ECR registry that the IAM principal has access to.)

字段名称 (Field Name)

必填 (Required)

可为空 (Nullable)

类型 (Type)

描述 (Description)

格式 (Format)

用户名 (username)

字符串 (String)

密码 (password)

字符串 (String)

过期时间 (expiresAt)

日期 (Date)

日期时间 (date-time)

GooglerpcStatus

字段名称 (Field Name)

必填 (Required)

可为空 (Nullable)

类型 (Type)

描述 (Description)

格式 (Format)

代码 (code)

整数 (Integer)

int32

消息 (message)

字符串 (String)

详情 (details)

ProtobufAny 列表 (ProtobufAny list)

ImageIntegrationServicePutImageIntegrationBody

Next Tag: 25

字段名称 (Field Name)

必填 (Required)

可为空 (Nullable)

类型 (Type)

描述 (Description)

格式 (Format)

名称 (name)

字符串 (String)

类型 (type)

字符串 (String)

类别

清单 StorageImageIntegrationCategory

clairify

StorageClairifyConfig

scannerV4

StorageScannerV4Config

docker

quay

ecr

google

clair

clairV4

ibm

StorageIBMRegistryConfig

azure

StorageAzureConfig

自动生成

布尔值

集群ID

字符串 (String)

跳过测试集成

布尔值

来源

StorageImageIntegrationSource

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

字段名称 (Field Name) 必填 (Required) 可为空 (Nullable) 类型 (Type) 描述 (Description) 格式 (Format)

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

@type

字符串 (String)

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

QuayConfigRobotAccount

Robot account is Quay's named tokens that can be granted permissions on multiple repositories under an organization. It's Quay's recommended authentication model when possible (i.e. registry integration)

字段名称 (Field Name)

必填 (Required)

可为空 (Nullable)

类型 (Type)

描述 (Description)

格式 (Format)

用户名 (username)

字符串 (String)

密码 (password)

字符串 (String)

服务器将在响应和日志中屏蔽此密码的值。

StorageAzureConfig

字段名称 (Field Name)

必填 (Required)

可为空 (Nullable)

类型 (Type)

描述 (Description)

格式 (Format)

端点

字符串 (String)

用户名 (username)

字符串 (String)

密码 (password)

字符串 (String)

集成的密码。服务器将在响应和日志中屏蔽此凭据的值。

wifEnabled

布尔值

StorageClairConfig

字段名称 (Field Name)

必填 (Required)

可为空 (Nullable)

类型 (Type)

描述 (Description)

格式 (Format)

端点

字符串 (String)

不安全

布尔值

StorageClairV4Config

字段名称 (Field Name)

必填 (Required)

可为空 (Nullable)

类型 (Type)

描述 (Description)

格式 (Format)

端点

字符串 (String)

不安全

布尔值

StorageClairifyConfig

字段名称 (Field Name)

必填 (Required)

可为空 (Nullable)

类型 (Type)

描述 (Description)

格式 (Format)

端点

字符串 (String)

grpc端点

字符串 (String)

并发扫描数

整数 (Integer)

int32

StorageDockerConfig

字段名称 (Field Name)

必填 (Required)

可为空 (Nullable)

类型 (Type)

描述 (Description)

格式 (Format)

端点

字符串 (String)

用户名 (username)

字符串 (String)

密码 (password)

字符串 (String)

集成的密码。服务器将在响应和日志中屏蔽此凭据的值。

不安全

布尔值

StorageECRConfig

字段名称 (Field Name)

必填 (Required)

可为空 (Nullable)

类型 (Type)

描述 (Description)

格式 (Format)

注册表ID

字符串 (String)

访问密钥ID

字符串 (String)

集成的访问密钥ID。服务器将在响应和日志中屏蔽此凭据的值。

秘密访问密钥

字符串 (String)

集成的秘密访问密钥。服务器将在响应和日志中屏蔽此凭据的值。

区域

字符串 (String)

使用IAM

布尔值

端点

字符串 (String)

使用AssumeRole

布尔值

AssumeRole ID

字符串 (String)

AssumeRole外部ID

字符串 (String)

授权数据

ECRConfigAuthorizationData

StorageGoogleConfig

字段名称 (Field Name)

必填 (Required)

可为空 (Nullable)

类型 (Type)

描述 (Description)

格式 (Format)

端点

字符串 (String)

服务账户

字符串 (String)

集成的服务账户。服务器将在响应和日志中屏蔽此凭据的值。

项目

字符串 (String)

wifEnabled

布尔值

StorageIBMRegistryConfig

字段名称 (Field Name)

必填 (Required)

可为空 (Nullable)

类型 (Type)

描述 (Description)

格式 (Format)

端点

字符串 (String)

API密钥

字符串 (String)

集成的API密钥。服务器将在响应和日志中屏蔽此凭据的值。

StorageImageIntegrationCategory

NODE_SCANNER：图像和节点集成目前在UI中的相同表单上完成，因此图像集成目前也用于节点集成。做出这个决定是因为我们目前只支持一个节点扫描器（我们的扫描器）。

枚举值
注册表
扫描器
NODE_SCANNER

枚举值

注册表

扫描器

NODE_SCANNER

StorageImageIntegrationSource

字段名称 (Field Name)

必填 (Required)

可为空 (Nullable)

类型 (Type)

描述 (Description)

格式 (Format)

集群ID

字符串 (String)

命名空间

字符串 (String)

imagePullSecretName

字符串 (String)

StorageQuayConfig

字段名称 (Field Name)

必填 (Required)

可为空 (Nullable)

类型 (Type)

描述 (Description)

格式 (Format)

端点

字符串 (String)

OAuth令牌

字符串 (String)

集成的OAuth令牌。如果这是扫描器集成，则需要此令牌。服务器将在响应和日志中屏蔽此凭据的值。

不安全

布尔值

注册表机器人凭据

QuayConfigRobotAccount

StorageScannerV4Config

字段名称 (Field Name)

必填 (Required)

可为空 (Nullable)

类型 (Type)

描述 (Description)

格式 (Format)

并发扫描数

整数 (Integer)

int32

索引器端点

字符串 (String)

匹配器端点

字符串 (String)