List all Provider Instances

GET /v1/Providers/Instances

Returns a list of the provider instances in the tenant. The provider instances are returned sorted by provider.

Headers

X-Tenant string Required

The domain used to access the portal.
Authorization string Required

JWT Authorization header using the Bearer scheme. Example: "Authorization: Bearer {token}"

Default value is Bearer eyJ0eXAiO....
X-Correlation-Id string(UUID)

This header is optional and by setting it you can correlate the audit logs made by this request.

Query parameters

pageNumber integer(int32)

A cursor for pagination across multiple pages of results. The default value is 1.
pageSize integer(int32)

The number of objects to be returned at each page. The size can range between 1 and 2000, and the default is 25.

Responses

200

text/plain

text/plain application/json text/json

OK
Hide response attributes Show response attributes object
- items array[object] | null
  
  The items for this page.
  
  Hide items attributes Show items attributes object
  
  id string(uuid)
  
  The id of the instance.
  
  alias string | null
  
  Alias for the instance of the provider.
  
  instanceProviderId string | null
  
  The id that identifies the instance on the providers side
  
  imageUrl string | null
  
  The provider instance image url.
  
  offerTypes array[object] | null
  
  The list of offer types that the provider instance allows selling.
  
  Hide offerTypes attribute Show offerTypes attribute object
  
  name string | null
  
  The name of the enumeration.
  
  supportedCountries array[string] | null
  
  Contains all the supported countries available for the provider instance.
  
  providerData string | null
  
  The provider instance data.
  
  provider object
  
  The viewmodel for the Provider entity.
  
  Additional properties are NOT allowed.
  
  Hide provider attributes Show provider attributes object
  
  id string(uuid)
  
  The id of the provider.
  
  name string | null
  
  The name of the provider.
  
  description string | null
  
  The description of the provider.
  
  imageUrl string | null
  
  The url that points to the image that represents the provider.
- paginationParameters object
  
  A model that is used to encapsulate the parameters needed to perform pagination queries.
  
  Additional properties are NOT allowed.
  
  Hide paginationParameters attributes Show paginationParameters attributes object
  
  pageNumber integer(int32)
  
  Indicates the number of the current page.
  
  pageSize integer(int32)
  
  The number of items that should be returned at most per page.
- totalPages integer(int32)
  
  The total number of pages available for the specified parameters and page size.
- totalCount integer(int32)
  
  The total number of results available for the specified parameters. Note this is typically not equal to the Count of items in the Items property, will only be equal if all the items fit in the first page.
- hasPreviousPage boolean
  
  Indicates if there is a previous page.
- hasNextPage boolean
  
  Indicates if there is a next page.
- continuationToken string | null
  
  The token to continue to retrieve the paginated items.
Hide response attributes Show response attributes object
- items array[object] | null
  
  The items for this page.
  
  Hide items attributes Show items attributes object
  
  id string(uuid)
  
  The id of the instance.
  
  alias string | null
  
  Alias for the instance of the provider.
  
  instanceProviderId string | null
  
  The id that identifies the instance on the providers side
  
  imageUrl string | null
  
  The provider instance image url.
  
  offerTypes array[object] | null
  
  The list of offer types that the provider instance allows selling.
  
  Hide offerTypes attribute Show offerTypes attribute object
  
  name string | null
  
  The name of the enumeration.
  
  supportedCountries array[string] | null
  
  Contains all the supported countries available for the provider instance.
  
  providerData string | null
  
  The provider instance data.
  
  provider object
  
  The viewmodel for the Provider entity.
  
  Additional properties are NOT allowed.
  
  Hide provider attributes Show provider attributes object
  
  id string(uuid)
  
  The id of the provider.
  
  name string | null
  
  The name of the provider.
  
  description string | null
  
  The description of the provider.
  
  imageUrl string | null
  
  The url that points to the image that represents the provider.
- paginationParameters object
  
  A model that is used to encapsulate the parameters needed to perform pagination queries.
  
  Additional properties are NOT allowed.
  
  Hide paginationParameters attributes Show paginationParameters attributes object
  
  pageNumber integer(int32)
  
  Indicates the number of the current page.
  
  pageSize integer(int32)
  
  The number of items that should be returned at most per page.
- totalPages integer(int32)
  
  The total number of pages available for the specified parameters and page size.
- totalCount integer(int32)
  
  The total number of results available for the specified parameters. Note this is typically not equal to the Count of items in the Items property, will only be equal if all the items fit in the first page.
- hasPreviousPage boolean
  
  Indicates if there is a previous page.
- hasNextPage boolean
  
  Indicates if there is a next page.
- continuationToken string | null
  
  The token to continue to retrieve the paginated items.
Hide response attributes Show response attributes object
- items array[object] | null
  
  The items for this page.
  
  Hide items attributes Show items attributes object
  
  id string(uuid)
  
  The id of the instance.
  
  alias string | null
  
  Alias for the instance of the provider.
  
  instanceProviderId string | null
  
  The id that identifies the instance on the providers side
  
  imageUrl string | null
  
  The provider instance image url.
  
  offerTypes array[object] | null
  
  The list of offer types that the provider instance allows selling.
  
  Hide offerTypes attribute Show offerTypes attribute object
  
  name string | null
  
  The name of the enumeration.
  
  supportedCountries array[string] | null
  
  Contains all the supported countries available for the provider instance.
  
  providerData string | null
  
  The provider instance data.
  
  provider object
  
  The viewmodel for the Provider entity.
  
  Additional properties are NOT allowed.
  
  Hide provider attributes Show provider attributes object
  
  id string(uuid)
  
  The id of the provider.
  
  name string | null
  
  The name of the provider.
  
  description string | null
  
  The description of the provider.
  
  imageUrl string | null
  
  The url that points to the image that represents the provider.
- paginationParameters object
  
  A model that is used to encapsulate the parameters needed to perform pagination queries.
  
  Additional properties are NOT allowed.
  
  Hide paginationParameters attributes Show paginationParameters attributes object
  
  pageNumber integer(int32)
  
  Indicates the number of the current page.
  
  pageSize integer(int32)
  
  The number of items that should be returned at most per page.
- totalPages integer(int32)
  
  The total number of pages available for the specified parameters and page size.
- totalCount integer(int32)
  
  The total number of results available for the specified parameters. Note this is typically not equal to the Count of items in the Items property, will only be equal if all the items fit in the first page.
- hasPreviousPage boolean
  
  Indicates if there is a previous page.
- hasNextPage boolean
  
  Indicates if there is a next page.
- continuationToken string | null
  
  The token to continue to retrieve the paginated items.
400

text/plain

text/plain application/json text/json

Bad Request
Hide response attributes Show response attributes object
- statusCode integer(int32)
  
  The HTTP status code that represents a specific error scenario.
- type string | null
  
  The type of error that occurred.
- description string | null
  
  Describes the error scenario that occurred.
- correlationId string | null
  
  The correlationId of the request that originated the error.
- errors array[object] | null
  
  A list containing the detail of the errors that occurred in this error scenario.
  
  Hide errors attributes Show errors attributes object
  
  propertyName string | null
  
  The name of the property involved in the error.
  
  description array[string] | null
  
  A description of each error associated with the given property.
Hide response attributes Show response attributes object
- statusCode integer(int32)
  
  The HTTP status code that represents a specific error scenario.
- type string | null
  
  The type of error that occurred.
- description string | null
  
  Describes the error scenario that occurred.
- correlationId string | null
  
  The correlationId of the request that originated the error.
- errors array[object] | null
  
  A list containing the detail of the errors that occurred in this error scenario.
  
  Hide errors attributes Show errors attributes object
  
  propertyName string | null
  
  The name of the property involved in the error.
  
  description array[string] | null
  
  A description of each error associated with the given property.
Hide response attributes Show response attributes object
- statusCode integer(int32)
  
  The HTTP status code that represents a specific error scenario.
- type string | null
  
  The type of error that occurred.
- description string | null
  
  Describes the error scenario that occurred.
- correlationId string | null
  
  The correlationId of the request that originated the error.
- errors array[object] | null
  
  A list containing the detail of the errors that occurred in this error scenario.
  
  Hide errors attributes Show errors attributes object
  
  propertyName string | null
  
  The name of the property involved in the error.
  
  description array[string] | null
  
  A description of each error associated with the given property.
401

Unauthorized
403

Forbidden
500

text/plain

text/plain application/json text/json

Internal Server Error
Hide response attributes Show response attributes object
- statusCode integer(int32)
  
  The HTTP status code that represents a specific error scenario.
- type string | null
  
  The type of error that occurred.
- description string | null
  
  Describes the error scenario that occurred.
- correlationId string | null
  
  The correlationId of the request that originated the error.
- errors array[object] | null
  
  A list containing the detail of the errors that occurred in this error scenario.
  
  Hide errors attributes Show errors attributes object
  
  propertyName string | null
  
  The name of the property involved in the error.
  
  description array[string] | null
  
  A description of each error associated with the given property.
Hide response attributes Show response attributes object
- statusCode integer(int32)
  
  The HTTP status code that represents a specific error scenario.
- type string | null
  
  The type of error that occurred.
- description string | null
  
  Describes the error scenario that occurred.
- correlationId string | null
  
  The correlationId of the request that originated the error.
- errors array[object] | null
  
  A list containing the detail of the errors that occurred in this error scenario.
  
  Hide errors attributes Show errors attributes object
  
  propertyName string | null
  
  The name of the property involved in the error.
  
  description array[string] | null
  
  A description of each error associated with the given property.
Hide response attributes Show response attributes object
- statusCode integer(int32)
  
  The HTTP status code that represents a specific error scenario.
- type string | null
  
  The type of error that occurred.
- description string | null
  
  Describes the error scenario that occurred.
- correlationId string | null
  
  The correlationId of the request that originated the error.
- errors array[object] | null
  
  A list containing the detail of the errors that occurred in this error scenario.
  
  Hide errors attributes Show errors attributes object
  
  propertyName string | null
  
  The name of the property involved in the error.
  
  description array[string] | null
  
  A description of each error associated with the given property.

GET /v1/Providers/Instances

curl \
 -X GET https://app-cloudcockpitapi-prod-01.azurewebsites.net/v1/Providers/Instances \
 -H "X-Tenant: portal.cloudcockpit.com" \
 -H "Authorization: Bearer eyJ0eXAiO..." \
 -H "X-Correlation-Id: string"

Response examples (200)

{
  "items": [
    {
      "id": "string",
      "alias": "string",
      "instanceProviderId": "string",
      "imageUrl": "string",
      "offerTypes": [
        {
          "name": "string"
        }
      ],
      "supportedCountries": [
        "string"
      ],
      "providerData": "string",
      "provider": {
        "id": "string",
        "name": "string",
        "description": "string",
        "imageUrl": "string"
      }
    }
  ],
  "paginationParameters": {
    "pageNumber": 42,
    "pageSize": 42
  },
  "totalPages": 42,
  "totalCount": 42,
  "hasPreviousPage": true,
  "hasNextPage": true,
  "continuationToken": "string"
}

Response examples (200)

{
  "items": [
    {
      "id": "string",
      "alias": "string",
      "instanceProviderId": "string",
      "imageUrl": "string",
      "offerTypes": [
        {
          "name": "string"
        }
      ],
      "supportedCountries": [
        "string"
      ],
      "providerData": "string",
      "provider": {
        "id": "string",
        "name": "string",
        "description": "string",
        "imageUrl": "string"
      }
    }
  ],
  "paginationParameters": {
    "pageNumber": 42,
    "pageSize": 42
  },
  "totalPages": 42,
  "totalCount": 42,
  "hasPreviousPage": true,
  "hasNextPage": true,
  "continuationToken": "string"
}

Response examples (400)

{
  "statusCode": 42,
  "type": "string",
  "description": "string",
  "correlationId": "string",
  "errors": [
    {
      "propertyName": "string",
      "description": [
        "string"
      ]
    }
  ]
}

Response examples (400)

{
  "statusCode": 42,
  "type": "string",
  "description": "string",
  "correlationId": "string",
  "errors": [
    {
      "propertyName": "string",
      "description": [
        "string"
      ]
    }
  ]
}

Response examples (500)

{
  "statusCode": 42,
  "type": "string",
  "description": "string",
  "correlationId": "string",
  "errors": [
    {
      "propertyName": "string",
      "description": [
        "string"
      ]
    }
  ]
}

Response examples (500)

{
  "statusCode": 42,
  "type": "string",
  "description": "string",
  "correlationId": "string",
  "errors": [
    {
      "propertyName": "string",
      "description": [
        "string"
      ]
    }
  ]
}