# README

Go API client for generated

The administration REST API for IBM Event Streams on Cloud.

Overview

This API client was generated by the OpenAPI Generator project. By using the OpenAPI-spec from a remote server, you can easily generate an API client.

  • API version: 1.1.0
  • Package version: 1.0.0
  • Build package: org.openapitools.codegen.languages.GoClientCodegen

Installation

Install the following dependencies:

go get github.com/stretchr/testify/assert
go get golang.org/x/oauth2
go get golang.org/x/net/context
go get github.com/antihax/optional

Put the package under your project folder and add the following in import:

import "./generated"

Documentation for API Endpoints

All URIs are relative to http://localhost

ClassMethodHTTP requestDescription
DefaultApiCreateTopicPost /admin/topicsCreate a new topic.
DefaultApiDeleteTopicDelete /admin/topics/{topic_name}Delete a topic.
DefaultApiGetTopicGet /admin/topics/{topic_name}Get detailed information on a topic.
DefaultApiListTopicsGet /admin/topicsGet a list of topics.
DefaultApiUpdateTopicPatch /admin/topics/{topic_name}Increase the number of partitions and/or update one or more topic configuration parameters.

Documentation For Models

Documentation For Authorization

APIKeyAuth

  • Type: API key

Example

auth := context.WithValue(context.Background(), sw.ContextAPIKey, sw.APIKey{
    Key: "APIKEY",
    Prefix: "Bearer", // Omit if not necessary.
})
r, err := client.Service.Operation(auth, args)

BasicAuth

  • Type: HTTP basic authentication

Example

auth := context.WithValue(context.Background(), sw.ContextBasicAuth, sw.BasicAuth{
    UserName: "username",
    Password: "password",
})
r, err := client.Service.Operation(auth, args)

TokenAuth

  • Type: API key

Example

auth := context.WithValue(context.Background(), sw.ContextAPIKey, sw.APIKey{
    Key: "APIKEY",
    Prefix: "Bearer", // Omit if not necessary.
})
r, err := client.Service.Operation(auth, args)

Author

# Functions

CacheExpires helper function to determine remaining time before repeating a request.
NewAPIClient creates a new API client.
NewAPIResponse returns a new APIResonse object.
NewAPIResponseWithError returns a new APIResponse object with the provided error message.
NewConfiguration returns a new Configuration object.

# Variables

ContextAccessToken takes a string oauth2 access token as authentication for the request.
ContextAPIKey takes an APIKey as authentication for the request.
ContextBasicAuth takes BasicAuth as authentication for the request.
ContextOAuth2 takes an oauth2.TokenSource as authentication for the request.

# Structs

APIClient manages communication with the IBM Event Streams Administration REST API API v1.1.0 In most cases there should be only one, shared, APIClient.
APIKey provides API key based authentication to a request passed via context using ContextAPIKey.
APIResponse stores the API response returned by the server.
BasicAuth provides basic http authentication to a request passed via context using ContextBasicAuth.
ConfigCreate struct for ConfigCreate.
ConfigUpdate struct for ConfigUpdate.
Configuration stores the configuration of the API client.
GenericOpenAPIError Provides access to the body, error and model on returned errors.
ListTopicsOpts Optional parameters for the method 'ListTopics'.
ModelError struct for ModelError.
ReplicaAssignment struct for ReplicaAssignment.
ReplicaAssignmentBrokers struct for ReplicaAssignmentBrokers.
ServerConfiguration stores the information about a server.
ServerVariable stores the information about a server variable.
TopicConfigs struct for TopicConfigs.
TopicCreateRequest struct for TopicCreateRequest.
TopicDetail struct for TopicDetail.
TopicUpdateRequest struct for TopicUpdateRequest.

# Type aliases

DefaultApiService DefaultApi service.