Skip to main content

jobs

Creates, updates, deletes, gets or lists a jobs resource.

Overview

Namejobs
TypeResource
Idazure_extras.storsimple_8000_series.jobs

Fields

The following fields are returned by SELECT queries:

The job.

NameDatatypeDescription
idstringThe path ID that uniquely identifies the object.
namestringThe name of the object.
endTimestring (date-time)The UTC time at which the job completed.
errorobjectThe error details, if any, for the job.
kindstringThe Kind of the object. Currently only Series8000 is supported
percentCompleteinteger (int32)The percentage of the job that is already complete.
propertiesobjectThe properties of the job.
startTimestring (date-time)The UTC time at which the job was started.
statusstringThe current status of the job.
typestringThe hierarchical type of the object.

Methods

The following methods are available for this resource:

NameAccessible byRequired ParamsOptional ParamsDescription
getselectdeviceName, jobName, subscriptionId, resourceGroupName, managerNameGets the details of the specified job name.
list_by_deviceselectdeviceName, subscriptionId, resourceGroupName, managerName$filterGets all the jobs for specified device. With optional OData query parameters, a filtered set of jobs is returned.
list_by_managerselectsubscriptionId, resourceGroupName, managerName$filterGets all the jobs for the specified manager. With optional OData query parameters, a filtered set of jobs is returned.
cancelexecdeviceName, jobName, subscriptionId, resourceGroupName, managerNameCancels a job on the device.

Parameters

Parameters can be passed in the WHERE clause of a query. Check the Methods section to see which parameters are required or optional for each operation.

NameDatatypeDescription
deviceNamestringThe device name
jobNamestringThe jobName.
managerNamestringThe manager name
resourceGroupNamestringThe resource group name
subscriptionIdstringThe subscription id
$filterstringOData Filter options

SELECT examples

Gets the details of the specified job name.

SELECT
id,
name,
endTime,
error,
kind,
percentComplete,
properties,
startTime,
status,
type
FROM azure_extras.storsimple_8000_series.jobs
WHERE deviceName = '{{ deviceName }}' -- required
AND jobName = '{{ jobName }}' -- required
AND subscriptionId = '{{ subscriptionId }}' -- required
AND resourceGroupName = '{{ resourceGroupName }}' -- required
AND managerName = '{{ managerName }}' -- required
;

Lifecycle Methods

Cancels a job on the device.

EXEC azure_extras.storsimple_8000_series.jobs.cancel 
@deviceName='{{ deviceName }}' --required,
@jobName='{{ jobName }}' --required,
@subscriptionId='{{ subscriptionId }}' --required,
@resourceGroupName='{{ resourceGroupName }}' --required,
@managerName='{{ managerName }}' --required
;