mirror of
https://github.com/hanzo-cpp/sdk.git
synced 2026-11-20 19:55:32 +00:00
The projection was 113 commits behind the document it claims to describe, and `generate.py --all --check` reported every one of the thirteen clients DRIFTED — the same +19 models in each, because they all fell behind the same emission. Regenerated in place from hanzo-inc/cloud openapi.yaml at 939b09d4 (sha256 087024f6…), which is the only description of this API that cannot name a route the binary does not serve. `--check` is clean across all thirteen after. .spec-lock moved with the code. The generator READS that file and never writes it — hanzoai/ci`s lane does — so a hand run leaves every lock naming the previous document. A lock that disagrees with the tree beside it is worse than no lock: the next `--check` without `--spec` fetches what production serves, compares it to a digest that was already wrong, and reports drift that is really staleness.
114 lines
5.4 KiB
C++
114 lines
5.4 KiB
C++
/**
|
|
* Hanzo Cloud API
|
|
* The Hanzo Cloud API as a customer calls it: every operation under /v1/ except the operator's admin product, relay routes, legacy spellings and capabilities still reached by flag. Tagged by product: the first path segment after /v1/.
|
|
*
|
|
* The version of the OpenAPI document: v1
|
|
*
|
|
* NOTE: This class is auto generated by OpenAPI-Generator 7.14.0.
|
|
* https://openapi-generator.tech
|
|
* Do not edit the class manually.
|
|
*/
|
|
|
|
/*
|
|
* RegistryApi.h
|
|
*
|
|
*
|
|
*/
|
|
|
|
#ifndef HANZO_API_RegistryApi_H_
|
|
#define HANZO_API_RegistryApi_H_
|
|
|
|
|
|
|
|
#include "hanzo/ApiClient.h"
|
|
|
|
#include "hanzo/model/RegistryImageList.h"
|
|
#include "hanzo/model/RegistryMint.h"
|
|
#include "hanzo/model/RegistryPackageList.h"
|
|
#include "hanzo/model/RegistryProjectList.h"
|
|
#include "hanzo/model/RegistryStatus.h"
|
|
#include "hanzo/model/RegistryTagList.h"
|
|
#include "hanzo/model/RegistryToken.h"
|
|
#include <cpprest/details/basic_types.h>
|
|
#include <boost/optional.hpp>
|
|
|
|
namespace hanzo {
|
|
namespace api {
|
|
|
|
using namespace hanzo::model;
|
|
|
|
|
|
|
|
class RegistryApi
|
|
{
|
|
public:
|
|
|
|
explicit RegistryApi( std::shared_ptr<const ApiClient> apiClient );
|
|
|
|
virtual ~RegistryApi();
|
|
|
|
/// <summary>
|
|
/// Images lists the org's container repositories, read live from the OCI catalog and filtered server-side to the org's namespace — the page can only ever hold the caller's own images.
|
|
/// </summary>
|
|
/// <remarks>
|
|
/// Images lists the org's container repositories, read live from the OCI catalog and filtered server-side to the org's namespace — the page can only ever hold the caller's own images.
|
|
/// </remarks>
|
|
pplx::task<std::shared_ptr<RegistryImageList>> getRegistryImages(
|
|
) const;
|
|
/// <summary>
|
|
/// Packages lists the org's npm packages — `<org>` and `@<org>/…` — from the npm registry's search index, optionally narrowed by a query within that scope.
|
|
/// </summary>
|
|
/// <remarks>
|
|
/// Packages lists the org's npm packages — `<org>` and `@<org>/…` — from the npm registry's search index, optionally narrowed by a query within that scope. The org boundary is applied server-side after the search, so a query can never widen it.
|
|
/// </remarks>
|
|
/// <param name="query">Query narrows the listing within the org's scope when present; the org boundary itself is never widened by it. It rides the query string. (optional, default to utility::conversions::to_string_t(""))</param>
|
|
pplx::task<std::shared_ptr<RegistryPackageList>> getRegistryPackages(
|
|
boost::optional<utility::string_t> query
|
|
) const;
|
|
/// <summary>
|
|
/// Projects lists the namespaces the caller can see with what each holds: the org's slug, its repository count on the OCI catalog, and its package count on the npm registry.
|
|
/// </summary>
|
|
/// <remarks>
|
|
/// Projects lists the namespaces the caller can see with what each holds: the org's slug, its repository count on the OCI catalog, and its package count on the npm registry. Today that is exactly one row — the caller's org.
|
|
/// </remarks>
|
|
pplx::task<std::shared_ptr<RegistryProjectList>> getRegistryProjects(
|
|
) const;
|
|
/// <summary>
|
|
/// Status reports whether the OCI and npm registries are reachable and, when the OCI half is auth-gated, which token realm its challenge advertises — an honest lens for \"is the registry plane up\", never a fabricated ok.
|
|
/// </summary>
|
|
/// <remarks>
|
|
/// Status reports whether the OCI and npm registries are reachable and, when the OCI half is auth-gated, which token realm its challenge advertises — an honest lens for \"is the registry plane up\", never a fabricated ok.
|
|
/// </remarks>
|
|
pplx::task<std::shared_ptr<RegistryStatus>> getRegistryStatus(
|
|
) const;
|
|
/// <summary>
|
|
/// Tags lists one org-owned repository's tags, read live from the OCI registry.
|
|
/// </summary>
|
|
/// <remarks>
|
|
/// Tags lists one org-owned repository's tags, read live from the OCI registry. The repository is addressed inside the org's namespace — a name outside it cannot be expressed, and an unknown one answers 404.
|
|
/// </remarks>
|
|
/// <param name="image">Image is the repository name inside the org's namespace, as returned by the images op. It rides the query string. (optional, default to utility::conversions::to_string_t(""))</param>
|
|
pplx::task<std::shared_ptr<RegistryTagList>> getRegistryTags(
|
|
boost::optional<utility::string_t> image
|
|
) const;
|
|
/// <summary>
|
|
/// Token mints a short-lived, pull-only registry token for exactly one of the org's images, through the same IAM realm the docker CLI authenticates against.
|
|
/// </summary>
|
|
/// <remarks>
|
|
/// Token mints a short-lived, pull-only registry token for exactly one of the org's images, through the same IAM realm the docker CLI authenticates against. The scope is pinned server-side to `<org>/<image>` with the `pull` action — no field exists to name another org's image or ask for push. Use it as `Authorization: Bearer …` on the OCI wire; it expires in minutes.
|
|
/// </remarks>
|
|
/// <param name="registryMint"></param>
|
|
pplx::task<std::shared_ptr<RegistryToken>> postRegistryToken(
|
|
std::shared_ptr<RegistryMint> registryMint
|
|
) const;
|
|
|
|
protected:
|
|
std::shared_ptr<const ApiClient> m_ApiClient;
|
|
};
|
|
|
|
}
|
|
}
|
|
|
|
#endif /* HANZO_API_RegistryApi_H_ */
|
|
|