/client-python

Primary LanguagePythonApache License 2.0Apache-2.0

Grafeas

An API to insert and retrieve annotations on cloud artifacts.

This Python package is automatically generated by the Swagger Codegen project:

  • API version: v1alpha1
  • Package version: v1alpha1
  • Build package: io.swagger.codegen.languages.PythonClientCodegen

Requirements.

Python 2.7 and 3.4+

Installation & Usage

pip install

To install the package from this repository:

pip3 install git+https://github.com/grafeas/client-python.git#egg=Grafeas --user

Then import the package:

import grafeas 

Setuptools

Install via Setuptools.

python setup.py install --user

(or sudo python setup.py install to install the package for all users)

Then import the package:

import grafeas

Getting Started

Please follow the installation procedure and then run the following:

from __future__ import print_function
import time
import grafeas
from grafeas.rest import ApiException
from pprint import pprint

# create an instance of the API class
api_instance = grafeas.GrafeasApi(grafeas.ApiClient(configuration))
parent = 'parent_example' # str | This field contains the project Id for example: \"project/{project_id}
body = grafeas.ApiNote() # ApiNote | The Note to be inserted

try:
    # Creates a new `Note`.
    api_response = api_instance.create_note(parent, body)
    pprint(api_response)
except ApiException as e:
    print("Exception when calling GrafeasApi->create_note: %s\n" % e)

Documentation for API Endpoints

All URIs are relative to http://localhost

Class Method HTTP request Description
GrafeasApi create_note POST /v1alpha1/{parent=projects/*}/notes Creates a new `Note`.
GrafeasApi create_occurrence POST /v1alpha1/{parent=projects/*}/occurrences Creates a new `Occurrence`. Use this method to create `Occurrences` for a resource.
GrafeasApi create_operation POST /v1alpha1/{parent=projects/*}/operations Creates a new `Operation`.
GrafeasApi delete_note DELETE /v1alpha1/{name=projects//notes/} Deletes the given `Note` from the system.
GrafeasApi delete_occurrence DELETE /v1alpha1/{name=projects//occurrences/} Deletes the given `Occurrence` from the system. Use this when an `Occurrence` is no longer applicable for the given resource.
GrafeasApi get_note GET /v1alpha1/{name=projects//notes/} Returns the requested `Note`.
GrafeasApi get_occurrence GET /v1alpha1/{name=projects//occurrences/} Returns the requested `Occurrence`.
GrafeasApi get_occurrence_note GET /v1alpha1/{name=projects//occurrences/}/notes Gets the `Note` attached to the given `Occurrence`.
GrafeasApi list_note_occurrences GET /v1alpha1/{name=projects//notes/}/occurrences Lists `Occurrences` referencing the specified `Note`. Use this method to get all occurrences referencing your `Note` across all your customer projects.
GrafeasApi list_notes GET /v1alpha1/{parent=projects/*}/notes Lists all `Notes` for a given project.
GrafeasApi list_occurrences GET /v1alpha1/{parent=projects/*}/occurrences Lists active `Occurrences` for a given project matching the filters.
GrafeasApi update_note PATCH /v1alpha1/{name=projects//notes/} Updates an existing `Note`.
GrafeasApi update_occurrence PATCH /v1alpha1/{name=projects//occurrences/} Updates an existing occurrence.
GrafeasApi update_operation PATCH /v1alpha1/{name=projects//operations/} Updates an existing operation returns an error if operation does not exist. The only valid operations are to update mark the done bit change the result.
GrafeasProjectsApi create_project POST /v1alpha1/projects Creates a new project.
GrafeasProjectsApi delete_project DELETE /v1alpha1/{name=projects/*} Deletes the specified project.
GrafeasProjectsApi get_project GET /v1alpha1/{name=projects/*} Gets the specified project.
GrafeasProjectsApi list_projects GET /v1alpha1/projects Lists projects.

Documentation For Models

Documentation For Authorization

All endpoints do not require authorization.

Author