Docs Dashboard Developers
Menu ⌃

Go SDK — Catalog & quotas

CatalogServiceClient, QuotaServiceClient, and AuditServiceClient cover discovery, limits, and compliance history.

Catalog

catalog := catalogv1connect.NewCatalogServiceClient(httpClient, base)
dcs, _ := catalog.ListDatacenters(ctx, connect.NewRequest(
    &catalogv1.ListDatacentersRequest{},
))
cap, _ := catalog.GetVMCapacity(ctx, connect.NewRequest(
    &catalogv1.GetVMCapacityRequest{DatacenterName: "datacenters/us-dal-1"},
))
quote, _ := catalog.QuoteVirtualMachine(ctx, connect.NewRequest(
    &catalogv1.QuoteVirtualMachineRequest{
        Vcpus: 2, RamGib: 8, CpuClass: "cascadelake", BootDiskGib: 80,
        AssignPublicIpv4: true,
    },
))

ListDatacenters includes per-DC capacity headroom. GetVMCapacity returns schedulable vCPU/RAM/GPU for quoting realistic VM sizes.

Quotas

quota := quotav1connect.NewQuotaServiceClient(httpClient, base)
resp, _ := quota.GetMyQuotas(ctx, connect.NewRequest(
    &quotav1.GetMyQuotasRequest{ProjectName: project},
))
for _, q := range resp.Msg.GetQuotas() {
    fmt.Println(q.GetMeter(), q.GetUsed(), "/", q.GetLimit())
}

Read-only in v1 — increase requests go through support tickets.

Audit

audit := auditv1connect.NewAuditServiceClient(httpClient, base)
resp, _ := audit.SearchEvents(ctx, connect.NewRequest(
    &auditv1.SearchEventsRequest{
        ProjectName: project,
        ActionPrefix: "compute.vm",
        PageSize: 50,
    },
))

What's next