Documentation
¶
Index ¶
- Variables
- func DescribeComputer(c jamfprotect.Computer) string
- func PickNamed(refs []NamedRef, name, noun, listCmd, avail string) (string, error)
- func PrintList[T any](out registry.OutputFormatter, items []T) error
- func PrintOne[T any](out registry.OutputFormatter, item T) error
- type NamedRef
- type Resolver
- func (r *Resolver) ResolveActionConfigID(ctx context.Context, name string) (string, error)
- func (r *Resolver) ResolveAnalyticSetUUID(ctx context.Context, name string) (string, error)
- func (r *Resolver) ResolveAnalyticUUID(ctx context.Context, name string) (string, error)
- func (r *Resolver) ResolveApiClientID(ctx context.Context, name string) (string, error)
- func (r *Resolver) ResolveComputer(ctx context.Context, arg string) (jamfprotect.Computer, error)
- func (r *Resolver) ResolveComputerUUID(ctx context.Context, arg string) (string, error)
- func (r *Resolver) ResolveConnectionID(ctx context.Context, name string) (string, error)
- func (r *Resolver) ResolveCustomPreventListID(ctx context.Context, name string) (string, error)
- func (r *Resolver) ResolveExceptionSetUUID(ctx context.Context, name string) (string, error)
- func (r *Resolver) ResolveGroupID(ctx context.Context, name string) (string, error)
- func (r *Resolver) ResolveInsightUUID(ctx context.Context, label string) (string, error)
- func (r *Resolver) ResolvePlanID(ctx context.Context, name string) (string, error)
- func (r *Resolver) ResolveRemovableStorageControlSetID(ctx context.Context, name string) (string, error)
- func (r *Resolver) ResolveRoleID(ctx context.Context, name string) (string, error)
- func (r *Resolver) ResolveTelemetryV2ID(ctx context.Context, name string) (string, error)
- func (r *Resolver) ResolveUnifiedLoggingFilterSetUUID(ctx context.Context, name string) (string, error)
- func (r *Resolver) ResolveUnifiedLoggingFilterUUID(ctx context.Context, name string) (string, error)
- func (r *Resolver) ResolveUserID(ctx context.Context, email string) (string, error)
Constants ¶
This section is empty.
Variables ¶
var ErrNotFound = errors.New("not found")
ErrNotFound reports that a lookup completed and the name was absent — as distinct from the lookup itself failing.
Callers that create-on-absent must tell the two apart with errors.Is. Treating every error as "absent" turns a transient list failure, an expired token or a permission problem into an unintended create, and the operator sees whatever the server says about the resulting duplicate rather than the real cause. That matters most in bulk paths like 'protect restore', where one blip mid-run would otherwise mutate the tenant a different way than intended.
Functions ¶
func DescribeComputer ¶ added in v1.32.0
func DescribeComputer(c jamfprotect.Computer) string
DescribeComputer renders a computer as hostname, serial and UUID for confirmations and ambiguity refusals.
func PickNamed ¶ added in v1.32.0
PickNamed returns the id of the one ref named exactly name. A name no ref carries matches ErrNotFound; a name several refs share is refused with every id, since acting on one of them would be a guess.
Types ¶
type NamedRef ¶ added in v1.32.0
NamedRef is one listed record reduced to the name it is looked up by and the identifier the caller acts on.
type Resolver ¶
type Resolver struct {
// contains filtered or unexported fields
}
Resolver maps resource names to IDs/UUIDs. Results are cached per resource type to avoid redundant list calls within a single command.
func NewResolver ¶
func NewResolver(client registry.ProtectClient) *Resolver
NewResolver creates a Resolver for the given Protect client.
func (*Resolver) ResolveActionConfigID ¶
ResolveActionConfigID returns the ID for an action config given its name.
func (*Resolver) ResolveAnalyticSetUUID ¶
ResolveAnalyticSetUUID returns the UUID for an analytic set given its name.
func (*Resolver) ResolveAnalyticUUID ¶
ResolveAnalyticUUID returns the UUID for an analytic given its name.
func (*Resolver) ResolveApiClientID ¶
ResolveApiClientID returns the client ID for an API client given its name.
func (*Resolver) ResolveComputer ¶ added in v1.32.0
ResolveComputer returns the one computer identified by arg, matched as an exact UUID, then serial number, then hostname. The first identifier that matches decides, so a hostname set to another computer's serial cannot capture it, and two computers sharing the deciding value are refused.
func (*Resolver) ResolveComputerUUID ¶
ResolveComputerUUID returns the UUID of the computer ResolveComputer picks.
func (*Resolver) ResolveConnectionID ¶ added in v1.28.0
ResolveConnectionID returns the ID for an identity provider connection given its name.
func (*Resolver) ResolveCustomPreventListID ¶
ResolveCustomPreventListID returns the ID for a custom prevent list given its name.
func (*Resolver) ResolveExceptionSetUUID ¶
ResolveExceptionSetUUID returns the UUID for an exception set given its name.
func (*Resolver) ResolveGroupID ¶
ResolveGroupID returns the ID for a group given its name.
func (*Resolver) ResolveInsightUUID ¶
ResolveInsightUUID returns the UUID for an insight given its label.
func (*Resolver) ResolvePlanID ¶
ResolvePlanID returns the ID for a plan given its name.
func (*Resolver) ResolveRemovableStorageControlSetID ¶
func (r *Resolver) ResolveRemovableStorageControlSetID(ctx context.Context, name string) (string, error)
ResolveRemovableStorageControlSetID returns the ID for a removable storage control set.
func (*Resolver) ResolveRoleID ¶
ResolveRoleID returns the ID for a role given its name.
func (*Resolver) ResolveTelemetryV2ID ¶
ResolveTelemetryV2ID returns the ID for a telemetry v2 config given its name.
func (*Resolver) ResolveUnifiedLoggingFilterSetUUID ¶ added in v1.27.0
func (r *Resolver) ResolveUnifiedLoggingFilterSetUUID(ctx context.Context, name string) (string, error)
ResolveUnifiedLoggingFilterSetUUID returns the UUID for a unified logging filter set.