//native
/**
* Approve change control
* Approve a change control (resource API changecontrol.v1). The approval is tied to the change control's current version, read just before, so a change control edited since is not approved by mistake.
*/
export async function main(
auth: RT.AristaCloudvision,
change_control_id: string,
notes: string = ""
) {
const current = await cv(
auth,
`/api/resources/changecontrol/v1/ChangeControl?key.id=${encodeURIComponent(change_control_id)}`,
{ notFound: `Change control ${change_control_id} not found` }
)
const version = current.value?.change?.time
if (!version) {
throw new Error(
`Change control ${change_control_id} has no change time to approve against`
)
}
return await cv(auth, "/api/resources/changecontrol/v1/ApproveConfig", {
body: {
key: { id: change_control_id },
approve: { value: true, notes: notes || "" },
version,
},
})
}
// Calls CloudVision and turns its failures into readable errors.
async function cv(
auth: RT.AristaCloudvision,
path: string,
options: { body?: unknown; notFound?: string; optional?: boolean } = {}
): Promise<any> {
const url = new URL(path, auth.base_url)
const response = await fetch(url, {
method: options.body === undefined ? "GET" : "POST",
headers: {
Authorization: `Bearer ${auth.token}`,
...(options.body === undefined
? {}
: { "Content-Type": "application/json" }),
Accept: "application/json",
},
body: options.body === undefined ? undefined : JSON.stringify(options.body),
})
const text = await response.text()
if (
response.status === 401 ||
response.status === 403 ||
(!response.ok && text.includes("User is unauthorized"))
) {
throw new Error(
`CloudVision refused the token (HTTP ${response.status}): check that the service-account token is valid, not expired, and that its role allows this call. ${text}`
)
}
const data =
text.trim() === ""
? {}
: /^\s*[[{]/.test(text)
? JSON.parse(text)
: undefined
const error = findError(data)
if (response.ok && data !== undefined && !error) return data
const detail = error
? `${error.errorCode} ${error.errorMessage ?? (error.errors ?? []).join("; ")}`
: `HTTP ${response.status} ${text.slice(0, 500)}`
// Legacy lookups answer an unknown name or ID with an errorCode (cvprac
// treats any error from getTaskById and getImageBundleByName that way).
if (
response.status === 404 ||
(error && (options.optional || options.notFound))
) {
if (options.optional) return undefined
if (options.notFound) throw new Error(`${options.notFound} (${detail})`)
}
if (response.ok && !error) {
throw new Error(
`CloudVision returned a non-JSON response for ${url.pathname}: check that base_url is the CloudVision address. ${detail}`
)
}
throw new Error(`CloudVision ${url.pathname} failed: ${detail}`)
}
function findError(value: any): any {
if (!value || typeof value !== "object") return undefined
// Like cvprac, only a truthy errorCode counts, at any depth.
if (!Array.isArray(value) && value.errorCode) return value
for (const item of Object.values(value)) {
const error = findError(item)
if (error) return error
}
return undefined
}
Submitted by hugo989 5 hours ago