Method templateVersionByName

coderd/templateversions.go:940–993

@Summary Get template version by template ID and name @ID get-template-version-by-template-id-and-name @Security CoderSessionToken @Produce json @Tags Templates @Param template path string true "Template ID" format(uuid) @Param templateversionname path string true "Template version name" @Success 20

(rw http.ResponseWriter, r *http.Request)

// @Success 200 {array} codersdk.TemplateVersion
// @Router /api/v2/templates/{template}/versions/{templateversionname} [get]
func (api *API) templateVersionByName(rw http.ResponseWriter, r *http.Request) {
	ctx := r.Context()
	template := httpmw.TemplateParam(r)

	templateVersionName := chi.URLParam(r, "templateversionname")
	templateVersion, err := api.Database.GetTemplateVersionByTemplateIDAndName(ctx, database.GetTemplateVersionByTemplateIDAndNameParams{
		TemplateID: uuid.NullUUID{
			UUID:  template.ID,
			Valid: true,
		},
		Name: templateVersionName,
	})
	if httpapi.Is404Error(err) {
		httpapi.Write(ctx, rw, http.StatusNotFound, codersdk.Response{
			Message: fmt.Sprintf("No template version found by name %q.", templateVersionName),
		})
		return
	}
	if err != nil {
		httpapi.Write(ctx, rw, http.StatusInternalServerError, codersdk.Response{
			Message: "Internal error fetching template version.",
			Detail:  err.Error(),
		})
		return
	}
	jobs, err := api.Database.GetProvisionerJobsByIDsWithQueuePosition(ctx, database.GetProvisionerJobsByIDsWithQueuePositionParams{
		IDs:             []uuid.UUID{templateVersion.JobID},
		StaleIntervalMS: provisionerdserver.StaleInterval.Milliseconds(),
	})
	if err != nil || len(jobs) == 0 {
		httpapi.Write(ctx, rw, http.StatusInternalServerError, codersdk.Response{
			Message: "Internal error fetching provisioner job.",
			Detail:  err.Error(),
		})
		return
	}
	var matchedProvisioners *codersdk.MatchedProvisioners
	if jobs[0].ProvisionerJob.JobStatus == database.ProvisionerJobStatusPending {
		// nolint: gocritic // The user hitting this endpoint may not have
		// permission to read provisioner daemons, but we want to show them
		// information about the provisioner daemons that are available.
		provisioners, err := api.Database.GetProvisionerDaemonsByOrganization(dbauthz.AsSystemReadProvisionerDaemons(ctx), database.GetProvisionerDaemonsByOrganizationParams{
			OrganizationID: jobs[0].ProvisionerJob.OrganizationID,
			WantTags:       jobs[0].ProvisionerJob.Tags,
		})
		if err != nil {
			api.Logger.Error(ctx, "failed to fetch provisioners for job id", slog.F("job_id", jobs[0].ProvisionerJob.ID), slog.Error(err))
		} else {
			matchedProvisioners = ptr.Ref(db2sdk.MatchedProvisioners(provisioners, dbtime.Now(), provisionerdserver.StaleInterval))
		}
	}

	httpapi.Write(ctx, rw, http.StatusOK, convertTemplateVersion(templateVersion, convertProvisionerJob(jobs[0]), matchedProvisioners, nil))
}

// @Summary Get template version by organization, template, and name
// @ID get-template-version-by-organization-template-and-name