Server Trust Certificates - Create Or Update

Carrega um certificado de confiança do servidor da caixa para o Sql Instância Gerenciada.

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

Parâmetros de URI

Nome Em Obrigatório Tipo Description
certificateName
path True

string

Nome do certificado a ser carregado.

managedInstanceName
path True

string

O nome da instância gerenciada.

resourceGroupName
path True

string

O nome do grupo de recursos que contém o recurso. Você pode obter esse valor por meio da API do Gerenciador de Recursos do Azure ou por meio do portal.

subscriptionId
path True

string

A ID de assinatura que identifica uma assinatura do Azure.

api-version
query True

string

A versão da API a ser usada para a solicitação.

Corpo da solicitação

Nome Tipo Description
properties.publicBlob

string

O blob público do certificado

Respostas

Nome Tipo Description
200 OK

ServerTrustCertificate

O certificado já existia.

201 Created

ServerTrustCertificate

O certificado foi criado com êxito.

202 Accepted

Solicitação aceita para criar um certificado de confiança do servidor.

Other Status Codes

Respostas de erro: ***

  • 400 NameAlreadyExists - O nome fornecido já existe.

  • 400 InvalidCollation – ordenação inválida.

  • 400 Provisionamento Desabilitado – Exibe a mensagem de erro do autorizador de operação de recursos como está, sem alterações

  • 400 RegionDoesNotAllowProvisioning – o local selecionado não está aceitando novos servidores do Banco de Dados do Windows SQL do Azure. Isso pode mudar posteriormente.

  • 400 UnableToResolveRemoteServer – O nome do servidor parceiro remoto não pôde ser resolvido devido a um nome de servidor inválido ou problemas de conectividade DNS.

  • 400 HkCannotSwitchToInactive – O banco de dados não pode continuar com a atualização do tipo de preço, pois tem objetos com otimização de memória. Solte esses objetos e tente novamente.

  • 400 TokenTooLong - O token fornecido é muito longo.

  • 400 CloudLifterUnsupportedFeature – A funcionalidade não está disponível no Instância Gerenciada no momento.

  • A operação 400 ManagedInstanceSloUpdateFailed – SLO '{0}' não pode ter êxito, pois o uso de memória de '{1}' excede a cota.

  • 400 OperationCanNotStartDueToMiLink – A operação '{0}' não pode ser concluída, pois existe um banco de dados em um processo de criação por meio de Instância Gerenciada link. Aguarde a conclusão da criação do link ou exclua o link e repita a operação.

  • 400 ManagedInstanceLocalStorageUpdateSloDisabled – Atualize o SLO para instâncias gerenciadas com armazenamento local ainda não tem suporte.

  • 400 InvalidSubnetResourceId - A ID do recurso de sub-rede fornecida para a criação ou atualização da instância gerenciada é inválida.

  • 400 VnetInWrongRegion – A rede virtual está na região errada.

  • 400 AlterDbDeactivatedNotSupported – Falha na operação de banco de dados para o servidor '{0}', banco de dados '{1}' devido a um atraso inesperado. Tente novamente.

  • 400 VnetAddressRangeError – O intervalo de endereços de rede virtual é inválido.

  • 400 RegionDoesNotSupportVersion – Um usuário tentou criar um servidor de uma versão especificada em um local em que não há suporte para essa versão do servidor.

  • 400 VnetConfigIsNotAllowed – A configuração de rede virtual não é permitida.

  • 400 InstanceFailoverGroupDoesNotExist – o grupo de failover não existe em um servidor.

  • 400 ManagedInstanceClassicVnetNotSupported – Instância Gerenciada não pode ser ingressado em uma rede virtual clássica.

  • 400 VnetConfigHasNsg – O usuário tentou injetar a sub-rede do Servidor Gerenciado com Grupos de Segurança de Rede.

  • 400 VnetConfigHasNoUdr - O usuário tentou injetar a sub-rede do Servidor Gerenciado sem a Tabela de Rota Definida pelo Usuário padrão.

  • 400 VnetConfigHasInvalidUdr - O usuário tentou injetar a sub-rede do Managed Server com uma tabela de rota definida pelo usuário inválida.

  • 400 VnetConfigHasInvalidDns – o usuário tentou injetar a sub-rede do Managed Server com DNS personalizado inválido.

  • 400 VnetConfigHasServiceEndpoints – o usuário tentou injetar a sub-rede do Managed Server com pontos de extremidade de serviço.

  • 400 VnetSubnetIsInUse - O usuário tentou injetar a sub-rede do Servidor Gerenciado que não está vazia.

  • 400 VnetSubnetIsLocked – o usuário tentou injetar a sub-rede do Servidor Gerenciado que está no escopo bloqueado.

  • 400 VnetSubnetIsGateway – O usuário tentou injetar a sub-rede do Servidor Gerenciado que é a sub-rede do Gateway.

  • 400 VnetSubnetIsUnknown – O usuário tentou injetar a sub-rede do Managed Server que não existe.

  • 400 VnetSubnetConflictWithIntendedPolicy – O usuário tentou injetar a sub-rede do Managed Server que tem um conflito com IntendedPolicy.

  • 400 ManagedInstanceInvalidEditionForSku – A edição {0} especificada não é consistente com o SKU {1}especificado.

  • 400 ManagedInstanceInvalidLicenseType - O tipo {0} de licença especificado não é válido.

  • 400 ManagedInstanceUpdateSloInProgress - "A operação não pôde ser concluída porque uma alteração de camada de serviço está em andamento para a instância gerenciada '{0}.' Aguarde a conclusão da operação em andamento e tente novamente."

  • 400 VnetResourceNotFound - Recurso não encontrado: '{0}'.

  • 400 InstanceCollationUpdateNotSupported – O usuário não pode alterar a ordenação de instância no Instância Gerenciada.

  • 400 CreateManagedInstanceWithNonDefaultCollationNotSupported – o usuário pode criar um Instância Gerenciada somente com ordenação "SQL_Latin1_General_CP1_CI_AS".

  • 400 ManagedInstanceOperationInProgress - A operação não pôde ser concluída porque {0} a operação está em andamento. Aguarde a conclusão da operação em andamento e tente novamente.

  • 400 ManagedInstanceExceedMaxAzureStorage - A operação não pôde ser concluída porque o tamanho total de armazenamento alocado para Uso Geral instância excederia {0}. Reduza o número de arquivos de banco de dados e a operação de repetição.

  • 400 ManagedInstanceHasGeoReplica - A operação não pôde ser concluída porque a instância configurou a instância secundária replicada geograficamente.

  • 400 InvalidDnsZone – A operação falhou porque você está tentando implantar a instância gerenciada como um secundário de replicação geográfica na sub-rede {0} na qual já existe uma instância gerenciada. A implantação da instância gerenciada como um secundário de replicação geográfica só tem suporte em casos em que a instância gerenciada é a primeira instância implantada em uma sub-rede. Considere implantar a instância gerenciada como um secundário de replicação geográfica em uma sub-rede diferente na qual não há instâncias gerenciadas existentes ou se a implantação em uma sub-rede com a instância gerenciada existente desabilitar a opção de replicação geográfica.

  • 400 ManagedInstanceInvalidStorageSizeLessThenCurrentSizeUsed - Tamanho de armazenamento inválido: limite de tamanho de armazenamento ({0} GB) é menor que o armazenamento atual usado ({1} GB). Especifique um limite de tamanho de armazenamento mais alto.

  • 400 InvalidTimezone - Fuso horário inválido.

  • 400 InstanceTimezoneUpdateNotSupported – Atualização de fuso horário da instância sem suporte.

  • 400 CreateManagedInstanceWithNonDefaultTimezoneNotSupported – Criar Instância Gerenciada com fuso horário não padrão sem suporte.

  • 400 ManagedInstanceIpAddressRangeLimit – Não é possível executar a criação/dimensionamento da instância gerenciada, pois não há endereços IP disponíveis suficientes na sub-rede para executar a operação.

  • 400 VnetDelegationNotAllowed – O usuário tentou injetar o Servidor Gerenciado na sub-rede delegada.

  • 400 SubnetHasResourcesOfDifferentType – o usuário tentou criar MI na sub-rede que tem recursos de tipo diferente.

  • 400 UpdateManagedServerWithMaintenanceWindowNotAllowed – a atualização de Instância Gerenciada com as configurações da janela de manutenção não é permitida.

  • 400 VnetPrepareNIPFailed - O usuário tentou preparar a sub-rede que tem um conflito com NetworkIntentPolicy.

  • 400 ManagedInstanceDeprecatedHardwareFamily – não é possível alterar a geração de hardware para a geração preterida {0} .

  • 400 ManagedInstanceBackupStorageTypeNotSupported – O parâmetro de tipo de armazenamento de backup não é permitido na operação de atualização de instância.

  • 400 EmptyPDCInvalidDnsZone – essa instância gerenciada não pode ser implantada porque sua zona DNS não corresponde ao prefixo DNS de seu cluster virtual pretendido para a sub-rede {0}. Embora esse cluster virtual esteja vazio, seu prefixo DNS não pode ser alterado. Os clusters virtuais vazios serão removidos automaticamente após várias horas. Considere esperar que esse cluster virtual expire ou exclua manualmente esse cluster virtual e, em seguida, crie a instância gerenciada.

  • 400 MissingIdentityId - Nenhuma identidade atribuída pelo usuário é fornecida quando o tipo de identidade é definido como UserAssigned

  • 400 InvalidPrimaryIdentityId - O usuário fornece um valor para PrimaryUserIdentityId, mas o mesmo não está listado no parâmetro IdentityId

  • 400 ManagedInstanceZoneRedudantFeatureNotSupported – Não há suporte para o recurso ZoneRedundant para a camada de serviço selecionada. Para obter mais detalhes, visite aka.ms/sqlmi-service-tier-characteristics.

  • 400 ManagedInstanceZoneRedudantFeatureCantBeEnabled – A habilitação do recurso zoneRedundant não é possível depois que a instância gerenciada é criada. Para obter mais detalhes, visite aka.ms/sqlmi-high-availability.

  • 400 ManagedInstanceZoneRedudantFeatureCantBeDisabled – Não é possível desabilitar o recurso zoneRedundant depois que a instância gerenciada é criada. Para obter mais detalhes, visite aka.ms/sqlmi-high-availability.

  • 400 UmiMissingAkvPermissions – PrimaryUserAssignedIdentityId fornecido pelo usuário não tem acesso ao KeyId fornecido

  • 400 MissingPrimaryIdentity – PrimaryUserAssignedIdentityId fornecido pelo usuário não tem acesso ao KeyId fornecido

  • 400 SubnetIdCantBeUpdated – Não há suporte para a alteração da sub-rede da instância gerenciada. Remova esse parâmetro da solicitação.

  • 400 MigrationToAnotherVNetNotSupported – A sub-rede selecionada está em outro Rede Virtual. Não é possível mover a instância gerenciada para outra Rede Virtual. Forneça a sub-rede do Rede Virtual {0}.

  • 400 MigrationToSubnetWithDifferentDnsZoneNotSupported – A sub-rede fornecida tem uma zona DNS diferente da atual. Não há suporte para a alteração da zona DNS da instância. Forneça uma sub-rede com a mesma zona DNS, crie uma nova sub-rede ou forneça uma vazia.

  • 400 MigrationToGen4SubnetNotSupported – não é possível atualizar a sub-rede durante a execução no hardware Gen4, pois ela está sendo preterida. Atualize o hardware do Gen4 para o Gen5 como parte da alteração da operação de sub-rede da instância gerenciada especificando ambos os parâmetros ao mesmo tempo: sub-rede de destino e geração de hardware.

  • 400 PrimaryIdentityMissingPermissionForKeyId – KeyId é fornecido pelo usuário durante a criação, mas PrimaryUserAssignedIdentityId não é fornecido na chamada à API

  • 400 InvalidIdentityTypeForKeyId - KeyId é fornecido pelo usuário durante a criação, mas o tipo de identidade não é definido como 'UserAssigned'

  • 400 ServerNotFound – O servidor solicitado não foi encontrado.

  • 400 ManagedInstanceFileExceededMaxAzureStorageFileSizeLimit - A operação não pôde ser concluída porque alguns dos arquivos de banco de dados estão excedendo o limite máximo de tamanho de arquivo Uso Geral de {0} GB.

  • 400 ManagedInstanceStoppingOrStopped – Operação conflitante enviada enquanto a instância está no estado de parada/parada

  • 400 ManagedInstanceStarting - Operação conflitante enviada enquanto a instância está no estado inicial

  • 400 InstancePoolNotEnoughCapacity - Um pool de instâncias não tem capacidade suficiente

  • 400 SourceAndTargetSubnetsMustBeVnetPeered - A sub-rede usada atualmente pela instância gerenciada e a sub-rede de destino fornecida fazem parte das redes virtuais que não estão conectadas ao emparelhamento de rede virtual ou têm o emparelhamento estabelecido, mas não têm tráfego permitido. Para mover a instância gerenciada de uma sub-rede para outra, o emparelhamento de rede virtual precisa ser estabelecido da rede virtual de origem e de destino. Configure os requisitos de rede virtual e repita a operação. Saiba mais https://docs.microsoft.com/en-us/azure/virtual-network/tutorial-connect-virtual-networks-portal#peer-virtual-networks.

  • 400 ManagedInstanceAndSubnetAreNotOnTheSameSubscription - A sub-rede fornecida para implantação de instância gerenciada está localizada na assinatura diferente daquela enviada para a instância gerenciada. A instância gerenciada e a sub-rede usadas para implantar a instância devem estar na mesma assinatura. Forneça outra sub-rede ou alterne para a assinatura de sub-rede e tente a operação novamente.

  • 400 CreateManagedInstanceInvalidSubnetSize - O usuário tentou criar uma instância gerenciada em uma sub-rede menor do que o tamanho mínimo permitido da sub-rede.

  • 400 AddressRangeOfTargetSubnetAndSubnetOfGeoDRReplicaCantOverlap - A sub-rede selecionada para migração de instância gerenciada tem um intervalo de endereços que se sobrepõe ao intervalo de endereços da sub-rede que contém a instância secundária replicada geograficamente. Verifique se a sub-rede está configurada de acordo com as diretrizes no https://aka.ms/move-managed-instance.

  • 400 TargetSubnetMustBeConfiguredToAllowGeoDRReplication - A sub-rede selecionada para migração de instância gerenciada não está configurada para habilitar a comunicação com uma instância secundária replicada geograficamente. Marcar se todas as portas necessárias estiverem abertas. Para configurar corretamente sua sub-rede, leia as diretrizes em https://aka.ms/move-managed-instance.

  • 400 InvalidIdentifier - O identificador contém NULL ou um caractere unicode inválido.

  • 400 InvalidLoginName - O nome de logon fornecido é inválido.

  • 400 InvalidUsername - O nome de usuário fornecido contém caracteres inválidos.

  • 400 PasswordTooShort - A senha fornecida é muito curta

  • 400 PasswordTooLong - A senha fornecida é muito longa.

  • 400 PasswordNotComplex - A senha fornecida não é complexa o suficiente.

  • 400 GatewayInvalidEdition - '{0}' não é uma edição de banco de dados válida nesta versão do SQL Server.

  • 400 InvalidLocation - Um local inválido foi especificado.

  • 400 InvalidParameterValue - Um valor inválido foi dado a um parâmetro.

  • 400 InvalidServerName - Nome do servidor inválido especificado.

  • 400 MissingPublicBlob - O blob público está ausente.

  • 400 InvalidPublicBlob - Blob público inválido especificado, motivo: '{0}'.

  • 400 MissingCertificateName - O nome do certificado está ausente.

  • 400 CertificateAlreadyExists - Já existe um certificado com um determinado nome ou esse certificado já foi adicionado ao banco de dados.

  • 404 ResourceNotFound - O recurso solicitado não foi encontrado.

  • 404 SubscriptionDoesNotHaveServer - O servidor solicitado não foi encontrado

  • 404 ServerNotInSubscriptionResourceGroup - O servidor especificado não existe no grupo de recursos e na assinatura especificados.

  • 404 OperationIdNotFound - A operação com Id não existe.

  • 404 ResourceDoesNotExist - O recurso com o nome '{0}' não existe. Para continuar, especifique um nome de recurso válido.

  • 404 InstancePoolNotFound - Um pool de instâncias não pode ser encontrado

  • 404 SubscriptionNotFound - A assinatura solicitada não foi encontrada.

  • 405 InvalidVcoreValue – o valor {0} de vCore não é válido. Especifique um valor vCore válido.

  • 405 InvalidHardwareGenerationValue – HardwareGeneration {0} não é válido. Especifique um valor válido de HardwareGeneration.

  • 405 InvalidStorageSizeValue - "Tamanho de armazenamento inválido: {0} GB. O tamanho do armazenamento deve ser especificado entre {1} e {2} gigabytes, em incrementos de {3} GB.

  • 409 OperationCancelled - A operação foi cancelada pelo usuário.

  • 409 OperationInterrupted - A operação no recurso não pôde ser concluída porque foi interrompida por outra operação no mesmo recurso.

  • 409 ConflictingServerOperation - Uma operação está em andamento no momento para o servidor.

  • 409 Assinatura Desabilitada – A assinatura está desabilitada.

  • 409 ServerOverridePreconditionFailed - Falha ao aplicar a substituição de servidor na categoria '{0}', porque o banco de dados físico ou a instância '{1}' no servidor '{2}' atualmente não está no estado 'Pronto' ou 'Desativado'.

  • 409 ManagedInstanceIsBusy - O servidor '{0}' está ocupado no momento. Aguarde alguns minutos antes de tentar novamente.

  • 409 ServerAlreadyExists - Nome do servidor duplicado.

  • 409 ServerDisabled – O servidor está desabilitado.

  • 409 ServerQuotaExceeded - O servidor não pode ser adicionado a uma assinatura porque excederá a cota.

  • 429 SubscriptionTooManyCreateUpdateRequests - Solicitações além do máximo de solicitações que podem ser processadas por recursos disponíveis.

  • 429 SubscriptionTooManyRequests - Solicitações além do máximo de solicitações que podem ser processadas por recursos disponíveis.

  • 429 ConflictingSubscriptionOperation - Uma operação está em andamento para a assinatura.

  • 429 SubscriptionTooManyCreateUpdateRequests - Solicitações além do máximo de solicitações que podem ser processadas por recursos disponíveis.

  • 429 SubscriptionTooManyRequests - Solicitações além do máximo de solicitações que podem ser processadas por recursos disponíveis.

  • 500 OperationTimedOut - A operação atingiu o tempo limite e foi revertida automaticamente. Tente executar a operação novamente.

  • 500 GatewayInternalServerError - O servidor encontrou uma exceção inesperada.

  • 503 TooManyRequests - Solicitações além do máximo de solicitações que podem ser processadas por recursos disponíveis.

  • 503 TooManyRequests - Solicitações além do máximo de solicitações que podem ser processadas por recursos disponíveis.

  • 504 RequestTimeout – A solicitação de serviço excedeu o tempo limite permitido.

Exemplos

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"
}

Definições

ServerTrustCertificate

Certificado de confiança do servidor importado da caixa para habilitar a conexão entre a caixa e o Sql Instância Gerenciada.

Nome Tipo Description
id

string

ID do recurso.

name

string

Nome do recurso.

properties.certificateName

string

O nome do certificado

properties.publicBlob

string

O blob público do certificado

properties.thumbprint

string

A impressão digital do certificado

type

string

Tipo de recurso.