Skip to main content

sonatype-guide-api-client

REST API into Sonatype Guide.

This Python package is automatically generated by the OpenAPI Generator project:

  • API version: 202608
  • Package version: 1.0.0
  • Generator version: 7.16.0
  • Build package: org.openapitools.codegen.languages.PythonClientCodegen For more information, please visit https://github.com/sonatype-nexus-community

Requirements.

Python 3.9+

Installation & Usage

pip install

If the python package is hosted on a repository, you can install directly using:

pip install git+https://github.com/sonatype-nexus-community/sonatype-guide-api-client.git

(you may need to run pip with root permission: sudo pip install git+https://github.com/sonatype-nexus-community/sonatype-guide-api-client.git)

Then import the package:

import sonatype_guide_api_client

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 sonatype_guide_api_client

Tests

Execute pytest to run the tests.

Getting Started

Please follow the installation procedure and then run the following:

import sonatype_guide_api_client
from sonatype_guide_api_client.rest import ApiException
from pprint import pprint

# Defining the host is optional and defaults to https://api.guide.sonatype.com
# See configuration.py for a list of all supported configuration parameters.
configuration = sonatype_guide_api_client.Configuration(
    host = "https://api.guide.sonatype.com"
)

# The client must configure the authentication and authorization parameters
# in accordance with the API server security policy.
# Examples for each auth method are provided below, use the example that
# satisfies your auth use case.

# Configure Bearer authorization (JWT): bearer-jwt
configuration = sonatype_guide_api_client.Configuration(
    access_token = os.environ["BEARER_TOKEN"]
)


# Enter a context with an instance of the API client
with sonatype_guide_api_client.ApiClient(configuration) as api_client:
    # Create an instance of the API class
    api_instance = sonatype_guide_api_client.AGPBulkOnboardingApi(api_client)

    try:
        # Get the caller's currently-running bulk onboarding job, if any
        api_response = api_instance.active()
        print("The response of AGPBulkOnboardingApi->active:\n")
        pprint(api_response)
    except ApiException as e:
        print("Exception when calling AGPBulkOnboardingApi->active: %s\n" % e)

Documentation for API Endpoints

All URIs are relative to https://api.guide.sonatype.com

Class Method HTTP request Description
AGPBulkOnboardingApi active GET /api/agp/onboarding/bulk/active Get the caller's currently-running bulk onboarding job, if any
AGPBulkOnboardingApi org_activity GET /api/agp/onboarding/bulk/org-activity Whether another org member currently has a bulk onboarding job in flight
AGPBulkOnboardingApi progress GET /api/agp/onboarding/bulk/{jobId} Get bulk onboarding job progress
AGPBulkOnboardingApi start POST /api/agp/onboarding/bulk Start bulk onboarding for selected repositories
AGPDashboardApi candidate_ids GET /api/agp/dashboard/candidate-ids Ids of all onboarding-candidate repositories matching the name filter
AGPDashboardApi dashboard GET /api/agp/dashboard List connected repositories with status (search, filter & paging)
AGPDashboardApi onboarding_access GET /api/agp/dashboard/onboarding-access Whether the caller may onboard repositories
AGPGovernanceApi agentic_mode_access GET /api/agp/agentic-mode-access Whether the caller's org is registered for AgentP agentic mode (org-scoped; gates the AI Fix toggle + AI agent config in the UI)
AGPGovernanceApi delete_repo_config DELETE /api/agp/repos/{installationRepoId}/config Reset a repo to the Default Configuration by clearing its config overrides (any org member)
AGPGovernanceApi get_org_config GET /api/agp/org/config Get the AgentP Default Configuration (read: any org member)
AGPGovernanceApi get_org_effective_config GET /api/agp/org/effective-config Get the rendered Default Configuration agp.yml (defaults + org) (Owner-only)
AGPGovernanceApi get_repo_config GET /api/agp/repos/{installationRepoId}/config Get a repo's AgentP config overrides + inherited Default Configuration + version (any org member)
AGPGovernanceApi get_repo_effective_config GET /api/agp/repos/{installationRepoId}/effective-config Get the rendered effective agp.yml for a repo (defaults + org + overrides) (any org member)
AGPGovernanceApi open_removal_pr POST /api/agp/repos/{installationRepoId}/removal-pr Open (and optionally merge) a PR removing the AgentP workflow file from a repository (any org member)
AGPGovernanceApi pause POST /api/agp/repos/{installationRepoId}/pause Pause AgentP for a repository (any org member)
AGPGovernanceApi resume POST /api/agp/repos/{installationRepoId}/resume Resume AgentP for a repository (any org member)
AGPGovernanceApi update_org_config PUT /api/agp/org/config Set the AgentP Default Configuration + developer-access flag (Owner-only)
AGPGovernanceApi update_repo_config PUT /api/agp/repos/{installationRepoId}/config Set per-repo AgentP config overrides (any org member)
ActivityLogApi get_activity_log GET /users/me/organization/activity-log Get organization activity log
BillingApi get_billing GET /billing Get billing information
BillingApi get_invoice_pdf GET /billing/invoices/{invoiceId}/pdf Download invoice PDF
BillingApi get_plans GET /billing/plans Get all available plans
BillingApi get_user_invoice_history GET /billing/invoices Get user invoice history
ComponentsApi get_component_dependencies_by_purl_query_param GET /components/dependencies Get dependencies for a component by coordinates (query parameters)
ComponentsApi get_component_detail_by_purl_query_param GET /components/detail Get component detail by coordinates (query parameters)
ComponentsApi get_component_versions_by_purl_query_param GET /components/versions Get all component versions by coordinates (query parameters)
ComponentsApi get_component_vulnerabilities_by_purl_query_param GET /components/vulnerabilities Get vulnerabilities for a component by coordinates (query parameters)
ComponentsApi get_latest_version POST /components/latest-version Get latest version of a component
CurrentUserOrganizationApi accept_invitation POST /users/me/organization/invitations/{invitationToken}/accept Accept organization invitation
CurrentUserOrganizationApi bulk_remove_members_or_invitations DELETE /users/me/organization/members Bulk remove members or invitations from organization
CurrentUserOrganizationApi dismiss_onboarding_banner DELETE /users/me/organization/onboarding-banner Dismiss onboarding banner
CurrentUserOrganizationApi get_current_user_organization GET /users/me/organization Get current user's organization
CurrentUserOrganizationApi get_onboarding_banner_status GET /users/me/organization/onboarding-banner Get onboarding banner status
CurrentUserOrganizationApi invite_users POST /users/me/organization/members/invite Invite users to current user's an organization
CurrentUserOrganizationApi leave_organization DELETE /users/me/organization/membership Leave organization
CurrentUserOrganizationApi remove_member_or_invitation DELETE /users/me/organization/members/{email} Remove member or invitation from organization
CurrentUserOrganizationApi retrieve_organization_members_as_csv GET /users/me/organization/members Retrieve current user's organization members and invitees
CurrentUserOrganizationApi update_organization PUT /users/me/organization Update current user's organization
CurrentUserTokensApi create_token POST /users/me/tokens Create a new Personal Access Token
CurrentUserTokensApi get_token_by_id GET /users/me/tokens/{tokenId} Get a Personal Access Token by ID
CurrentUserTokensApi list_tokens GET /users/me/tokens List all Personal Access Tokens
CurrentUserTokensApi revoke_token DELETE /users/me/tokens/{tokenId} Revoke a Personal Access Token
CurrentUserTokensApi rotate_token POST /users/me/tokens/{tokenId}/rotate Rotate a Personal Access Token
OSSIndexCompatibilityApi get_component_report GET /api/v3/authorized/component-report/** Get component report by PURL
OSSIndexCompatibilityApi get_component_report1 GET /api/v3/component-report/** Get component report by PURL
OSSIndexCompatibilityApi get_component_reports POST /api/v3/component-report Get component reports for multiple PURLs
OSSIndexCompatibilityApi get_component_reports1 POST /api/v3/authorized/component-report Get component reports for multiple PURLs
OSSIndexCompatibilityApi get_version GET /api/v3/version Get API version
RecommendationsApi get_recommendations POST /recommendations Get version upgrade recommendations
SecurityEventsApi get_security_event_by_id GET /security-events/{id} Get security event by ID
UsageApi get_credit_periods GET /usage/credit-periods Get credit periods
UsageApi get_cumulative_usage GET /usage/cumulative Get cumulative credit usage for a billing period
UsageApi get_ossi_usage_history GET /usage/ossi-history Get historical OSSI usage
UsageApi get_usage GET /usage Get usage information
VulnerabilitiesApi get_vulnerability_affected_components GET /vulnerabilities/{id}/components Get affected components for a vulnerability
VulnerabilitiesApi get_vulnerability_by_ref_id GET /vulnerabilities/{id} Get vulnerability by ID

Documentation For Models

Documentation For Authorization

Authentication schemes defined for the API:

bearer-jwt

  • Type: Bearer authentication (JWT)

ossi-basic-auth

  • Type: HTTP basic authentication

user-token

  • Type: Bearer authentication

Author

community@sonatype.com

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

sonatype_guide_api_client-1.202608.1.tar.gz (88.6 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

sonatype_guide_api_client-1.202608.1-py3-none-any.whl (167.8 kB view details)

Uploaded Python 3

File details

Details for the file sonatype_guide_api_client-1.202608.1.tar.gz.

File metadata

File hashes

Hashes for sonatype_guide_api_client-1.202608.1.tar.gz
Algorithm Hash digest
SHA256 04234f30658439f29712d9de8710ee3ab1d5d0e833d2fa79a93fef30f8368751
MD5 e49bbe1133c15575d4d3c5a61155ddc9
BLAKE2b-256 587ad06991ba90b3cdca1227b387c88a74ef315dc8988a86431676231c0a6705

See more details on using hashes here.

Provenance

The following attestation bundles were made for sonatype_guide_api_client-1.202608.1.tar.gz:

Publisher: release.yaml on sonatype-nexus-community/sonatype-guide-api-client

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file sonatype_guide_api_client-1.202608.1-py3-none-any.whl.

File metadata

File hashes

Hashes for sonatype_guide_api_client-1.202608.1-py3-none-any.whl
Algorithm Hash digest
SHA256 8810ef325c024fb41aa8211756cbea9b18986418e8e2a34dfc24ce1f85577d75
MD5 d24a367abc2128a8ec70a752f2bb6e5e
BLAKE2b-256 10ff9af0309c3964a50f2a98f30e8a1416d2eb55528f267b0da45c96db3e3eb3

See more details on using hashes here.

Provenance

The following attestation bundles were made for sonatype_guide_api_client-1.202608.1-py3-none-any.whl:

Publisher: release.yaml on sonatype-nexus-community/sonatype-guide-api-client

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Release history Release notifications | RSS feed

1.202608.3

2 files

1.202608.2

2 files

This release

1.202608.1 This release

2 files

1.202608.0

2 files

1.202607.2

2 files

1.202607.1

2 files

1.202607.0

2 files

1.202606.2

2 files

1.202606.1

2 files

1.202605.3

2 files

1.202605.2

2 files

1.202605.1

2 files

1.202605.0

2 files

0.1.0

2 files

0.0.2

2 files

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page