IBM Cloud Docs
基于上下文的限制 CLI 插件

基于上下文的限制 CLI 插件

IBM Cloud® 基于上下文的限制命令行界面 (CLI) 为基于上下文的限制提供了额外功能。 您可以使用此 CLI 插件根据访问请求的网络位置来管理 IBM Cloud® 资源的访问限制。

准备工作

  • 安装 IBM Cloud CLI。 有关更多信息，请参阅 IBM Cloud CLI 入门。 使用 IBM Cloud CLI 运行命令的前缀为 ibmcloud。
  • 在运行命令之前，请使用 ibmcloud login 命令登录 IBM Cloud，生成访问令牌并验证您的会话。

安装基于上下文的限制插件

要安装基于上下文的限制插件，请运行以下命令：

ibmcloud plugin install cbr

在命令行中，当 ibmcloud CLI和 cbr CLI插件有更新可用时，您会收到通知。 请确保您的CLI保持更新，以便使用所有可用的命令和标志。

如果您想查看您当前版本的 cbr CLI插件，请运行 ibmcloud plugin list。

区域

网络区域上的操作。

ibmcloud cbr zone-create

此操作将为指定的帐户创建网络区域。

ibmcloud cbr zone-create [--name NAME] [--description DESCRIPTION] [--addresses ADDRESSES] [--vpc VPC] [--service-ref SERVICEREF] [--excluded EXCLUDED] [--empty-address-list] [--file FILE]

示例

ibmcloud cbr zone-create --name example-zone --description "Example zone description" --addresses 192.0.2.1,3ffe:1900:fe21:4545::,192.2.3.5-192.2.3.10,3ffe:1900:fe21:4547::-3ffe:1900:fe21:6767:

ibmcloud cbr zone-create --name example-zone-with-service-ref --service-ref service_name=kms,location=us-south

ibmcloud cbr zone-create --name example-zone-with-vpc --vpc crn:v1:staging:public:is:us-south:a/12ab34cd56ef78ab90cd12ef34ab56cd::vpc:r123-abc456de-f789-abc1-23de-f456abc789ab

示例输出

id                    9adc34f2867a43452a517b3c2de78b95   
crn                   crn:v1:bluemix:public:cbr:global:a/0123456789::zone:9adc34f2867a43452a517b3c2de78b95   
address_count         7   
excluded_count        0   
name                  test   
account_id            0123456789   
description              
Addresses             1 IP Address, 1 IP Range, 1 Subnet, 2 VPCs, 2 Service References                                                                    
Excluded              No addresses       
href                  https://cbr.cloud.ibm.com/v1/zones/9adc34f2867a43452a517b3c2de78b95   
created_at            2024-03-06T22:20:25.000Z   
created_by_id         iam-ServiceId-0123456789
last_modified_at      2024-03-06T22:20:25.000Z   
last_modified_by_id   iam-ServiceId-0123456789

命令选项

--name （字符串）
区域名称。
--description （字符串）
区域的描述。
--addresses （字符串）
区域中的地址列表。 只允许使用逗号分隔格式的 ipAddress、ipRange 和 subnet 类型的地址。 支持 IPv4 和 IPv6。
--service-ref （字符串）
区域中的服务引用。 以 service_name=VALUE,service_name=VALUE,... 格式输入。
要查找可用服务引用的列表，请运行 ibmcloud cbr service-ref-targets 命令。
--vpc （字符串）
区域中允许的 VPC。 以 value,value,... 格式输入。
--excluded （字符串）
区域中已排除的地址的列表。 只允许使用逗号分隔格式的 ipAddress、ipRange 和 subnet 类型的地址。
--empty-address-list (bool)
明确指定区域没有地址。 不能与 addresses, service-ref, vpc 或 excluded 标志同时使用。
--file （字符串）
提供的文件用于创建区域。 此标志是唯一的，不能与其他标志一起使用。 该文件需要遵循区域创建 API 的 JSON 模式。 有关更多信息，请参阅 基于上下文的限制 API。

ibmcloud cbr zones

此操作列示指定帐户中的网络区域。

ibmcloud cbr zones [--name NAME] [--sort SORT]

示例

ibmcloud cbr zones

示例输出

id                                 name      address_count   excluded_count   
9adc34f2867a43452a517b3c2de78b95   test      7               0
12ab34cd56ef78ab90cd12ef34ab56cd   example   2               0

命令选项

--name （字符串）
区域名称。
--sort （字符串）
使用有效的排序字段对结果进行排序。 要了解更多信息，请参阅 排序。

ibmcloud cbr zone

此操作将检索由指定区域标识标识的网络区域。

ibmcloud cbr zone ZONE-ID

示例

ibmcloud cbr zone 9adc34f2867a43452a517b3c2de78b95

示例输出

id                    9adc34f2867a43452a517b3c2de78b95   
crn                   crn:v1:bluemix:public:cbr:global:a/0123456789::zone:9adc34f2867a43452a517b3c2de78b95   
address_count         7   
excluded_count        0   
name                  test   
account_id            0123456789   
description              
Addresses             1 IP Address, 1 IP Range, 1 Subnet, 2 VPCs, 2 Service References                                                                    
Excluded              No addresses       
href                  https://cbr.cloud.ibm.com/v1/zones/9adc34f2867a43452a517b3c2de78b95   
created_at            2024-03-06T22:20:25.000Z   
created_by_id         iam-ServiceId-0123456789
last_modified_at      2024-03-06T22:20:25.000Z   
last_modified_by_id   iam-ServiceId-0123456789

ibmcloud cbr zone-update

此操作将替换由指定区域标识标识的网络区域。 不支持部分更新，将替换整个网络区域对象。

ibmcloud cbr zone-update ZONE-ID [--name NAME] [--description DESCRIPTION] [--addresses ADDRESSES] [--vpc VPC] [--service-ref SERVICEREF] [--excluded EXCLUDED] [--empty-address-list] [--file FILE]

示例

ibmcloud cbr zone-update 9adc34f2867a43452a517b3c2de78b95 --name 'Example Zone Name' --addresses 166.22.23.0-166.22.23.108,3ffe:1900:fe21:4545:: --excluded 166.22.23.100

ibmcloud cbr zone-update 9adc34f2867a43452a517b3c2de78b95 --name example-zone-with-service-ref --service-ref service_name=kms,location=us-south

ibmcloud cbr zone-update 9adc34f2867a43452a517b3c2de78b95 --name example-zone-with-vpc --vpc crn:v1:staging:public:is:us-south:a/12ab34cd56ef78ab90cd12ef34ab56cd::vpc:r123-abc456de-f789-abc1-23de-f456abc789ab

示例输出

id                    9adc34f2867a43452a517b3c2de78b95   
crn                   crn:v1:bluemix:public:cbr:global:a/0123456789::zone:9adc34f2867a43452a517b3c2de78b95   
address_count         7   
excluded_count        0   
name                  test update   
account_id            0123456789   
description              
Addresses             1 IP Address, 1 IP Range, 1 Subnet, 2 VPCs, 2 Service References                                                                    
Excluded              No addresses       
href                  https://cbr.cloud.ibm.com/v1/zones/9adc34f2867a43452a517b3c2de78b95   
created_at            2024-03-06T22:20:25.000Z   
created_by_id         iam-ServiceId-0123456789
last_modified_at      2024-03-06T22:29:19.000Z   
last_modified_by_id   iam-ServiceId-0123456789

命令选项

--name （字符串）
区域名称。
--description （字符串）
区域的描述。
--addresses （字符串）
区域中的地址列表。 只允许使用逗号分隔格式的 ipAddress、ipRange 和 subnet 类型的地址。 支持 IPv4 和 IPv6。
--service-ref （字符串）
区域中的服务引用。 以 name=value,name=value,... 格式输入。
--vpc （字符串）
区域中允许的 VPC。 以 value,value,... 格式输入。
--excluded （字符串）
区域中已排除的地址的列表。 只允许使用逗号分隔格式的 ipAddress、ipRange 和 subnet 类型的地址。
--empty-address-list (bool)
明确指定区域没有地址。 不能与 addresses, service-ref, vpc 或 excluded 标志同时使用。
--file （字符串）
提供的文件用于更新区域。 此标志是唯一的，不能与其他标志一起使用。 该文件需要遵循区域更新 API 的 JSON 模式。 有关更多信息，请参阅 基于上下文的限制 API。

ibmcloud cbr zone-patch

此操作对指定区域 ID 所标识的网络区域执行部分更新。

ibmcloud cbr zone-patch ZONE-ID [--name NAME] [--description DESCRIPTION]

示例

ibmcloud cbr zone-patch 9adc34f2867a43452a517b3c2de78b95 --name 'Example Zone Name' --description updated

示例输出

id                    9adc34f2867a43452a517b3c2de78b95   
crn                   crn:v1:bluemix:public:cbr:global:a/0123456789::zone:9adc34f2867a43452a517b3c2de78b95   
address_count         7   
excluded_count        0   
name                  test update   
account_id            0123456789   
description           updated   
Addresses             1 IP Address, 1 IP Range, 1 Subnet, 2 VPCs, 2 Service References                                                                    
Excluded              No addresses       
href                  https://cbr.cloud.ibm.com/v1/zones/9adc34f2867a43452a517b3c2de78b95   
created_at            2024-03-06T22:20:25.000Z   
created_by_id         iam-ServiceId-0123456789
last_modified_at      2024-03-06T22:29:19.000Z   
last_modified_by_id   iam-ServiceId-0123456789

命令选项

--name （字符串）
区域名称。
--description （字符串）
区域的描述。

ibmcloud cbr zone-delete

此操作将删除由指定区域标识标识的网络区域。

ibmcloud cbr zone-delete ZONE-ID

示例

ibmcloud cbr zone-delete 65810ac762004f22ac19f8f8edf70a34

ibmcloud cbr service-ref-targets

此操作将列出所有可用的服务引用目标。

ibmcloud cbr service-ref-targets [--type TYPE]

示例

ibmcloud cbr service-ref-targets

示例输出

service_name                   service_type       locations   
ace                            -                  -   
apprapp                        -                  na, us, dal   
apprapp-dev                    -                  na, us, dal   
cloud-object-storage           -                  na, us, sjc   
cloudantnosqldb                -                  ap, au, syd, +27   
codeengine                     -                  ap, au, syd, +6   
compliance                     platform_service   na, us, dal, +1   
containers-kubernetes          -                  na, us, dal   
directlink                     -                  -   
event-notifications            -                  na, us, dal   
globalcatalog-collection       -                  -   
iam-groups                     platform_service   -   
is                             -                  eu, es, mad, +4   
kms                            -                  -   
logdna                         -                  ap, au, syd, +17   
logdnaat                       -                  ap, au, syd, +17   
messagehub                     -                  eu, uk, lon, +3   
messagehub-vnext-integration   -                  eu, uk, lon, +3   
schematics                     -                  eu, de, fra, +6   
secrets-manager                -                  -   
server-protect                 -                  eu, es, mad, +4   
sysdig-monitor                 -                  eu, uk, lon, +3   
sysdig-secure                  -                  eu, uk, lon, +3   
toolchain                      -                  ap, au, syd, +6   
user-management                platform_service   -

命令选项

--type （字符串）
指定要检索的服务类型。 缺省值为 all。 允许的值为: all 和 platform_service。

ibmcloud cbr service-ref-target

此操作将获取指定服务名称的服务引用目标。

ibmcloud cbr service-ref-target SERVICE-NAME

示例

ibmcloud cbr service-ref-target compliance

示例输出

Service Name     compliance         
Service Type:    platform_service   
Locations:       
                 Name               Display Name    Kind   
                 na                 North America   geography   
                 us                 United States   country   
                 dal                Dallas          metro   
                 wdc                Washington DC   metro

规则

对基于上下文的限制规则的操作。

ibmcloud cbr rule-create

此操作将为指定的帐户创建规则。

ibmcloud cbr rule-create [--description DESCRIPTION] [--resource-attributes RESOURCES] [--context-attributes CONTEXTS] [--api-types API-TYPES] [--enforcement-mode ENFORCEMENT-MODE] [--service-name SERVICE-NAME] [--service-group-id SERVICE-GROUP-ID] [--service-instance SERVICE-INSTANCE] [--region REGION] [--resource-type RESOURCE-TYPE] [--resource RESOURCE] [--resource-group-id RESOURCE-GROUP-ID] [--tags TAGS] [--zone-id ZONE-ID] [--empty-context-list] [--file FILE]

示例

ibmcloud cbr rule-create --description 'Example Rule Description' --service-name kms --context-attributes endpointType=private --zone-id 93de8d3f588ab2c457ff576c364d1145

ibmcloud cbr rule-create --service-name example-service --context-attributes mfa=LEVEL2,endpointType=public,networkZoneId=12ab34cd56ef78ab90cd12ef34ab56cd

示例输出

id                    2c54cb0fefb0050c88f72d68c400fbec   
crn                   crn:v1:bluemix:public:cbr:global:a/0123456789::rule:2c54cb0fefb0050c88f72d68c400fbec   
description           test   
operations            1 API Type   
contexts              1 Context   
resources                                  
                      serviceInstance   1234567891234   
                      serviceName       cloud-object-storage

href                  https://cbr.cloud.ibm.com/v1/rules/2c54cb0fefb0050c88f72d68c400fbec   
created_at            2024-03-07T15:36:52.000Z   
created_by_id         iam-ServiceId-0123456789
last_modified_at      2024-03-07T15:36:52.000Z   
last_modified_by_id   iam-ServiceId-0123456789
enforcement_mode      enabled

命令选项

--description （字符串）
规则的描述。
--resource-attributes （字符串）
此规则应用于的资源属性的格式为 name=value,name=value,...。
--context-attributes （字符串）
此规则应用于的上下文属性的格式为 name=value,name=value,...。
--api-types （字符串）
规则适用的 API。 对于支持的服务 API 类型，请在资源上使用 api-types 命令。
--enforcement-mode （字符串）
如何实施规则。 CLI 接受值 enabled (缺省值)，disabled 和 report。 有关执行的更多信息，请参阅 规则执行。
--service-name （字符串）
用于创建 IBM Cloud 资源属性 serviceName 的速记。
--service-group-id （字符串）
service_group_id 资源属性。
--service-instance （字符串）
服务实例的 GUID。 此选项与 --file不可同时使用。
--region （字符串）
用于创建 IBM Cloud 资源属性 region 的速记。 如需支持，请发送电子邮件至 ibmcloud regions。
--resource-type （字符串）
用于创建 IBM Cloud 资源属性 resourceType 的速记。
--resource （字符串）
用于创建 IBM Cloud 资源属性 resource 的速记。
--resource-group-id （字符串）
用于创建 IBM Cloud 资源属性 resourceGroupId 的速记。
--tags （字符串）
资源的访问标记，格式为 name:value,name:value,...。
--zone-id （字符串）
用于将上下文属性 networkZoneId 添加到第一个上下文的速记。
--empty-context-list (bool)
明确指定规则没有上下文。 不能与 context-attributes 或 zone-id 标志同时使用。
--file （字符串）
提供的文件用于创建规则。 此标志是唯一的，不能与其他标志一起使用。 该文件需要遵循规则创建 API 的 JSON 模式。 有关更多信息，请参阅 基于上下文的限制 API。

ibmcloud cbr rules

此操作列示指定帐户中的规则。

ibmcloud cbr rules [--enforcement-mode ENFORCEMENT-MODE] [--service-name SERVICE-NAME] [--service-group-id SERVICE-GROUP-ID] [--service-instance SERVICE-INSTANCE] [--region REGION] [--resource-type RESOURCE-TYPE] [--resource RESOURCE] [--zone-id ZONE-ID] [--sort SORT]

示例

ibmcloud cbr rules

示例输出

id                                 service_name           enforcement   description   
2c54cb0fefb0050c88f72d68c400fbec   cloud-object-storage   enabled       test   
a4135a90bb507bf6d96cf4c6f009d151   kms                    disabled       example

命令选项

--enforcement-mode （字符串）
如何实施规则。 CLI 接受值 enabled (缺省值)，disabled 和 report。 有关执行的更多信息，请参阅 规则执行。
--region （字符串）
region 资源属性。
--resource （字符串）
resource 资源属性。
--resource-type （字符串）
resourceType 资源属性。
--service-instance （字符串）
服务实例的GUID。
--service-name （字符串）
serviceName 资源属性。
--service-group-id （字符串）
service_group_id 资源属性。
--zone-id （字符串）
全球唯一的区域ID。
--sort （字符串）
使用有效的排序字段对结果进行排序。 要了解更多信息，请参阅 排序。

ibmcloud cbr rule

此操作检索由指定规则标识标识的规则。

ibmcloud cbr rule RULE-ID

示例

ibmcloud cbr rule 30fd58c9b75f40e854b89c432318b4a2

示例输出

id                    2c54cb0fefb0050c88f72d68c400fbec   
crn                   crn:v1:bluemix:public:cbr:global:a/0123456789::rule:2c54cb0fefb0050c88f72d68c400fbec   
description           test   
operations            1 API Type   
contexts              1 Context   
resources                                  
                      serviceInstance   1234567891234   
                      serviceName       cloud-object-storage

href                  https://cbr.cloud.ibm.com/v1/rules/2c54cb0fefb0050c88f72d68c400fbec   
created_at            2024-03-07T15:36:52.000Z   
created_by_id         iam-ServiceId-0123456789
last_modified_at      2024-03-07T15:36:52.000Z   
last_modified_by_id   iam-ServiceId-0123456789
enforcement_mode      enabled

ibmcloud cbr rule-update

此操作将替换由指定规则标识标识的规则。 不支持部分更新，将替换整个规则对象。

ibmcloud cbr rule-update RULE-ID [--description DESCRIPTION] [--resource-attributes RESOURCES] [--context-attributes CONTEXTS] [--api-types API-TYPES] [--enforcement-mode ENFORCEMENT-MODE] [--service-name SERVICE-NAME] [--service-instance SERVICE-INSTANCE] [--region REGION] [--resource-type RESOURCE-TYPE] [--resource RESOURCE] [--resource-group-id RESOURCE-GROUP-ID] [--tags TAGS] [--zone-id ZONE-ID] [--empty-context-list] [--file FILE]

示例

ibmcloud cbr rule-update 30fd58c9b75f40e854b89c432318b4a2 --description 'Example rule description' --service-name kms --context-attributes endpointType=private --zone-id 93de8d3f588ab2c457ff576c364d1145

示例输出

id                    2c54cb0fefb0050c88f72d68c400fbec   
crn                   crn:v1:bluemix:public:cbr:global:a/0123456789::rule:2c54cb0fefb0050c88f72d68c400fbec   
description           updated   
operations            1 API Type   
contexts              1 Context   
resources                                  
                      serviceInstance   1234567891234   
                      serviceName       cloud-object-storage

href                  https://cbr.cloud.ibm.com/v1/rules/2c54cb0fefb0050c88f72d68c400fbec   
created_at            2024-03-07T15:36:52.000Z   
created_by_id         iam-ServiceId-0123456789
last_modified_at      2024-03-07T15:41:18.000Z   
last_modified_by_id   iam-ServiceId-0123456789
enforcement_mode      enabled

命令选项

--description （字符串）
规则的描述。
--resource-attributes （字符串）
此规则应用于的资源属性的格式为 name=value,name=value,...。
--context-attributes （字符串）
此规则应用于的上下文属性的格式为 name=value,name=value,...。
--api-types （字符串）
规则适用的 API。 对于支持的服务 API 类型，请在资源上使用 api-types 命令。
--enforcement-mode （字符串）
如何实施规则。 CLI 接受值 enabled (缺省值)，disabled 和 report。 有关执行的更多信息，请参阅 规则执行。
--service-name （字符串）
用于创建 IBM Cloud 资源属性 serviceName 的速记。
--service-group-id （字符串）
service_group_id 资源属性。
--service-instance （字符串）
服务实例的 GUID。 此选项与 --file不可同时使用。
--region （字符串）
用于创建 IBM Cloud 资源属性 region 的速记。 如需支持，请发送电子邮件至 ibmcloud regions。
--resource-type （字符串）
用于创建 IBM Cloud 资源属性 resourceType 的速记。
--resource （字符串）
用于创建 IBM Cloud 资源属性 resource 的速记。
--resource-group-id （字符串）
用于创建 IBM Cloud 资源属性 resourceGroupId 的速记。
--tags （字符串）
资源的访问标记，格式为 name:value,name:value,...。
--zone-id （字符串）
用于将上下文属性 networkZoneId 添加到第一个上下文的速记。
--empty-context-list (bool)
明确指定规则没有上下文。 不能与 context-attributes 或 zone-id 标志同时使用。
--file （字符串）
提供的文件用于更新规则。 此标志是唯一的，不能与其他标志一起使用。 文件需要遵循JSON模式，以更新规则API。 有关更多信息，请参阅 基于上下文的限制 API。
提供的文件用于创建规则。 此标志是唯一的，不能与其他标志一起使用。 该文件需要遵循规则创建 API 的 JSON 模式。 有关更多信息，请参阅 基于上下文的限制 API。

ibmcloud cbr rule-patch

此操作将部分更新指定规则 ID 所标识的规则。

ibmcloud cbr rule-patch RULE-ID [--description DESCRIPTION] [--enforcement-mode ENFORCEMENT-MODE]

示例

ibmcloud cbr rule-patch 30fd58c9b75f40e854b89c432318b4a2 --description 'Example rule description' --enforcement-mode disabled

示例输出

id                    2c54cb0fefb0050c88f72d68c400fbec   
crn                   crn:v1:bluemix:public:cbr:global:a/0123456789::rule:2c54cb0fefb0050c88f72d68c400fbec   
description           updated   
operations            1 API Type   
contexts              1 Context   
resources                                  
                      serviceInstance   1234567891234   
                      serviceName       cloud-object-storage

href                  https://cbr.cloud.ibm.com/v1/rules/2c54cb0fefb0050c88f72d68c400fbec   
created_at            2024-03-07T15:36:52.000Z   
created_by_id         iam-ServiceId-0123456789
last_modified_at      2024-03-07T15:41:18.000Z   
last_modified_by_id   iam-ServiceId-0123456789
enforcement_mode      enabled

命令选项

--description （字符串）
规则的描述。
--enforcement-mode （字符串）
如何实施规则。 CLI 接受值 enabled (缺省值)，disabled 和 report。 有关执行的更多信息，请参阅 规则执行。

ibmcloud cbr rule-delete

此操作将删除由指定规则标识标识的规则。

ibmcloud cbr rule-delete RULE-ID

示例

ibmcloud cbr rule-delete 30fd58c9b75f40e854b89c432318b4a2