Server Trust Certificates - Create Or Update

Отправляет сертификат доверия сервера из box в sql Управляемый экземпляр.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/managedInstances/{managedInstanceName}/serverTrustCertificates/{certificateName}?api-version=2021-11-01

Параметры URI

Имя В Обязательно Тип Описание
certificateName
path True

string

Имя отправляемого сертификата.

managedInstanceName
path True

string

Имя управляемого экземпляра.

resourceGroupName
path True

string

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

subscriptionId
path True

string

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

api-version
query True

string

Версия API для использования в запросе.

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

Имя Тип Описание
properties.publicBlob

string

Общедоступный BLOB-объект сертификата

Ответы

Имя Тип Описание
200 OK

ServerTrustCertificate

Сертификат уже существует.

201 Created

ServerTrustCertificate

Сертификат успешно создан.

202 Accepted

Принятый запрос на создание сертификата доверия сервера.

Other Status Codes

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

  • 400 NameAlreadyExists — предоставленное имя уже существует.

  • 400 InvalidCollation — недопустимые параметры сортировки.

  • 400 ProvisioningDisabled — отображает сообщение об ошибке от авторизации операции ресурсов без изменений.

  • 400 RegionDoesNotAllowProvisioning — выбранное расположение не принимает новые серверы Windows Azure SQL Database. Позже это может измениться.

  • 400 UnableToResolveRemoteServer — не удалось разрешить имя удаленного сервера-партнера из-за недопустимого имени сервера или проблем с подключением к DNS.

  • 400 HkCannotSwitchToInactive — база данных не может продолжить обновление ценовой категории, так как в ней есть объекты, оптимизированные для памяти. Удалите такие объекты и повторите попытку.

  • 400 TokenTooLong — предоставленный маркер слишком длинный.

  • 400 CloudLifterUnsupportedFeature — в настоящее время эта функция недоступна на Управляемый экземпляр.

  • 400 ManagedInstanceSloUpdateFailed — операция SLO "{0}" не может быть успешно выполнена, так как использование памяти "{1}" превышает квоту.

  • 400 OperationCanNotStartDueToMiLink — операция "{0}" не может быть завершена, так как существует база данных в процессе создания через Управляемый экземпляр ссылку. Дождитесь завершения создания ссылки или удалите ссылку и повторите операцию.

  • 400 ManagedInstanceLocalStorageUpdateSloDisabled — обновление SLO для управляемых экземпляров с локальным хранилищем пока не поддерживается.

  • 400 InvalidSubnetResourceId — указанный идентификатор ресурса подсети для создания или обновления управляемого экземпляра недопустим.

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

  • 400 AlterDbDeactivatedNotSupported — сбой операции базы данных для сервера "{0}", базы данных "{1}" из-за неожиданной задержки. Повторите попытку.

  • 400 VnetAddressRangeError — недопустимый диапазон адресов виртуальной сети.

  • 400 RegionDoesNotSupportVersion — пользователь пытался создать сервер указанной версии в расположении, где эта версия сервера не поддерживается.

  • 400 VnetConfigIsNotAllowed — конфигурация виртуальной сети не разрешена.

  • 400 InstanceFailoverGroupDoesNotExist — группа отработки отказа не существует на сервере.

  • 400 ManagedInstanceClassicVnetNotSupported — Управляемый экземпляр не может быть присоединен к классической виртуальной сети.

  • 400 VnetConfigHasNsg — пользователь попытался внедрить подсеть Управляемого сервера с группами безопасности сети.

  • 400 VnetConfigHasNoUdr — пользователь пытался внедрить подсеть Управляемого сервера без таблицы маршрутов, определяемой пользователем по умолчанию.

  • 400 VnetConfigHasInvalidUdr — пользователь попытался внедрить подсеть Управляемого сервера с недопустимой определяемой пользователем таблицей маршрутов.

  • 400 VnetConfigHasInvalidDns — пользователь пытался внедрить подсеть Управляемого сервера с недопустимым пользовательским DNS.

  • 400 VnetConfigHasServiceEndpoints — пользователь попытался внедрить подсеть Управляемого сервера с конечными точками службы.

  • 400 VnetSubnetIsInUse — пользователь пытался внедрить непустую подсеть управляемого сервера.

  • 400 VnetSubnetIsLocked — пользователь попытался внедрить подсеть Управляемого сервера, которая находится в заблокированном область.

  • 400 VnetSubnetIsGateway — пользователь попытался внедрить подсеть Управляемого сервера, которая является подсетью шлюза.

  • 400 VnetSubnetIsUnknown — пользователь пытался внедрить подсеть управляемого сервера, которая не существует.

  • 400 VnetSubnetConflictWithIntendedPolicy — пользователь пытался внедрить подсеть Управляемого сервера, которая имеет конфликт с IntendedPolicy.

  • 400 ManagedInstanceInvalidEditionForSku — указанный выпуск {0} не соответствует указанному номеру SKU {1}.

  • 400 ManagedInstanceInvalidLicenseType — указанный тип {0} лицензии недопустим.

  • 400 ManagedInstanceUpdateSloInProgress — "Не удалось завершить операцию, так как для управляемого экземпляра выполняется изменение уровня служб ".{0} Дождитесь завершения операции и повторите попытку".

  • 400 VnetResourceNotFound — ресурс не найден: "{0}".

  • 400 InstanceCollationUpdateNotSupported — пользователь не может изменить параметры сортировки экземпляра на Управляемый экземпляр.

  • 400 CreateManagedInstanceWithNonDefaultCollationNotSupported — пользователь может создать Управляемый экземпляр только с параметрами сортировки "SQL_Latin1_General_CP1_CI_AS".

  • 400 ManagedInstanceOperationInProgress — не удалось выполнить операцию, так как {0} операция выполняется. Дождитесь завершения операции и повторите попытку.

  • 400 ManagedInstanceExceedMaxAzureStorage — не удалось выполнить операцию, так как общий размер выделенного хранилища для экземпляра общего назначения превысит {0}. Сократите количество файлов базы данных и повторите операцию.

  • 400 ManagedInstanceHasGeoReplica — не удалось выполнить операцию, так как экземпляр настроил геореплицированный вторичный экземпляр.

  • 400 InvalidDnsZone — операция завершилась сбоем, так как вы пытаетесь развернуть управляемый экземпляр в качестве вторичной георепликации в подсети {0} , в которой уже существует управляемый экземпляр. Развертывание управляемого экземпляра в качестве вторичной георепликации поддерживается только в тех случаях, когда управляемый экземпляр является первым экземпляром, развернутым в подсети. Рассмотрите возможность развертывания управляемого экземпляра в качестве вторичной георепликации в другой подсети, в которой нет управляемых экземпляров, или при развертывании в подсети с существующим управляемым экземпляром отключите параметр георепликации.

  • 400 ManagedInstanceInvalidStorageSizeLessThenCurrentSizeUsed — недопустимый размер хранилища: максимальный размер хранилища ({0} ГБ) меньше текущего используемого хранилища ({1} ГБ). Укажите более высокий размер хранилища.

  • 400 InvalidTimezone — недопустимый часовой пояс.

  • 400 InstanceTimezoneUpdateNotSupported — обновление часового пояса экземпляра не поддерживается.

  • 400 CreateManagedInstanceWithNonDefaultTimezoneNotSupported — создание Управляемый экземпляр с часовыми поясами, не поддерживаемыми по умолчанию.

  • 400 ManagedInstanceIpAddressRangeLimit — не удается выполнить создание или масштабирование управляемого экземпляра, так как в подсети недостаточно доступных IP-адресов для выполнения операции.

  • 400 VnetDelegationNotAllowed — пользователь пытался внедрить управляемый сервер в делегированную подсеть.

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

  • 400 UpdateManagedServerWithMaintenanceWindowNotAllowed — обновление Управляемый экземпляр с параметрами периода обслуживания не допускается.

  • 400 VnetPrepareNIPFailed — пользователь пытался подготовить подсеть, конфликтующую с NetworkIntentPolicy.

  • 400 ManagedInstanceDeprecatedHardwareFamily — изменение поколения оборудования на устаревшее {0} поколение невозможно.

  • 400 ManagedInstanceBackupStorageTypeNotSupported — параметр типа хранилища резервных копий не разрешен в операции обновления экземпляра.

  • 400 EmptyPDCInvalidDnsZone — этот управляемый экземпляр не может быть развернут, так как его зона DNS не соответствует DNS-префиксу предполагаемого виртуального кластера для подсети {0}. Хотя этот виртуальный кластер пуст, его DNS-префикс нельзя изменить. Через несколько часов пустые виртуальные кластеры будут автоматически удалены. Рассмотрите возможность ожидания истечения срока действия этого виртуального кластера или удаления этого виртуального кластера вручную, а затем создания управляемого экземпляра.

  • 400 MissingIdentityId — удостоверение, назначаемое пользователем, не предоставляется, если для типа удостоверения задано значение UserAssigned.

  • 400 InvalidPrimaryIdentityId — пользователь предоставляет значение для PrimaryUserIdentityId, но то же не указано в параметре IdentityId.

  • 400 ManagedInstanceZoneRedudantFeatureNotSupported — функция ZoneRedundant не поддерживается для выбранного уровня служб. Дополнительные сведения см. в aka.ms/sqlmi-service-tier-characteristics.

  • 400 ManagedInstanceZoneRedudantFeatureCantBeEnabled — включение функции zoneRedundant невозможно после создания управляемого экземпляра. Дополнительные сведения см. на странице aka.ms/sqlmi-high-availability.

  • 400 ManagedInstanceZoneRedudantFeatureCantBeDisabled — отключение функции zoneRedundant невозможно после создания управляемого экземпляра. Дополнительные сведения см. на странице aka.ms/sqlmi-high-availability.

  • 400 UmiMissingAkvPermissions — PrimaryUserAssignedIdentityId, предоставленный пользователем, не имеет доступа к предоставленному идентификатору KeyId

  • 400 MissingPrimaryIdentity — PrimaryUserAssignedIdentityId, предоставленный пользователем, не имеет доступа к предоставленному идентификатору KeyId

  • 400 SubnetIdCantBeUpdated — изменение подсети управляемого экземпляра не поддерживается. Удалите этот параметр из запроса.

  • 400 MigrationToAnotherVNetNotSupported — выбранная подсеть находится в другой виртуальная сеть. Перемещение управляемого экземпляра в другой виртуальная сеть невозможно. Укажите подсеть из виртуальная сеть {0}.

  • 400 MigrationToSubnetWithDifferentDnsZoneNotSupported — если подсеть имеет зону DNS, отличную от текущей. Изменение зоны DNS экземпляра не поддерживается. Укажите подсеть с той же зоной DNS, создайте новую подсеть или укажите пустую.

  • 400 MigrationToGen4SubnetNotSupported — невозможно обновить подсеть во время работы на оборудовании 4-го поколения, так как она является устаревшей. Обновите оборудование с 4-го поколения до 5-го поколения в рамках операции изменения подсети управляемого экземпляра, указав оба параметра одновременно: целевую подсеть и поколение оборудования.

  • 400 PrimaryIdentityMissingPermissionForKeyId — KeyId предоставляется пользователем во время создания, но PrimaryUserAssignedIdentityId не предоставляется в вызове API

  • 400 InvalidIdentityTypeForKeyId — KeyId предоставляется пользователем во время создания, но для типа удостоверения не задано значение UserAssigned.

  • 400 ServerNotFound — запрошенный сервер не найден.

  • 400 ManagedInstanceFileExceededMaxAzureStorageFileSizeLimit — не удалось выполнить операцию, так как некоторые файлы базы данных превышают максимальный размер {0} файла общего назначения ГБ.

  • 400 ManagedInstanceStoppingOrStopped — конфликтующая операция, отправленная, когда экземпляр находится в состоянии остановки или остановки

  • 400 ManagedInstanceStarting — конфликтующая операция, отправленная во время запуска экземпляра

  • 400 InstancePoolNotEnoughCapacity — пул экземпляров не имеет достаточной емкости

  • 400 SourceAndTargetSubnetsMustBeVnetPeered — подсеть, используемая в настоящее время управляемым экземпляром и предоставленной целевой подсетью, являются частью виртуальных сетей, которые не подключены к пирингу виртуальных сетей или имеют установленный пиринг, но не имеют разрешенного трафика. Чтобы переместить управляемый экземпляр из одной подсети в другую, необходимо установить пиринг между виртуальными сетями как из исходной, так и из целевой виртуальной сети. Настройте требования к виртуальной сети и повторите операцию. https://docs.microsoft.com/en-us/azure/virtual-network/tutorial-connect-virtual-networks-portal#peer-virtual-networksДополнительные сведения .

  • 400 ManagedInstanceAndSubnetAreNotOnTheSameSubscription — подсеть, предоставляемая для развертывания управляемого экземпляра, находится в подписке, отличной от той, что отправлена для управляемого экземпляра. Управляемый экземпляр и подсеть, используемые для развертывания экземпляра, должны находиться в одной подписке. Укажите другую подсеть или переключитесь на подписку на подсеть, а затем повторите операцию.

  • 400 CreateManagedInstanceInvalidSubnetSize — пользователь попытался создать управляемый экземпляр в подсети, которая меньше допустимого минимального размера подсети.

  • 400 AddressRangeOfTargetSubnetAndSubnetOfGeoDRReplicaCantOverlap — подсеть, выбранная для миграции управляемого экземпляра, имеет диапазон адресов, перекрывающийся с диапазоном адресов подсети, содержащей геореплицированный вторичный экземпляр. Убедитесь, что подсеть настроена в соответствии с рекомендациями в https://aka.ms/move-managed-instance.

  • 400 TargetSubnetMustBeConfiguredToAllowGeoDRReplication — подсеть, выбранная для миграции управляемого экземпляра, не настроена для включения взаимодействия с геореплицированным вторичным экземпляром. Если открыты все необходимые порты, проверка. Чтобы правильно настроить подсеть, ознакомьтесь с рекомендациями в https://aka.ms/move-managed-instanceразделе .

  • 400 InvalidIdentifier — идентификатор содержит значение NULL или недопустимый символ Юникода.

  • 400 InvalidLoginName — указано недопустимое имя входа.

  • 400 InvalidUsername — указанное имя пользователя содержит недопустимые символы.

  • 400 PasswordTooShort — слишком короткий пароль

  • 400 PasswordTooLong — слишком длинный пароль.

  • 400 PasswordNotComplex — предоставленный пароль недостаточно сложный.

  • 400 GatewayInvalidEdition — "{0}" не является допустимым выпуском базы данных в этой версии SQL Server.

  • 400 InvalidLocation — указано недопустимое расположение.

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

  • 400 InvalidServerName — указано недопустимое имя сервера.

  • 400 MissingPublicBlob — отсутствует общедоступный BLOB-объект.

  • 400 InvalidPublicBlob — указан недопустимый общедоступный BLOB-объект, причина: "{0}".

  • 400 MissingCertificateName — отсутствует имя сертификата.

  • 400 CertificateAlreadyExists — сертификат с заданным именем уже существует или этот сертификат уже добавлен в базу данных.

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

  • 404 SubscriptionDoesNotHaveServer — запрошенный сервер не найден

  • 404 ServerNotInSubscriptionResourceGroup — указанный сервер не существует в указанной группе ресурсов и подписке.

  • 404 OperationIdNotFound — операция с идентификатором не существует.

  • 404 ResourceDoesNotExist — ресурс с именем "{0}" не существует. Чтобы продолжить, укажите допустимое имя ресурса.

  • 404 InstancePoolNotFound — не удается найти пул экземпляров

  • 404 SubscriptionNotFound — запрошенная подписка не найдена.

  • 405 InvalidVcoreValue — недопустимое значение {0} виртуального ядра. Укажите допустимое значение виртуального ядра.

  • 405 InvalidHardwareGenerationValue — hardwareGeneration {0} is not valid. Укажите допустимое значение HardwareGeneration.

  • 405 InvalidStorageSizeValue — "Недопустимый размер хранилища: {0} ГБ. Размер хранилища должен быть указан в диапазоне от {1} гигабайт {2} до гигабайт с шагом {3} в ГБ.

  • 409 OperationCancelled — операция отменена пользователем.

  • 409 OperationInterrupted — не удалось завершить операцию с ресурсом, так как она была прервана другой операцией с тем же ресурсом.

  • 409 ConflictingServerOperation — в настоящее время выполняется операция для сервера.

  • 409 SubscriptionDisabled — подписка отключена.

  • 409 ServerOverridePreconditionFailed — не удалось применить переопределение сервера к категории "{0}", так как физическая база данных или экземпляр "{1}" на сервере "{2}" в настоящее время не находится в состоянии "Готово" или "Деактивирован".

  • 409 ManagedInstanceIsBusy — сервер "{0}" в настоящее время занят. Подождите несколько минут и повторите попытку.

  • 409 ServerAlreadyExists — повторяющееся имя сервера.

  • 409 ServerDisabled — сервер отключен.

  • 409 ServerQuotaExceeded — сервер не может быть добавлен в подписку, так как он превысит квоту.

  • 429 SubscriptionTooManyCreateUpdateRequests — запросы, превышающие максимальное количество запросов, которые могут обрабатываться доступными ресурсами.

  • 429 SubscriptionTooManyRequests — запросы, превышающие максимальное количество запросов, которые могут быть обработаны доступными ресурсами.

  • 429 ConflictingSubscriptionOperation — в настоящее время выполняется операция для подписки.

  • 429 SubscriptionTooManyCreateUpdateRequests — запросы, превышающие максимальное количество запросов, которые могут обрабатываться доступными ресурсами.

  • 429 SubscriptionTooManyRequests — запросы, превышающие максимальное количество запросов, которые могут быть обработаны доступными ресурсами.

  • 500 OperationTimedOut — истекло время ожидания операции и автоматически выполняется откат. Повторите операцию.

  • 500 GatewayInternalServerError — сервер обнаружил непредвиденное исключение.

  • 503 TooManyRequests — запросы, превышающие максимальное количество запросов, которые могут быть обработаны доступными ресурсами.

  • 503 TooManyRequests — запросы, превышающие максимальное количество запросов, которые могут быть обработаны доступными ресурсами.

  • 504 RequestTimeout — превышено допустимое время ожидания запроса на обслуживание.

Примеры

Create server trust certificate.

Sample Request

PUT https://management.azure.com/subscriptions/0574222d-5c7f-489c-a172-b3013eafab53/resourceGroups/testrg/providers/Microsoft.Sql/managedInstances/testcl/serverTrustCertificates/customerCertificateName?api-version=2021-11-01

{
  "properties": {
    "publicBlob": "308203AE30820296A0030201020210"
  }
}

Sample Response

{
  "properties": {
    "thumbprint": "33702D20EC86119985283",
    "certificateName": "customerCertificateName"
  },
  "id": "/subscriptions/0574222d-5c7f-489c-a172-b3013eafab53/resourceGroups/testrg/providers/Microsoft.Sql/managedInstances/testcl/serverTrustCertificates/customerCertificateName",
  "name": "customerCertificateName",
  "type": "Microsoft.Sql/managedInstances/serverTrustCertificates"
}
{
  "properties": {
    "thumbprint": "33702D20EC86119985283",
    "certificateName": "customerCertificateName"
  },
  "id": "/subscriptions/0574222d-5c7f-489c-a172-b3013eafab53/resourceGroups/testrg/providers/Microsoft.Sql/managedInstances/testcl/serverTrustCertificates/customerCertificateName",
  "name": "customerCertificateName",
  "type": "Microsoft.Sql/managedInstances/serverTrustCertificates"
}

Определения

ServerTrustCertificate

Сертификат доверия сервера, импортированный из box, чтобы обеспечить подключение между box и sql Управляемый экземпляр.

Имя Тип Описание
id

string

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

name

string

Имя ресурса.

properties.certificateName

string

Имя сертификата

properties.publicBlob

string

Общедоступный BLOB-объект сертификата

properties.thumbprint

string

Отпечаток сертификата

type

string

Тип ресурса.