Jump to

• Request
• Response
• Examples

Initiates a single poll

put

/apiplatform/gatewaynode/v1/config/poller/poll

Initiates a poll to the management tier to fetch updates for this node from its associated logical gateway.

Users requesting this resource must be assigned the Gateway Manager role for the logical gateway this node is registered to.

Request

There are no request parameters for this operation.

Back to Top

Response

Supported Media Types

• application/json
• text/plain

200 Response

Single poll information.

Body ()

Entities processed in the poll.

Root Schema : SinglePollDetails

Entities processed in the poll.

Match All

Show Source

• object PollDelta

{
    "allOf":[
        {
            "$ref":"#/definitions/PollDelta"
        }
    ],
    "description":"Entities processed in the poll."
}

Nested Schema : PollDelta

Type: object

Show Source

• apis: array apis
  APIs processed in the poll.
• applications: array applications
  Applications processed in the poll.
• artifacts: array artifacts
  Artifacts processed in the poll.
• configurations: array configurations
  Configurations processed in the poll.
• policies: array policies
  Policies processed in the poll.
• serviceAccounts: array serviceAccounts
  Service Accounts processed in the poll.
• services: array services
  Service Objects processed in the poll.
• subscriptions: array subscriptions
  Subscriptions processed in the poll.

{
    "type":"object",
    "required":[
        "apis",
        "applications",
        "artifacts",
        "configurations",
        "policies",
        "serviceAccounts",
        "services",
        "subscriptions"
    ],
    "properties":{
        "artifacts":{
            "type":"array",
            "description":"Artifacts processed in the poll.",
            "items":{
                "$ref":"#/definitions/Artifact"
            }
        },
        "policies":{
            "type":"array",
            "description":"Policies processed in the poll.",
            "items":{
                "$ref":"#/definitions/Policy"
            }
        },
        "services":{
            "type":"array",
            "description":"Service Objects processed in the poll.",
            "items":{
                "$ref":"#/definitions/ServiceObject"
            }
        },
        "serviceAccounts":{
            "type":"array",
            "description":"Service Accounts processed in the poll.",
            "items":{
                "$ref":"#/definitions/ServiceAccount"
            }
        },
        "apis":{
            "type":"array",
            "description":"APIs processed in the poll.",
            "items":{
                "$ref":"#/definitions/Api"
            }
        },
        "applications":{
            "type":"array",
            "description":"Applications processed in the poll.",
            "items":{
                "$ref":"#/definitions/Application"
            }
        },
        "subscriptions":{
            "type":"array",
            "description":"Subscriptions processed in the poll.",
            "items":{
                "$ref":"#/definitions/Subscription"
            }
        },
        "configurations":{
            "type":"array",
            "description":"Configurations processed in the poll.",
            "items":{
                "$ref":"#/definitions/Configuration"
            }
        }
    }
}

Nested Schema : apis

Type: array

APIs processed in the poll.

Show Source

• Array of: object Api

{
    "type":"array",
    "description":"APIs processed in the poll.",
    "items":{
        "$ref":"#/definitions/Api"
    }
}

Nested Schema : applications

Type: array

Applications processed in the poll.

Show Source

• Array of: object Application

{
    "type":"array",
    "description":"Applications processed in the poll.",
    "items":{
        "$ref":"#/definitions/Application"
    }
}

Nested Schema : artifacts

Type: array

Artifacts processed in the poll.

Show Source

• Array of: object Artifact

{
    "type":"array",
    "description":"Artifacts processed in the poll.",
    "items":{
        "$ref":"#/definitions/Artifact"
    }
}

Nested Schema : configurations

Type: array

Configurations processed in the poll.

Show Source

• Array of: object Configuration

{
    "type":"array",
    "description":"Configurations processed in the poll.",
    "items":{
        "$ref":"#/definitions/Configuration"
    }
}

Nested Schema : policies

Type: array

Policies processed in the poll.

Show Source

• Array of: object Policy

{
    "type":"array",
    "description":"Policies processed in the poll.",
    "items":{
        "$ref":"#/definitions/Policy"
    }
}

Nested Schema : serviceAccounts

Type: array

Service Accounts processed in the poll.

Show Source

• Array of: object ServiceAccount

{
    "type":"array",
    "description":"Service Accounts processed in the poll.",
    "items":{
        "$ref":"#/definitions/ServiceAccount"
    }
}

Nested Schema : services

Type: array

Service Objects processed in the poll.

Show Source

• Array of: object ServiceObject

{
    "type":"array",
    "description":"Service Objects processed in the poll.",
    "items":{
        "$ref":"#/definitions/ServiceObject"
    }
}

Nested Schema : subscriptions

Type: array

Subscriptions processed in the poll.

Show Source

• Array of: object Subscription

{
    "type":"array",
    "description":"Subscriptions processed in the poll.",
    "items":{
        "$ref":"#/definitions/Subscription"
    }
}

Nested Schema : Api

Type: object

Show Source

• action: string
  The action performed on the API.
• apiId: string
  The API's ID.
• deploymentState: string
  The deployment state of the API.

{
    "type":"object",
    "required":[
        "action",
        "apiId",
        "deploymentState"
    ],
    "properties":{
        "apiId":{
            "type":"string",
            "description":"The API's ID."
        },
        "action":{
            "type":"string",
            "description":"The action performed on the API."
        },
        "deploymentState":{
            "type":"string",
            "description":"The deployment state of the API."
        }
    }
}

Nested Schema : Application

Type: object

Show Source

• action: string
  The action performed on the application.
• deploymentState: string
  The deployment state of the application.
• id: string
  The application's ID.

{
    "type":"object",
    "required":[
        "action",
        "deploymentState",
        "id"
    ],
    "properties":{
        "id":{
            "type":"string",
            "description":"The application's ID."
        },
        "action":{
            "type":"string",
            "description":"The action performed on the application."
        },
        "deploymentState":{
            "type":"string",
            "description":"The deployment state of the application."
        }
    }
}

Nested Schema : Artifact

Type: object

Show Source

• action: string
  The action performed with the artifact.
• deploymentState: string
  The deployment state of the artifact.
• name: string
  The artifact's name.
• version: string
  The artifact's version.

{
    "type":"object",
    "required":[
        "action",
        "deploymentState",
        "name",
        "version"
    ],
    "properties":{
        "name":{
            "type":"string",
            "description":"The artifact's name."
        },
        "action":{
            "type":"string",
            "description":"The action performed with the artifact."
        },
        "version":{
            "type":"string",
            "description":"The artifact's version."
        },
        "deploymentState":{
            "type":"string",
            "description":"The deployment state of the artifact."
        }
    }
}

Nested Schema : Configuration

Type: object

Show Source

• action: string
  The configuration action type.
• deploymentState: string
  The deployment state of the configuration.
• value: string
  The configuration value.

{
    "type":"object",
    "required":[
        "action",
        "deploymentState",
        "value"
    ],
    "properties":{
        "action":{
            "type":"string",
            "description":"The configuration action type."
        },
        "value":{
            "type":"string",
            "description":"The configuration value."
        },
        "deploymentState":{
            "type":"string",
            "description":"The deployment state of the configuration."
        }
    }
}

Nested Schema : Policy

Type: object

Show Source

• action: string
  The action performed on the policy.
• deploymentState: string
  The deployment state of the policy.
• name: string
  The policy's name.
• revision: string
  The policy's revision number.
• type: string
  The policy's type.
• version: string
  The policy's version.

{
    "type":"object",
    "required":[
        "action",
        "deploymentState",
        "name",
        "revision",
        "type",
        "version"
    ],
    "properties":{
        "name":{
            "type":"string",
            "description":"The policy's name."
        },
        "type":{
            "type":"string",
            "description":"The policy's type."
        },
        "action":{
            "type":"string",
            "description":"The action performed on the policy."
        },
        "version":{
            "type":"string",
            "description":"The policy's version."
        },
        "revision":{
            "type":"string",
            "description":"The policy's revision number."
        },
        "deploymentState":{
            "type":"string",
            "description":"The deployment state of the policy."
        }
    }
}

Nested Schema : ServiceAccount

Type: object

Show Source

• action: string
  The action performed with the service account.
• configuration(optional): string
  The configuration for the service account.
• deploymentState: string
  The deployment state of the service account.
• id: string
  The service account's ID.
• name(optional): string
  The name of the service account.

{
    "type":"object",
    "required":[
        "action",
        "deploymentState",
        "id"
    ],
    "properties":{
        "id":{
            "type":"string",
            "description":"The service account's ID."
        },
        "action":{
            "type":"string",
            "description":"The action performed with the service account."
        },
        "name":{
            "type":"string",
            "description":"The name of the service account."
        },
        "configuration":{
            "type":"string",
            "description":"The configuration for the service account."
        },
        "deploymentState":{
            "type":"string",
            "description":"The deployment state of the service account."
        }
    }
}

Nested Schema : ServiceObject

Type: object

Show Source

• action: string
  The action performed with the service.
• deploymentState: string
  The deployment state of the service object.
• id: string
  The service object's ID.
• implementation(optional): string
  The service object's implementation. Please see Object definition in Management APIs
• name(optional): string
  The service object's name.
• version(optional): string
  The service object's version.

{
    "type":"object",
    "required":[
        "action",
        "deploymentState",
        "id"
    ],
    "properties":{
        "id":{
            "type":"string",
            "description":"The service object's ID."
        },
        "action":{
            "type":"string",
            "description":"The action performed with the service."
        },
        "version":{
            "type":"string",
            "description":"The service object's version."
        },
        "deploymentState":{
            "type":"string",
            "description":"The deployment state of the service object."
        },
        "name":{
            "type":"string",
            "description":"The service object's name."
        },
        "implementation":{
            "type":"string",
            "description":"The service object's implementation. Please see Object definition in Management APIs"
        }
    }
}

Nested Schema : Subscription

Type: object

Show Source

• action: string
  The action performed on the subscription.
• apiId: string
  The API's ID.
• appId: string
  The application's ID.
• deploymentState: string
  The deployment state of the application.

{
    "type":"object",
    "required":[
        "action",
        "apiId",
        "appId",
        "deploymentState"
    ],
    "properties":{
        "apiId":{
            "type":"string",
            "description":"The API's ID."
        },
        "appId":{
            "type":"string",
            "description":"The application's ID."
        },
        "action":{
            "type":"string",
            "description":"The action performed on the subscription."
        },
        "deploymentState":{
            "type":"string",
            "description":"The deployment state of the application."
        }
    }
}

400 Response

Bad request, indicates a problem with the input parameters.

Body ()

Error Definition.

Root Schema : Error

Type: object

Error Definition.

Show Source

• detail(optional): string
  Detailed error message.
• errorCode(optional): string
  Application-specific error code.
• errorDetails(optional): array errorDetails
  Additional errors.
• errorPath(optional): string
• instance(optional): string
  URI to the link that provides more detail about the error.
• status(optional): string
  HTTP status code.
• title: string
  Summary error message.
• type: string
  Error type.

{
    "type":"object",
    "required":[
        "title",
        "type"
    ],
    "properties":{
        "type":{
            "type":"string",
            "description":"Error type."
        },
        "title":{
            "type":"string",
            "description":"Summary error message."
        },
        "detail":{
            "type":"string",
            "description":"Detailed error message."
        },
        "instance":{
            "type":"string",
            "description":"URI to the link that provides more detail about the error."
        },
        "errorCode":{
            "type":"string",
            "description":"Application-specific error code."
        },
        "errorPath":{
            "type":"string"
        },
        "status":{
            "type":"string",
            "description":"HTTP status code."
        },
        "errorDetails":{
            "type":"array",
            "description":"Additional errors.",
            "items":{
                "$ref":"#/definitions/Error"
            }
        }
    },
    "description":"Error Definition."
}

Nested Schema : errorDetails

Type: array

Additional errors.

Show Source

• Array of: object Error
  Error Definition.

{
    "type":"array",
    "description":"Additional errors.",
    "items":{
        "$ref":"#/definitions/Error"
    }
}

401 Response

Authentication required.

Body ()

Error Definition.

Root Schema : Error

Type: object

Error Definition.

Show Source

• detail(optional): string
  Detailed error message.
• errorCode(optional): string
  Application-specific error code.
• errorDetails(optional): array errorDetails
  Additional errors.
• errorPath(optional): string
• instance(optional): string
  URI to the link that provides more detail about the error.
• status(optional): string
  HTTP status code.
• title: string
  Summary error message.
• type: string
  Error type.

{
    "type":"object",
    "required":[
        "title",
        "type"
    ],
    "properties":{
        "type":{
            "type":"string",
            "description":"Error type."
        },
        "title":{
            "type":"string",
            "description":"Summary error message."
        },
        "detail":{
            "type":"string",
            "description":"Detailed error message."
        },
        "instance":{
            "type":"string",
            "description":"URI to the link that provides more detail about the error."
        },
        "errorCode":{
            "type":"string",
            "description":"Application-specific error code."
        },
        "errorPath":{
            "type":"string"
        },
        "status":{
            "type":"string",
            "description":"HTTP status code."
        },
        "errorDetails":{
            "type":"array",
            "description":"Additional errors.",
            "items":{
                "$ref":"#/definitions/Error"
            }
        }
    },
    "description":"Error Definition."
}

Nested Schema : errorDetails

Type: array

Additional errors.

Show Source

• Array of: object Error
  Error Definition.

{
    "type":"array",
    "description":"Additional errors.",
    "items":{
        "$ref":"#/definitions/Error"
    }
}

403 Response

Forbidden.

Body ()

Error Definition.

Root Schema : Error

Type: object

Error Definition.

Show Source

• detail(optional): string
  Detailed error message.
• errorCode(optional): string
  Application-specific error code.
• errorDetails(optional): array errorDetails
  Additional errors.
• errorPath(optional): string
• instance(optional): string
  URI to the link that provides more detail about the error.
• status(optional): string
  HTTP status code.
• title: string
  Summary error message.
• type: string
  Error type.

{
    "type":"object",
    "required":[
        "title",
        "type"
    ],
    "properties":{
        "type":{
            "type":"string",
            "description":"Error type."
        },
        "title":{
            "type":"string",
            "description":"Summary error message."
        },
        "detail":{
            "type":"string",
            "description":"Detailed error message."
        },
        "instance":{
            "type":"string",
            "description":"URI to the link that provides more detail about the error."
        },
        "errorCode":{
            "type":"string",
            "description":"Application-specific error code."
        },
        "errorPath":{
            "type":"string"
        },
        "status":{
            "type":"string",
            "description":"HTTP status code."
        },
        "errorDetails":{
            "type":"array",
            "description":"Additional errors.",
            "items":{
                "$ref":"#/definitions/Error"
            }
        }
    },
    "description":"Error Definition."
}

Nested Schema : errorDetails

Type: array

Additional errors.

Show Source

• Array of: object Error
  Error Definition.

{
    "type":"array",
    "description":"Additional errors.",
    "items":{
        "$ref":"#/definitions/Error"
    }
}

500 Response

Unexpected error.

Body ()

Error Definition.

Root Schema : Error

Type: object

Error Definition.

Show Source

• detail(optional): string
  Detailed error message.
• errorCode(optional): string
  Application-specific error code.
• errorDetails(optional): array errorDetails
  Additional errors.
• errorPath(optional): string
• instance(optional): string
  URI to the link that provides more detail about the error.
• status(optional): string
  HTTP status code.
• title: string
  Summary error message.
• type: string
  Error type.

{
    "type":"object",
    "required":[
        "title",
        "type"
    ],
    "properties":{
        "type":{
            "type":"string",
            "description":"Error type."
        },
        "title":{
            "type":"string",
            "description":"Summary error message."
        },
        "detail":{
            "type":"string",
            "description":"Detailed error message."
        },
        "instance":{
            "type":"string",
            "description":"URI to the link that provides more detail about the error."
        },
        "errorCode":{
            "type":"string",
            "description":"Application-specific error code."
        },
        "errorPath":{
            "type":"string"
        },
        "status":{
            "type":"string",
            "description":"HTTP status code."
        },
        "errorDetails":{
            "type":"array",
            "description":"Additional errors.",
            "items":{
                "$ref":"#/definitions/Error"
            }
        }
    },
    "description":"Error Definition."
}

Nested Schema : errorDetails

Type: array

Additional errors.

Show Source

• Array of: object Error
  Error Definition.

{
    "type":"array",
    "description":"Additional errors.",
    "items":{
        "$ref":"#/definitions/Error"
    }
}

503 Response

Temporarily unavailable error.

Body ()

Error Definition.

Root Schema : Error

Type: object

Error Definition.

Show Source

• detail(optional): string
  Detailed error message.
• errorCode(optional): string
  Application-specific error code.
• errorDetails(optional): array errorDetails
  Additional errors.
• errorPath(optional): string
• instance(optional): string
  URI to the link that provides more detail about the error.
• status(optional): string
  HTTP status code.
• title: string
  Summary error message.
• type: string
  Error type.

{
    "type":"object",
    "required":[
        "title",
        "type"
    ],
    "properties":{
        "type":{
            "type":"string",
            "description":"Error type."
        },
        "title":{
            "type":"string",
            "description":"Summary error message."
        },
        "detail":{
            "type":"string",
            "description":"Detailed error message."
        },
        "instance":{
            "type":"string",
            "description":"URI to the link that provides more detail about the error."
        },
        "errorCode":{
            "type":"string",
            "description":"Application-specific error code."
        },
        "errorPath":{
            "type":"string"
        },
        "status":{
            "type":"string",
            "description":"HTTP status code."
        },
        "errorDetails":{
            "type":"array",
            "description":"Additional errors.",
            "items":{
                "$ref":"#/definitions/Error"
            }
        }
    },
    "description":"Error Definition."
}

Nested Schema : errorDetails

Type: array

Additional errors.

Show Source

• Array of: object Error
  Error Definition.

{
    "type":"array",
    "description":"Additional errors.",
    "items":{
        "$ref":"#/definitions/Error"
    }
}

Back to Top

Examples

The following example shows how to initiate a poll by submitting a PUT request on the REST resource using cURL. For more information about cURL, see Use cURL

curl -i -X PUT 
-H "Authorization: Bearer access_token 
https://example.com/apiplatform/gatewaynode/v1/config/poller/poll

Example of Response Headers

The following shows an example of the response headers.

HTTP/1.1 200 OK
Date: Fri, 30 Dec 2016 18:31:59 GMT
Transfer-Encoding: chunked
Content-Type: application/json

Example of Response Body

The following example shows the contents of the response body in JSON format.

{
  "subscriptions": [],
  "apis": [],
  "configurations": [],
  "policies": [],
  "artifacts": [],
  "applications": []
}

Back to Top