|
APIs in Category: DpSchedule |
API version 5.0 |
DpScheduleContentGet |
This set of API's is being used To manage data protection schedules. A data protection schedule can be of Type daily, weekly or monthly. The data protection schedule will be used by the data protection Policy To provide Snapshot, snap vault and/or snap mirror protection. All date/time ranges in the APIs are inclusive. |
| DpScheduleContentGet (supported) | [top] |
Get the content of a given schedule.
Input Name Type DpScheduleContentGet DpScheduleContentGet
Output Name Type DpScheduleContentGetResult DpScheduleContentGetResult
Error Name Description EACCESSDENIED EDATABASEERROR EOBJECTAMBIGUOUS ESCHEDULEINVALIDINPUT ESCHEDULENOTFOUND
| DpScheduleCreate (supported) | [top] |
Create a new schedule with the given Name. The schedule Type may be daily, weekly, or monthly.
Input Name Type DpScheduleCreate DpScheduleCreate
Output Name Type DpScheduleCreateResult DpScheduleCreateResult
Error Name Description EDATABASEERROR ESCHEDULEDUPLICATE ESCHEDULEINVALIDINPUT
| DpScheduleDailyAdd (supported) | [top] |
Create a single Snapshot within a daily schedule.
Input Name Type DpScheduleDailyAdd DpScheduleDailyAdd
Output Name Type DpScheduleDailyAddResult DpScheduleDailyAddResult
Error Name Description EACCESSDENIED EDATABASEERROR EOBJECTAMBIGUOUS ESCHEDULEINVALIDINPUT ESCHEDULENOTFOUND ESCHEDULENOTMODIFIABLE
| DpScheduleDailyDelete (supported) | [top] |
Delete a single Snapshot within a daily schedule.
Input Name Type DpScheduleDailyDelete DpScheduleDailyDelete
Output Name Type DpScheduleDailyDeleteResult DpScheduleDailyDeleteResult
Error Name Description EACCESSDENIED EDATABASEERROR EOBJECTAMBIGUOUS ESCHEDULEINVALIDINPUT ESCHEDULENOTFOUND
| DpScheduleDailyModify (supported) | [top] |
Modify a single Snapshot within a daily schedule. Sample schedules cannot be modified.
Input Name Type DpScheduleDailyModify DpScheduleDailyModify
Output Name Type DpScheduleDailyModifyResult DpScheduleDailyModifyResult
Error Name Description EACCESSDENIED EDATABASEERROR EOBJECTAMBIGUOUS ESCHEDULEINVALIDINPUT ESCHEDULENOTFOUND ESCHEDULENOTMODIFIABLE
| DpScheduleDependency (supported) | [top] |
Return a list of other DP policies and DP schedules using the specified DP schedule.
Input Name Type DpScheduleDependency DpScheduleDependency
Output Name Type DpScheduleDependencyResult DpScheduleDependencyResult
Error Name Description EACCESSDENIED EDATABASEERROR ESCHEDULENOTFOUND
| DpScheduleDestroy (supported) | [top] |
Delete a schedule with the given Name or ID. A schedule that is used by another schedule(s) may not be deleted and an Error will be returned. Sample schedules cannot be destroyed.
Input Name Type DpScheduleDestroy DpScheduleDestroy
Output Name Type DpScheduleDestroyResult DpScheduleDestroyResult
Error Name Description EACCESSDENIED EDATABASEERROR EOBJECTAMBIGUOUS ESCHEDULEINUSE ESCHEDULEINVALIDINPUT ESCHEDULENOTFOUND ESCHEDULENOTMODIFIABLE
| DpScheduleHourlyAdd (supported) | [top] |
Create an hourly schedule within a daily schedule. An hourly schedule specifies the Frequency of Snapshots To be run within the start time and end time.
Input Name Type DpScheduleHourlyAdd DpScheduleHourlyAdd
Output Name Type DpScheduleHourlyAddResult DpScheduleHourlyAddResult
Error Name Description EACCESSDENIED EDATABASEERROR EOBJECTAMBIGUOUS ESCHEDULEINVALIDINPUT ESCHEDULENOTFOUND ESCHEDULENOTMODIFIABLE
| DpScheduleHourlyDelete (supported) | [top] |
Delete an hourly schedule within a daily schedule.
Input Name Type DpScheduleHourlyDelete DpScheduleHourlyDelete
Output Name Type DpScheduleHourlyDeleteResult DpScheduleHourlyDeleteResult
Error Name Description EACCESSDENIED EDATABASEERROR EOBJECTAMBIGUOUS ESCHEDULEINVALIDINPUT ESCHEDULENOTFOUND
| DpScheduleHourlyModify (supported) | [top] |
Modify an hourly schedule within a daily schedule. Sample schedules cannot be modified.
Input Name Type DpScheduleHourlyModify DpScheduleHourlyModify
Output Name Type DpScheduleHourlyModifyResult DpScheduleHourlyModifyResult
Error Name Description EACCESSDENIED EDATABASEERROR EOBJECTAMBIGUOUS ESCHEDULEINVALIDINPUT ESCHEDULENOTFOUND ESCHEDULENOTMODIFIABLE
| DpScheduleList (supported) | [top] |
List all existing schedule IDs and types.
Input Name Type DpScheduleList DpScheduleList
Output Name Type DpScheduleListResult DpScheduleListResult
Error Name Description EDATABASEERROR
| DpScheduleListInfoIterEnd (supported) | [top] |
Tell the DFM station that the temporary store associated with the specified Tag is no longer necessary
Input Name Type DpScheduleListInfoIterEnd DpScheduleListInfoIterEnd
Output Name Type DpScheduleListInfoIterEndResult DpScheduleListInfoIterEndResult
Error Name Description EINVALIDTAG ESCHEDULEINVALIDINPUT
| DpScheduleListInfoIterNext (supported) | [top] |
Iterate over the list of schedules stored in the temporary store. The DFM internally maintains a cursor pointing To the last record returned. Subsequent calls To this API will return the Records after the cursor up To the specified "Maximum" or number of actual Records left.
Input Name Type DpScheduleListInfoIterNext DpScheduleListInfoIterNext
Output Name Type DpScheduleListInfoIterNextResult DpScheduleListInfoIterNextResult
Error Name Description EINVALIDTAG ESCHEDULEINVALIDINPUT
| DpScheduleListInfoIterStart (supported) | [top] |
The dp-dpschedule-list-info-iter-* set of APIs are used To retrieve a list of schedule contents
Input Name Type DpScheduleListInfoIterStart DpScheduleListInfoIterStart
Output Name Type DpScheduleListInfoIterStartResult DpScheduleListInfoIterStartResult
Error Name Description EACCESSDENIED EDATABASEERROR EOBJECTAMBIGUOUS ESCHEDULEINVALIDINPUT ESCHEDULENOTFOUND
| DpScheduleModify (supported) | [top] |
Modify a schedule's details in the database. When the zapi is called, all details within the schedule will be removed and replace by the new details specified in schedule-content. Sample schedules cannot be modified. ScheduleId and ScheduleType cannot be modified.
Input Name Type DpScheduleModify DpScheduleModify
Output Name Type DpScheduleModifyResult DpScheduleModifyResult
Error Name Description EACCESSDENIED EDATABASEERROR ESCHEDULEDUPLICATE ESCHEDULEINVALIDINPUT ESCHEDULENOTFOUND ESCHEDULENOTMODIFIABLE
| DpScheduleMonthlyAdd (supported) | [top] |
Specify a single Snapshot within a monthly schedule. Either DayOfMonth, or both WeekOfMonth and DayOfWeek must be specified.
Input Name Type DpScheduleMonthlyAdd DpScheduleMonthlyAdd
Output Name Type DpScheduleMonthlyAddResult DpScheduleMonthlyAddResult
Error Name Description EACCESSDENIED EDATABASEERROR EOBJECTAMBIGUOUS ESCHEDULEINVALIDINPUT ESCHEDULENOTFOUND ESCHEDULENOTMODIFIABLE
| DpScheduleMonthlyDelete (supported) | [top] |
Delete a single Snapshot within a monthly schedule
Input Name Type DpScheduleMonthlyDelete DpScheduleMonthlyDelete
Output Name Type DpScheduleMonthlyDeleteResult DpScheduleMonthlyDeleteResult
Error Name Description EACCESSDENIED EDATABASEERROR EOBJECTAMBIGUOUS ESCHEDULEINVALIDINPUT ESCHEDULENOTFOUND
| DpScheduleMonthlyModify (supported) | [top] |
Modify a single Snapshot within a monthly schedule. Sample schedules cannot be modified.
Input Name Type DpScheduleMonthlyModify DpScheduleMonthlyModify
Output Name Type DpScheduleMonthlyModifyResult DpScheduleMonthlyModifyResult
Error Name Description EACCESSDENIED EDATABASEERROR EOBJECTAMBIGUOUS ESCHEDULEINVALIDINPUT ESCHEDULENOTFOUND ESCHEDULENOTMODIFIABLE
| DpScheduleMonthlySubscheduleSet (supported) | [top] |
Specify a sub-schedule To be used by a monthly schedule. On top of the individual monthly Events, a monthly schedule may only have 1 daily subschedule OR 1 weekly schedule. If this monthly schedule already has a daily or weekly schedule, this command replaces the old one.
Input Name Type DpScheduleMonthlySubscheduleSet DpScheduleMonthlySubscheduleSet
Output Name Type DpScheduleMonthlySubscheduleSetResult DpScheduleMonthlySubscheduleSetResult
Error Name Description EACCESSDENIED EDATABASEERROR EOBJECTAMBIGUOUS ESCHEDULEINVALIDINPUT ESCHEDULENOTFOUND
| DpScheduleMonthlySubscheduleUnset (supported) | [top] |
Unset a sub-schedule used by a monthly schedule.
Input Name Type DpScheduleMonthlySubscheduleUnset DpScheduleMonthlySubscheduleUnset
Output Name Type DpScheduleMonthlySubscheduleUnsetResult DpScheduleMonthlySubscheduleUnsetResult
Error Name Description EACCESSDENIED EDATABASEERROR EOBJECTAMBIGUOUS ESCHEDULEINVALIDINPUT ESCHEDULENOTFOUND
| DpScheduleRename (supported) | [top] |
Rename a schedule. Sample schedules cannot be renamed.
Input Name Type DpScheduleRename DpScheduleRename
Output Name Type DpScheduleRenameResult DpScheduleRenameResult
Error Name Description EACCESSDENIED EDATABASEERROR EOBJECTAMBIGUOUS ESCHEDULEDUPLICATE ESCHEDULEINVALIDINPUT ESCHEDULENOTFOUND ESCHEDULENOTMODIFIABLE
| DpScheduleWeeklyAdd (supported) | [top] |
Specify a single Snapshot within a weekly schedule.
Input Name Type DpScheduleWeeklyAdd DpScheduleWeeklyAdd
Output Name Type DpScheduleWeeklyAddResult DpScheduleWeeklyAddResult
Error Name Description EACCESSDENIED EDATABASEERROR EOBJECTAMBIGUOUS ESCHEDULEINVALIDINPUT ESCHEDULENOTFOUND ESCHEDULENOTMODIFIABLE
| DpScheduleWeeklyDelete (supported) | [top] |
Delete a single Snapshot within a weekly schedule.
Input Name Type DpScheduleWeeklyDelete DpScheduleWeeklyDelete
Output Name Type DpScheduleWeeklyDeleteResult DpScheduleWeeklyDeleteResult
Error Name Description EACCESSDENIED EDATABASEERROR EOBJECTAMBIGUOUS ESCHEDULEINVALIDINPUT ESCHEDULENOTFOUND
| DpScheduleWeeklyModify (supported) | [top] |
Modify a single Snapshot within a weekly schedule. Sample schedules canot be modified.
Input Name Type DpScheduleWeeklyModify DpScheduleWeeklyModify
Output Name Type DpScheduleWeeklyModifyResult DpScheduleWeeklyModifyResult
Error Name Description EACCESSDENIED EDATABASEERROR EOBJECTAMBIGUOUS ESCHEDULEINVALIDINPUT ESCHEDULENOTFOUND ESCHEDULENOTMODIFIABLE
| DpScheduleWeeklySubscheduleAdd (supported) | [top] |
Specify which daily schedule will be used on a certain range of Days within a weekly schedule
Input Name Type DpScheduleWeeklySubscheduleAdd DpScheduleWeeklySubscheduleAdd
Output Name Type DpScheduleWeeklySubscheduleAddResult DpScheduleWeeklySubscheduleAddResult
Error Name Description EACCESSDENIED EDATABASEERROR EOBJECTAMBIGUOUS ESCHEDULEINVALIDINPUT ESCHEDULENOTFOUND ESCHEDULENOTMODIFIABLE
| DpScheduleWeeklySubscheduleDelete (supported) | [top] |
Specify which daily schedule To be deleted within a weekly schedule
Input Name Type DpScheduleWeeklySubscheduleDelete DpScheduleWeeklySubscheduleDelete
Output Name Type DpScheduleWeeklySubscheduleDeleteResult DpScheduleWeeklySubscheduleDeleteResult
Error Name Description EACCESSDENIED EDATABASEERROR EOBJECTAMBIGUOUS ESCHEDULEINVALIDINPUT ESCHEDULENOTFOUND
| DpScheduleWeeklySubscheduleModify (supported) | [top] |
Specify which daily schedule will be used on a certain range of Days within a weekly schedule. Permenent of sample schedules cannot be modified.
Input Name Type DpScheduleWeeklySubscheduleModify DpScheduleWeeklySubscheduleModify
Output Name Type DpScheduleWeeklySubscheduleModifyResult DpScheduleWeeklySubscheduleModifyResult
Error Name Description EACCESSDENIED EDATABASEERROR EOBJECTAMBIGUOUS ESCHEDULEINVALIDINPUT ESCHEDULENOTFOUND ESCHEDULENOTMODIFIABLE
| Element definition: DpScheduleContentGet | [top] |
Get the content of a given schedule.
Name Type Description ScheduleCategory xsd:string
optional
Specifies the category of the schedule. Possible Values are: 'dfm_schedule', 'dp_schedule'. Default Value is 'dp_schedule'. ScheduleNameOrId xsd:string
Name or ID of the schedule
| Element definition: DpScheduleContentGetResult | [top] |
Name Type Description ScheduleContentInfo ScheduleContentInfo
Details of a schedule
| Element definition: DpScheduleCreate | [top] |
Create a new schedule with the given Name. The schedule Type may be daily, weekly, or monthly.
Name Type Description ScheduleContentInfo ScheduleContentInfo
Details of a schedule
| Element definition: DpScheduleCreateResult | [top] |
Name Type Description ScheduleId xsd:integer
A unique ID of the schedule
| Element definition: DpScheduleDailyAdd | [top] |
Create a single Snapshot within a daily schedule.
Name Type Description DailyContent WrapperOfDailyInfo
Content of the daily schedule. DailyScheduleNameOrId xsd:string
Name or ID of a daily schedule ScheduleCategory xsd:string
optional
Specifies the category of the schedule. Possible Values are: 'dfm_schedule', 'dp_schedule'. Default Value is 'dp_schedule'.
| Element definition: DpScheduleDailyAddResult | [top] |
Name Type Description ItemId xsd:integer
An ID of the daily item within the schedule
| Element definition: DpScheduleDailyDelete | [top] |
Delete a single Snapshot within a daily schedule.
Name Type Description DailyScheduleNameOrId xsd:string
Name or ID of a daily schedule ItemId xsd:integer
An ID of the daily item within the schedule. Range: [1..(2^31)-1] ScheduleCategory xsd:string
optional
Specifies the category of the schedule. Possible Values are: 'dfm_schedule', 'dp_schedule'. Default Value is 'dp_schedule'.
| Element definition: DpScheduleDailyDeleteResult | [top] |
[none]
| Element definition: DpScheduleDailyModify | [top] |
Modify a single Snapshot within a daily schedule. Sample schedules cannot be modified.
Name Type Description DailyContent WrapperOfDailyInfo
Content of the daily schedule. DailyScheduleNameOrId xsd:string
Name or ID of a daily schedule ScheduleCategory xsd:string
optional
Specifies the category of the schedule. Possible Values are: 'dfm_schedule', 'dp_schedule'. Default Value is 'dp_schedule'.
| Element definition: DpScheduleDailyModifyResult | [top] |
[none]
| Element definition: DpScheduleDependency | [top] |
Return a list of other DP policies and DP schedules using the specified DP schedule.
Name Type Description ScheduleCategory xsd:string
optional
Specifies the category of the schedule. Possible Values are: 'dfm_schedule', 'dp_schedule'. Default Value is 'dp_schedule'. ScheduleNameOrId ObjNameOrId
Name or identifier of a DP schedule.
| Element definition: DpScheduleDependencyResult | [top] |
Name Type Description ScheduleAssignees ArrayOfScheduleAssignee
List of other DP polices and DP schedules using the specified DP schedule. The list excludes DP policies or DP schedules that the caller has no permissions To read. ScheduleInUse xsd:boolean
True if the schedule is in use by other DP policies or DP schedules.
| Element definition: DpScheduleDestroy | [top] |
Delete a schedule with the given Name or ID. A schedule that is used by another schedule(s) may not be deleted and an Error will be returned. Sample schedules cannot be destroyed.
Name Type Description ScheduleCategory xsd:string
optional
Specifies the category of the schedule. Possible Values are: 'dfm_schedule', 'dp_schedule'. Default Value is 'dp_schedule'. ScheduleNameOrId xsd:string
Name or ID of the schedule
| Element definition: DpScheduleDestroyResult | [top] |
[none]
| Element definition: DpScheduleHourlyAdd | [top] |
Create an hourly schedule within a daily schedule. An hourly schedule specifies the Frequency of Snapshots To be run within the start time and end time.
Name Type Description DailyScheduleNameOrId xsd:string
Name or ID of a daily schedule HourlyContent WrapperOfHourlyInfo
Content of the hourly schedule. ScheduleCategory xsd:string
optional
Specifies the category of the schedule. Possible Values are: 'dfm_schedule', 'dp_schedule'. Default Value is 'dp_schedule'.
| Element definition: DpScheduleHourlyAddResult | [top] |
Name Type Description ItemId xsd:integer
An ID of the hourly item within the schedule
| Element definition: DpScheduleHourlyDelete | [top] |
Delete an hourly schedule within a daily schedule.
Name Type Description DailyScheduleNameOrId xsd:string
Name or ID of a daily schedule ItemId xsd:integer
An ID of the hourly item within the schedule. Range: [1..(2^31)-1] ScheduleCategory xsd:string
optional
Specifies the category of the schedule. Possible Values are: 'dfm_schedule', 'dp_schedule'. Default Value is 'dp_schedule'.
| Element definition: DpScheduleHourlyDeleteResult | [top] |
[none]
| Element definition: DpScheduleHourlyModify | [top] |
Modify an hourly schedule within a daily schedule. Sample schedules cannot be modified.
Name Type Description DailyScheduleNameOrId xsd:string
Name or ID of a daily schedule HourlyContent WrapperOfHourlyInfo
Content of the hourly schedule. ScheduleCategory xsd:string
optional
Specifies the category of the schedule. Possible Values are: 'dfm_schedule', 'dp_schedule'. Default Value is 'dp_schedule'.
| Element definition: DpScheduleHourlyModifyResult | [top] |
[none]
| Element definition: DpScheduleList | [top] |
List all existing schedule IDs and types.
Name Type Description ScheduleCategory xsd:string
optional
Specifies the category of the schedule. Possible Values are: 'dfm_schedule', 'dp_schedule'. Default Value is 'dp_schedule'.
| Element definition: DpScheduleListInfoIterEnd | [top] |
Tell the DFM station that the temporary store associated with the specified Tag is no longer necessary
Name Type Description Tag xsd:string
An opaque handle used by the DFM station To identify a temporary store.
| Element definition: DpScheduleListInfoIterEndResult | [top] |
[none]
| Element definition: DpScheduleListInfoIterNext | [top] |
Iterate over the list of schedules stored in the temporary store. The DFM internally maintains a cursor pointing To the last record returned. Subsequent calls To this API will return the Records after the cursor up To the specified "Maximum" or number of actual Records left.
Name Type Description Maximum xsd:integer
Maximum number of schedules To retrieve Tag xsd:string
An opaque handle used by the DFM station To identify a temporary store.
| Element definition: DpScheduleListInfoIterNextResult | [top] |
Name Type Description Records xsd:integer
The number of Records actually returned. Range: [0..2^31-1]. ScheduleContentList ArrayOfScheduleContentInfo
List of detailed schedule contents
| Element definition: DpScheduleListInfoIterStart | [top] |
The dp-dpschedule-list-info-iter-* set of APIs are used To retrieve a list of schedule contents
Name Type Description ScheduleCategory xsd:string
optional
Specifies the category of the schedule. Possible Values are: 'dfm_schedule', 'dp_schedule'. Default Value is 'dp_schedule'. ScheduleNameOrId xsd:string
optional
Name or ID of the schedule. If specified, only this schedule is listed.
| Element definition: DpScheduleListInfoIterStartResult | [top] |
Name Type Description Records xsd:integer
Number of items saved for future retrieval Tag xsd:string
An opaque handle used by the DFM station To identify a temporary store.
| Element definition: DpScheduleListResult | [top] |
Name Type Description ScheduleList ArrayOfScheduleIdInfo
List of schedule IDs
| Element definition: DpScheduleModify | [top] |
Modify a schedule's details in the database. When the zapi is called, all details within the schedule will be removed and replace by the new details specified in schedule-content. Sample schedules cannot be modified. ScheduleId and ScheduleType cannot be modified.
Name Type Description ScheduleContentInfo ScheduleContentInfo
Details of a schedule
| Element definition: DpScheduleModifyResult | [top] |
[none]
| Element definition: DpScheduleMonthlyAdd | [top] |
Specify a single Snapshot within a monthly schedule. Either DayOfMonth, or both WeekOfMonth and DayOfWeek must be specified.
Name Type Description MonthlyContent WrapperOfMonthlyInfo
Content of the monthly schedule. MonthlyScheduleNameOrId xsd:string
Name or ID of a weekly schedule ScheduleCategory xsd:string
optional
Specifies the category of the schedule. Possible Values are: 'dfm_schedule', 'dp_schedule'. Default Value is 'dp_schedule'.
| Element definition: DpScheduleMonthlyAddResult | [top] |
Name Type Description ItemId xsd:integer
An ID of the monthly item within the schedule
| Element definition: DpScheduleMonthlyDelete | [top] |
Delete a single Snapshot within a monthly schedule
Name Type Description ItemId xsd:integer
An ID of the monthly item within the schedule. Range: [1..(2^31)-1] MonthlyScheduleNameOrId xsd:string
Name or ID of a weekly schedule ScheduleCategory xsd:string
optional
Specifies the category of the schedule. Possible Values are: 'dfm_schedule', 'dp_schedule'. Default Value is 'dp_schedule'.
| Element definition: DpScheduleMonthlyDeleteResult | [top] |
[none]
| Element definition: DpScheduleMonthlyModify | [top] |
Modify a single Snapshot within a monthly schedule. Sample schedules cannot be modified.
Name Type Description MonthlyContent WrapperOfMonthlyInfo
Content of the monthly schedule. MonthlyScheduleNameOrId xsd:string
Name or ID of a monthly schedule ScheduleCategory xsd:string
optional
Specifies the category of the schedule. Possible Values are: 'dfm_schedule', 'dp_schedule'. Default Value is 'dp_schedule'.
| Element definition: DpScheduleMonthlyModifyResult | [top] |
[none]
| Element definition: DpScheduleMonthlySubscheduleSet | [top] |
Specify a sub-schedule To be used by a monthly schedule. On top of the individual monthly Events, a monthly schedule may only have 1 daily subschedule OR 1 weekly schedule. If this monthly schedule already has a daily or weekly schedule, this command replaces the old one.
Name Type Description MonthlyScheduleNameOrId xsd:string
Name or ID of the monthly schedule ScheduleCategory xsd:string
optional
Specifies the category of the schedule. Possible Values are: 'dfm_schedule', 'dp_schedule'. Default Value is 'dp_schedule'. SubscheduleNameOrId xsd:string
Name or ID of the schedule To be used by the monthly schedule
| Element definition: DpScheduleMonthlySubscheduleSetResult | [top] |
[none]
| Element definition: DpScheduleMonthlySubscheduleUnset | [top] |
Unset a sub-schedule used by a monthly schedule.
Name Type Description MonthlyScheduleNameOrId xsd:string
Name or ID of the monthly schedule ScheduleCategory xsd:string
optional
Specifies the category of the schedule. Possible Values are: 'dfm_schedule', 'dp_schedule'. Default Value is 'dp_schedule'.
| Element definition: DpScheduleMonthlySubscheduleUnsetResult | [top] |
[none]
| Element definition: DpScheduleRename | [top] |
Rename a schedule. Sample schedules cannot be renamed.
Name Type Description NewScheduleName xsd:string
A new unique Name of the schedule ScheduleCategory xsd:string
optional
Specifies the category of the schedule. Possible Values are: 'dfm_schedule', 'dp_schedule'. Default Value is 'dp_schedule'. ScheduleNameOrId xsd:string
Name or ID of the schedule
| Element definition: DpScheduleRenameResult | [top] |
[none]
| Element definition: DpScheduleWeeklyAdd | [top] |
Specify a single Snapshot within a weekly schedule.
Name Type Description ScheduleCategory xsd:string
optional
Specifies the category of the schedule. Possible Values are: 'dfm_schedule', 'dp_schedule'. Default Value is 'dp_schedule'. WeeklyContent WrapperOfWeeklyInfo
Content of the weekly schedule. WeeklyScheduleNameOrId xsd:string
Name or ID of a weekly schedule
| Element definition: DpScheduleWeeklyAddResult | [top] |
Name Type Description ItemId xsd:integer
An ID of the weekly item within the schedule
| Element definition: DpScheduleWeeklyDelete | [top] |
Delete a single Snapshot within a weekly schedule.
Name Type Description ItemId xsd:integer
An ID of the weekly item within the schedule. Range: [1..(2^31)-1] ScheduleCategory xsd:string
optional
Specifies the category of the schedule. Possible Values are: 'dfm_schedule', 'dp_schedule'. Default Value is 'dp_schedule'. WeeklyScheduleNameOrId xsd:string
Name or ID of a weekly schedule
| Element definition: DpScheduleWeeklyDeleteResult | [top] |
[none]
| Element definition: DpScheduleWeeklyModify | [top] |
Modify a single Snapshot within a weekly schedule. Sample schedules canot be modified.
Name Type Description ScheduleCategory xsd:string
optional
Specifies the category of the schedule. Possible Values are: 'dfm_schedule', 'dp_schedule'. Default Value is 'dp_schedule'. WeeklyContent WrapperOfWeeklyInfo
Content of the weekly schedule. WeeklyScheduleNameOrId xsd:string
Name or ID of a weekly schedule
| Element definition: DpScheduleWeeklyModifyResult | [top] |
[none]
| Element definition: DpScheduleWeeklySubscheduleAdd | [top] |
Specify which daily schedule will be used on a certain range of Days within a weekly schedule
Name Type Description DailyScheduleNameOrId xsd:string
Name or ID of a daily schedule EndDayOfWeek xsd:integer
Day of week for the Snapshot. Range: [0..6] (0 = "Sun") ScheduleCategory xsd:string
optional
Specifies the category of the schedule. Possible Values are: 'dfm_schedule', 'dp_schedule'. Default Value is 'dp_schedule'. StartDayOfWeek xsd:integer
Day of week for the Snapshot. Range: [0..6] (0 = "Sun") WeeklyScheduleNameOrId xsd:string
Name or ID of a weekly schedule
| Element definition: DpScheduleWeeklySubscheduleAddResult | [top] |
Name Type Description ItemId xsd:integer
An ID of the weekly use item within the schedule. Range: [1..(2^31)-1]
| Element definition: DpScheduleWeeklySubscheduleDelete | [top] |
Specify which daily schedule To be deleted within a weekly schedule
Name Type Description ItemId xsd:integer
An ID of the weekly use item within the schedule. Range: [1..(2^31)-1] ScheduleCategory xsd:string
optional
Specifies the category of the schedule. Possible Values are: 'dfm_schedule', 'dp_schedule'. Default Value is 'dp_schedule'. WeeklyScheduleNameOrId xsd:string
Name or ID of a weekly schedule
| Element definition: DpScheduleWeeklySubscheduleDeleteResult | [top] |
[none]
| Element definition: DpScheduleWeeklySubscheduleModify | [top] |
Specify which daily schedule will be used on a certain range of Days within a weekly schedule. Permenent of sample schedules cannot be modified.
Name Type Description DailyScheduleNameOrId xsd:string
Name or ID of a weekly schedule EndDayOfWeek xsd:integer
Day of week for the Snapshot. Range: [0..6] (0 = "Sun") ItemId xsd:integer
An ID of the weekly use item within the schedule. Range: [1..(2^31)-1] ScheduleCategory xsd:string
optional
Specifies the category of the schedule. Possible Values are: 'dfm_schedule', 'dp_schedule'. Default Value is 'dp_schedule'. StartDayOfWeek xsd:integer
Day of week for the Snapshot. Range: [0..6] (0 = "Sun") WeeklyScheduleNameOrId xsd:string
Name or ID of a weekly schedule
| Element definition: DpScheduleWeeklySubscheduleModifyResult | [top] |
[none]
| Element definition: ArrayOfScheduleAssignee | [top] |
Name Type Description ScheduleAssignee ScheduleAssignee[]
| Element definition: ArrayOfScheduleContentInfo | [top] |
Name Type Description ScheduleContentInfo ScheduleContentInfo[]
| Element definition: ArrayOfScheduleIdInfo | [top] |
Name Type Description ScheduleIdInfo ScheduleIdInfo[]
| Element definition: ObjNameOrId | [top] |
Name or internal ID of a DFM object. This typedef is an alias for the builtin ZAPI Type string. An ObjNameOrId must contain between 1 and 64 characters, and must conform To one of the following formats: Elements of Type ObjNameOrId are used only as inputs To ZAPIs. The Value must Match either the Name or internal ID of an existing DFM object. The ZAPI must specify the object's DFM object Type (e.g. Dataset, Host, DP Policy, etc.). Some ZAPIs allow the object To be one of several different types.
- It must have the format of an ObjName, or
- It must be the decimal numeric string form of a positive integer whose Value is in the range [1..2^31 - 1].
- In case of application resources From the Host Service, this field can contain unique identifier assigned To the object by the Host Service e.g. for a Virtual Machine, it can be a GUID of the VM. One exception is when such unique identifier is a decimal numeric string containing only digits From 0 through 9. In that case, you cannot use such identifier as ObjNameOrId input.
If the format of an ObjNameOrId input element does not conform, or the Value does not Match the Name or ID of an existing object, then generally the ZAPI documents that it fails with Error code EOBJECTNOTFOUND. A ZAPI may return more specific Error codes. In such cases, the ZAPI specification must document its behavior.
If a ZAPI can accept a null Value (e.g. reference To no object at all) for such an element, then the element is declared optional, and the absence of the input element represents a null Value.
[none]
| Element definition: ScheduleContentInfo | [top] |
Detailed schedule contents. A schedule can be a daily, weekly, or monthly schedule. A daily schedule may include both multiple recurring hourly schedules (HourlyList element) and/or individual non-recurring daily schedules (DailyList element). A weekly schedule may include multiple references To daily schedules To be run on specific Days of the week (WeeklySubscheduleList element) and/or individual non-recurring weekly schedules (WeeklyList element). A monthly schedule may include multiple non-recurring monthly schedules (MonthlyList element). In addition, a monthly schedule may include a single reference To either a daily schedule or a montly schedule, not both. User may only specify one MonthlySubscheduleInfo element in the MonthlySubscheduleList.
Name Type Description DailyList ArrayOfDailyInfo
optional
List of daily schedules. May only be used in a daily schedule. HourlyList ArrayOfHourlyInfo
optional
List of hourly schedules. May only be used in a daily schedule. IsModifiable xsd:boolean
optional
If false, this schedule is one of the sample schedules that is created at installation time, therefore it may not be modified, renamed or destroyed. If true, it is not one of the sample schedules, therefore it may be modified, renamed or destroyed. IsModifiable always appears in the output. It is not possible To use it as input. MonthlyList ArrayOfMonthlyInfo
optional
List of monthly schedules. May only be used in a monthly schedule. MonthlySubscheduleList ArrayOfMonthlySubscheduleInfo
optional
List of monthly sub-schedules used by the schedule. May only be used in a monthly schedule. ScheduleCategory xsd:string
optional
Specifies the category of the schedule. Possible Values are: 'dfm_schedule', 'dp_schedule'. The default Value is 'dp_schedule'. ScheduleDescription xsd:string
optional
Description of the schedule. It may contain From 0 To 255 characters. The Description always appears in the output. If the Description is omitted, then the default Value is the empty string "". ScheduleId ObjId
optional
ID of the schedule. Ignored for DfmScheduleCreate. Required for all other calls. Range: [1..(2^31)-1] ScheduleName ObjName
Name of the schedule. May not be numeric. ScheduleType xsd:string
Type of schedule. Possible Values are: 'daily', 'weekly', 'monthly'. Note that the Type cannot be changed once the schedule is created. User has To delete the schedule before creating a new schedule using the same Name with different Type WeeklyList ArrayOfWeeklyInfo
optional
List of weekly schedules. May only be used in a weekly schedule. WeeklySubscheduleList ArrayOfWeeklySubscheduleInfo
optional
List of weekly sub-schedules used by the schedule. May only be used in a weekly schedule.
| Element definition: WrapperOfDailyInfo | [top] |
Name Type Description DailyInfo DailyInfo
| Element definition: WrapperOfHourlyInfo | [top] |
Name Type Description HourlyInfo HourlyInfo
| Element definition: WrapperOfMonthlyInfo | [top] |
Name Type Description MonthlyInfo MonthlyInfo
| Element definition: WrapperOfWeeklyInfo | [top] |
Name Type Description WeeklyInfo WeeklyInfo
| Element definition: ArrayOfDailyInfo | [top] |
Name Type Description DailyInfo DailyInfo[]
| Element definition: ArrayOfHourlyInfo | [top] |
Name Type Description HourlyInfo HourlyInfo[]
| Element definition: ArrayOfMonthlyInfo | [top] |
Name Type Description MonthlyInfo MonthlyInfo[]
| Element definition: ArrayOfMonthlySubscheduleInfo | [top] |
Name Type Description MonthlySubscheduleInfo MonthlySubscheduleInfo[]
| Element definition: ArrayOfWeeklyInfo | [top] |
Name Type Description WeeklyInfo WeeklyInfo[]
| Element definition: ArrayOfWeeklySubscheduleInfo | [top] |
Name Type Description WeeklySubscheduleInfo WeeklySubscheduleInfo[]
| Element definition: DailyInfo | [top] |
The Attributes of a daily schedule. May only be used in a daily schedule.
Name Type Description ItemId xsd:integer
optional
ID of the daily item within the schedule. Ignored for dfm-schedule-create/modify and Required for all other calls. Will be presented in output. Range: [1..(2^31)-1] StartHour xsd:integer
Start Hour of the daily schedule. Range: [0..23] StartMinute xsd:integer
Start Minute of the daily schedule. Range: [0..59]
| Element definition: HourlyInfo | [top] |
The Attributes of an hourly schedule. May only be used in a daily schedule.
Name Type Description EndHour xsd:integer
End Hour of the hourly schedule. Range: [0..23] EndMinute xsd:integer
End Minute of the hourly schedule. Range: [0..59] Frequency xsd:integer
Number of minutes between each schedule. Range: [5..1440] ItemId xsd:integer
optional
ID of the hourly item within the schedule. Ignored for dfm-schedule-create/modify and Required for all other calls. Will be presented in output. Range: [1..(2^31)-1] StartHour xsd:integer
Start Hour of the hourly schedule. Range: [0..23] StartMinute xsd:integer
Start Minute of the hourly schedule. Range: [0..59]
| Element definition: MonthlyInfo | [top] |
The Attributes of a monthly schedule. May only be used in a monthly schedule.
Name Type Description DayOfMonth xsd:integer
optional
If DayOfMonth is 29, 30, or 31, it will be interpretted as the last Day of the Month for Months with fewer than that many Days. if DayOfMonth is set, then both WeekOfMonth and DayOfWeek must not be set. Range: [1..31] DayOfWeek xsd:integer
optional
Day of week for the schedule. If DayOfWeek is set, then WeekOfMonth must also be set and DayOfMonth must not be set. Range: [0..6] (0 = "Sun") ItemId xsd:integer
optional
ID of the monthly item within the schedule. Ignored for dfm-schedule-create/modify and Required for all other calls. Will be presented in output. Range: [1..(2^31)-1] StartHour xsd:integer
Start Hour of the monthly schedule. Range: [0..23] StartMinute xsd:integer
Start Minute of the monthly schedule. Range: [0..59] WeekOfMonth xsd:integer
optional
A Value of 5 indicates the last week of the Month. If WeekOfMonth is set, then DayOfWeek must also be set and DayOfMonth must not be set. Range: [1..5]
| Element definition: ObjId | [top] |
Identification number (ID) for a DFM object. This typedef is an alias for the builtin ZAPI Type integer. Object IDs are unsigned integers in the range [1..2^31 - 1]. In some contexts, an object ID is also allowed To be 0, which is interpreted as a null Value, e.g., a reference To no object at all. The ID for a DFM object is always assigned by the system; the user is never allowed To assign an ID To an object. Therefore, an input element of Type ObjId is always used To refer To an existing object by its ID. The ZAPI must specify the object's DFM object Type (e.g. Dataset, Host, DP Policy, etc.). Some ZAPIs allow the object To be one of several different types.
If the Value of an ObjId input element does not Match the ID of any existing DFM object of the specified Type or types, then typically the ZAPI fails with Error code EOBJECTNOTFOUND. A ZAPI may deviate From this general rule, for example, it may return a more specific Error code. In either case, the ZAPI specification must document its behavior.
[none]
| Element definition: ObjName | [top] |
Name of a DFM object. This typedef is an alias for the built in ZAPI Type string. An object Name must conform To the following format: The behavior of a ZAPI when it encounters an Error involving an ObjName input element depends on how the ZAPI uses the input element. Here are the general rules:
- It must contain between 1 and 64 characters.
- It may start with any character and may contain any combination of characters, except that it may not consist solely of decimal digits ('0' through '9').
- In some contexts, a Name may be the empty string (""), which is interpreted as a null Value, e.g., a reference To no object at all.
A ZAPI may deviate From these general rules, for example, it may return more specific Error codes. In such cases, the ZAPI specification must document its behavior.
- If the input Name element is used To create a new object with the given Name, or rename an existing object To that Name, and the Name does not conform To the above format, then the ZAPI fails with Error code EINVALIDINPUTERROR. Note that because EINVALIDINPUTERROR is such a common Error code, ZAPI specifications are not required To document cases when they may return it.
- If the input Name element is used To refer To an existing object with that Name, and there is no object with that Name, then the ZAPI fails with Error code EOBJECTNOTFOUND. Generally the ZAPI specification documents cases when it may return this Error code.
If an input Name element is used To refer To an existing object, then the ZAPI specification must specify which DFM object Type (e.g. data set, Host, DP Policy, etc.) is allowed. Some ZAPIs allow the object To be one of several different types. See the Description of ObjFullName for examples of valid input formats.
Note that there is no requirement that all object names must be unique. However, the names for some specific types of Objects are constrained such that no two Objects of that Type may have the same Name. For example, this constraint applies To Datasets, DP schedules, and DP policies. This means that no two Datasets may have the same Name, but a Dataset may have the same Name as a DP schedule or DP Policy.
In general, object names are compared in a case-insensitive manner. This means that, for example, "MyObject" and "MYOBJECT" are considered To be the same Name for purposes of: creating new Objects, renaming existing Objects, or looking up an object by Name. On the other hand, ZAPIs that return an ObjName generally do not change the capitalization at all. For example, if an object's Name has been set To "MyObject", then list iteration ZAPIs that return the object's Name return it as "MyObject" rather than "MYOBJECT" or "myobject".
ZAPIs that operate on ObjName Values and do not follow these general rules about case sensitivity must document the rules that they do follow.
One important exception To these general rules is that Volumes, Qtrees, OSSV Directories, SRM Paths, Interfaces, FCP Targets and FC switch ports all have case-sensitive names. When looking up Objects of these types by Name, the case must Match the object Name.
[none]
| Element definition: ScheduleAssignee | [top] |
Description of a DFM object using the schedule.
Name Type Description AssigneeFullName ObjFullName
Full Name of a DFM object. AssigneeId ObjId
Identification number of a DFM object. AssigneeType xsd:string
Type of DFM object. Possible Values are: 'dp_policy', 'dp_schedule', 'dfm_schedule' and 'report_schedule'.
| Element definition: ScheduleIdInfo | [top] |
The Attributes of a Id list
Name Type Description Id ObjId
ID of the schedule. Range: [1..(2^31)-1] Name ObjName
Name of the schedule. May not be numeric. Type xsd:string
Type of schedule. Possible Values are: daily, weekly, monthly
| Element definition: WeeklyInfo | [top] |
The Attributes of a weekly schedule. May only be used in a weekly schedule.
Name Type Description DayOfWeek xsd:integer
Day of week for the schedule. Range: [0..6] (0 = "Sun") ItemId xsd:integer
optional
ID of the weekly item within the schedule Ignored for dfm-schedule-create/modify and Required for all other calls. Will be presented in output. Range: [1..(2^31)-1] StartHour xsd:integer
Start Hour of the weekly schedule. Range: [0..23] StartMinute xsd:integer
Start Minute of the weekly schedule. Range: [0..59]
| Element definition: MonthlySubscheduleInfo | [top] |
The Attributes of a monthly subschedule. May only be used in a monthly schedule.
Name Type Description SubscheduleId ObjId
ID of the subschedule To be used. Range: [1..(2^31)-1] SubscheduleName ObjName
optional
Name of the subschedule To be used Ignored for dfm-schedule-create/modify. Required for all other calls. Will be presented in output. Range: [1..(2^31)-1]
| Element definition: ObjFullName | [top] |
Full Name of a DFM object. This typedef is an alias for the builtin ZAPI Type string. An object full Name conforms To all the rules of an ObjName, except that the full Name may be up To 255 characters long. DFM creates full names by concatenating an object Name with any parent object names, so as To create a unique Name for an object. The format of full names is as follows:
- Host full names are the either the fully-qualified domain Name or the IP Address of the Host.
- Aggregate full names are the Host Name and the Aggregate Name, separated by a colon, e.g. Hostname:aggr0.
- Volume full names are the Host Name and the Volume Name, separated by ":/", e.g. Hostname:/volume. Note this does not include "/vol". Volume and Aggregate full names are distinguished by the presence of a forward slash after the colon.
- Qtree full names are the containing Volume full Name and the Qtree Name, separated by a slash, e.g. Hostname:/volume/qtree. The data not contained by any Qtree may be represented by "-", e.g. Hostname:/volume/-.
- Lun Path full names are either a Volume or Qtree full Name and the LUN Path, separated by a slash, e.g. Hostname:/volume/LUN or Hostname:/volume/qtree/LUN.
- Network full names are a network Address block in CIDR format, e.g. 1.2.3.0/8.
- OSSV Directory full names are the OSSV Host Name and the OSSV Path, separated by a colon, e.g. host-lnx:/usr/local or host-w2k:c:/temp
- Include any others here...
- Initiator Group full names are Host Name and the initiator Group Name, separated by a colon, e.g. Hostname:igroup.
For any DFM object not listed above, the ObjName and ObjFullName are identical.
[none]
| Element definition: WeeklySubscheduleInfo | [top] |
The Attributes of a weekly subschedule. May only be used in a weekly schedule.
Name Type Description EndDayOfWeek xsd:integer
End Day To be applied To the schedule being used. Range: [0..6] (0 = "Sun") ItemId xsd:integer
optional
ID of the use Type within the schedule. Ignored for dfm-schedule-create/modify and Required for all other calls. Will be presented in output. Range: [1..(2^31)-1] StartDayOfWeek xsd:integer
Start Day To be applied To the schedule being used. Range: [0..6] (0 = "Sun") SubscheduleId ObjId
ID of the subschedule To be used. Range: [1..(2^31)-1] SubscheduleName ObjName
optional
Name of the subschedule To be used Ignored for dfm-schedule-create/modify. Required for all other calls. Will be presented in output. Range: [1..(2^31)-1]