Метод CreateReplicationRelationship класса MSFT_StorageSubSystem
Создает две группы репликации и связь репликации между ними. Для этого метода требуется, чтобы подсистема поддерживала полностью обнаруженную репликацию.
Синтаксис
UInt32 CreateReplicationRelationship(
[in] String FriendlyName,
[in] Uint16 SyncType,
[in] String TargetStorageSubsystem,
[in] String SourceReplicationGroupFriendlyName,
[in] String SourceReplicationGroupDescription,
[in] String SourceStorageElements[],
[in] String SourceGroupSettings,
[in] String TargetReplicationGroupFriendlyName,
[in] String TargetReplicationGroupDescription,
[in] String TargetStorageElements[],
[in] String TargetStoragePool,
[in] String TargetStoragePools[],
[in] String TargetGroupSettings,
[in] UInt16 RecoveryPointObjective,
[out] String SourceGroup,
[out] String TargetGroup,
[out] String CreatedReplicaPeer,
[out] MSFT_StorageJob REF CreatedStorageJob,
[out] String ExtendedStatus
);
Параметры
FriendlyName [in]
Имя, соответствующее пользователю для связи между исходной и целевой группами или между исходным элементом и целевой группой (т. е. "один ко многим"). Если значение РАВНО NULL, реализация присваивает имя. Если для отдельных целевых элементов требуется элемент ElementName, реализация создает соответствующее имя элемента с помощью RelationshipName; Например, RelationshipName в качестве префикса, за которым следует порядковый номер "_n", где n — это число, начинаемое с 1.
SyncType [in]
Описывает тип копии, которая будет выполнена.
Зарезервировано DMTF (..)
Зеркало (6)
Моментальный снимок (7)
Клонирование (8)
TokenizedClone (9)
Зарезервировано DMTF (..)
Конкретный поставщик (0x8000.).
TargetStorageSubsystem [in]
Строка, содержащая внедренный объект MSFT_ReplicaPeer . Это позволяет пользователю указать целевую подсистему реплика при настройке связи с другой подсистемой.
SourceReplicationGroupFriendlyName [in]
Имя создаваемой исходной группы репликации.
SourceReplicationGroupDescription [in]
Описание назначения исходной группы репликации.
SourceStorageElements [in]
Задает массив строк, содержащих внедренные объекты MSFT_StorageObject . Это упорядоченный список объектов хранилища, которые должны входить в исходную группу репликации.
SourceGroupSettings [in]
Строка, содержащая внедренный объект MSFT_ReplicationSettings , применяемый к исходной группе репликации.
TargetReplicationGroupFriendlyName [in]
Имя создаваемой целевой группы репликации.
TargetReplicationGroupDescription [in]
Описание назначения целевой группы репликации.
TargetStorageElements [in]
Задает массив строк, содержащих внедренные объекты MSFT_StorageObject . Это упорядоченный список объектов хранилища, которые должны входить в целевую группу репликации.
TargetStoragePool [in]
Строка, содержащая внедренный объект MSFT_StoragePool . Это пул носителей в целевом объекте, который будет использоваться в качестве источника для создания необходимых TargetStorageElements. Этот параметр можно указать вместо TargetStorageElements.
TargetStoragePools [in]
Массив строк, содержащий внедренные объекты MSFT_StoragePool . Базовое хранилище для целевых элементов (реплик) будет взято из TargetStoragePool , если это указано. В противном случае выделение зависит от реализации. Если указаны целевые элементы, этот параметр должен иметь значение NULL. Если параметр TargetStoragePools указан, targetStoragePool должен иметь значение NULL.
TargetGroupSettings [in]
Строка, содержащая внедренный объект MSFT_ReplicationSettings , применяемый к целевой группе репликации.
RecoveryPointObjective [in]
Указывает максимальный интервал, через который могут быть потеряны данные. Для синхронных операций копирования Значение RecoveryPointObjective равно 0. Для операций асинхронного копирования RecoveryPointObjective представляет интервал с момента последней передачи данных в целевой элемент.
SourceGroup [out]
Если группы репликации и связь созданы успешно, этот параметр получает строку, содержащую внедренный объект MSFT_ReplicationGroup , представляющий исходную группу репликации.
TargetGroup [out]
Если группы репликации и связь созданы успешно, этот параметр получает строку, содержащую внедренный объект MSFT_ReplicationGroup , представляющий целевую группу репликации.
CreatedReplicaPeer [out]
Если группы репликации и связь созданы успешно, этот параметр получает строку, содержащую внедренный объект MSFT_ReplicaPeer, представляющий реплика одноранговый узел для целевой группы репликации.
CreatedStorageJob [out]
Возвращает ссылку на объект задания хранения, используемый для отслеживания длительной операции.
ExtendedStatus [out]
Строка, содержащая внедренный объект MSFT_StorageExtendedStatus .
Этот параметр позволяет поставщику хранилища возвращать расширенные (зависящие от реализации) сведения об ошибках.
Возвращаемое значение
Успешно (0)
Не поддерживается (1)
Неуказаная ошибка (2)
Время ожидания (3)
Сбой (4)
Недопустимый параметр (5)
Объект не найден (8)
Проверенные параметры метода — задание запущено (4096)
Доступ запрещен (40001)
Недостаточно ресурсов для завершения операции. (40002)
Кэш устарел (40003)
Операция не поддерживается во время обновления кластера. (40009)
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows 10 [только классические приложения] |
| Минимальная версия сервера | Windows Server 2016 [только классические приложения] |
| Пространство имен | Root\Microsoft\Windows\Storage |
| MOF | Storagewmi.mof |