Skip to main content

List unmigrated connections

GET /unmigratedconnections

Lists connections managed through Cloud Central that you can import into BlueXP. Connections must be enabled in Cloud Central to be eligible for import. Only connections that you have permission to manage in Cloud Central are returned.

Response

Status: 200, List of unmigrated connections.
Name Type Required Description

items

array[unmigratedconnection_1.0_get_response_body]

True
Example response 
{
  "items": [
    {
      "adfsOptions": {
        "metadataFileProvided": 1,
        "metadataUrl": "https://example.com/FederationMetadata/2007-06/FederationMetadata.xml",
        "signInUrl": "https://example.com/adfs/ls/"
      },
      "creatorUsers": [
        "auth0|680f8f5e279840afb355ab00",
        "auth0|680f8f5e279840afb355ab11"
      ],
      "domains": [
        "example.com",
        "example2.com"
      ],
      "emailDomain": "example.com",
      "entraIdOptions": {
        "clientId": "94e2a45c-64e6-48d1-a31e-1eee0ded5c2a",
        "tenantDomain": "example.onmicrosoft.com"
      },
      "id": "con_jxQFVfPHKSdiwoxs",
      "name": "fed-example-com-waad",
      "pingFederateOptions": {
        "serverUrl": "https://example.com/saml/signin"
      },
      "providerType": "ENTRAID",
      "samlOptions": {
        "signInUrl": "https://example.com/saml/signin"
      },
      "type": "application/vnd.netapp.bxp.unmigratedconnection",
      "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"
}

Definitions

See Definitions

unmigratedconnection_1.0_adfs_response_options

Active Directory Federation Services (AD FS) configuration options when providerType=ADFS.

Name Type Required Description

metadataFileProvided

boolean

False

Indicates whether the connection uses the Federation metadata XML file or the server URL.

metadataUrl

string

False

AD FS server URL for the Federation metadata XML file.

signInUrl

string

False

AD FS single login URL extracted from the Federation metadata XML file.

unmigratedconnection_1.0_entraid_response_options

Microsoft Entra ID (formerly Azure Active Directory) configuration options when providerType=ENTRAID.

Name Type Required Description

clientId

string

False

Entra ID client ID.

tenantDomain

string

False

Entra ID domain.

unmigratedconnection_1.0_pingfederate_response_options

PingFederate configuration options when providerType=PINGFEDERATE.

Name Type Required Description

serverUrl

string

False

PingFederate server URL.

unmigratedconnection_1.0_saml_response_options

SAML configuration options when providerType=SAML.

Name Type Required Description

signInUrl

string

False

SAML single login URL.

unmigratedconnection_1.0_get_response_body

Name Type Required Description

adfsOptions

unmigratedconnection_1.0_adfs_response_options

False

Active Directory Federation Services (AD FS) configuration options when providerType=ADFS.

creatorUsers

array[string]

False

Array of Auth0 user IDs that can manage the connection in Cloud Central.

domains

array[string]

False

Array of domain names that are associated with the connection.

emailDomain

string

False

The primary email domain associated with the connection.

entraIdOptions

unmigratedconnection_1.0_entraid_response_options

False

Microsoft Entra ID (formerly Azure Active Directory) configuration options when providerType=ENTRAID.

id

string

False

The ID of the connection in Auth0.

name

string

False

The name of the connection in Auth0.

pingFederateOptions

unmigratedconnection_1.0_pingfederate_response_options

False

PingFederate configuration options when providerType=PINGFEDERATE.

providerType

string

False

The type of the identity provider. Defined values are:

  • "ADFS" - Active Directory Federation Services

  • "ENTRAID" - Microsoft Entra ID (formerly Azure Active Directory)

  • "PINGFEDERATE" - PingFederate

  • "SAML" - Security Assertion Markup Language 2.0

samlOptions

unmigratedconnection_1.0_saml_response_options

False

SAML configuration options when providerType=SAML.

type

string

False

Media type of the resource.

version

string

False

Version of the resource.

invalidParams

Name Type Required Description

name

string

True

Name of the invalid parameter.

reason

string

True

Reason why the parameter is invalid.