Skip to main content

Retrieve a domain

GET /organizations/{organization_id}/domains/{domain_id}

Retrieves the specified domain.

Parameters

Name Type In Required Description

organization_id

string

path

True

Identifier for an organization.

domain_id

string

path

True

ID of the domain.

  • example: 4336388b-2992-43af-81de-ba9284b7dc36

include

string

query

False

Specifies which fields should be returned when listing a collection.

URL examples: "include=id", "include=id,name"

OpenAPI examples: "id"

Response

Status: 200, Returns the stored domain in the JSON response body.
Name Type Required Description

code

string

False

The unique verification code for this domain.

federations

array[federations]

False

The list of federations that use this domain.

id

string

False

Globally unique identifier of the resource conforming to the UUIDv4 schema.

metadata

type_bxp_metadata

False

Metadata associated with the resource.

name

string

False

The domain name.

organizationId

string

False

Identifier for an organization.

resourceId

string

False

Identifier for the resource.

state

string

False

The state of the domain. Defined values are:

  • "UNVERIFIED" - Ownership of the domain has not been verified.

  • "VERIFIED" - Ownership of the domain has been verified using a DNS TXT record with the verification code.

type

string

False

Media type of the resource.

verificationTimestamp

string

False

The date that the domain was verified.

version

string

False

Version of the resource.
Example response 
{
  "code": "BlueXP133ad2ea-99de-4ada-9be4-876d4d53923e",
  "federations": [
    {
      "id": "4336388b-2992-43af-81de-ba9284b7dc36",
      "name": "Example Co. AD FS"
    },
    {
      "id": "645eae30-ea32-4542-af58-1d9012fed81a",
      "name": "Example Co. SAML"
    }
  ],
  "id": "4336388b-2992-43af-81de-ba9284b7dc36",
  "metadata": {
    "createdBy": "666a3f38-d4fa-5b62-a391-a69029758d32",
    "creationTimestamp": "2022-10-06T20:58:16.305662Z",
    "labels": [
      {
        "name": "string",
        "value": "string"
      }
    ],
    "modificationTimestamp": "2022-10-06T20:58:16.305662Z",
    "modifiedBy": "666a3f38-d4fa-5b62-a391-a69029758d32"
  },
  "name": "example.com",
  "organizationId": "9b0ee210-70a0-4158-b025-0decde66e4de",
  "resourceId": "862b6f03-58ac-479b-9ca5-5cb4429d8996",
  "state": "VERIFIED",
  "type": "application/vnd.netapp.bxp.domain",
  "verificationTimestamp": "2024-11-18T20:58:16.305662Z",
  "version": "1.0"
}

Error

Status: 400, Bad request
Name Type Required Description

correlationId

string

False

Internal UUID representing the request or trace ID related.

detail

string

False

Details about the problem.

invalidParams

array[invalidParams]

False

List of invalid parameters.

status

string

True

HTTP error code related to the problem.

title

string

True

Title description of the problem.

type

string

True

Content-type of the object.
Example error response 
{
  "detail": "The supplied query parameters are invalid.",
  "status": "400",
  "title": "Invalid query parameters",
  "type": "https://bluexp.netapp.io/problems/1"
}

Error

Status: 401, Unauthorized
Name Type Required Description

correlationId

string

False

Internal UUID representing the request or trace ID related.

detail

string

False

Details about the problem.

invalidParams

array[invalidParams]

False

List of invalid parameters.

status

string

True

HTTP error code related to the problem.

title

string

True

Title description of the problem.

type

string

True

Content-type of the object.
Example error response 
{
  "detail": "The request is missing the required bearer token.",
  "status": "401",
  "title": "Missing bearer token",
  "type": "https://bluexp.netapp.io/problems/1"
}

Error

Status: 403, Forbidden
Name Type Required Description

correlationId

string

False

Internal UUID representing the request or trace ID related.

detail

string

False

Details about the problem.

invalidParams

array[invalidParams]

False

List of invalid parameters.

status

string

True

HTTP error code related to the problem.

title

string

True

Title description of the problem.

type

string

True

Content-type of the object.
Example error response 
{
  "detail": "The requested operation isn't permitted.",
  "status": "403",
  "title": "Operation not permitted",
  "type": "https://bluexp.netapp.io/problems/11"
}

Error

Status: 404, Not found
Name Type Required Description

correlationId

string

False

Internal UUID representing the request or trace ID related.

detail

string

False

Details about the problem.

invalidParams

array[invalidParams]

False

List of invalid parameters.

status

string

True

HTTP error code related to the problem.

title

string

True

Title description of the problem.

type

string

True

Content-type of the object.
Example error response 
{
  "detail": "The collection specified in the request URI wasn't found.",
  "status": "404",
  "title": "Collection not found",
  "type": "https://bluexp.netapp.io/problems/2"
}

Definitions

See Definitions

federations

Name Type Required Description

id

string

False

Globally unique identifier of the resource conforming to the UUIDv4 schema.

name

string

False

The name of the federation.

type_bxp_label

Name/value pair.

Name Type Required Description

name

string

True

Name of the label.

value

string

True

Value of the label.

type_bxp_metadata

Metadata associated with the resource.

Name Type Required Description

createdBy

string

False

UUID of the user who created the resource.

creationTimestamp

string

False

Resource creation date.

labels

array[type_bxp_label]

False

Array of name/value pairs representing additional information for the resource.

modificationTimestamp

string

False

Resource modification date.

modifiedBy

string

False

UUID of the user who modified the resource.

invalidParams

Name Type Required Description

name

string

True

Name of the invalid parameter.

reason

string

True

Reason why the parameter is invalid.