Documentation
¶
Overview ¶
Package controlclient calls the tnl control API.
responses cannot exceed 64 KiB. a successful response other than HTTP 204 must contain one non-null JSON value that matches the generated schema. most requests time out after 20 seconds; certificate requests time out after 150 seconds. requests do not follow redirects. network and read failures wrap ErrUnavailable, but caller cancellation, invalid responses, and oversized responses do not. known server problem codes take precedence over status.
Index ¶
- Variables
- func IngressTransportTLSConfig(trust controlv1.IngressTransportTrust) (*tls.Config, error)
- type Client
- func (c *Client) AcceptServiceInvitation(ctx context.Context, secret string) (controlv1.ServiceGrant, error)
- func (c *Client) AcceptVisitorInvitation(ctx context.Context, secret string) (controlv1.VisitorGrant, error)
- func (c *Client) AcknowledgePublisherGroupConfiguration(ctx context.Context, token string, ...) error
- func (c *Client) AcquirePublisherGroupLease(ctx context.Context, body controlv1.PublisherGroupLeaseRequest) (controlv1.PublisherGroupLease, error)
- func (c *Client) AddPreviewPublicURL(ctx context.Context, id, publicURLID string) (controlv1.Preview, error)
- func (c *Client) AdminDrainRelay(ctx context.Context, relayID string, body controlv1.AdminDrainRelayRequest) (controlv1.AdminRelayLease, error)
- func (c *Client) AdminListMaintenanceControls(ctx context.Context) ([]controlv1.MaintenanceControl, error)
- func (c *Client) AdminListRelays(ctx context.Context) (controlv1.AdminRelayPage, error)
- func (c *Client) AdminServerStatus(ctx context.Context) (controlv1.AdminServerStatus, error)
- func (c *Client) AdminSetMaintenanceControl(ctx context.Context, name controlv1.MaintenanceControlName, allowed bool) (controlv1.MaintenanceControl, error)
- func (c *Client) AllocateGuestDemoNumber(ctx context.Context) (controlv1.GuestDemoNumber, error)
- func (c *Client) AllocatePublisherPublicURL(ctx context.Context, token string, ...) (controlv1.PublicURL, error)
- func (c *Client) AppendFeedbackEvent(ctx context.Context, id, key string, body controlv1.AppendFeedbackEventRequest) (controlv1.FeedbackEvent, error)
- func (c *Client) AppendReviewerFeedbackEvent(ctx context.Context, runID, id, key string, ...) (controlv1.FeedbackEvent, error)
- func (c *Client) ApplyProjectConfiguration(ctx context.Context, project string, ...) (controlv1.AppliedProjectConfiguration, error)
- func (c *Client) AuthorizeHTTPVisitor(ctx context.Context, runID string, input controlv1.HTTPVisitorRequest, ...) (controlv1.HTTPVisitorResponse, error)
- func (c *Client) AuthorizeServiceClientCertificate(ctx context.Context, service, run string, token credentials.ServiceRunToken, ...) (controlv1.ServiceClientCertificateDecision, error)
- func (c *Client) AuthorizeServiceConnector(ctx context.Context, service, run string, token credentials.ServiceRunToken, ...) (controlv1.ServiceClientCertificateDecision, error)
- func (c *Client) AuthorizeServiceHTTPVisitor(ctx context.Context, service, run string, token credentials.ServiceRunToken, ...) (controlv1.ServiceClientCertificateDecision, error)
- func (c *Client) CheckBrowserAccess(ctx context.Context, runID string, version uint64, secret string, ...) (controlv1.BrowserAccessResponse, error)
- func (c *Client) CheckServiceBrowserSession(ctx context.Context, service, run string, token credentials.ServiceRunToken, ...) (controlv1.BrowserAccessResponse, error)
- func (c *Client) CheckWorkloadService(ctx context.Context, credential, service string) (controlv1.WorkloadServiceAuthorization, error)
- func (c *Client) ClientIP(ctx context.Context) (controlv1.ClientIPResponse, error)
- func (c *Client) ClosePublishRun(ctx context.Context, publishRunID string, token credentials.PublishRunToken) error
- func (c *Client) CloseServiceRun(ctx context.Context, serviceID, runID string, ...) error
- func (c *Client) ConfigureService(ctx context.Context, id string, metadata controlv1.ServiceMetadata) (controlv1.Service, error)
- func (c *Client) ControlURL() string
- func (c *Client) CreateCertificateIssuance(ctx context.Context, publishRunID string, publishRunNumber uint64, ...) (controlv1.CertificateIssuance, error)
- func (c *Client) CreateFeedbackReport(ctx context.Context, runID, key string, ...) (controlv1.FeedbackThread, error)
- func (c *Client) CreateGuestDemo(ctx context.Context) (controlv1.GuestDemoSession, error)
- func (c *Client) CreateIdentityVisitorGrant(ctx context.Context, id, key string, ...) (controlv1.VisitorGrant, error)
- func (c *Client) CreatePreview(ctx context.Context, teamID, key string) (controlv1.Preview, error)
- func (c *Client) CreatePublicURL(ctx context.Context, body controlv1.CreatePublicURLRequest, ...) (controlv1.PublicURL, error)
- func (c *Client) CreatePublishRun(ctx context.Context, publicURLID, idempotencyKey string) (controlv1.PublishRunSetup, error)
- func (c *Client) CreatePublishRunPreview(ctx context.Context, runID string, version uint64, ...) (controlv1.Preview, error)
- func (c *Client) CreatePublisherEnrollment(ctx context.Context, b controlv1.CreatePublisherEnrollmentRequest) (controlv1.PublisherEnrollment, error)
- func (c *Client) CreatePublisherGrant(ctx context.Context, id string, b controlv1.CreatePublisherGrantRequest) (controlv1.PublisherGrant, error)
- func (c *Client) CreatePublisherGroupEnrollment(ctx context.Context, project, group string, ...) (controlv1.PublisherGroupEnrollment, error)
- func (c *Client) CreatePublisherRun(ctx context.Context, id, retry, token, proof string) (controlv1.PublishRunSetup, error)
- func (c *Client) CreatePublisherRunWithTraffic(ctx context.Context, id, retry, token, proof string, ...) (controlv1.PublishRunSetup, error)
- func (c *Client) CreateService(ctx context.Context, team, name, key string, ...) (controlv1.Service, error)
- func (c *Client) CreateServiceAt(ctx context.Context, team, name, key string, ...) (controlv1.Service, error)
- func (c *Client) CreateServiceCertificateIssuance(ctx context.Context, service, run string, number int64, ...) (controlv1.ServiceCertificateIssuance, error)
- func (c *Client) CreateServiceHTTPGrant(ctx context.Context, service string, ...) (controlv1.ServiceHTTPGrant, error)
- func (c *Client) CreateShare(ctx context.Context, previewID, key string, body controlv1.CreateShareRequest) (controlv1.Share, error)
- func (c *Client) CreateTeamVisitorGrant(ctx context.Context, id, key string, ...) (controlv1.VisitorGrant, error)
- func (c *Client) CreateURLShare(ctx context.Context, key string, body controlv1.CreateShareRequest) (controlv1.Share, error)
- func (c *Client) CreateVisitorIngressAssignment(ctx context.Context, serviceID, deviceID, excludeIngressID, key string) (controlv1.ConnectorSessionSetup, error)
- func (c *Client) CreateVisitorIngressAssignments(ctx context.Context, serviceID, deviceID, key string) ([]controlv1.ConnectorSessionSetup, error)
- func (c *Client) CreateVisitorInvitation(ctx context.Context, id, key string, ...) (controlv1.VisitorInvitation, error)
- func (c *Client) CreateWorkloadIngressAssignmentSet(ctx context.Context, credential, service, key string, count int, ...) (controlv1.WorkloadIngressAssignments, error)
- func (c *Client) CreateWorkloadIngressAssignments(ctx context.Context, credential, service, key string) (controlv1.WorkloadIngressAssignments, error)
- func (c *Client) DeletePublicURL(ctx context.Context, publicURLID string) error
- func (c *Client) DeletePublisherPublicURL(ctx context.Context, token, id string) error
- func (c *Client) DeleteService(ctx context.Context, id string) error
- func (c *Client) Discovery(ctx context.Context) (controlv1.ControlDiscovery, error)
- func (c *Client) EnableShareAccess(ctx context.Context, runID string, version uint64, previewID string, ...) error
- func (c *Client) EnrollGuestPublisher(ctx context.Context, id string, public ed25519.PublicKey) (controlv1.GuestPublisherIdentity, error)
- func (c *Client) EnrollVisitorDevice(ctx context.Context, key ed25519.PublicKey) (controlv1.VisitorDevice, error)
- func (c *Client) GetCertificateIssuance(ctx context.Context, issuanceID string, token credentials.PublishRunToken) (controlv1.CertificateIssuance, error)
- func (c *Client) GetFeedbackThread(ctx context.Context, id string) (controlv1.FeedbackThread, error)
- func (c *Client) GetLocalProjectService(ctx context.Context, project, service string, ...) (controlv1.LocalProjectService, error)
- func (c *Client) GetPreview(ctx context.Context, id string) (controlv1.Preview, error)
- func (c *Client) GetProjectConfiguration(ctx context.Context, team, project string) (controlv1.AppliedProjectConfiguration, error)
- func (c *Client) GetProjectPublicMetadata(ctx context.Context, team, project string) (controlv1.ProjectPublicMetadata, error)
- func (c *Client) GetProjectService(ctx context.Context, project, service string, ...) (controlv1.Service, error)
- func (c *Client) GetPublicURL(ctx context.Context, publicURLID string) (controlv1.PublicURL, error)
- func (c *Client) GetPublicURLByHostname(ctx context.Context, teamID, hostname string) (controlv1.PublicURL, error)
- func (c *Client) GetPublishRunShareState(ctx context.Context, runID string, version uint64, ...) (controlv1.PublishRunShareState, error)
- func (c *Client) GetPublisherGroupAssignments(ctx context.Context, token string) (controlv1.PublisherGroupAssignments, error)
- func (c *Client) GetPublisherService(ctx context.Context, publisherAccess string) (controlv1.Service, error)
- func (c *Client) GetReviewerFeedbackThread(ctx context.Context, runID, id string, ...) (controlv1.FeedbackThread, error)
- func (c *Client) GetService(ctx context.Context, id string) (controlv1.Service, error)
- func (c *Client) GetServiceCertificateIssuance(ctx context.Context, service, run, issuance string, ...) (controlv1.ServiceCertificateIssuance, error)
- func (c *Client) GetShare(ctx context.Context, id string) (controlv1.Share, error)
- func (c *Client) GetVisitorIngressTransportTrust(ctx context.Context, sessionID string) (controlv1.IngressTransportTrust, error)
- func (c *Client) GetWorkloadIngressTransportTrust(ctx context.Context, credential, session string) (controlv1.IngressTransportTrust, error)
- func (c *Client) HeartbeatPublishRun(ctx context.Context, publishRunID string, publishRunNumber uint64, ...) (controlv1.PublishRunHeartbeat, error)
- func (c *Client) HeartbeatServiceRun(ctx context.Context, serviceID, runID string, ...) (controlv1.ServiceRunState, error)
- func (c *Client) HeartbeatServiceRunHealth(ctx context.Context, serviceID, runID string, ...) (controlv1.ServiceRunState, error)
- func (c *Client) InviteServiceVisitor(ctx context.Context, service, key string, ...) (controlv1.ServiceInvitation, error)
- func (c *Client) IssueServiceClientCertificate(ctx context.Context, service, device string, csr []byte) (controlv1.ServiceClientCertificate, error)
- func (c *Client) IssueWorkloadServiceClientCertificate(ctx context.Context, credential, service string, csr []byte) (controlv1.ServiceClientCertificate, error)
- func (c *Client) ListAvailablePublicURLs(ctx context.Context, teamID, cursor string) (controlv1.AvailablePublicURLPage, error)
- func (c *Client) ListAvailableServices(ctx context.Context) ([]controlv1.Service, error)
- func (c *Client) ListFeedbackEvents(ctx context.Context, teamID string, after uint64) (controlv1.FeedbackEventPage, error)
- func (c *Client) ListFeedbackThreadEvents(ctx context.Context, id string, after uint64) (controlv1.FeedbackEventPage, error)
- func (c *Client) ListFeedbackThreads(ctx context.Context, teamID string) ([]controlv1.FeedbackThreadSummary, uint64, error)
- func (c *Client) ListPreviewPageFeedback(ctx context.Context, runID string, body controlv1.PreviewPageFeedbackRequest, ...) (controlv1.FeedbackThreadPage, error)
- func (c *Client) ListPublicURLs(ctx context.Context, teamID string) ([]controlv1.PublicURL, error)
- func (c *Client) ListPublisherIdentities(ctx context.Context, team, after string) (controlv1.PublisherIdentityPage, error)
- func (c *Client) ListReviewerFeedbackEvents(ctx context.Context, runID, id string, ...) (controlv1.FeedbackEventPage, error)
- func (c *Client) ListServiceAudit(ctx context.Context, team string, params controlv1.ListServiceAuditParams) (controlv1.ServiceAuditPage, error)
- func (c *Client) ListServiceGrants(ctx context.Context, service string) ([]controlv1.ServiceGrant, error)
- func (c *Client) ListServiceHTTPGrants(ctx context.Context, service string) ([]controlv1.ServiceHTTPGrantSummary, error)
- func (c *Client) ListServiceInvitations(ctx context.Context, service string) ([]controlv1.ServiceInvitation, error)
- func (c *Client) ListServices(ctx context.Context, team string) ([]controlv1.Service, error)
- func (c *Client) ListShares(ctx context.Context, previewID string) ([]controlv1.Share, error)
- func (c *Client) ListTeamShares(ctx context.Context, teamID string) ([]controlv1.Share, error)
- func (c *Client) ListVisitorGrants(ctx context.Context, id string) ([]controlv1.VisitorGrant, error)
- func (c *Client) ListVisitorInvitations(ctx context.Context, id string) ([]controlv1.VisitorInvitation, error)
- func (c *Client) ListWorkloadServices(ctx context.Context, credential string) (controlv1.WorkloadServices, error)
- func (c *Client) MarkPublishRunCertificateInstalled(ctx context.Context, publishRunID string, publishRunNumber uint64, ...) error
- func (c *Client) MarkPublishRunReady(ctx context.Context, publishRunID string, publishRunNumber uint64, ...) error
- func (c *Client) MarkServiceCertificateInstalled(ctx context.Context, service, run string, number int64, issuance string, ...) error
- func (c *Client) PrepareServiceRun(ctx context.Context, serviceID, key, publisherAccess string, ...) (controlv1.ServiceRunPreparation, error)
- func (c *Client) PublisherPublicURL(ctx context.Context, token string) (controlv1.PublicURL, error)
- func (c *Client) PublisherRuntime(ctx context.Context, body controlv1.PublisherRuntimeRequest) (controlv1.PublisherRuntimeResponse, error)
- func (c *Client) RealizeLocalProjectService(ctx context.Context, project, service string, ...) (controlv1.LocalProjectService, error)
- func (c *Client) RedeemBrowserHandoff(ctx context.Context, runID string, version uint64, ticket string, ...) (controlv1.BrowserHandoffResponse, error)
- func (c *Client) RedeemPublishRunShare(ctx context.Context, runID string, body controlv1.RedeemShareRequest, ...) (controlv1.ShareRedemption, error)
- func (c *Client) RedeemPublisherGroupEnrollment(ctx context.Context, key string, public ed25519.PublicKey) (controlv1.PublisherGroupMember, error)
- func (c *Client) RedeemServiceBrowserHandoff(ctx context.Context, service, run string, token credentials.ServiceRunToken, ...) (controlv1.BrowserHandoffResponse, error)
- func (c *Client) ReleaseVisitorIngressAssignment(ctx context.Context, sessionID string) error
- func (c *Client) ReleaseWorkloadIngressAssignment(ctx context.Context, credential, session string) error
- func (c *Client) RenamePublisherGroup(ctx context.Context, project, group string, ...) (controlv1.AppliedProjectConfiguration, error)
- func (c *Client) RenamePublisherNamespace(ctx context.Context, project, group string, ...) (controlv1.AppliedProjectConfiguration, error)
- func (c *Client) ReplaceVisitorAccess(ctx context.Context, id string, body controlv1.ReplaceVisitorAccessRequest) (controlv1.PublicURL, error)
- func (c *Client) ReportPublisherServiceObservations(ctx context.Context, runID string, number uint64, ...) error
- func (c *Client) RevokeBrowserAccess(ctx context.Context, runID string, version uint64, secret string, ...) error
- func (c *Client) RevokePublisherGrant(ctx context.Context, team, id, grant string) error
- func (c *Client) RevokePublisherGroupMember(ctx context.Context, team, project, group, publisher string) error
- func (c *Client) RevokePublisherIdentity(ctx context.Context, team, id string) error
- func (c *Client) RevokeServiceBrowserSession(ctx context.Context, service, run string, token credentials.ServiceRunToken, ...) error
- func (c *Client) RevokeServiceGrant(ctx context.Context, service, id string) error
- func (c *Client) RevokeServiceHTTPGrant(ctx context.Context, service, id string) error
- func (c *Client) RevokeServiceInvitation(ctx context.Context, service, id string) error
- func (c *Client) RevokeShare(ctx context.Context, id string) (controlv1.Share, error)
- func (c *Client) RevokeVisitorDevice(ctx context.Context, id string) error
- func (c *Client) RevokeVisitorGrant(ctx context.Context, id, grantID string) error
- func (c *Client) RevokeVisitorInvitation(ctx context.Context, id, inviteID string) error
- func (c *Client) SelectServiceRun(ctx context.Context, serviceID, deviceID string) (controlv1.ServiceSelection, error)
- func (c *Client) SelectWorkloadServiceRun(ctx context.Context, credential, service string) (controlv1.ServiceSelection, error)
- func (c *Client) SetPreviewTeamAccess(ctx context.Context, id string, enabled bool) (controlv1.Preview, error)
- func (c *Client) StartServiceRun(ctx context.Context, service, run, access string, number int64) (controlv1.ServiceRunSetup, error)
- func (c *Client) UpdatePublicURL(ctx context.Context, publicURLID string, body controlv1.UpdatePublicURLRequest) (controlv1.PublicURL, error)
- func (c *Client) VerifyPublisherGroupIdentity(ctx context.Context, body controlv1.PublisherGroupLeaseRequest) (controlv1.PublisherGroupVerification, error)
- type ProblemError
- type RateLimitError
Constants ¶
This section is empty.
Variables ¶
var ( ErrUnauthenticated = failure.Wrap("authenticate control request", failure.Authentication, errors.New("controlclient: unauthenticated")) ErrNotFound = failure.Wrap("read control resource", failure.ServerResourceNotFound, errors.New("controlclient: not found")) ErrStatusConflict = failure.Wrap("update control state", failure.ServerConflict, errors.New("controlclient: status conflict")) ErrProjectManaged = failure.Wrap("change project-managed resource", failure.ServerConflict, fmt.Errorf("resource is managed by project configuration: %w", ErrStatusConflict)) ErrCertificateStatus = failure.Wrap("issue public URL certificate", failure.CertificateUnavailable, errors.New("controlclient: certificate status conflict")) ErrDNSProofPending = failure.Wrap("configure domain DNS", failure.DNSPending, errors.New("controlclient: DNS setup pending")) ErrRateLimited = failure.Wrap("request control API", failure.ServerRateLimited, errors.New("controlclient: rate limited")) ErrUnsupported = failure.Wrap("request control API", failure.ServerResponseInvalid, errors.New("controlclient: unsupported")) ErrGuestTrialExhausted = failure.Wrap("publish guest demo", failure.GuestTrialExhausted, errors.New("controlclient: guest demo trial exhausted")) ErrGuestDemoOnly = failure.Wrap("publish guest demo", failure.GuestDemoOnly, errors.New("controlclient: guest demo only")) ErrGuestIPChanged = failure.Wrap("publish guest demo", failure.GuestIPChanged, errors.New("controlclient: guest demo source IP changed")) ErrGuestIssuanceLimited = failure.Wrap("create guest demo", failure.GuestIssuanceLimited, errors.New("controlclient: guest demo issuance limited")) ErrMemberHostnameDepth = failure.Wrap("select public URL hostname", failure.MemberHostnameDepthExceeded, errors.New("managed-domain member hostname depth exceeded")) )
Functions ¶
func IngressTransportTLSConfig ¶
func IngressTransportTLSConfig(trust controlv1.IngressTransportTrust) (*tls.Config, error)
the control HTTPS response authenticates this private transport trust anchor. normal chain/hostname verification stays enabled; the extra pin binds the peer key and URI to one ingress process lease, for either QUIC or TLS/TCP.
Types ¶
type Client ¶
type Client struct {
// contains filtered or unexported fields
}
func New ¶
func New(server string, httpClient *http.Client, access credentials.AccessToken) (*Client, error)
func NewExternallyAuthenticated ¶
NewExternallyAuthenticated creates a client whose HTTP transport adds authorization.
func (*Client) AcceptServiceInvitation ¶
func (*Client) AcceptVisitorInvitation ¶
func (*Client) AcknowledgePublisherGroupConfiguration ¶
func (*Client) AcquirePublisherGroupLease ¶
func (c *Client) AcquirePublisherGroupLease(ctx context.Context, body controlv1.PublisherGroupLeaseRequest) (controlv1.PublisherGroupLease, error)
func (*Client) AddPreviewPublicURL ¶
func (*Client) AdminDrainRelay ¶
func (c *Client) AdminDrainRelay(ctx context.Context, relayID string, body controlv1.AdminDrainRelayRequest) (controlv1.AdminRelayLease, error)
func (*Client) AdminListMaintenanceControls ¶
func (*Client) AdminListRelays ¶
func (*Client) AdminServerStatus ¶
func (*Client) AdminSetMaintenanceControl ¶
func (c *Client) AdminSetMaintenanceControl(ctx context.Context, name controlv1.MaintenanceControlName, allowed bool) (controlv1.MaintenanceControl, error)
func (*Client) AllocateGuestDemoNumber ¶
func (*Client) AllocatePublisherPublicURL ¶
func (*Client) AppendFeedbackEvent ¶
func (c *Client) AppendFeedbackEvent(ctx context.Context, id, key string, body controlv1.AppendFeedbackEventRequest) (controlv1.FeedbackEvent, error)
func (*Client) AppendReviewerFeedbackEvent ¶
func (c *Client) AppendReviewerFeedbackEvent(ctx context.Context, runID, id, key string, body controlv1.AppendReviewerFeedbackEventRequest, token credentials.PublishRunToken) (controlv1.FeedbackEvent, error)
func (*Client) ApplyProjectConfiguration ¶
func (c *Client) ApplyProjectConfiguration(ctx context.Context, project string, body controlv1.ApplyProjectConfigurationRequest) (controlv1.AppliedProjectConfiguration, error)
func (*Client) AuthorizeHTTPVisitor ¶
func (c *Client) AuthorizeHTTPVisitor(ctx context.Context, runID string, input controlv1.HTTPVisitorRequest, token credentials.PublishRunToken) (controlv1.HTTPVisitorResponse, error)
func (*Client) AuthorizeServiceClientCertificate ¶
func (c *Client) AuthorizeServiceClientCertificate(ctx context.Context, service, run string, token credentials.ServiceRunToken, body controlv1.AuthorizeServiceClientCertificateRequest) (controlv1.ServiceClientCertificateDecision, error)
func (*Client) AuthorizeServiceConnector ¶
func (c *Client) AuthorizeServiceConnector(ctx context.Context, service, run string, token credentials.ServiceRunToken, body controlv1.AuthorizeServiceConnectorRequest) (controlv1.ServiceClientCertificateDecision, error)
func (*Client) AuthorizeServiceHTTPVisitor ¶
func (c *Client) AuthorizeServiceHTTPVisitor(ctx context.Context, service, run string, token credentials.ServiceRunToken, input controlv1.ServiceHTTPVisitorRequest) (controlv1.ServiceClientCertificateDecision, error)
func (*Client) CheckBrowserAccess ¶
func (c *Client) CheckBrowserAccess(ctx context.Context, runID string, version uint64, secret string, token credentials.PublishRunToken) (controlv1.BrowserAccessResponse, error)
func (*Client) CheckServiceBrowserSession ¶
func (c *Client) CheckServiceBrowserSession(ctx context.Context, service, run string, token credentials.ServiceRunToken, input controlv1.ServiceBrowserRequest) (controlv1.BrowserAccessResponse, error)
func (*Client) CheckWorkloadService ¶
func (*Client) ClosePublishRun ¶
func (c *Client) ClosePublishRun(ctx context.Context, publishRunID string, token credentials.PublishRunToken) error
func (*Client) CloseServiceRun ¶
func (c *Client) CloseServiceRun(ctx context.Context, serviceID, runID string, token credentials.ServiceRunToken) error
func (*Client) ConfigureService ¶
func (*Client) ControlURL ¶
func (*Client) CreateCertificateIssuance ¶
func (c *Client) CreateCertificateIssuance(ctx context.Context, publishRunID string, publishRunNumber uint64, token credentials.PublishRunToken, csrDER []byte, idempotencyKey string) (controlv1.CertificateIssuance, error)
func (*Client) CreateFeedbackReport ¶
func (c *Client) CreateFeedbackReport(ctx context.Context, runID, key string, body controlv1.CreateFeedbackReportRequest, token credentials.PublishRunToken) (controlv1.FeedbackThread, error)
func (*Client) CreateGuestDemo ¶
func (*Client) CreateIdentityVisitorGrant ¶
func (c *Client) CreateIdentityVisitorGrant(ctx context.Context, id, key string, body controlv1.CreateIdentityVisitorGrantRequest) (controlv1.VisitorGrant, error)
func (*Client) CreatePreview ¶
func (*Client) CreatePublicURL ¶
func (*Client) CreatePublishRun ¶
func (*Client) CreatePublishRunPreview ¶
func (c *Client) CreatePublishRunPreview(ctx context.Context, runID string, version uint64, token credentials.PublishRunToken) (controlv1.Preview, error)
func (*Client) CreatePublisherEnrollment ¶
func (c *Client) CreatePublisherEnrollment(ctx context.Context, b controlv1.CreatePublisherEnrollmentRequest) (controlv1.PublisherEnrollment, error)
func (*Client) CreatePublisherGrant ¶
func (c *Client) CreatePublisherGrant(ctx context.Context, id string, b controlv1.CreatePublisherGrantRequest) (controlv1.PublisherGrant, error)
func (*Client) CreatePublisherGroupEnrollment ¶
func (c *Client) CreatePublisherGroupEnrollment(ctx context.Context, project, group string, body controlv1.CreatePublisherGroupEnrollmentRequest) (controlv1.PublisherGroupEnrollment, error)
func (*Client) CreatePublisherRun ¶
func (*Client) CreatePublisherRunWithTraffic ¶
func (c *Client) CreatePublisherRunWithTraffic(ctx context.Context, id, retry, token, proof string, selection *trafficlimits.Selection) (controlv1.PublishRunSetup, error)
CreatePublisherRunWithTraffic preserves the publisher proof boundary while carrying an optional selection through the typed control API request.
func (*Client) CreateService ¶
func (c *Client) CreateService(ctx context.Context, team, name, key string, metadata ...controlv1.ServiceMetadata) (controlv1.Service, error)
a person's control session may create the saved service and issue an exact enrollment. the resulting publisher uses only its scoped grant for runs.
func (*Client) CreateServiceAt ¶
func (*Client) CreateServiceCertificateIssuance ¶
func (c *Client) CreateServiceCertificateIssuance(ctx context.Context, service, run string, number int64, token credentials.ServiceRunToken, csr []byte, key string) (controlv1.ServiceCertificateIssuance, error)
func (*Client) CreateServiceHTTPGrant ¶
func (c *Client) CreateServiceHTTPGrant(ctx context.Context, service string, input controlv1.CreateServiceHTTPGrantRequest) (controlv1.ServiceHTTPGrant, error)
func (*Client) CreateShare ¶
func (*Client) CreateTeamVisitorGrant ¶
func (c *Client) CreateTeamVisitorGrant(ctx context.Context, id, key string, body controlv1.CreateTeamVisitorGrantRequest) (controlv1.VisitorGrant, error)
func (*Client) CreateURLShare ¶
func (*Client) CreateVisitorIngressAssignment ¶
func (*Client) CreateVisitorIngressAssignments ¶
func (*Client) CreateVisitorInvitation ¶
func (c *Client) CreateVisitorInvitation(ctx context.Context, id, key string, body controlv1.CreateVisitorInvitationRequest) (controlv1.VisitorInvitation, error)
func (*Client) CreateWorkloadIngressAssignmentSet ¶
func (*Client) CreateWorkloadIngressAssignments ¶
func (*Client) DeletePublicURL ¶
func (*Client) DeletePublisherPublicURL ¶
func (*Client) EnableShareAccess ¶
func (c *Client) EnableShareAccess(ctx context.Context, runID string, version uint64, previewID string, token credentials.PublishRunToken) error
func (*Client) EnrollGuestPublisher ¶
func (*Client) EnrollVisitorDevice ¶
func (*Client) GetCertificateIssuance ¶
func (c *Client) GetCertificateIssuance(ctx context.Context, issuanceID string, token credentials.PublishRunToken) (controlv1.CertificateIssuance, error)
func (*Client) GetFeedbackThread ¶
func (*Client) GetLocalProjectService ¶
func (c *Client) GetLocalProjectService(ctx context.Context, project, service string, params controlv1.GetLocalProjectServiceParams) (controlv1.LocalProjectService, error)
func (*Client) GetPreview ¶
func (*Client) GetProjectConfiguration ¶
func (*Client) GetProjectPublicMetadata ¶
func (*Client) GetProjectService ¶
func (*Client) GetPublicURL ¶
func (*Client) GetPublicURLByHostname ¶
func (c *Client) GetPublicURLByHostname(ctx context.Context, teamID, hostname string) (controlv1.PublicURL, error)
GetPublicURLByHostname uses one filtered request instead of paging through a team's public URLs. reject unfiltered responses from servers ignoring the filter.
func (*Client) GetPublishRunShareState ¶
func (c *Client) GetPublishRunShareState(ctx context.Context, runID string, version uint64, token credentials.PublishRunToken) (controlv1.PublishRunShareState, error)
func (*Client) GetPublisherGroupAssignments ¶
func (*Client) GetPublisherService ¶
func (*Client) GetReviewerFeedbackThread ¶
func (c *Client) GetReviewerFeedbackThread(ctx context.Context, runID, id string, body controlv1.ReviewerFeedbackReadRequest, token credentials.PublishRunToken) (controlv1.FeedbackThread, error)
func (*Client) GetService ¶
func (*Client) GetServiceCertificateIssuance ¶
func (c *Client) GetServiceCertificateIssuance(ctx context.Context, service, run, issuance string, token credentials.ServiceRunToken) (controlv1.ServiceCertificateIssuance, error)
func (*Client) GetVisitorIngressTransportTrust ¶
func (*Client) GetWorkloadIngressTransportTrust ¶
func (*Client) HeartbeatPublishRun ¶
func (c *Client) HeartbeatPublishRun(ctx context.Context, publishRunID string, publishRunNumber uint64, token credentials.PublishRunToken) (controlv1.PublishRunHeartbeat, error)
func (*Client) HeartbeatServiceRun ¶
func (c *Client) HeartbeatServiceRun(ctx context.Context, serviceID, runID string, token credentials.ServiceRunToken) (controlv1.ServiceRunState, error)
func (*Client) HeartbeatServiceRunHealth ¶
func (c *Client) HeartbeatServiceRunHealth(ctx context.Context, serviceID, runID string, token credentials.ServiceRunToken, health controlv1.ServiceRunHeartbeat) (controlv1.ServiceRunState, error)
func (*Client) InviteServiceVisitor ¶
func (c *Client) InviteServiceVisitor(ctx context.Context, service, key string, body controlv1.CreateServiceInvitationRequest) (controlv1.ServiceInvitation, error)
func (*Client) IssueServiceClientCertificate ¶
func (*Client) IssueWorkloadServiceClientCertificate ¶
func (*Client) ListAvailablePublicURLs ¶
func (*Client) ListAvailableServices ¶
ListAvailableServices returns only services the signed-in identity may visit. publisher inventory and a friendly name are not visitor grants.
func (*Client) ListFeedbackEvents ¶
func (*Client) ListFeedbackThreadEvents ¶
func (*Client) ListFeedbackThreads ¶
func (*Client) ListPreviewPageFeedback ¶
func (c *Client) ListPreviewPageFeedback(ctx context.Context, runID string, body controlv1.PreviewPageFeedbackRequest, token credentials.PublishRunToken) (controlv1.FeedbackThreadPage, error)
func (*Client) ListPublicURLs ¶
func (*Client) ListPublisherIdentities ¶
func (*Client) ListReviewerFeedbackEvents ¶
func (c *Client) ListReviewerFeedbackEvents(ctx context.Context, runID, id string, body controlv1.ReviewerFeedbackReadRequest, token credentials.PublishRunToken) (controlv1.FeedbackEventPage, error)
func (*Client) ListServiceAudit ¶
func (c *Client) ListServiceAudit(ctx context.Context, team string, params controlv1.ListServiceAuditParams) (controlv1.ServiceAuditPage, error)
ListServiceAudit reads one manager-authorized page using the person's session. callers retain filters and advance the returned cursor when reading more pages.
func (*Client) ListServiceGrants ¶
func (*Client) ListServiceHTTPGrants ¶
func (*Client) ListServiceInvitations ¶
func (*Client) ListServices ¶
func (*Client) ListShares ¶
func (*Client) ListTeamShares ¶
func (*Client) ListVisitorGrants ¶
func (*Client) ListVisitorInvitations ¶
func (*Client) ListWorkloadServices ¶
func (*Client) MarkPublishRunCertificateInstalled ¶
func (*Client) MarkPublishRunReady ¶
func (c *Client) MarkPublishRunReady(ctx context.Context, publishRunID string, publishRunNumber uint64, token credentials.PublishRunToken) error
func (*Client) MarkServiceCertificateInstalled ¶
func (*Client) PrepareServiceRun ¶
func (c *Client) PrepareServiceRun(ctx context.Context, serviceID, key, publisherAccess string, declared controlv1.ServiceRunDeclaration) (controlv1.ServiceRunPreparation, error)
func (*Client) PublisherPublicURL ¶
func (*Client) PublisherRuntime ¶
func (c *Client) PublisherRuntime(ctx context.Context, body controlv1.PublisherRuntimeRequest) (controlv1.PublisherRuntimeResponse, error)
func (*Client) RealizeLocalProjectService ¶
func (c *Client) RealizeLocalProjectService(ctx context.Context, project, service string, body controlv1.RealizeLocalProjectServiceRequest) (controlv1.LocalProjectService, error)
func (*Client) RedeemBrowserHandoff ¶
func (c *Client) RedeemBrowserHandoff(ctx context.Context, runID string, version uint64, ticket string, token credentials.PublishRunToken) (controlv1.BrowserHandoffResponse, error)
func (*Client) RedeemPublishRunShare ¶
func (c *Client) RedeemPublishRunShare(ctx context.Context, runID string, body controlv1.RedeemShareRequest, token credentials.PublishRunToken) (controlv1.ShareRedemption, error)
func (*Client) RedeemPublisherGroupEnrollment ¶
func (*Client) RedeemServiceBrowserHandoff ¶
func (c *Client) RedeemServiceBrowserHandoff(ctx context.Context, service, run string, token credentials.ServiceRunToken, input controlv1.ServiceBrowserRequest) (controlv1.BrowserHandoffResponse, error)
func (*Client) ReleaseVisitorIngressAssignment ¶
func (*Client) ReleaseWorkloadIngressAssignment ¶
func (*Client) RenamePublisherGroup ¶
func (c *Client) RenamePublisherGroup(ctx context.Context, project, group string, body controlv1.RenamePublisherGroupRequest) (controlv1.AppliedProjectConfiguration, error)
func (*Client) RenamePublisherNamespace ¶
func (c *Client) RenamePublisherNamespace(ctx context.Context, project, group string, body controlv1.RenamePublisherNamespaceRequest) (controlv1.AppliedProjectConfiguration, error)
func (*Client) ReplaceVisitorAccess ¶
func (*Client) ReportPublisherServiceObservations ¶
func (c *Client) ReportPublisherServiceObservations(ctx context.Context, runID string, number uint64, token credentials.PublishRunToken, batch serviceaudit.Batch) error
func (*Client) RevokeBrowserAccess ¶
func (c *Client) RevokeBrowserAccess(ctx context.Context, runID string, version uint64, secret string, token credentials.PublishRunToken) error
func (*Client) RevokePublisherGrant ¶
func (*Client) RevokePublisherGroupMember ¶
func (*Client) RevokePublisherIdentity ¶
func (*Client) RevokeServiceBrowserSession ¶
func (c *Client) RevokeServiceBrowserSession(ctx context.Context, service, run string, token credentials.ServiceRunToken, input controlv1.ServiceBrowserRequest) error
func (*Client) RevokeServiceGrant ¶
func (*Client) RevokeServiceHTTPGrant ¶
func (*Client) RevokeServiceInvitation ¶
func (*Client) RevokeShare ¶
func (*Client) RevokeVisitorDevice ¶
func (*Client) RevokeVisitorGrant ¶
func (*Client) RevokeVisitorInvitation ¶
func (*Client) SelectServiceRun ¶
func (*Client) SelectWorkloadServiceRun ¶
func (*Client) SetPreviewTeamAccess ¶
func (*Client) StartServiceRun ¶
func (*Client) UpdatePublicURL ¶
func (*Client) VerifyPublisherGroupIdentity ¶
func (c *Client) VerifyPublisherGroupIdentity(ctx context.Context, body controlv1.PublisherGroupLeaseRequest) (controlv1.PublisherGroupVerification, error)
type ProblemError ¶
func (*ProblemError) Error ¶
func (e *ProblemError) Error() string
type RateLimitError ¶
func (*RateLimitError) Error ¶
func (e *RateLimitError) Error() string
func (*RateLimitError) Unwrap ¶
func (e *RateLimitError) Unwrap() error