IBM Cloud Docs
Listing and getting details of access requests

Listing and getting details of access requests

List all access requests and get the details of an access request in your linked zone by using the UI, CLI, or API.

Listing all access requests in the console

To list all access requests using the UI, take the following steps:

  1. Navigate to the Zones section of your DNS Services instance, then select the DNS zones tab, which shows a list of all zones.
  2. Check the Status column for pending requests.

Getting the details of an access request in the console

To get the details of an access request using the UI, take the following steps:

  1. Navigate to the Zones section of your DNS Services instance, then select the DNS zones tab.
  2. Click the link in the Zone name column of the linked zone you want to view.

Listing all access requests from the CLI

To list an access request using the CLI, run the following command:

ibmcloud dns cross-account access-request ZONE_ID [-i, --instance INSTANCE] [--output FORMAT]

Where:

  • ZONE_ID is the ID of the owner's zone.
  • -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.

Getting the details of an access request from the CLI

To get the details of an access request using the API, run the following command:

ibmcloud dns cross-account access-request ZONE_ID REQUEST_ID [-i, --instance INSTANCE] [--output FORMAT]

Where:

  • ZONE_ID is the ID of the owner's zone.
  • REQUEST_ID is the ID of the access request.
  • -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.

Listing access requests with the API

To list all access requests 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.
    • 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, list the access requests:

    curl -X GET \
    https://api.dns-svcs.cloud.ibm.com/v1/instances/$INSTANCE_ID/dnszones/$DNSZONE_ID/access_requests \
    -H "Authorization: $IAM_TOKEN"

Getting the details of an access request with the API

To get the details of an access request 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.
    • DNSZONE_ID which is the unique identifier of a linked zone.
    • ACCESS_REQUEST_ID which is the unique identifier of an access request.
    • IAM_TOKEN, which is the IAM authorization token.

  3. When all variables are initiated, get the details of the the access request:

    curl -X GET \
    https://api.dns-svcs.cloud.ibm.com/v1/instances/$INSTANCE_ID/dnszones/$DNSZONE_ID/access_requests/$ACCESS_REQUEST_ID \
    -H "Authorization: $IAM_TOKEN"