Skip to content

Latest commit

 

History

History
81 lines (61 loc) · 2.95 KB

sec-zone-create.md

File metadata and controls

81 lines (61 loc) · 2.95 KB
Raw
copyright lastupdated keywords subcollection
years
2022, 2024
2024-10-25
dns-svcs

{{site.data.keyword.attribute-definition-list}}

Creating a secondary zone

{: #create-secondary-zone}

Create a secondary zone by using the UI, CLI, or API. {: shortdesc}

Creating a secondary zone in the UI

{: #ui-create-secondary-zone} {: ui}

To create a secondary zone using the UI, take the following steps:

  1. Navigate to the Custom resolver section of your DNS Services instance, and select the custom resolver where you want to create a secondary zone.
  2. In the Custom resolver details page, select the Secondary zone tab.
  3. Click Create secondary zone.
  4. Enter a name for the secondary zone.
  5. Optionally, enter a description for the secondary zone.
  6. Enter up to two IP addresses of your AXFR-capable DNS servers, separated by a comma.
  7. Click Create.

The new secondary zone now appears in the list of secondary zones in the Custom resolver details page, and is enabled by default.

Creating a secondary zone from the CLI

{: #cli-create-secondary-zone} {: cli}

To create a secondary zone using the CLI, run the following command:

ibmcloud dns secondary-zone-create RESOLVER_ID --name NAME --transfer-from ADDRESS1,ADDRESS2 [--description DESCRIPTION] [--enabled true|false] [-i, --instance INSTANCE] [--output FORMAT]

{: pre}

Where:

  • RESOLVER_ID is the ID of the custom resolver. Required.
  • --name value is the name of the secondary zone.
  • --transfer-from value is the addresses of the DNS servers from where the secondary zone data is transferred.
  • --description value is the description of the secondary zone.
  • --enabled value specifies whether the secondary zone is enabled.
  • -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.

Creating a secondary zone with the API

{: #api-create-secondary-zone} {: api}

To create a secondary 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.
    • RESOLVER_ID, which is the unique identifier of a custom resolver.
    • X-Correlation-ID (optional), which uniquely identifies a request.
  3. When all variables are initiated, create a secondary zone:
curl -X POST   https://api.dns-svcs.cloud.ibm.com/v1/instances/2be5d4a7-78f0-4c62-a957-41dc15342777/custom_resolvers/ddbe7a53-7971-46dc-b021-420335c31562/secondary_zones   -H 'Content-Type: application/json'   -H 'Authorization: Bearer xxxxxx'   -d '{
  "description": "secondary zone",
  "zone": "example.com",
  "enabled": false,
  "transfer_from": [
    "10.0.0.7"
  ]
}'

{: codeblock}