命令选项

--connector-id

Satellite 连接器的 ID。 要查找连接器标识，请运行 ibmcloud sat connector ls。

--endpoint

要为该 ACL 启用的端点的名称或 ID。

--location

Satellite 位置的名称或标识。 要查找位置 ID 或名称，请运行 ibmcloud sat location ls。

--name

ACL 的名称。

-q

不显示每日消息或更新提示。

--subnet

此 ACL 允许的 IP 或 CIDR 块。 该值必须完全包含在以下 CIDR 范围内：10.0.0.0/8、161.26.0.0/16、166.8.0.0/14、172.16.0.0/12。

示例

创建访问控制列表 (ACL)

ibmcloud sat acl create --name NAME --subnet SUBNET --connector-id ID

命令选项

--acl-id

指定访问控制列表（ACL）的ID。 要列出所有 ACL，请运行 ibmcloud sat acl ls。

--connector-id

Satellite 连接器的 ID。 要查找连接器标识，请运行 ibmcloud sat connector ls。

--endpoint

要为该 ACL 启用的端点的名称或 ID。

--location

Satellite 位置的名称或标识。 要查找位置 ID 或名称，请运行 ibmcloud sat location ls。

-q

不显示每日消息或更新提示。

示例

将一个或多个已启用的端点添加到访问控制列表 (ACL) 中

ibmcloud sat acl endpoint add --acl-id ID --endpoint ENDPOINT --connector-id ID

示例

显示帮助

ibmcloud sat acl endpoint help

命令选项

--acl-id

指定访问控制列表（ACL）的ID。 要列出所有 ACL，请运行 ibmcloud sat acl ls。

--connector-id

Satellite 连接器的 ID。 要查找连接器标识，请运行 ibmcloud sat connector ls。

--location

Satellite 位置的名称或标识。 要查找位置 ID 或名称，请运行 ibmcloud sat location ls。

--output

以提供的格式打印命令输出。 接受的值： json

-q

不显示每日消息或更新提示。

示例

列出某个访问控制列表（ACL）的所有已启用端点

ibmcloud sat acl endpoint ls --acl-id ID --connector-id ID

命令选项

--acl-id

指定访问控制列表（ACL）的ID。 要列出所有 ACL，请运行 ibmcloud sat acl ls。

--connector-id

Satellite 连接器的 ID。 要查找连接器标识，请运行 ibmcloud sat connector ls。

--endpoint

要禁用此 ACL 的端点名称或 ID。

--location

Satellite 位置的名称或标识。 要查找位置 ID 或名称，请运行 ibmcloud sat location ls。

-q

不显示每日消息或更新提示。

示例

从访问控制列表（ACL）中移除一个或多个已启用的端点

ibmcloud sat acl endpoint rm --acl-id ID --endpoint ENDPOINT --connector-id ID

命令选项

--acl-id

指定访问控制列表（ACL）的ID。 要列出所有 ACL，请运行 ibmcloud sat acl ls。

--connector-id

Satellite 连接器的 ID。 要查找连接器标识，请运行 ibmcloud sat connector ls。

--location

Satellite 位置的名称或标识。 要查找位置 ID 或名称，请运行 ibmcloud sat location ls。

--output

以提供的格式打印命令输出。 接受的值： json

-q

不显示每日消息或更新提示。

示例

查看访问控制列表（ACL）的详细信息

ibmcloud sat acl get --acl-id ID --connector-id ID

示例

显示帮助

ibmcloud sat acl help

命令选项

--connector-id

Satellite 连接器的 ID。 要查找连接器标识，请运行 ibmcloud sat connector ls。

--location

Satellite 位置的名称或标识。 要查找位置 ID 或名称，请运行 ibmcloud sat location ls。

--output

以提供的格式打印命令输出。 接受的值： json

-q

不显示每日消息或更新提示。

示例

列出 Satellite 连接器或位置的所有访问控制列表（ACL）

ibmcloud sat acl ls --connector-id ID

命令选项

--acl-id

指定访问控制列表（ACL）的ID。 要列出所有 ACL，请运行 ibmcloud sat acl ls。

--connector-id

Satellite 连接器的 ID。 要查找连接器标识，请运行 ibmcloud sat connector ls。

--location

Satellite 位置的名称或标识。 要查找位置 ID 或名称，请运行 ibmcloud sat location ls。

-q

不显示每日消息或更新提示。

示例

删除访问控制列表 (ACL)

ibmcloud sat acl rm --acl-id ID --connector-id ID

命令选项

--acl-id

指定访问控制列表（ACL）的ID。 要列出所有 ACL，请运行 ibmcloud sat acl ls。

--connector-id

Satellite 连接器的 ID。 要查找连接器标识，请运行 ibmcloud sat connector ls。

--location

Satellite 位置的名称或标识。 要查找位置 ID 或名称，请运行 ibmcloud sat location ls。

-q

不显示每日消息或更新提示。

--subnet

此 ACL 允许的 IP 或 CIDR 块。 该值必须完全包含在以下 CIDR 范围内：10.0.0.0/8、161.26.0.0/16、166.8.0.0/14、172.16.0.0/12。

示例

向访问控制列表（ACL）添加一个或多个子网

ibmcloud sat acl subnet add --acl-id ID --subnet SUBNET --connector-id ID

示例

显示帮助

ibmcloud sat acl subnet help

命令选项

--acl-id

指定访问控制列表（ACL）的ID。 要列出所有 ACL，请运行 ibmcloud sat acl ls。

--connector-id

Satellite 连接器的 ID。 要查找连接器标识，请运行 ibmcloud sat connector ls。

--location

Satellite 位置的名称或标识。 要查找位置 ID 或名称，请运行 ibmcloud sat location ls。

-q

不显示每日消息或更新提示。

--subnet

此 ACL 允许的 IP 或 CIDR 块。 该值必须完全包含在以下 CIDR 范围内：10.0.0.0/8、161.26.0.0/16、166.8.0.0/14、172.16.0.0/12。

示例

从访问控制列表（ACL）中删除一个或多个子网

ibmcloud sat acl subnet rm --acl-id ID --subnet SUBNET --connector-id ID

命令选项

--acl-id

指定访问控制列表（ACL）的ID。 要列出所有 ACL，请运行 ibmcloud sat acl ls。

--connector-id

Satellite 连接器的 ID。 要查找连接器标识，请运行 ibmcloud sat connector ls。

--location

Satellite 位置的名称或标识。 要查找位置 ID 或名称，请运行 ibmcloud sat location ls。

--name

ACL 的新名称。

-q

不显示每日消息或更新提示。

示例

更新访问控制列表（ACL）的名称

ibmcloud sat acl update --acl-id ID --name NAME --connector-id ID

命令选项

--platform

Satellite连接器代理的平台。 有关 Docker 的更多信息，请参阅 https://ibm.biz/satconagent 文档 可用选项：WINDOWS、Docker

-q

不显示每日消息或更新提示。

示例

获取适用于特定平台的 Satellite 连接器代理

ibmcloud sat agent attach --platform PLATFORM

示例

显示帮助

ibmcloud sat agent help

命令选项

--connector-id

Satellite 连接器的标识。

--output

以提供的格式打印命令输出。 接受的值： json

-q

不显示每日消息或更新提示。

示例

列出 Satellite 连接器下的所有代理

ibmcloud sat agent ls --connector-id ID

命令选项

-c, --cluster

指定集群名称或标识。 要列出已注册的集群，请运行 ibmcloud sat cluster ls。

--output

以提供的格式打印命令输出。 接受的值： json

-q

不显示每日消息或更新提示。

示例

获取已注册集群的详细信息

ibmcloud sat cluster get --cluster CLUSTER

示例

显示帮助

ibmcloud sat cluster help

命令选项

--filter

按集群标识过滤已注册的集群。

--limit

限制返回的集群数量。

--output

以提供的格式打印命令输出。 接受的值： json

-q

不显示每日消息或更新提示。

示例

列出您在 IBM Cloud 账户中注册的所有集群

ibmcloud sat cluster ls

命令选项

--name

指定要注册的集群的名称

-q

不显示每日消息或更新提示。

--silent

静默。 仅在输出中返回注册命令。

示例

获取一个 kubectl 命令，用于将您的集群注册到 Satellite 配置中

ibmcloud sat cluster register --name NAME

命令选项

-c, --cluster

指定集群名称或标识。 要列出已注册的集群，请运行 ibmcloud sat cluster ls。

-f

强制此命令运行，而不显示用户提示。

-q

不显示每日消息或更新提示。

示例

删除集群注册

ibmcloud sat cluster unregister --cluster CLUSTER

命令选项

--data-location

指定用于存储 Satellite 配置数据的 IBM 区域。 策略：直接上载。

--name

提供 Satellite 配置的名称。

--provider

指示 Satellite 配置的远程 GitOps 提供程序。 此提供程序将存储 Kubernetes 资源定义。 策略：GitOps。 允许的值 :github 和 gitlab

-q

不显示每日消息或更新提示。

示例

创建一个配置，以指定您希望在 Satellite 工作负载中的集群上部署哪些 Kubernetes 资源

ibmcloud sat config create --name NAME --data-location LOCATION

命令选项

--config

指定 Satellite 配置的名称或标识。 要列出可用的配置，请运行 ibmcloud sat config ls。

--output

以提供的格式打印命令输出。 接受的值： json

-q

不显示每日消息或更新提示。

示例

获取 Satellite 配置的详细信息，例如与该配置关联的版本或订阅

ibmcloud sat config get --config CONFIG

示例

显示帮助

ibmcloud sat config help

命令选项

--output

以提供的格式打印命令输出。 接受的值： json

-q

不显示每日消息或更新提示。

示例

列出您在 IBM Cloud 账户中的所有“Satellite”配置

ibmcloud sat config ls

命令选项

--config

指定 Satellite 配置的名称或标识。 要列出可用的配置，请运行 ibmcloud sat config ls。

--name

为 Satellite 配置提供新名称。

-q

不显示每日消息或更新提示。

示例

重命名 Satellite 配置

ibmcloud sat config rename --config CONFIG --name NAME

命令选项

--config

指定 Satellite 配置的名称或标识。 要列出可用的配置，请运行 ibmcloud sat config ls。

-f

强制此命令运行，而不显示用户提示。

-q

不显示每日消息或更新提示。

示例

删除 Satellite 配置

ibmcloud sat config rm --config CONFIG

命令选项

--config

指定 Satellite 配置的名称或标识。 要列出可用的配置，请运行 ibmcloud sat config ls。

--description

添加 Satellite 配置版本的描述。

--file-format

指示配置版本的文件格式。 可用选项 :yaml

--name

提供 Satellite 配置版本的名称。

-q

不显示每日消息或更新提示。

--read-config

指定配置版本文件的文件路径。

示例

创建一个配置版本，以更新您 Satellite 工作负载的现有 Kubernetes 资源

ibmcloud sat config version create \
  --config CONFIG \
  --file-format FORMAT \
  --name NAME \
  --read-config CONFIG

命令选项

--config

指定 Satellite 配置的名称或标识。 要列出可用的配置，请运行 ibmcloud sat config ls。

--output

以提供的格式打印命令输出。 接受的值： json

-q

不显示每日消息或更新提示。

--save-config

下载配置版本并将其保存到临时文件。

--version

指定 Satellite 配置版本的名称或标识。 要在配置中列出版本，请运行 ibmcloud sat config get --config <configuration_name_or_ID>。

示例

获取 Satellite 配置版本的详细信息

ibmcloud sat config version get --config CONFIG --version VERSION

示例

显示帮助

ibmcloud sat config version help

命令选项

--config

指定 Satellite 配置的名称或标识。 要列出可用的配置，请运行 ibmcloud sat config ls。

-f

强制此命令运行，而不显示用户提示。

-q

不显示每日消息或更新提示。

--version

指示 Satellite 配置版本的名称或标识。 要列出版本，请运行 ibmcloud sat config get --config <configuration_name_or_ID>。

示例

删除 Satellite 配置版本

ibmcloud sat config version rm --config CONFIG --version VERSION

命令选项

--name

Satellite 连接器的名称。

-q

不显示每日消息或更新提示。

--region

用于管理 Satellite 连接器的 IBM Cloud 区域。

示例

创建一个 Satellite 连接器

ibmcloud sat connector create --name NAME --region REGION

命令选项

--connector-id

Satellite 连接器的标识。

--output

以提供的格式打印命令输出。 接受的值： json

-q

不显示每日消息或更新提示。

示例

查看 Satellite 连接器的详细信息

ibmcloud sat connector get --connector-id ID

示例

显示帮助

ibmcloud sat connector help

命令选项

--after

显示指定光标后的Satellite连接器。

--first

查看下一个Satellite连接器，直至第一个连接器的数量。

--output

以提供的格式打印命令输出。 接受的值： json

-q

不显示每日消息或更新提示。

示例

在您的 IBM Cloud 账户中查看 Satellite 连接器

ibmcloud sat connector ls

命令选项

--connector-id

Satellite 连接器的标识。

-f

强制此命令运行，而不显示用户提示。

-q

不显示每日消息或更新提示。

示例

删除 Satellite 连接器

ibmcloud sat connector rm --connector-id ID

命令选项

--connector-id

Satellite 连接器的 ID。 要查找连接器标识，请运行 ibmcloud sat connector ls。

--endpoint

指定端点的名称或标识。 要列出所有端点，请运行 ibmcloud sat endpoint ls。

--location

Satellite 位置的名称或标识。 要查找位置 ID 或名称，请运行 ibmcloud sat location ls。

--output

以提供的格式打印命令输出。 接受的值： json

-q

不显示每日消息或更新提示。

示例

获取端点的身份验证设置

ibmcloud sat endpoint authn get --endpoint ENDPOINT --connector-id ID

示例

显示帮助

ibmcloud sat endpoint authn help

命令选项

--connector-id

Satellite 连接器的 ID。 要查找连接器标识，请运行 ibmcloud sat connector ls。

--dest-ca-cert-file

用于验证目标服务器证书的可信 CA 证书或链。 例如，myCA.pem。

--dest-cert-file

用于向目标服务器进行身份验证的客户端证书。 例如，myCert.pem。

--dest-key-file

用于加密客户机证书的客户机专用密钥。 例如，myKey.pem。

--endpoint

指定端点的名称或标识。 要列出所有端点，请运行 ibmcloud sat endpoint ls。

--location

Satellite 位置的名称或标识。 要查找位置 ID 或名称，请运行 ibmcloud sat location ls。

-q

不显示每日消息或更新提示。

--source-ca-cert-file

当 source-tls-mode 是相互的时，用于验证源客户机证书的可信 CA 证书或链。 例如，myCA.pem。

--source-cert-file

要向源客户机提供的服务器证书。 例如，myCert.pem。

--source-key-file

用于加密服务器证书的服务器专用密钥。 例如，myKey.pem。

示例

用新的认证证书替换现有的认证证书

ibmcloud sat endpoint authn rotate --endpoint ENDPOINT --connector-id ID

命令选项

--connector-id

Satellite 连接器的 ID。 要查找连接器标识，请运行 ibmcloud sat connector ls。

--dest-ca-cert-file

用于验证目标服务器证书的可信 CA 证书或链。 例如，myCA.pem。

--dest-cert-file

用于向目标服务器进行身份验证的客户端证书。 例如，myCert.pem。

--dest-key-file

用于加密客户机证书的客户机专用密钥。 例如，myKey.pem。

--dest-tls-mode

目的地 TLS 模式。 接受值：simple, mutual, none

--endpoint

指定端点的名称或标识。 要列出所有端点，请运行 ibmcloud sat endpoint ls。

--location

Satellite 位置的名称或标识。 要查找位置 ID 或名称，请运行 ibmcloud sat location ls。

-q

不显示每日消息或更新提示。

--source-ca-cert-file

当 source-tls-mode 是相互的时，用于验证源客户机证书的可信 CA 证书或链。 例如，myCA.pem。

--source-cert-file

要向源客户机提供的服务器证书。 例如，myCert.pem。

--source-key-file

用于加密服务器证书的服务器专用密钥。 例如，myKey.pem。

--source-tls-mode

来源：TLS 模式。 接受的值: simple，mutual

示例

为端点设置身份验证设置

ibmcloud sat endpoint authn set --endpoint ENDPOINT --connector-id ID

命令选项

--connector-id

Satellite 连接器的 ID。 要查找连接器标识，请运行 ibmcloud sat connector ls。

--dest-hostname

指示要连接到的目标的标准域名 (FQDN) 或外部可访问的 IP 地址。 对于 cloud 端点，该值必须解析为公共 IP 地址，或解析为可在 IBM Cloud 内访问的私有 IP 地址（例如私有云服务端点）。 对于 location 端点，该值必须能够从控制平面主机解析出来，并且从控制平面主机可访问该值（适用于 Satellite 位置）；或者，对于 Satellite Connector，该值必须能够从代理运行的位置解析出来并可访问。

--dest-port

提供目标资源侦听入局请求的端口。 确保端口与目标协议匹配。

--dest-protocol

指定目标的协议。 如果未指定此选项，那么将从源协议继承目标协议。 接受的值: TCP，TLS

--dest-type

指定目标资源的运行位置，可以是 IBM Cloud （cloud ）或您的 Satellite 位置（location ）。可用选项：location、cloud

--idle-timeout-seconds

指定与目标的活动连接的超时时间间隔 (以秒计)。 确保超时与目标服务和协议 keep-alive 设置兼容。

--location

Satellite 位置的名称或标识。 要查找位置 ID 或名称，请运行 ibmcloud sat location ls。

--name

提供端点的名称。

--output

以提供的格式打印命令输出。 接受的值： json

-q

不显示每日消息或更新提示。

--sni

如果指定了 tls 或 https 源协议，并且希望在 TLS 握手过程中添加一个单独的主机名，请指定服务器名称指示符。

--source-protocol

提供源用于连接目标资源的协议。 参见 http://ibm.biz/endpoint-protocols。 可用选项：TCP、TLS、HTTP、HTTPS、HTTP-tunnel

示例

创建端点

ibmcloud sat endpoint create \
  --dest-hostname HOSTNAME \
  --dest-port PORT \
  --dest-type TYPE \
  --name NAME \
  --source-protocol PROTOCOL \
  --connector-id ID

命令选项

--connector-id

Satellite 连接器的 ID。 要查找连接器标识，请运行 ibmcloud sat connector ls。

--endpoint

指定端点的名称或标识。 要列出所有端点，请运行 ibmcloud sat endpoint ls (--connector-id ID | --location LOCATION)。

-f

强制此命令运行，而不显示用户提示。

--location

Satellite 位置的名称或标识。 要查找位置 ID 或名称，请运行 ibmcloud sat location ls。

-q

不显示每日消息或更新提示。

示例

禁用一个端点

ibmcloud sat endpoint disable --endpoint ENDPOINT --connector-id ID

命令选项

--connector-id

Satellite 连接器的 ID。 要查找连接器标识，请运行 ibmcloud sat connector ls。

--endpoint

指定端点的名称或标识。 要列出所有端点，请运行 ibmcloud sat endpoint ls (--connector-id ID | --location LOCATION)。

-f

强制此命令运行，而不显示用户提示。

--location

Satellite 位置的名称或标识。 要查找位置 ID 或名称，请运行 ibmcloud sat location ls。

-q

不显示每日消息或更新提示。

示例

启用一个端点

ibmcloud sat endpoint enable --endpoint ENDPOINT --connector-id ID

命令选项

--connector-id

Satellite 连接器的 ID。 要查找连接器标识，请运行 ibmcloud sat connector ls。

--endpoint

指定端点的名称或标识。 要列出所有端点，请运行 ibmcloud sat endpoint ls (--connector-id ID | --location LOCATION)。

--location

Satellite 位置的名称或标识。 要查找位置 ID 或名称，请运行 ibmcloud sat location ls。

--output

以提供的格式打印命令输出。 接受的值： json

-q

不显示每日消息或更新提示。

示例

查看端点的详细信息

ibmcloud sat endpoint get --endpoint ENDPOINT --connector-id ID

示例

显示帮助

ibmcloud sat endpoint help

命令选项

--connector-id

Satellite 连接器的 ID。 要查找连接器标识，请运行 ibmcloud sat connector ls。

--location

Satellite 位置的名称或标识。 要查找位置 ID 或名称，请运行 ibmcloud sat location ls。

--output

以提供的格式打印命令输出。 接受的值： json

-q

不显示每日消息或更新提示。

示例

列出 Satellite 位置中的所有端点

ibmcloud sat endpoint ls --connector-id ID

命令选项

--connector-id

Satellite 连接器的 ID。 要查找连接器标识，请运行 ibmcloud sat connector ls。

--endpoint

指定端点的名称或标识。 要列出所有端点，请运行 ibmcloud sat endpoint ls (--connector-id ID | --location LOCATION)。

--location

Satellite 位置的名称或标识。 要查找位置 ID 或名称，请运行 ibmcloud sat location ls。

-q

不显示每日消息或更新提示。

示例

删除端点

ibmcloud sat endpoint rm --endpoint ENDPOINT --connector-id ID

命令选项

--connector-id

Satellite 连接器的 ID。 要查找连接器标识，请运行 ibmcloud sat connector ls。

--dest-hostname

指示要连接到的目标的标准域名 (FQDN) 或外部可访问的 IP 地址。 对于 cloud 端点，该值必须解析为公共 IP 地址，或解析为可在 IBM Cloud 内访问的私有 IP 地址（例如私有云服务端点）。 对于 location 端点，该值必须能够从控制平面主机解析出来，并且从控制平面主机可访问该值（适用于 Satellite 位置）；或者，对于 Satellite Connector，该值必须能够从代理运行的位置解析出来并可访问。

--dest-port

提供目标资源侦听入局请求的端口。 确保端口与目标协议匹配。

--dest-protocol

指定目标的协议。 如果未指定此选项，那么将从源协议继承目标协议。 接受的值: TCP，TLS

--endpoint

指定端点的名称或标识。 要列出所有端点，请运行 ibmcloud sat endpoint ls (--connector-id ID | --location LOCATION)。

--idle-timeout-seconds

指定与目标的活动连接的超时时间间隔 (以秒计)。 确保超时与目标服务和协议 keep-alive 设置兼容。

--location

Satellite 位置的名称或标识。 要查找位置 ID 或名称，请运行 ibmcloud sat location ls。

--name

为端点提供新名称。

-q

不显示每日消息或更新提示。

--sni

如果指定了 tls 或 https 源协议，并且希望在 TLS 握手过程中添加一个单独的主机名，请指定服务器名称指示符。

--source-protocol

提供源用于连接目标资源的协议。 参见 http://ibm.biz/endpoint-protocols。 允许的值：TCP、TLS、HTTP、HTTPS、HTTP-tunnel

示例

更新端点

ibmcloud sat endpoint update --endpoint ENDPOINT --connector-id ID

示例

显示帮助

ibmcloud sat experimental endpoint help

示例

显示帮助

ibmcloud sat experimental help

命令选项

-c, --cluster

指定集群名称或标识。 要列出已注册的集群，请运行 ibmcloud sat cluster ls。

-g, --group

指定 Satellite 集群组的名称或标识。 要列出可用的集群组，请运行 ibmcloud sat group ls。

-q

不显示每日消息或更新提示。

示例

将一个集群添加到集群组中

ibmcloud sat group attach --cluster CLUSTER --group GROUP

命令选项

-c, --cluster

指定要添加到集群组的集群名称或标识。 要列出已注册的集群，请运行 ibmcloud sat cluster ls。

--name

提供 Satellite 集群组的名称。

-q

不显示每日消息或更新提示。

示例

创建一个集群组

ibmcloud sat group create --name NAME

命令选项

-c, --cluster

指定集群名称或标识。 要列出集群组中的集群，请运行 ibmcloud sat group get --group <cluster_group_name_or_ID>。

-f

强制此命令运行，而不显示用户提示。

-g, --group

指定 Satellite 集群组的名称或标识。 要列出可用的集群组，请运行 ibmcloud sat group ls。

-q

不显示每日消息或更新提示。

示例

从您的 Satellite 集群组中移除一个或多个集群，并删除由该组订阅管理的 Kubernetes 资源

ibmcloud sat group detach --cluster CLUSTER --group GROUP

命令选项

-g, --group

指定 Satellite 集群组的名称或标识。 要列出已注册的集群，请运行 ibmcloud sat cluster ls。

--output

以提供的格式打印命令输出。 接受的值： json

-q

不显示每日消息或更新提示。

示例

获取 Satellite 集群组的详细信息

ibmcloud sat group get --group GROUP

示例

显示帮助

ibmcloud sat group help

命令选项

--output

以提供的格式打印命令输出。 接受的值： json

-q

不显示每日消息或更新提示。

示例

列出您在 IBM Cloud 账户中的所有 Satellite 集群组

ibmcloud sat group ls

命令选项

-f

强制此命令运行，而不显示用户提示。

-g, --group

指定 Satellite 集群组的名称或标识。 要列出可用的集群组，请运行 ibmcloud sat group ls。

-q

不显示每日消息或更新提示。

示例

删除一个 Satellite 集群组，此操作将取消集群的订阅，并删除由该组订阅管理的 Kubernetes 资源

ibmcloud sat group rm --group GROUP

命令选项

--cluster

要将主机分配到的集群的名称或标识。 要列出可用的集群，请运行 ibmcloud sat cluster ls。 如果未提供任何集群，那么会自动将主机分配给 Satellite 控制面板。

--host

要分配的主机的名称或标识。 要根据标签自动分配主机，请不要包含此选项。 要获取主机 ID，请运行 ibmcloud sat host ls --location <location_ID_or_name>。

--host-label, --hl

请以键值对的形式输入任意标签，用于标识要分配给您的 Satellite 控制平面或 Red Hat OpenShift 集群的主机。 具有此标签且未分配的第一个主机将自动分配给控制平面或集群。 要查找可用的主机标签，请运行 ibmcloud sat host get --host <host_name_or_ID> --location <location_name_or_ID>。

--location

Satellite 位置的名称或标识。 要查找位置 ID 或名称，请运行 ibmcloud sat location ls。

-p, --worker-pool

要分配主机的集群中工作程序池的名称或标识。 如果未指定工作程序池，那么会将主机分配给缺省工作程序池。

-q

不显示每日消息或更新提示。

--zone

要分配主机的区域的名称或标识。 要查找可用的区域，请运行 ibmcloud sat location get --location <location_name_or_ID>，并查看 Host Zones 字段。

示例

将主机分配给 Satellite 位置控制平面或集群

ibmcloud sat host assign --location LOCATION

命令选项

--host-label, --hl

请以键值对的形式输入任意标签，用于标识要分配给您的 Satellite 控制平面或 Red Hat OpenShift 集群的主机。 具有此标签且未分配的第一个主机将自动分配给控制平面或集群。 要查找可用的主机标签，请运行 ibmcloud sat host get --host <host_name_or_ID> --location <location_name_or_ID>。

--host-link-agent-endpoint

链路代理程序用于连接到链路隧道服务器的端点。

--location

Satellite 位置的名称或标识。 要查找位置 ID 或名称，请运行 ibmcloud sat location ls。

--operating-system

您要连接到您的位置的主机的操作系统。 要连接 RHCOS 主机，您的位置必须启用 RHCOS。 接受的值: RHEL，RHCOS

-q

不显示每日消息或更新提示。

--reset-key

重置控制平面用于连接和分配位置中的主机的密钥。 参见 https://ibm.biz/reset-key。

示例

创建并下载一个脚本，您可以在主机上运行该脚本，将其关联到您的位置

ibmcloud sat host attach --location LOCATION

命令选项

--host

Satellite 主机标识。 要查找主机 ID，请运行 ibmcloud sat host ls <location_ID_or_name>。

--location

Satellite 位置的名称或标识。 要查找位置 ID 或名称，请运行 ibmcloud sat location ls。

--output

以提供的格式打印命令输出。 接受的值： json

-q

不显示每日消息或更新提示。

示例

查看 Satellite 主机的详细信息

ibmcloud sat host get --host HOST --location LOCATION

示例

显示帮助

ibmcloud sat host help

命令选项

--location

Satellite 位置的名称或标识。 要查找位置 ID 或名称，请运行 ibmcloud sat location ls。

--output

以提供的格式打印命令输出。 接受的值： json

-q

不显示每日消息或更新提示。

示例

列出所有连接到 Satellite 位置的主机，包括已分配给集群或控制平面（control plane）的主机

ibmcloud sat host ls --location LOCATION

命令选项

-f

强制此命令运行，而不显示用户提示。

--host

要移除的主机的名称或标识。

--location

Satellite 位置的名称或标识。 要查找位置 ID 或名称，请运行 ibmcloud sat location ls。

-q

不显示每日消息或更新提示。

示例

从 Satellite 位置中移除主机

ibmcloud sat host rm --host HOST --location LOCATION

命令选项

--host

要分配的主机的名称或标识。 要根据标签自动分配主机，请不要包含此选项。

--host-label, --hl

请以键值对的形式输入任意标签，用于标识要分配给您的 Satellite 控制平面或 Red Hat OpenShift 集群的主机。 具有此标签且未分配的第一个主机将自动分配给控制平面或集群。 要查找可用的主机标签，请运行 ibmcloud sat host get --host <host_name_or_ID> --location <location_name_or_ID>。

--location

Satellite 位置的名称或标识。 要查找位置 ID 或名称，请运行 ibmcloud sat location ls。

-q

不显示每日消息或更新提示。

--zone

要与主机关联的区域的名称或标识。 不能更改分配给资源（例如集群）的主机的区域。 必须先取消分配这些。 要列出可用的区域，请运行 ibmcloud sat location get --location <ID>。

示例

更新主机信息，例如区域和标签

ibmcloud sat host update --host HOST --location LOCATION

示例

显示帮助

ibmcloud sat key help

命令选项

--output

以提供的格式打印命令输出。 接受的值： json

-q

不显示每日消息或更新提示。

示例

列出您 IBM Cloud 账户中的所有 Satellite 配置键

ibmcloud sat key ls

命令选项

-f

强制此命令运行，而不显示用户提示。

--key

Satellite 配置密钥的名称或标识。

-q

不显示每日消息或更新提示。

示例

删除 Satellite 配置键

ibmcloud sat key rm --key KEY

命令选项

-f

强制此命令运行，而不显示用户提示。

--name

新 Satellite Config 密钥的名称。

-q

不显示每日消息或更新提示。

示例

生成一个新密钥，供托管集群用于连接 Satellite 配置

ibmcloud sat key rotate --name NAME

命令选项

--capability

Satellite位置的能力。

--coreos-enabled

对 Satellite 位置启用 Red Hat CoreOS 功能部件。 无法撤销此操作。 请参阅 https://ibm.biz/infra-os。

--cos-bucket

指定用于存储 Satellite 位置控制平面数据的 IBM Cloud Object Storage 存储区的名称。 否则，将为您创建新的存储区。

--description

输入 Satellite 位置的描述。

--ha-zone

指定位置的区域。 为了实现高可用性，请为您的位置指定 3 个区域，即 --ha-zone ZONE1_NAME --ha-zone ZONE2_NAME --ha-zone ZONE3_NAME。 这些区域的名称必须与您计划在其中创建主机的基础结构提供程序中相应区域的名称完全匹配。

--managed-from

选择要从中管理 Satellite 位置的 IBM Cloud 区域。 为了获得更佳的性能，请选择您的本地数据中心附近的区域。 请参阅 https://ibm.biz/sat-region。

--name

指定 Satellite 位置的名称。 位置名称必须以字母开头，可以包含字母、数字、句点 (.) 和连字符 (-)，且长度必须少于 36 个字符。 请勿复用名称，即使删除了其他位置也是如此。

--physical-address

Satellite位置的物理地址。

--pod-network-interface-selection

用于选择内部 pod 网络的节点网络接口的方法。 只有在同时启用 Red Hat CoreOS 并使用 --coreos-enabled 选项的情况下，才能使用此选项。 要提供直接 URL 或 IP 地址，请指定 can-reach=<url> 或 can-reach=<ip_address>。 要选择网络接口，请指定 interface=<network_interface>。

--pod-subnet

指定定制子网 CIDR 以便为 Pod 提供专用 IP 地址。 只有当您启用 Red Hat CoreOS 并同时启用 --coreos-enabled 选项时，才会使用此选项。 子网必须为 /23 或更大。 请参阅 https://ibm.biz/sat-location-create。 缺省值：“172.16.0.0/16”

--provider

指示要用于 Satellite 位置的基础结构提供程序。 如果启用此选项，还必须启用 --provider-credential 选项。 接受的值: aws，azure，gcp 和 vmware

--provider-credential

指定本地机器上具有 Satellite 位置的基础架构提供程序凭证的 JSON 文件的路径。 凭证格式是特定于提供者的。 请参阅 http://ibm.biz/sat-infra-creds。

--provider-region

指定基础结构提供程序中您计划在其中为 Satellite 位置创建主机的区域。 如果启用此选项，还必须启用 --provider 选项。

-q

不显示每日消息或更新提示。

--service-subnet

指定定制子网 CIDR 以便为服务提供专用 IP 地址。 只有当您启用 Red Hat CoreOS 并同时启用 --coreos-enabled 选项时，才会使用此选项。 子网必须为 /24 或更大。 请参阅 https://ibm.biz/sat-location-create。 缺省值： 172.20.0.0/16

示例

创建 Satellite 位置

ibmcloud sat location create --managed-from REGION --name NAME

命令选项

--location

Satellite 位置的名称或标识。 要查找位置 ID 或名称，请运行 ibmcloud sat location ls。

--output

以提供的格式打印命令输出。 接受的值： json

-q

不显示每日消息或更新提示。

--subdomain

指定子域名。 要列出现有的子域名，请运行 ibmcloud sat location dns ls --location <ID>。

示例

查看 Satellite 位置中已注册子域名的详细信息

ibmcloud sat location dns get --location LOCATION --subdomain SUBDOMAIN

示例

显示帮助

ibmcloud sat location dns help

命令选项

--location

Satellite 位置的名称或标识。 要查找位置 ID 或名称，请运行 ibmcloud sat location ls。

--output

以提供的格式打印命令输出。 接受的值： json

-q

不显示每日消息或更新提示。

示例

列出 Satellite 位置下的已注册子域名

ibmcloud sat location dns ls --location LOCATION

命令选项

--ip

请为每个控制平面主机指定 IP 地址，格式为 --ip x.x.x.1 --ip x.x.x.2 --ip x.x.x.3。 对于多区域集群，每个区域都使用一个 IP 地址。 要查找 IP 地址，请运行 ibmcloud sat host ls --location <location_ID_or_name>，然后查找 Worker IP，查看标记为 infrastructure 的主机。

--location

Satellite 位置的名称或标识。 要查找位置 ID 或名称，请运行 ibmcloud sat location ls。

--output

以提供的格式打印命令输出。 接受的值： json

-q

不显示每日消息或更新提示。

示例

为 Satellite 位置中分配给控制平面（control plane）的主机设置一个子域名

ibmcloud sat location dns register --ip IP --location LOCATION

命令选项

--location

Satellite 位置的名称或标识。 要查找位置 ID 或名称，请运行 ibmcloud sat location ls。

--output

以提供的格式打印命令输出。 接受的值： json

-q

不显示每日消息或更新提示。

示例

查看 Satellite 门店的详细信息

ibmcloud sat location get --location LOCATION

示例

显示帮助

ibmcloud sat location help

命令选项

--output

以提供的格式打印命令输出。 接受的值： json

-q

不显示每日消息或更新提示。

示例

在您的 IBM Cloud 账户中列出所有 Satellite 地点

ibmcloud sat location ls

命令选项

-f

强制此命令运行，而不显示用户提示。

--location

Satellite 位置的名称或标识。 要查找位置 ID 或名称，请运行 ibmcloud sat location ls。

-q

不显示每日消息或更新提示。

示例

删除一个位置

ibmcloud sat location rm --location LOCATION

命令选项

--description

请为“Satellite”地点输入新的描述。 说明的长度限制为 400 字节。

--location-id

Satellite 位置的 ID。 要查找位置 ID，请运行 ibmcloud sat location ls。

--name

为“Satellite”位置指定一个新名称。 位置名称必须以字母开头，可以包含字母、数字、句点 (.) 和连字符 (-)，且长度必须少于 36 个字符。 不要重复使用名称，包括已删除位置的名称。

-q

不显示每日消息或更新提示。

示例

更新 Satellite 位置的名称或描述

ibmcloud sat location update --location-id ID

命令选项

-q

不显示每日消息或更新提示。

示例

查看当前用户的消息

ibmcloud sat messages

命令选项

--history

资源的历史记录标识。

--output

以提供的格式打印命令输出。 接受的值： json

-q

不显示每日消息或更新提示。

--resource

指定 Kubernetes 资源标识。 要查找 Kubernetes 的相关资源，请运行 ibmcloud sat resource ls。

--save-data

下载 Kubernetes 资源定义并将其保存到临时文件。

示例

查看由 Satellite 配置所管理的 Kubernetes 资源的详细信息

ibmcloud sat resource get --resource RESOURCE

示例

显示帮助

ibmcloud sat resource help

命令选项

--limit

指定要返回的最大历史记录条目数。

--output

以提供的格式打印命令输出。 接受的值： json

-q

不显示每日消息或更新提示。

--resource

Kubernetes 资源标识。

示例

获取 Kubernetes 资源的历史记录

ibmcloud sat resource history get --resource RESOURCE

示例

显示帮助

ibmcloud sat resource history help

命令选项

-c, --cluster

指定在其中运行 Kubernetes 资源的已注册集群的名称或标识。 要查找已注册的集群，请运行 ibmcloud sat cluster ls。

--limit

指定要返回的搜索的最大资源条目数。

--output

以提供的格式打印命令输出。 接受的值： json

-q

不显示每日消息或更新提示。

--search

指示用于过滤 Kubernetes 资源（例如 pod 或名称空间名称）的搜索结果的字符串。

--subscription

指定 Satellite 预订标识或名称。 要查找订阅，请运行 ibmcloud sat cluster ls。

示例

搜索由以下机构管理的 Kubernetes 资源：Satellite

ibmcloud sat resource ls --cluster CLUSTER

示例

显示帮助

ibmcloud sat service help

命令选项

--location

Satellite 位置的名称或标识。 要查找位置 ID 或名称，请运行 ibmcloud sat location ls。

--output

以提供的格式打印命令输出。 接受的值： json

-q

不显示每日消息或更新提示。

示例

列出您所在位置的所有 Satellite 服务集群，以便查看详细信息，例如请求的主机资源

ibmcloud sat service ls --location LOCATION

命令选项

--all

禁用存储器配置的所有 Satellite 存储器分配的自动补丁。

--assignment

Satellite 存储器分配的标识。 要列出配置的可用存储器分配，请运行 ibmcloud sat storage assignment ls --config CONFIG。

--config

Satellite 存储器配置的名称或标识。 要列出可用的存储配置，请运行 ibmcloud sat storage config ls。

-q

不显示每日消息或更新提示。

示例

禁用 Satellite 存储分配的自动修补程序

ibmcloud sat storage assignment autopatch disable --config CONFIG --all

命令选项

--all

对存储器配置的所有 Satellite 存储器分配启用自动补丁。

--assignment

Satellite 存储器分配的标识。 要列出配置的可用存储器分配，请运行 ibmcloud sat storage assignment ls --config CONFIG。

--config

Satellite 存储器配置的名称或标识。 要列出可用的存储配置，请运行 ibmcloud sat storage config ls。

-q

不显示每日消息或更新提示。

示例

为 Satellite 存储分配启用自动修补程序

ibmcloud sat storage assignment autopatch enable --config CONFIG --all

示例

显示帮助

ibmcloud sat storage assignment autopatch help

命令选项

-c, --cluster

指定用于分配的 Satellite 集群的标识。 要查找集群 ID，请运行 ibmcloud oc cluster ls --provider satellite。

--config

指定分配的 Satellite 存储器配置。要查找配置，请运行 ibmcloud sat storage config ls。

-g, --group

指定用于分配的集群组。 要查找集群组，请运行 ibmcloud sat group ls。

--name

提供 Satellite 存储器分配的名称。

-q

不显示每日消息或更新提示。

--service-cluster-id

指定用于分配的服务集群的标识。 要查找服务集群 ID，请运行 ibmcloud sat service ls --location <location>。

示例

创建一项任务，将您的存储配置部署到 Satellite 位置中的集群中

ibmcloud sat storage assignment create --config CONFIG --cluster CLUSTER

命令选项

--assignment

指定 Satellite 存储器分配的标识。

--output

以提供的格式打印命令输出。 接受的值： json

-q

不显示每日消息或更新提示。

示例

获取 Satellite 存储分配的详细信息

ibmcloud sat storage assignment get --assignment ASSIGNMENT

示例

显示帮助

ibmcloud sat storage assignment help

命令选项

-c, --cluster

指定用于分配的 Satellite 集群的标识。 要获取集群 ID，请运行 ibmcloud oc cluster ls --provider satellite。

--config

指定 Satellite 存储配置的名称或标识。 要列出可用的存储配置，请运行 ibmcloud sat storage config ls。

--location

指定 Satellite 位置的名称。 要列出可用的位置，请运行 ibmcloud sat location ls。 此选项不能由服务管理员使用。

--output

以提供的格式打印命令输出。 接受的值： json

-q

不显示每日消息或更新提示。

--service-cluster-id

指定用于分配的服务集群的标识。 要查找服务集群 ID，请运行 ibmcloud sat service ls --location <location>。

示例

列出您在 IBM Cloud 账户中的 Satellite 存储分配情况

ibmcloud sat storage assignment ls --cluster CLUSTER

命令选项

--assignment

指定 Satellite 存储器分配的标识。 要列出可用的任务，请运行 ibmcloud sat storage assignment ls。

-f

强制此命令运行，而不显示用户提示。

-q

不显示每日消息或更新提示。

示例

将存储配置更改应用到相关的分配中

ibmcloud sat storage assignment patch --assignment ASSIGNMENT

命令选项

--assignment

指定 Satellite 存储器分配的标识。 要查找作业，请运行 ibmcloud sat storage assignment ls。

-f

强制此命令运行，而不显示用户提示。

-q

不显示每日消息或更新提示。

示例

删除 Satellite 存储分配

ibmcloud sat storage assignment rm --assignment ASSIGNMENT

命令选项

--assignment

指定 Satellite 存储器分配的标识。

-f

强制此命令运行，而不显示用户提示。

-g, --group

指定用于分配的新集群组。 要列出可用的组，请运行 ibmcloud sat group ls。

--name

为 Satellite 存储器分配提供新名称。

-q

不显示每日消息或更新提示。

示例

更新 Satellite 存储分配

ibmcloud sat storage assignment update --assignment ASSIGNMENT

命令选项

--config-name

指定定制存储类的存储配置的名称。 要列出 Satellite 存储配置，请运行 ibmcloud sat storage config ls。

--name

提供定制存储类的名称。

-p, --param

为存储类参数指定 key=value 对。 要查看存储模板中的存储类参数，请运行 ibmcloud sat storage template get。

-q

不显示每日消息或更新提示。

示例

创建自定义的 Satellite 存储类

ibmcloud sat storage config class add --config-name NAME --name NAME --param PARAM

命令选项

--class

指定 Satellite 存储类的名称。

--config

指定 Satellite 存储配置的名称或标识。 要列出 Satellite 存储配置，请运行 ibmcloud sat storage config ls。

--output

以提供的格式打印命令输出。 接受的值： json

-q

不显示每日消息或更新提示。

示例

获取 Satellite 存储类的详细信息

ibmcloud sat storage config class get --class CLASS --config CONFIG

示例

显示帮助

ibmcloud sat storage config class help

命令选项

--config

指定 Satellite 存储配置的名称或标识。 要列出 Satellite 存储配置，请运行 ibmcloud sat storage config ls。

--output

以提供的格式打印命令输出。 接受的值： json

-q

不显示每日消息或更新提示。

--show-params

包含此选项以列出所有存储类参数详细信息。

示例

列出 Satellite 存储器配置中的存储类

ibmcloud sat storage config class ls --config CONFIG

命令选项

--location

输入存储配置的位置的标识或名称。 要查找可用的位置，请运行 ibmcloud sat location ls。

--name

指定存储器配置的名称。

-p, --param

为配置参数指定一个 key=value 对。 要查看存储模板中的配置参数，请运行 ibmcloud sat storage template get。

-q

不显示每日消息或更新提示。

--template-name

指定 Satellite 存储器配置模板名称。 要列出可用的存储配置模板，请运行 ibmcloud sat storage template ls。

--template-version

指定 Satellite 存储器配置模板版本。 如果不包含此选项，那么将使用缺省版本。 要列出可用的存储配置模板，请运行 ibmcloud sat storage template ls。

示例

创建一个 Satellite 存储配置，以便在集群中安装存储驱动程序

ibmcloud sat storage config create --location LOCATION --name NAME --template-name NAME

命令选项

--config

指定 Satellite 存储配置的名称或标识。 要列出可用的配置，请运行 ibmcloud sat storage config ls。

--output

以提供的格式打印命令输出。 接受的值： json

-q

不显示每日消息或更新提示。

示例

获取 Satellite 存储配置的详细信息

ibmcloud sat storage config get --config CONFIG

示例

显示帮助

ibmcloud sat storage config help

命令选项

--location

指定包含要列示的配置的位置的标识或名称。 要查找可用的位置，请运行 ibmcloud sat location ls。

--output

以提供的格式打印命令输出。 接受的值： json

-q

不显示每日消息或更新提示。

示例

列出您在 IBM Cloud 账户中的 Satellite 存储配置

ibmcloud sat storage config ls

示例

显示帮助

ibmcloud sat storage config param help

命令选项

--apply

将最新的 Satellite 存储配置版本应用于某个配置的所有分配。 要列出配置的分配情况，请运行 ibmcloud sat storage assignment ls --config CONFIG。

--config

指定存储器配置的名称或标识。 要列出 Satellite 存储配置，请运行 ibmcloud sat storage config ls。

-f

强制此命令运行，而不显示用户提示。

-p, --param

为配置参数指定一个 key=value 对。 要查看存储模板中的配置参数，请运行 ibmcloud sat storage template get。

-q

不显示每日消息或更新提示。

示例

设置 Satellite 存储配置的配置和密钥参数

ibmcloud sat storage config param set --config CONFIG --param PARAM

命令选项

--config

指定 Satellite 存储配置的名称或标识。 要列出可用的配置，请运行 ibmcloud sat storage config ls。

-f

强制此命令运行，而不显示用户提示。

--include-assignments

选中此选项，可将存储配置的分配更新为最新配置版本。

-q

不显示每日消息或更新提示。

示例

对 Satellite 存储配置应用最新的补丁更新

ibmcloud sat storage config patch --config CONFIG

命令选项

--config

指定 Satellite 存储配置的名称或标识。 要列出可用的配置，请运行 ibmcloud sat storage config ls。

-f

强制此命令运行，而不显示用户提示。

--include-assignments

包含此选项以除去存储器配置以及任何关联的分配。

-q

不显示每日消息或更新提示。

示例

删除 Satellite 存储配置

ibmcloud sat storage config rm --config CONFIG

示例

显示帮助

ibmcloud sat storage help

命令选项

--name

指定存储器模板名称。 要列出可用的存储模板，请运行 ibmcloud sat storage template ls。

--output

以提供的格式打印命令输出。 接受的值： json

-q

不显示每日消息或更新提示。

--version

指定存储器模板版本。 要列出可用的存储模板，请运行 ibmcloud sat storage template ls。

示例

获取 Satellite 存储器模板的详细信息

ibmcloud sat storage template get --name NAME --version VERSION

示例

显示帮助

ibmcloud sat storage template help

命令选项

-q

不显示每日消息或更新提示。

示例

列出可用的 Satellite 存储模板

ibmcloud sat storage template ls

命令选项

--auth-required

提供连接到远程存储库所需的认证私钥。 请参阅 https://ibm.biz/sat-config-private-repo 以获取详细信息。 策略：GitOps。

--config

指定要用于预订的配置的名称。 要查找可用的配置，请运行 ibmcloud sat config ls。

-g, --group

指定要预订配置的集群组的名称或标识。 要查找可用的集群组，请运行 ibmcloud sat group ls。

--gitref

指定要用于 Satellite 预订的 GitRef。 策略：GitOps。

--gitref-type

指示要用于 Satellite 预订的 GitRef 的类型。 策略：GitOps。 允许的值 :branch，commit，tag 和 release

--name

输入预订的名称。

--path

提供远程存储库中要用于 Satellite 预订的存储库文件或发布资产的路径。 策略：GitOps。

-q

不显示每日消息或更新提示。

--repository

指定要用于预订的远程存储库的 URL。 策略：GitOps。

--version

指示要用于预订的现有配置版本的名称或标识。 要查找版本信息，请运行 ibmcloud sat config get --config <configuration_name_or_ID>。 策略：直接上载。

示例

为集群创建 Satellite 订阅

ibmcloud sat subscription create \
  --config CONFIG \
  --group GROUP \
  --name NAME \
  --auth-required \
  --gitref GITREF \
  --gitref-type TYPE \
  --path PATH \
  --repository REPOSITORY

命令选项

--output

以提供的格式打印命令输出。 接受的值： json

-q

不显示每日消息或更新提示。

--subscription

输入“Satellite”订阅的名称或 ID。 要查找订阅，请运行 ibmcloud sat subscription ls。

示例

获取有关“Satellite”订阅的详细信息

ibmcloud sat subscription get --subscription SUBSCRIPTION

示例

显示帮助

ibmcloud sat subscription help

示例

显示帮助

ibmcloud sat subscription identity help

命令选项

-f

强制此命令运行，而不显示用户提示。

-q

不显示每日消息或更新提示。

--subscription

指定 Satellite 预订的名称或标识。 要列出订阅，请运行 ibmcloud sat subscription ls。

示例

更新“Satellite”订阅，以便使用您的身份来管理资源

ibmcloud sat subscription identity set --subscription SUBSCRIPTION

命令选项

-c, --cluster

指定 Satellite 集群名称或标识。 要查找已注册的集群，请运行 ibmcloud sat cluster ls。

--output

以提供的格式打印命令输出。 接受的值： json

-q

不显示每日消息或更新提示。

示例

列出您在 IBM Cloud 账户中的所有 Satellite 订阅

ibmcloud sat subscription ls

命令选项

-f

强制此命令运行，而不显示用户提示。

-q

不显示每日消息或更新提示。

--subscription

提供 Satellite 预订的名称或标识。 要列出订阅，请运行 ibmcloud sat subscription ls。

示例

取消“Satellite”订阅

ibmcloud sat subscription rm --subscription SUBSCRIPTION

命令选项

--auth-required

提供连接到远程存储库所需的认证私钥。 策略：GitOps。

-f

强制此命令运行，而不显示用户提示。

-g, --group

指定要预订配置的新集群组。

--gitref

指定要用于 Satellite 预订的 GitRef。 策略：GitOps。

--gitref-type

指示要用于此 Satellite 预订的 GitRef 的类型。 策略：GitOps。 允许的值 :branch，commit，tag 和 release

--name

提供 Satellite 预订的新名称。

--path

指示远程存储库中要用于 Satellite 预订的存储库文件或发行版资产的路径。 策略：GitOps。

-q

不显示每日消息或更新提示。

--repository

提供要用于 Satellite 预订的远程存储库的 URL。 策略：GitOps。

--subscription

指定 Satellite 预订的名称或标识。 要列出订阅，请运行 ibmcloud sat subscription ls。

--version

指示要用于 Satellite 预订的现有配置版本。 策略：直接上载。

示例

更新 Satellite 订阅

ibmcloud sat subscription update \
  --subscription SUBSCRIPTION \
  --auth-required \
  --gitref GITREF \
  --gitref-type TYPE \
  --path PATH \
  --repository REPOSITORY