softwareartifacts

type GetSoftwareArtifactRequest struct {
	// Resource name of the artifact, of the form
	// `software-artifacts/{catalog}.{schema}.{artifact}`.
	Name string `json:"-" url:"-"`
}

type GetSoftwareArtifactVersionRequest struct {
	// Resource name of the version, of the form
	// `software-artifacts/{catalog}.{schema}.{artifact}/versions/{version}`.
	Name string `json:"-" url:"-"`
}

type ImageAccelerationDetail struct {
	// Image acceleration status for the version.
	Status ImageAccelerationDetailStatus `json:"status,omitempty"`
}

type ImageAccelerationDetailStatus string

type ListSoftwareArtifactVersionsRequest struct {
	// Maximum number of versions to return. If omitted or set to 0, the page
	// size defaults to 50. The maximum value is 50; values above 50 or below 0
	// are rejected.
	PageSize int `json:"-" url:"page_size,omitempty"`
	// Opaque continuation token from a previous response's next_page_token.
	// Omit for the first page.
	PageToken string `json:"-" url:"page_token,omitempty"`
	// Resource name of the parent artifact, of the form
	// `software-artifacts/{catalog}.{schema}.{artifact}`.
	Parent string `json:"-" url:"-"`

	ForceSendFields []string `json:"-" url:"-"`
}

type ListSoftwareArtifactVersionsResponse struct {
	// Opaque token to pass as the next request's page_token. Empty when there
	// are no more pages.
	NextPageToken string `json:"next_page_token,omitempty"`
	// The versions of the requested software artifact.
	SoftwareArtifactVersions []SoftwareArtifactVersion `json:"software_artifact_versions,omitempty"`

	ForceSendFields []string `json:"-" url:"-"`
}

type ListSoftwareArtifactsRequest struct {
	// Maximum number of software artifacts to return. If omitted or set to 0,
	// the page size defaults to 50. The maximum value is 50; values above 50 or
	// below 0 are rejected.
	PageSize int `json:"-" url:"page_size,omitempty"`
	// Opaque continuation token from a previous response's next_page_token.
	// Omit for the first page.
	PageToken string `json:"-" url:"page_token,omitempty"`
	// Resource name of the parent schema, of the form
	// `schemas/{catalog}.{schema}`.
	Parent string `json:"-" url:"parent"`

	ForceSendFields []string `json:"-" url:"-"`
}

type ListSoftwareArtifactsResponse struct {
	// Opaque token to pass as the next request's page_token. Empty when there
	// are no more pages.
	NextPageToken string `json:"next_page_token,omitempty"`
	// The software artifacts under the requested schema.
	SoftwareArtifacts []SoftwareArtifact `json:"software_artifacts,omitempty"`

	ForceSendFields []string `json:"-" url:"-"`
}

type ResolveSoftwareArtifactVersionRequest struct {
	// Image tag alias selecting the version.
	Alias string `json:"alias"`
	// Resource name of the software artifact containing the alias.
	Parent string `json:"-" url:"-"`
}

type ResolveSoftwareArtifactVersionResponse struct {
	// The software artifact version selected by the alias.
	SoftwareArtifactVersion *SoftwareArtifactVersion `json:"software_artifact_version,omitempty"`
}

type SoftwareArtifact struct {
	// Time at which this software artifact was created.
	CreateTime *time.Time `json:"create_time,omitempty"`
	// Principal name of the software artifact creator.
	CreatedBy string `json:"created_by,omitempty"`
	// Resource name of the artifact, of the form
	// `software-artifacts/{catalog}.{schema}.{artifact}`.
	Name string `json:"name,omitempty"`
	// Principal name (a user, service principal, or group) that owns this
	// artifact.
	Owner string `json:"owner,omitempty"`
	// Time at which this software artifact was last updated.
	UpdateTime *time.Time `json:"update_time,omitempty"`
	// Principal name that last updated this software artifact.
	UpdatedBy string `json:"updated_by,omitempty"`

	ForceSendFields []string `json:"-" url:"-"`
}

type SoftwareArtifactVersion struct {
	// Time at which this software artifact version was created.
	CreateTime *time.Time `json:"create_time,omitempty"`
	// Principal name of the software artifact version creator.
	CreatedBy string `json:"created_by,omitempty"`
	// Content digest of the version, for example `sha256:...`.
	Digest string `json:"digest,omitempty"`
	// Image acceleration information for this version.
	ImageAccelerationDetails *ImageAccelerationDetail `json:"image_acceleration_details,omitempty"`
	// Resource name of the version, of the form
	// `software-artifacts/{catalog}.{schema}.{artifact}/versions/{version}`.
	Name string `json:"name,omitempty"`
	// Tags (aliases) that currently point at this version, for example `latest`
	// or `v1.2.3`. Bounded at 10 per version; a version pointed at by more tags
	// returns an arbitrary 10 of them.
	Tags []string `json:"tags,omitempty"`
	// Time at which this software artifact version was last updated.
	UpdateTime *time.Time `json:"update_time,omitempty"`
	// Principal name that last updated this software artifact version.
	UpdatedBy string `json:"updated_by,omitempty"`

	ForceSendFields []string `json:"-" url:"-"`
}

type SoftwareArtifactsAPI struct {
	// contains filtered or unexported fields
}

type SoftwareArtifactsInterface interface {

	// Gets a software artifact.
	GetSoftwareArtifact(ctx context.Context, request GetSoftwareArtifactRequest) (*SoftwareArtifact, error)

	// Gets a software artifact version.
	GetSoftwareArtifactVersion(ctx context.Context, request GetSoftwareArtifactVersionRequest) (*SoftwareArtifactVersion, error)

	// Lists the versions of a software artifact.
	//
	// This method is generated by Databricks SDK Code Generator.
	ListSoftwareArtifactVersions(ctx context.Context, request ListSoftwareArtifactVersionsRequest) listing.Iterator[SoftwareArtifactVersion]

	// Lists the versions of a software artifact.
	//
	// This method is generated by Databricks SDK Code Generator.
	ListSoftwareArtifactVersionsAll(ctx context.Context, request ListSoftwareArtifactVersionsRequest) ([]SoftwareArtifactVersion, error)

	// Lists software artifacts in a schema.
	//
	// This method is generated by Databricks SDK Code Generator.
	ListSoftwareArtifacts(ctx context.Context, request ListSoftwareArtifactsRequest) listing.Iterator[SoftwareArtifact]

	// Lists software artifacts in a schema.
	//
	// This method is generated by Databricks SDK Code Generator.
	ListSoftwareArtifactsAll(ctx context.Context, request ListSoftwareArtifactsRequest) ([]SoftwareArtifact, error)

	// Resolves a software artifact version from its tag alias.
	ResolveSoftwareArtifactVersion(ctx context.Context, request ResolveSoftwareArtifactVersionRequest) (*ResolveSoftwareArtifactVersionResponse, error)

	// Updates a software artifact. The name is immutable; only the owner may be
	// changed. The destination owner must exist in the account. The caller needs
	// MANAGE_ACCESS_CONTROL on the artifact. The response contains its name and the
	// requested owner; audit fields are omitted.
	UpdateSoftwareArtifact(ctx context.Context, request UpdateSoftwareArtifactRequest) (*SoftwareArtifact, error)
}

type UpdateSoftwareArtifactRequest struct {
	// Resource name of the artifact, of the form
	// `software-artifacts/{catalog}.{schema}.{artifact}`.
	Name string `json:"-" url:"-"`
	// The software artifact to update. Its name identifies the existing
	// artifact; only owner may be changed.
	SoftwareArtifact SoftwareArtifact `json:"software_artifact"`
	// Fields to update, relative to `software_artifact`. Accepts `owner` or
	// `*`; owner is the only mutable field, so both select the same update.
	// Output-only values in the resource are ignored.
	UpdateMask fieldmask.FieldMask `json:"-" url:"update_mask"`
}