octokit.net/Octokit.Reactive/Clients/IObservableActionsSelfHostedRunnersClient.cs

using System;
using System.Collections.Generic;
using System.Reactive;

namespace Octokit.Reactive
{
    /// <summary>
    /// A client for GitHub's Actions Self-hosted runners API.
    /// </summary>
    /// <remarks>
    /// See the <a href="https://developer.github.com/v3/actions/self-hosted-runners/">Actions Self-hosted runners API documentation</a> for more information.
    /// </remarks>
    public interface IObservableActionsSelfHostedRunnersClient
    {
        /// <summary>
        /// Gets a list of all self-hosted runners for an enterprise.
        /// </summary>
        /// <remarks>
        /// https://docs.github.com/en/enterprise-cloud@latest/rest/actions/self-hosted-runners?apiVersion=2022-11-28#list-self-hosted-runners-for-an-enterprise
        /// </remarks>
        /// <param name="enterprise">The enterprise.</param>
        IObservable<RunnerResponse> ListAllRunnersForEnterprise(string enterprise);

        /// <summary>
        /// Gets a list of all self-hosted runners for an enterprise.
        /// </summary>
        /// <remarks>
        /// https://developer.github.com/v3/actions/self-hosted-runners/#list-self-hosted-runners-for-an-enterprise
        /// </remarks>
        /// <param name="enterprise">The enterprise.</param>
        /// <param name="options">Options to change the API response.</param>
        IObservable<RunnerResponse> ListAllRunnersForEnterprise(string enterprise, ApiOptions options);

        /// <summary>
        /// Gets a list of all self-hosted runners for an organization.
        /// </summary>
        /// <remarks>
        /// https://developer.github.com/v3/actions/self-hosted-runners/#list-self-hosted-runners-for-an-organization
        /// </remarks>
        /// <param name="organization">The organization.</param>
        IObservable<RunnerResponse> ListAllRunnersForOrganization(string organization);

        /// <summary>
        /// Gets a list of all self-hosted runners for an organization.
        /// </summary>
        /// <remarks>
        /// https://developer.github.com/v3/actions/self-hosted-runners/#list-self-hosted-runners-for-an-organization
        /// </remarks>
        /// <param name="organization">The organization.</param>
        /// <param name="options">Options to change the API response.</param>
        IObservable<RunnerResponse> ListAllRunnersForOrganization(string organization, ApiOptions options);

        /// <summary>
        /// Gets a list of all self-hosted runners for a repository.
        /// </summary>
        /// <remarks>
        /// https://developer.github.com/v3/actions/self-hosted-runners/#list-self-hosted-runners-for-a-repository
        /// </remarks>
        /// <param name="owner">The owner of the repository.</param>
        /// <param name="name">The name of the repository.</param>
        IObservable<RunnerResponse> ListAllRunnersForRepository(string owner, string name);

        /// <summary>
        /// Gets a list of all self-hosted runners for a repository.
        /// </summary>
        /// <remarks>
        /// https://developer.github.com/v3/actions/self-hosted-runners/#list-self-hosted-runners-for-a-repository
        /// </remarks>
        /// <param name="owner">The owner of the repository.</param>
        /// <param name="name">The name of the repository.</param>
        /// <param name="options">Options to change the API response.</param>
        IObservable<RunnerResponse> ListAllRunnersForRepository(string owner, string name, ApiOptions options);

        /// <summary>
        /// List runner applications for an enterprise
        /// </summary>
        /// <remarks>
        /// https://docs.github.com/en/enterprise-cloud@latest/rest/actions/self-hosted-runners?apiVersion=2022-11-28#list-runner-applications-for-an-enterprise
        /// </remarks>
        /// <param name="enterprise">The enterprise.</param>
        IObservable<RunnerApplication> ListAllRunnerApplicationsForEnterprise(string enterprise);

        /// <summary>
        /// List runner applications for an enterprise
        /// </summary>
        /// <remarks>
        /// https://docs.github.com/en/enterprise-cloud@latest/rest/actions/self-hosted-runners?apiVersion=2022-11-28#list-runner-applications-for-an-enterprise
        /// </remarks>
        /// <param name="enterprise">The enterprise.</param>
        /// <param name="options">Options to change the API response.</param>
        IObservable<RunnerApplication> ListAllRunnerApplicationsForEnterprise(string enterprise, ApiOptions options);

        /// <summary>
        /// List runner applications for an organization
        /// </summary>
        /// <remarks>
        /// https://docs.github.com/en/enterprise-cloud@latest/rest/actions/self-hosted-runners?apiVersion=2022-11-28#list-runner-applications-for-an-organization
        /// </remarks>
        /// <param name="organization">The organization.</param>
        IObservable<RunnerApplication> ListAllRunnerApplicationsForOrganization(string organization);

        /// <summary>
        /// List runner applications for an organization
        /// </summary>
        /// <remarks>
        /// https://docs.github.com/en/enterprise-cloud@latest/rest/actions/self-hosted-runners?apiVersion=2022-11-28#list-runner-applications-for-an-organization
        /// </remarks>
        /// <param name="organization">The organization.</param>
        /// <param name="options">Options to change the API response.</param>
        IObservable<RunnerApplication> ListAllRunnerApplicationsForOrganization(string organization, ApiOptions options);

        /// <summary>
        /// List runner applications for a repository
        /// </summary>
        /// <remarks>
        /// https://docs.github.com/en/enterprise-cloud@latest/rest/actions/self-hosted-runners?apiVersion=2022-11-28#list-runner-applications-for-a-repository
        /// </remarks>
        /// <param name="owner">The owner of the repository.</param>
        /// <param name="name">The name of the repository.</param>
        IObservable<RunnerApplication> ListAllRunnerApplicationsForRepository(string owner, string name);

        /// <summary>
        /// List runner applications for a repository
        /// </summary>
        /// <remarks>
        /// https://docs.github.com/en/enterprise-cloud@latest/rest/actions/self-hosted-runners?apiVersion=2022-11-28#list-runner-applications-for-a-repository
        /// </remarks>
        /// <param name="owner">The owner of the repository.</param>
        /// <param name="name">The name of the repository.</param>
        /// <param name="options">Options to change the API response.</param>
        IObservable<RunnerApplication> ListAllRunnerApplicationsForRepository(string owner, string name, ApiOptions options);

        /// <summary>
        /// Deletes a self-hosted runner from an enterprise.
        /// </summary>
        /// <remarks>
        /// https://docs.github.com/en/enterprise-cloud@latest/rest/actions/self-hosted-runners?apiVersion=2022-11-28#delete-a-self-hosted-runner-from-an-enterprise
        /// </remarks>
        /// <param name="enterprise">The enterprise.</param>
        /// <param name="runnerId">The runner ID.</param>
        IObservable<Unit> DeleteEnterpriseRunner(string enterprise, long runnerId);

        /// <summary>
        /// Deletes a self-hosted runner from an enterprise.
        /// </summary>
        /// <remarks>
        /// https://docs.github.com/en/enterprise-cloud@latest/rest/actions/self-hosted-runners?apiVersion=2022-11-28#delete-a-self-hosted-runner-from-an-enterprise
        /// </remarks>
        /// <param name="enterprise">The enterprise.</param>
        /// <param name="runnerId">The runner ID.</param>
        /// <param name="options">Options to change the API response.</param>
        IObservable<Unit> DeleteEnterpriseRunner(string enterprise, long runnerId, ApiOptions options);

        /// <summary>
        /// Deletes a self-hosted runner from an organization.
        /// </summary>
        /// <remarks>
        /// https://docs.github.com/en/enterprise-cloud@latest/rest/actions/self-hosted-runners?apiVersion=2022-11-28#delete-a-self-hosted-runner-from-an-organization
        /// </remarks>
        /// <param name="organization">The organization.</param>
        /// <param name="runnerId">The runner ID.</param>
        IObservable<Unit> DeleteOrganizationRunner(string organization, long runnerId);

        /// <summary>
        /// Deletes a self-hosted runner from an organization.
        /// </summary>
        /// <remarks>
        /// https://docs.github.com/en/enterprise-cloud@latest/rest/actions/self-hosted-runners?apiVersion=2022-11-28#delete-a-self-hosted-runner-from-an-organization
        /// </remarks>
        /// <param name="organization">The organization.</param>
        /// <param name="runnerId">The runner ID.</param>
        /// <param name="options">Options to change the API response.</param>
        IObservable<Unit> DeleteOrganizationRunner(string organization, long runnerId, ApiOptions options);

        /// <summary>
        /// Deletes a self-hosted runner from a repository.
        /// </summary>
        /// <remarks>
        /// https://docs.github.com/en/enterprise-cloud@latest/rest/actions/self-hosted-runners?apiVersion=2022-11-28#delete-a-self-hosted-runner-from-a-repository
        /// </remarks>
        /// <param name="owner">The owner of the repository.</param>
        /// <param name="name">The name of the repository.</param>
        /// <param name="runnerId">The runner ID.</param>
        IObservable<Unit> DeleteRepositoryRunner(string owner, string name, long runnerId);

        /// <summary>
        /// Deletes a self-hosted runner from a repository.
        /// </summary>
        /// <remarks>
        /// https://docs.github.com/en/enterprise-cloud@latest/rest/actions/self-hosted-runners?apiVersion=2022-11-28#delete-a-self-hosted-runner-from-a-repository
        /// </remarks>
        /// <param name="owner">The owner of the repository.</param>
        /// <param name="name">The name of the repository.</param>
        /// <param name="runnerId">The runner ID.</param>
        /// <param name="options">Options to change the API response.</param>
        IObservable<Unit> DeleteRepositoryRunner(string owner, string name, long runnerId, ApiOptions options);

        /// <summary>
        /// Create a registration token for an enterprise.
        /// </summary>
        /// <remarks>
        /// https://docs.github.com/en/enterprise-cloud@latest/rest/actions/self-hosted-runners?apiVersion=2022-11-28#create-a-registration-token-for-an-enterprise
        /// </remarks>
        /// <param name="enterprise">The enterprise.</param>
        IObservable<AccessToken> CreateEnterpriseRegistrationToken(string enterprise);

        /// <summary>
        /// Create a registration token for an enterprise.
        /// </summary>
        /// <remarks>
        /// https://docs.github.com/en/enterprise-cloud@latest/rest/actions/self-hosted-runners?apiVersion=2022-11-28#create-a-registration-token-for-an-enterprise
        /// </remarks>
        /// <param name="enterprise">The enterprise.</param>
        /// <param name="options">Options to change the API response.</param>
        IObservable<AccessToken> CreateEnterpriseRegistrationToken(string enterprise, ApiOptions options);

        /// <summary>
        /// Create a registration token for an organization.
        /// </summary>
        /// <remarks>
        /// https://docs.github.com/en/enterprise-cloud@latest/rest/actions/self-hosted-runners?apiVersion=2022-11-28#create-a-registration-token-for-an-organization
        /// </remarks>
        /// <param name="organization">The organization.</param>
        IObservable<AccessToken> CreateOrganizationRegistrationToken(string organization);

        /// <summary>
        /// Create a registration token for an organization.
        /// </summary>
        /// <remarks>
        /// https://docs.github.com/en/enterprise-cloud@latest/rest/actions/self-hosted-runners?apiVersion=2022-11-28#create-a-registration-token-for-an-organization
        /// </remarks>
        /// <param name="organization">The organization.</param>
        /// <param name="options">Options to change the API response.</param>
        IObservable<AccessToken> CreateOrganizationRegistrationToken(string organization, ApiOptions options);

        /// <summary>
        /// Create a registration token for a repository.
        /// </summary>
        /// <remarks>
        /// https://docs.github.com/en/enterprise-cloud@latest/rest/actions/self-hosted-runners?apiVersion=2022-11-28#create-a-registration-token-for-a-repository
        /// </remarks>
        /// <param name="owner">The owner of the repository.</param>
        /// <param name="name">The name of the repository.</param>
        IObservable<AccessToken> CreateRepositoryRegistrationToken(string owner, string name);

        /// <summary>
        /// Create a registration token for a repository.
        /// </summary>
        /// <remarks>
        /// https://docs.github.com/en/enterprise-cloud@latest/rest/actions/self-hosted-runners?apiVersion=2022-11-28#create-a-registration-token-for-a-repository
        /// </remarks>
        /// <param name="owner">The owner of the repository.</param>
        /// <param name="name">The name of the repository.</param>
        /// <param name="options">Options to change the API response.</param>
        IObservable<AccessToken> CreateRepositoryRegistrationToken(string owner, string name, ApiOptions options);

    }
}