使用控制台的示例

通过创建网络区域，可以建立产生访问请求的允许位置的列表。 将“目录管理”服务作为服务引用添加到该允许列表。 创建网络区域后，可以将其添加到规则。

要创建网络区域，请完成以下步骤：

1. 在 IBM Cloud 控制台中，单击 管理 > 基于上下文的限制，然后选择 网络区域。

2. 单击创建。

   您可以使用 JSON 代码表单来直接输入 JSON，以通过单击 作为 JSON 代码输入来创建区域，而不是使用 UI 输入来创建区域。

3. 输入一个唯一的名称和描述。 例如，“目录区域”和“允许目录与其他服务交互”。

4. 引用服务。 选择服务类型“IAM 服务”，然后选择“目录管理”服务。 单击 添加 以将服务的 IP 地址与网络区域相关联。

5. 单击 下一步 以查看网络区域。

6. 单击创建。

使用CLI的示例

通过创建网络区域，可以建立产生访问请求的允许位置的列表。 将“目录管理”服务作为服务引用添加到该允许列表。 创建网络区域后，可以将其添加到规则。

1. 通过运行以下命令来安装 基于上下文的限制 CLI 插件:

   ibmcloud plugin install cbr
   

2. 要创建网络区域，请使用 cbr zone-create 命令。

   以下示例创建具有服务引用的网络区域。 有关更多信息，请参阅 服务参考。

   ibmcloud cbr zone-create --name CatalogZone --description "Allow catalogs to interact with other services" --service-ref service_name=globalcatalog-collection
   

   要查找可用服务引用的列表，请运行 ibmcloud cbr service-ref-targets 命令。

使用API的示例

通过创建网络区域，可以建立产生访问请求的允许位置的列表。 将“目录管理”服务作为服务引用添加到该允许列表。 创建网络区域后，可以将其添加到规则。

要创建包含目录管理服务的网络区域，请调用 基于上下文的限制 API，如以下示例中所示:

{
  "name": "Catalog zone",
  "description": "Allow catalogs to interact with other services",
  "addresses": [
    {
      "type": "serviceRef",
      "ref": {
        "service_name": "globalcatalog-collection"
      }
    }
  ]
}

AddressIPAddress ipAddressModel = new AddressIPAddress.Builder()
ServiceRefValue serviceRefValueModel = new ServiceRefValue.Builder()
  .accountId(accountID)
  .serviceName("globalcatalog-collection")
  .build();
AddressServiceRef serviceRefAddressModel = new AddressServiceRef.Builder()
  .type("serviceRef")
  .ref(serviceRefValueModel)
  .build();
CreateZoneOptions createZoneOptions = new CreateZoneOptions.Builder()
  .name("Catalog zone")
  .accountId(accountID)
  .description("Allow catalogs to interact with other services")
  .addresses(java.util.Arrays.asList(ipAddressModel, ipRangeAddressModel, subnetAddressModel, vpcAddressModel, serviceRefAddressModel))
  .excluded(java.util.Arrays.asList(excludedIPAddressModel))
  .build();

Response<Zone> response = contextBasedRestrictionsService.createZone(createZoneOptions).execute();
Zone zone = response.getResult();

System.out.println(zone);

// Request models needed by this operation.

// AddressServiceRef
const serviceRefAddressModel = {
  type: 'serviceRef',
  ref: {
    account_id: accountId,
    service_name: 'globalcatalog-collection',
  },
};

const params = {
  name: 'Catalog zone',
  accountId,
  addresses: [ipAddressModel, ipRangeAddressModel, subnetAddressModel, vpcAddressModel, serviceRefAddressModel],
  excluded: [excludedIPAddressModel],
  description: 'Allow catalogs to interact with other services',
};

try {
  const res = await contextBasedRestrictionsService.createZone(params);
  zoneId = res.result.id;
  zoneRev = res.headers.etag;
  console.log(JSON.stringify(res.result, null, 2));
} catch (err) {
  console.warn(err);
}

service_ref_address_model = {
  'type': 'serviceRef',
  'ref': {
    'account_id': account_id,
    'service_name': 'globalcatalog-collection',
  }
}

zone = context_based_restrictions_service.create_zone(
  name='catalog zone',
  account_id=account_id,
  addresses=[service_ref_address_model],
  description='allow catalogs to interact with other services',
).get_result()

print(json.dumps(zone, indent=2))

serviceRefAddressModel := &contextbasedrestrictionsv1.AddressServiceRef{
  Type: core.StringPtr("serviceRef"),
  Ref: &contextbasedrestrictionsv1.ServiceRefValue{
    AccountID:   core.StringPtr(accountID),
    ServiceName: core.StringPtr("globalcatalog-collection"),
  },

createZoneOptions := contextBasedRestrictionsService.NewCreateZoneOptions()
createZoneOptions.SetName("catalog zone")
createZoneOptions.SetAccountID(accountID)
createZoneOptions.SetDescription("allow catalogs to interact with other services")
createZoneOptions.SetAddresses([]contextbasedrestrictionsv1.AddressIntf{serviceRefAddressModel})

zone, response, err := contextBasedRestrictionsService.CreateZone(createZoneOptions)
if err != nil {
  panic(err)
}
b, _ := json.MarshalIndent(zone, "", "  ")
fmt.Println(string(b))

要查找可用服务引用列表，请调用 ListAvailableServicerefTargets 方法。