pipelinesapproval

type Approval struct {
	// /// Gets the links to access the approval object.
	Links interface{} `json:"_links,omitempty"`
	// Identities which are not allowed to approve.
	BlockedApprovers *[]webapi.IdentityRef `json:"blockedApprovers,omitempty"`
	// Date on which approval got created.
	CreatedOn *azuredevops.Time `json:"createdOn,omitempty"`
	// Order in which approvers will be actionable.
	ExecutionOrder *ApprovalExecutionOrder `json:"executionOrder,omitempty"`
	// Unique identifier of the approval.
	Id *uuid.UUID `json:"id,omitempty"`
	// Instructions for the approvers.
	Instructions *string `json:"instructions,omitempty"`
	// Date on which approval was last modified.
	LastModifiedOn *azuredevops.Time `json:"lastModifiedOn,omitempty"`
	// Minimum number of approvers that should approve for the entire approval to be considered approved.
	MinRequiredApprovers *int `json:"minRequiredApprovers,omitempty"`
	// Current user permissions for approval object.
	Permissions *ApprovalPermissions `json:"permissions,omitempty"`
	// Overall status of the approval.
	Status *ApprovalStatus `json:"status,omitempty"`
	// List of steps associated with the approval.
	Steps *[]ApprovalStep `json:"steps,omitempty"`
}

type ApprovalCompletedNotificationEvent struct {
	Approval  *Approval  `json:"approval,omitempty"`
	ProjectId *uuid.UUID `json:"projectId,omitempty"`
}

type ApprovalConfig struct {
	// Ordered list of approvers.
	Approvers *[]webapi.IdentityRef `json:"approvers,omitempty"`
	// Identities which are not allowed to approve.
	BlockedApprovers *[]webapi.IdentityRef `json:"blockedApprovers,omitempty"`
	// Order in which approvers will be actionable.
	ExecutionOrder *ApprovalExecutionOrder `json:"executionOrder,omitempty"`
	// Instructions for the approver.
	Instructions *string `json:"instructions,omitempty"`
	// Minimum number of approvers that should approve for the entire approval to be considered approved. Defaults to all.
	MinRequiredApprovers *int `json:"minRequiredApprovers,omitempty"`
}

type ApprovalConfigSettings struct {
	// Ordered list of approvers.
	Approvers *[]webapi.IdentityRef `json:"approvers,omitempty"`
	// Identities which are not allowed to approve.
	BlockedApprovers *[]webapi.IdentityRef `json:"blockedApprovers,omitempty"`
	// Order in which approvers will be actionable.
	ExecutionOrder *ApprovalExecutionOrder `json:"executionOrder,omitempty"`
	// Instructions for the approver.
	Instructions *string `json:"instructions,omitempty"`
	// Minimum number of approvers that should approve for the entire approval to be considered approved. Defaults to all.
	MinRequiredApprovers *int `json:"minRequiredApprovers,omitempty"`
	// Determines whether check requester can approve the check.
	RequesterCannotBeApprover *bool `json:"requesterCannotBeApprover,omitempty"`
}

type ApprovalDetailsExpandParameter string

type ApprovalExecutionOrder string

type ApprovalNotificationEventBase struct {
	Approval  *Approval  `json:"approval,omitempty"`
	ProjectId *uuid.UUID `json:"projectId,omitempty"`
}

type ApprovalPermissions string

type ApprovalRequest struct {
	// Unique identifier with which the approval is to be registered.
	ApprovalId *uuid.UUID `json:"approvalId,omitempty"`
	// Configuration of the approval request.
	Config *ApprovalConfig `json:"config,omitempty"`
}

type ApprovalStatus string

type ApprovalStep struct {
	// Identity who approved.
	ActualApprover *webapi.IdentityRef `json:"actualApprover,omitempty"`
	// Identity who should approve.
	AssignedApprover *webapi.IdentityRef `json:"assignedApprover,omitempty"`
	// Comment associated with this step.
	Comment *string `json:"comment,omitempty"`
	// History of the approval step
	History *[]ApprovalStepHistory `json:"history,omitempty"`
	// Timestamp at which this step was initiated.
	InitiatedOn *azuredevops.Time `json:"initiatedOn,omitempty"`
	// Identity by which this step was last modified.
	LastModifiedBy *webapi.IdentityRef `json:"lastModifiedBy,omitempty"`
	// Timestamp at which this step was last modified.
	LastModifiedOn *azuredevops.Time `json:"lastModifiedOn,omitempty"`
	// Order in which the approvers are allowed to approve.
	Order *int `json:"order,omitempty"`
	// Current user permissions for step.
	Permissions *ApprovalPermissions `json:"permissions,omitempty"`
	// Current status of this step.
	Status *ApprovalStatus `json:"status,omitempty"`
}

type ApprovalStepHistory struct {
	// Identity who was assigned this approval
	AssignedTo *webapi.IdentityRef `json:"assignedTo,omitempty"`
	// Comment associated with this step history.
	Comment *string `json:"comment,omitempty"`
	// Identity by which this step history was created.
	CreatedBy *webapi.IdentityRef `json:"createdBy,omitempty"`
	// Timestamp at which this step history was created.
	CreatedOn *azuredevops.Time `json:"createdOn,omitempty"`
}

type ApprovalUpdateParameters struct {
	// ID of the approval to be updated.
	ApprovalId *uuid.UUID `json:"approvalId,omitempty"`
	// Current approver.
	AssignedApprover *webapi.IdentityRef `json:"assignedApprover,omitempty"`
	// Gets or sets comment.
	Comment *string `json:"comment,omitempty"`
	// Reassigned Approver.
	ReassignTo *webapi.IdentityRef `json:"reassignTo,omitempty"`
	// Gets or sets status.
	Status *ApprovalStatus `json:"status,omitempty"`
}

type ApprovalsQueryParameters struct {
	// Query approvals based on list of approval IDs.
	ApprovalIds *[]uuid.UUID `json:"approvalIds,omitempty"`
}

type Client interface {
	// [Preview API] Get an approval.
	GetApproval(context.Context, GetApprovalArgs) (*Approval, error)
	// [Preview API] List Approvals. This can be used to get a set of pending approvals in a pipeline, on an user or for a resource..
	QueryApprovals(context.Context, QueryApprovalsArgs) (*[]Approval, error)
	// [Preview API] Update approvals.
	UpdateApprovals(context.Context, UpdateApprovalsArgs) (*[]Approval, error)
}

type ClientImpl struct {
	Client azuredevops.Client
}

type GetApprovalArgs struct {
	// (required) Project ID or project name
	Project *string
	// (required) Id of the approval.
	ApprovalId *uuid.UUID
	// (optional)
	Expand *ApprovalDetailsExpandParameter
}

type QueryApprovalsArgs struct {
	// (required) Project ID or project name
	Project *string
	// (optional)
	ApprovalIds *[]uuid.UUID
	// (optional)
	Expand *ApprovalDetailsExpandParameter
}

type UpdateApprovalsArgs struct {
	// (required)
	UpdateParameters *[]ApprovalUpdateParameters
	// (required) Project ID or project name
	Project *string
}