IBM Cloud Docs
Adding a permitted network to a linked zone

Adding a permitted network to a linked zone

Add a permitted network to your linked zone by using the UI, CLI, or API.

Adding a permitted network in the console

To add a permitted network using the UI, take the following steps:

  1. Navigate to the Zones section of your DNS Services instance, then select the Linked zones tab.
  2. Click the link in the Zone name column of the linked zone to which you want to add a permitted network. The Add networks panel appears.
  3. Select a region.
  4. Select a network.
  5. Click Add to add the permitted network.

The Status column shows that the linked zone is "Active" after a permitted network is successfully added.

Adding a permitted network from the CLI

To add a permitted network to your linked zone using the CLI, run the following command:

ibmcloud dns cross-account linked-zone-permitted-network-add LINKED_ZONE_ID --vpc-crn VPC_CRN [--type TYPE] [-i, --instance INSTANCE] [--output FORMAT]

Where:

  • LINKED_ZONE_ID is the ID of the linked zone.
  • --type value is the permitted network type. Valid values: vpc.
  • --vpc-crn value is the CRN of VPC instance.
  • -i, --instance value is the instance name or ID. If not set, the context instance specified by ibmcloud dns instance-target INSTANCE is used.
  • --output value specifies the output format. Currently, json is the only supported format.

Adding a permitted network with the API

To add a permitted network to your linked zone using the API, follow these steps:

  1. Set up your API environment with the correct variables.

  2. Store the following values in variables to be used in the API command:

    • INSTANCE_ID, which is the unique identifier of a service instance.
    • LINKED_DNSZONE_ID which is the unique identifier of a linked zone.
    • IAM_TOKEN, which is the IAM authorization token.
  3. When all variables are initiated, add the permitted network:

    curl -X POST \
        https://api.dns-svcs.cloud.ibm.com/v1/instances/$INSTANCE_ID/linked_dnszones/$LINKED_DNSZONE_ID/permitted_networks \
        -H "Authorization: $IAM_TOKEN" \
        -H "Content-Type: application/json" \
        -d '{
                "permitted_network": {
                     "vpc_crn": "crn:v1:bluemix:public:is:us-south:a/a8c46c094344a98ec1d8ef6ea19da410::vpc:r134-02681b2e-3c65-42c0-8ce4-b31da3fafcb7"
                },
                "type": "vpc"
         }
    

The following response is an example of when a permitted network is added successfully.

{
  "id": "fecd0173-3919-456b-b202-3029dfa1b0f7",
  "created_on": "2019-01-01T05:20:00.12345Z",
  "modified_on": "2019-01-01T05:20:00.12345Z",
  "permitted_network": {
    "vpc_crn": "crn:v1:bluemix:public:is:us-south:a/a8c46c094344a98ec1d8ef6ea19da410::vpc:r134-02681b2e-3c65-42c0-8ce4-b31da3fafcb"
  },
  "type": "vpc",
  "state": "ACTIVE"
}