Sql Virtual Machine Groups - Create Or Update

Создает или обновляет группу виртуальных машин SQL.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.SqlVirtualMachine/sqlVirtualMachineGroups/{sqlVirtualMachineGroupName}?api-version=2021-11-01-preview

Параметры URI

Name In Required Type Description
resourceGroupName
path True
  • string

Имя группы ресурсов, к которой относится ресурс. Это значение можно получить от API-интерфейса диспетчера ресурсов Azure или портала.

sqlVirtualMachineGroupName
path True
  • string

Имя группы виртуальных машин SQL.

subscriptionId
path True
  • string

Идентификатор подписки, идентифицирующий подписку Azure.

api-version
query True
  • string

Версия API, используемая для запроса.

Текст запроса

Name Required Type Description
location True
  • string

Расположение ресурса.

properties.sqlImageOffer
  • string

SQL предложение изображения. Примерами могут быть SQL2016-WS2016, SQL2017-WS2016.

properties.sqlImageSku

SQL SKU образа.

properties.wsfcDomainProfile

Профиль домена Active Directory кластера.

tags
  • object

Теги ресурсов.

Ответы

Name Type Description
200 OK

Группа виртуальных машин SQL успешно обновлена.

201 Created

Группа виртуальных машин SQL успешно создана.

Other Status Codes

Ответы на ошибки: ***

  • 400 RPGenericUser — сбой пользователя при вызове другого поставщика ресурсов.

  • 400 RPResponseMissingAsyncOperationHeader — в ответе отсутствуют сведения о заголовке операции Async

  • 400 InvalidArgument — недопустимый аргумент '{0}'.

  • 400 ArgumentNotInRange — аргумент "{0}" не в диапазоне.

  • 400 ResourceNotProvisioned — как ресурс: {0} не находится в подготовленном состоянии, запрос невозможно продолжить.

  • 400 CRPNotAllowedOperation — операция не может быть завершена из-за следующей ошибки: {0}

  • 400 AadAppDisabled — приложение Microsoft AAD SQLVMResourceProviderAuth ({0}) отключено в клиенте.

  • 400 InvalidRgResourceId — указан недопустимый идентификатор ресурса группы ресурсов.

  • 400 InternalAPIAccessDenied — внутренний доступ к API запрещен. Идентификатор {0} приложения недопустим для использования этого API.

  • 400 InvalidParameterValue — недопустимое значение было присвоено параметру.

  • 400 SqlVmGroupUpdateFailVmAttached — SQL группу виртуальных машин нельзя обновить, так как она подключена к виртуальной машине SQL.

  • 400 InvalidSqlImageOffer — предоставлено SQL предложение образа недопустимо.

  • 400 InvalidSqlSku — указан недопустимый номер SKU SQL.

  • 400 OuPathAndDomainMismatch — путь к подразделению не входит в указанный домен.

  • 400 InvalidAccountNameFormat — недопустимый формат имени учетной записи.

  • 400 CloudWitnessUnsupported — для Windows Server 2012R2 настройка облачного следящего сервера запрещена.

  • 400 FileShareWitnessDisAllowed — для Windows Server 2016 и за пределами установки файловый ресурс-свидетель запрещен.

  • 400 InvalidStorageAccountUrl — недопустимый URL-адрес учетной записи хранения.

  • 400 SqlVmGroupNameTooLong — SQL имя группы виртуальных машин не может превышать 15 символов.

  • 400 InvalidSqlVmGroupName — недопустимое имя группы виртуальных машин SQL.

  • 400 InvalidStorageAccountCredentials — указанные учетные данные учетной записи хранения неверны.

  • 400 InvalidStorageAccountType — для этой операции разрешена только учетная запись хранения типа "Общего назначения версии 2".

  • 400 SqlVmGroupNotEmpty — SQL группа виртуальных машин не пуста.

  • 400 SqlVmGroupUpdateNotAllowed — обновление до SQL группы виртуальных машин запрещено.

  • 403 AccessDenied — доступ запрещен.

  • 404 SubscriptionDoesNotExist — идентификатор подписки не существует.

  • 404 ResourceDoesNotExist — ресурс не существует.

  • 404 RPOperationNotFound — операция не найдена

  • 404 OperationIdNotFound — не удалось найти идентификатор операции.

  • 404 OperationTypeNotFound — тип операции не найден.

  • 404 ResourceNotFound — запрошенный ресурс не найден.

  • 404 SubscriptionDoesNotHaveSqlVMGroupInResourceGroup — подписка не содержит SQL группу виртуальных машин в группе ресурсов.

  • 409 ResourceAlreadyExists — ресурс уже существует.

  • 409 LBGenericErrors — сбой операции балансировки нагрузки

  • 409 NICGenericError — сбой операции сетевого адаптера

  • 409 SqlExtensionNotInstalled — SQL расширение не установлено.

  • 409 RPPluginSubstatusMissing — отсутствует подсостояние подключаемого модуля RP

  • 409 MissingMoveResources — не удается переместить ресурсы, так как некоторые ресурсы отсутствуют в запросе.

  • 409 ResourceExists — произошла внутренняя ошибка при очистке ресурсов.

  • 409 SubscriptionOperationInProgress — операция с подпиской уже выполняется

  • 409 OperationInProgress — операция, выполняемая в ресурсе.

  • 409 OperationCanceled — операция отменена.

  • 429 TooManyRequestsReceived -

  • 500 RPGenericSystem — сбой системы при вызове другого поставщика ресурсов.

  • 500 UnExpectedErrorOccurred — произошла непредвиденная ошибка.

  • 500 OperationTimeout — истекло время ожидания операции.

Примеры

Creates or updates a SQL virtual machine group.

Sample Request

PUT https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testrg/providers/Microsoft.SqlVirtualMachine/sqlVirtualMachineGroups/testvmgroup?api-version=2021-11-01-preview

{
  "location": "northeurope",
  "tags": {
    "mytag": "myval"
  },
  "properties": {
    "sqlImageOffer": "SQL2016-WS2016",
    "sqlImageSku": "Enterprise",
    "wsfcDomainProfile": {
      "domainFqdn": "testdomain.com",
      "ouPath": "OU=WSCluster,DC=testdomain,DC=com",
      "clusterBootstrapAccount": "testrpadmin",
      "clusterOperatorAccount": "testrp@testdomain.com",
      "sqlServiceAccount": "sqlservice@testdomain.com",
      "storageAccountUrl": "https://storgact.blob.core.windows.net/",
      "storageAccountPrimaryKey": "<primary storage access key>"
    }
  }
}

Sample Response

{
  "properties": {
    "provisioningState": "UpdatingDomainful",
    "sqlImageOffer": "SQL2016-WS2016",
    "sqlImageSku": "Enterprise",
    "wsfcDomainProfile": {
      "storageAccountUrl": "https://storgact.blob.core.windows.net/"
    }
  },
  "location": "northeurope",
  "tags": {
    "mytag": "myval"
  },
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testrg/providers/Microsoft.SqlVirtualMachine/sqlVirtualMachineGroups/testvmgroup",
  "name": "testvmgroup",
  "type": "Microsoft.SqlVirtualMachine/sqlVirtualMachineGroups"
}
{
  "properties": {
    "provisioningState": "ProvisioningDomainful",
    "sqlImageOffer": "SQL2016-WS2016",
    "sqlImageSku": "Enterprise",
    "wsfcDomainProfile": {
      "storageAccountUrl": "https://storgact.blob.core.windows.net/"
    }
  },
  "location": "northeurope",
  "tags": {
    "mytag": "myval"
  },
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testrg/providers/Microsoft.SqlVirtualMachine/sqlVirtualMachineGroups/testvmgroup",
  "name": "testvmgroup",
  "type": "Microsoft.SqlVirtualMachine/sqlVirtualMachineGroups"
}

Определения

ClusterConfiguration

Тип кластера.

ClusterManagerType

Тип диспетчера кластеров: Windows отказоустойчивый кластер сервера (WSFC), подразумеваемый типом масштабирования группы и типа ОС.

createdByType

Тип удостоверения, создавшего ресурс.

ScaleType

Тип масштабирования.

SqlVirtualMachineGroup

Группа виртуальных машин SQL.

SqlVmGroupImageSku

SQL SKU образа.

systemData

Метаданные, относящиеся к созданию и последнему модификации ресурса.

WsfcDomainProfile

Сведения об учетной записи Active Directory для работы Windows отказоустойчивого кластера сервера.

ClusterConfiguration

Тип кластера.

Name Type Description
Domainful
  • string

ClusterManagerType

Тип диспетчера кластеров: Windows отказоустойчивый кластер сервера (WSFC), подразумеваемый типом масштабирования группы и типа ОС.

Name Type Description
WSFC
  • string

createdByType

Тип удостоверения, создавшего ресурс.

Name Type Description
Application
  • string
Key
  • string
ManagedIdentity
  • string
User
  • string

ScaleType

Тип масштабирования.

Name Type Description
HA
  • string

SqlVirtualMachineGroup

Группа виртуальных машин SQL.

Name Type Description
id
  • string

Идентификатор ресурса.

location
  • string

Расположение ресурса.

name
  • string

Имя ресурса.

properties.clusterConfiguration

Тип кластера.

properties.clusterManagerType

Тип диспетчера кластеров: Windows отказоустойчивый кластер сервера (WSFC), подразумеваемый типом масштабирования группы и типа ОС.

properties.provisioningState
  • string

Состояние подготовки для отслеживания состояния асинхронной операции.

properties.scaleType

Тип масштабирования.

properties.sqlImageOffer
  • string

SQL предложение изображения. Примерами могут быть SQL2016-WS2016, SQL2017-WS2016.

properties.sqlImageSku

SQL SKU образа.

properties.wsfcDomainProfile

Профиль домена Active Directory кластера.

systemData

Метаданные, относящиеся к созданию и последнему модификации ресурса.

tags
  • object

Теги ресурсов.

type
  • string

Тип ресурса.

SqlVmGroupImageSku

SQL SKU образа.

Name Type Description
Developer
  • string
Enterprise
  • string

systemData

Метаданные, относящиеся к созданию и последнему модификации ресурса.

Name Type Description
createdAt
  • string

Метка времени создания ресурса (UTC).

createdBy
  • string

Удостоверение, создающее ресурс.

createdByType

Тип удостоверения, создавшего ресурс.

lastModifiedAt
  • string

Метка времени последнего изменения ресурса (UTC)

lastModifiedBy
  • string

Удостоверение, которое последнее изменение ресурса.

lastModifiedByType

Тип удостоверения, который последний раз изменил ресурс.

WsfcDomainProfile

Сведения об учетной записи Active Directory для работы Windows отказоустойчивого кластера сервера.

Name Type Description
clusterBootstrapAccount
  • string

Имя учетной записи, используемое для создания кластера (как минимум требует разрешений на создание объектов-компьютеров в домене).

clusterOperatorAccount
  • string

Имя учетной записи, используемое для операционного кластера, то есть будет частью группы администраторов на всех участвующих виртуальных машинах в кластере.

domainFqdn
  • string

Полное имя домена.

fileShareWitnessPath
  • string

Необязательный путь к файлу-свидетелю.

ouPath
  • string

Путь к подразделению, в котором будут присутствовать узлы и кластер.

sqlServiceAccount
  • string

Имя учетной записи, под которой будет выполняться служба SQL на всех участвующих SQL виртуальных машинах в кластере.

storageAccountPrimaryKey
  • string

Первичный ключ учетной записи хранения-свидетеля.

storageAccountUrl
  • string

Полный идентификатор ресурса ARM для учетной записи хранения-свидетеля.