mirror of
https://github.com/hanzos3/madmin-go.git
synced 2026-10-30 20:35:32 +00:00
* feat: add DistJobType enum and sync distjob status types Adds an iota-based DistJobType enum (mirrors the HealingDriveReason/ OfflineReason pattern already used in heal-commands.go) so distributed job identity is a typed wire value instead of a bare string, per review feedback on the eos distributed-job framework PR. Also syncs DistJobLeaderStatus/DistJobNodeStatus field shapes to match the current server-side JSON response (JobID/JobType replace JobName; drops the unused Generation/AssignedSets/top-level CurrentBucket fields that were never populated by the server). * fix: bump vulnerable prometheus dep - Add msgp generation (//msgp:tag json + //go:generate msgp) for DistJobLeaderStatus/DistJobNodeStatus, matching the pattern used by every other *-commands.go file in this package. - Add unit tests for ListDistJobStatuses (success path, job-filter query param, DistJobTypeUnknown no-filter case, non-200 error path). - Bump github.com/prometheus/prometheus v0.304.1 -> v0.312.0 to clear 3 of the 4 govulncheck findings on this branch (GO-2026-5710, GO-2026-5381, GO-2026-5264, all fixed by that version). The 4th, GO-2026-5662, has no fix published upstream yet and also currently fails govulncheck on main independent of this branch. * fix: pin go:generate directives to go.mod tool versions Consolidate distjob-commands.go's separate //msgp:tag json directive into the //go:generate msgp -d "tag json" flag, matching net-stats.go's style (review feedback, PR #557). Change every //go:generate msgp / //go:generate stringer directive (31 occurrences, 30 files) to //go:generate go tool msgp / go tool stringer, so generation always resolves the exact version pinned in go.mod's tool block instead of whatever binary happens to be on PATH. This was the root cause of the earlier stringer-drift CI failure. Drop the now-unnecessary `go install -v tool` step from lint.yml.
164 lines
4.3 KiB
Go
164 lines
4.3 KiB
Go
// Copyright (c) 2015-2025 MinIO, Inc.
|
|
//
|
|
// This file is part of MinIO Object Storage stack
|
|
//
|
|
// This program is free software: you can redistribute it and/or modify
|
|
// it under the terms of the GNU Affero General Public License as
|
|
// published by the Free Software Foundation, either version 3 of the
|
|
// License, or (at your option) any later version.
|
|
//
|
|
// This program is distributed in the hope that it will be useful,
|
|
// but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
// GNU Affero General Public License for more details.
|
|
//
|
|
// You should have received a copy of the GNU Affero General Public License
|
|
// along with this program. If not, see <http://www.gnu.org/licenses/>.
|
|
//
|
|
|
|
package madmin
|
|
|
|
import (
|
|
"context"
|
|
"errors"
|
|
"net/http"
|
|
"net/url"
|
|
"time"
|
|
|
|
"github.com/tinylib/msgp/msgp"
|
|
)
|
|
|
|
//go:generate go tool msgp -d clearomitted -d "timezone utc" -unexported -file=$GOFILE
|
|
|
|
// ObjectSummaryOptions provides options for ObjectSummary call.
|
|
type ObjectSummaryOptions struct {
|
|
Bucket string
|
|
Object string
|
|
Bitrot bool
|
|
}
|
|
|
|
// ObjectSummary calls minio to search for all files and parts
|
|
// related to the given object, across all disks.
|
|
func (adm *AdminClient) ObjectSummary(ctx context.Context, objOpts ObjectSummaryOptions) (objectSummary *ObjectSummary, err error) {
|
|
form := make(url.Values)
|
|
if objOpts.Bucket == "" {
|
|
return nil, errors.New("no bucket speficied")
|
|
}
|
|
if objOpts.Object == "" {
|
|
return nil, errors.New("no object speficied")
|
|
}
|
|
|
|
form.Add("bucket", objOpts.Bucket)
|
|
form.Add("object", objOpts.Object)
|
|
if objOpts.Bitrot {
|
|
form.Add("bitrot", "true")
|
|
}
|
|
|
|
resp, err := adm.executeMethod(ctx,
|
|
http.MethodGet,
|
|
requestData{
|
|
relPath: adminAPIPrefix + "/object-summary",
|
|
queryValues: form,
|
|
})
|
|
defer closeResponse(resp)
|
|
if err != nil {
|
|
return nil, err
|
|
}
|
|
|
|
if resp.StatusCode != http.StatusOK {
|
|
return nil, httpRespToErrorResponse(resp)
|
|
}
|
|
|
|
objectSummary = new(ObjectSummary)
|
|
err = msgp.Decode(resp.Body, objectSummary)
|
|
if err != nil {
|
|
return nil, err
|
|
}
|
|
|
|
return objectSummary, err
|
|
}
|
|
|
|
// ObjectMetaSummary is returned from minio when calling ObjectSummary
|
|
// This struct gives specific information about xl.meta files
|
|
// belonging to the object being inspected by the ObjectSummary API.
|
|
type ObjectMetaSummary struct {
|
|
Filename string
|
|
Host string
|
|
Drive string
|
|
Size int64
|
|
Errors []string
|
|
IsDeleteMarker bool
|
|
ModTime int64
|
|
Signature [4]byte
|
|
Pool int
|
|
Set int
|
|
}
|
|
|
|
// ObjectPartSummary is returned from minio when calling ObjectSummary.
|
|
// This struct gives specific information about each part of the object
|
|
// being inspected by the ObjectSummary API.
|
|
type ObjectPartSummary struct {
|
|
Part int
|
|
Pool int
|
|
Host string
|
|
Set int
|
|
Drive string
|
|
Filename string
|
|
Size int64
|
|
}
|
|
|
|
// ObjectUnknownSummary is returned from minio when calling ObjectSummary.
|
|
// This struct contains information about files that are not part of any object structure.
|
|
type ObjectUnknownSummary struct {
|
|
Pool int
|
|
Host string
|
|
Set int
|
|
Drive string
|
|
Filename string
|
|
Size int64
|
|
Dir bool
|
|
Err string
|
|
}
|
|
|
|
// ObjectVersionSummary is returned from minio when calling ObjectSummary.
|
|
// This struct contains information on a single version.
|
|
type ObjectVersionSummary struct {
|
|
DeleteMarker bool
|
|
InLined bool
|
|
Size int64
|
|
VersionID string
|
|
Checksum []byte
|
|
ModTime time.Time
|
|
DataDir string
|
|
DataBlocks int
|
|
ParityBlocks int
|
|
}
|
|
|
|
// ObjectBitrotSummary is returned from minio when calling ObjectSummary.
|
|
// This struct contains bitrot information for and object on a specific host and drive.
|
|
type ObjectBitrotSummary struct {
|
|
Host string
|
|
Disk string
|
|
Parts []int
|
|
}
|
|
|
|
// ObjectSummary is returned from minio when calling ObjectSummary.
|
|
type ObjectSummary struct {
|
|
Name string
|
|
Errors []string
|
|
// DataDir represents the directory on disk created using
|
|
// the version ID's or a random uuid if the object is not
|
|
// versioned.
|
|
DataDir string
|
|
Version string
|
|
PartNumbers []int
|
|
ErasureDist []uint8
|
|
ParityCount int // deprecated
|
|
DeleteMarker bool
|
|
Metas []*ObjectMetaSummary
|
|
Parts []*ObjectPartSummary
|
|
Unknown []*ObjectUnknownSummary
|
|
Versions []*ObjectVersionSummary
|
|
Bitrot []*ObjectBitrotSummary
|
|
}
|