Servers - Update

  • Referência
Serviço:
SQL Database
Versão da API:
2021-11-01

Atualiza um servidor.

PATCH https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}?api-version=2021-11-01

Parâmetros de URI

Nome Em Obrigatório Tipo Description
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.
serverName
 path True

string

O nome do servidor.
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
identity

ResourceIdentity

Identidade do servidor
properties.administratorLogin

string

Nome de usuário do administrador para o servidor. Depois de criado, ele não pode ser alterado.
properties.administratorLoginPassword

string

A senha de logon do administrador (necessária para a criação do servidor).
properties.administrators

ServerExternalAdministrator

O administrador do Azure Active Directory do servidor.
properties.federatedClientId

string

A ID do cliente usada para o cenário de CMK entre locatários
properties.keyId

string

Um URI cmk da chave a ser usada para criptografia.
properties.minimalTlsVersion

string

Versão mínima do TLS. Valores permitidos: '1.0', '1.1', '1.2'
properties.primaryUserAssignedIdentityId

string

A ID do recurso de uma identidade atribuída pelo usuário a ser usada por padrão.
properties.publicNetworkAccess

ServerNetworkAccessFlag

Se o acesso ao ponto de extremidade público é permitido ou não para este servidor. O valor é opcional, mas, se passado, deve ser 'Habilitado' ou 'Desabilitado'
properties.restrictOutboundNetworkAccess

ServerNetworkAccessFlag

Se o acesso à rede de saída deve ou não ser restringido para este servidor. O valor é opcional, mas, se passado, deve ser 'Habilitado' ou 'Desabilitado'
properties.version

string

A versão do servidor.
tags

object

Marcas de recurso.

Respostas

Nome Tipo Description
200 OK

Server

O servidor foi atualizado com êxito.
202 Accepted

Aceito
Other Status Codes

Respostas de erro: ***

  • 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 PECsNotExistingToDenyPublicNetworkAccess - Não é possível definir Negar Acesso à Rede Pública como Sim, pois não há nenhum ponto de extremidade privado habilitado para acessar o servidor. Configure pontos de extremidade privados e repita a operação (https://docs.microsoft.com/azure/sql-database/sql-database-private-endpoint-overview#how-to-set-up-private-link-for-azure-sql-database).

  • 400 NameAlreadyExists - O nome fornecido já existe.

  • 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 ProvisioningDisabled - Exibe a mensagem de erro do autorizador de operação de recursos como está, sem alterações

  • 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 está definido como 'UserAssigned'

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

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

  • 400 Ipv6FeatureNotEnabled - O usuário tentou ativar o suporte ao Ipv6 no servidor sem habilitar o sinalizador de recurso na assinatura ou o suporte ao recurso está desabilitado na região.

  • 400 PasswordTooShort - A senha fornecida é muito curta

  • 400 AadOnlyAuthenticationIsEnabled – A autenticação somente do Azure Active Directory está habilitada. Entre em contato com o administrador do sistema.

  • 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 PasswordTooLong - A senha fornecida é muito longa.

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

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

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

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

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

  • 400 TokenTooLong - O token fornecido é muito longo.

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

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

  • 400 InvalidMinimalTlsVersion - Versão mínima inválida do TLS.

  • 400 InvalidExternalAdministratorLogin - Nome de logon de administrador externo inválido ou ausente.

  • 400 InvalidExternalAdministratorSid - ID de objeto de administrador externo inválida ou ausente.

  • 400 InvalidExternalAdministratorTenantId - ID de locatário de administrador externo inválida ou ausente.

  • 400 ExternalAdministratorPrincipalType - Tipo de entidade de segurança de administrador externo inválido ou ausente. Selecione usuário, aplicativo ou grupo.

  • 400 MissingExternalAdministratorWithAadOnlyAuth – Para usar Azure AD Somente Autenticação, forneça detalhes de um administrador externo.

  • 400 ExternalAdministratorLoginSameAsSqlAdmin - Os nomes do administrador do Azure Active Directory e da conta de administrador do servidor devem ser diferentes. Forneça valores diferentes.

  • 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 SubscriptionNotFound - A assinatura solicitada não foi encontrada.

  • 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 UpsertLogicalServerRequestAlreadyInProgress - Uma solicitação de servidor lógico em andamento já está em andamento, tente sua solicitação novamente mais tarde.

  • 409 ServerDisabled – O servidor está desabilitado.

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

  • 409 Assinatura Desabilitada – A assinatura está desabilitada.

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

  • 409 ServerAlreadyExists - Nome do servidor duplicado.

  • 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 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.

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

  • 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.

Exemplos

Update a server

Solicitação de exemplo

PATCH https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/sqlcrudtest-7398/providers/Microsoft.Sql/servers/sqlcrudtest-4645?api-version=2021-11-01

{
  "properties": {
    "administratorLogin": "dummylogin",
    "administratorLoginPassword": "placeholder",
    "publicNetworkAccess": "Disabled",
    "restrictOutboundNetworkAccess": "Enabled"
  }
}

Resposta de exemplo

Código de status:
200 
{
  "tags": {
    "tagKey1": "TagValue1"
  },
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/sqlcrudtest-7398/providers/Microsoft.Sql/servers/sqlcrudtest-4645",
  "name": "sqlcrudtest-4645",
  "type": "Microsoft.Sql/servers",
  "location": "japaneast",
  "kind": "v12.0",
  "properties": {
    "fullyQualifiedDomainName": "sqlcrudtest-4645.database.windows.net",
    "administratorLogin": "dummylogin",
    "version": "12.0",
    "state": "Ready",
    "publicNetworkAccess": "Disabled",
    "restrictOutboundNetworkAccess": "Enabled",
    "privateEndpointConnections": [
      {
        "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/sqlcrudtest-7398/providers/Microsoft.Sql/servers/sqlcrudtest-4645/privateEndpointConnections/private-endpoint-name-00000000-1111-2222-3333-444444444444",
        "properties": {
          "provisioningState": "Ready",
          "privateEndpoint": {
            "id": "/subscriptions/55555555-6666-7777-8888-999999999999/resourceGroups/Default-Network/providers/Microsoft.Network/privateEndpoints/private-endpoint-name"
          },
          "privateLinkServiceConnectionState": {
            "status": "Approved",
            "description": "Auto-approved",
            "actionsRequired": "None"
          }
        }
      }
    ]
  }
}
Código de status:
202

Definições

Nome Description
AdministratorType

Tipo do administrador de sever.
IdentityType

O tipo de identidade. Defina isso como "SystemAssigned" para criar e atribuir automaticamente uma entidade de segurança do Azure Active Directory para o recurso.
PrincipalType

Tipo principal do administrador de sever.
PrivateEndpointConnectionProperties

Propriedades de uma conexão de ponto de extremidade privado.
PrivateEndpointProperty
PrivateEndpointProvisioningState

Estado da conexão de ponto de extremidade privado.
PrivateLinkServiceConnectionStateActionsRequire

As ações necessárias para a conexão do serviço de link privado.
PrivateLinkServiceConnectionStateProperty
PrivateLinkServiceConnectionStateStatus

A conexão do serviço de link privado status.
ResourceIdentity

Configuração de identidade do Azure Active Directory para um recurso.
Server

Um servidor de banco de dados SQL do Azure.
ServerExternalAdministrator

Propriedades de um administrador do Active Directory.
ServerNetworkAccessFlag

Se o acesso ao ponto de extremidade público é permitido ou não para este servidor. O valor é opcional, mas, se passado, deve ser 'Habilitado' ou 'Desabilitado'
ServerPrivateEndpointConnection

Uma conexão de ponto de extremidade privado em um servidor
ServerUpdate

Uma solicitação de atualização para um servidor de banco de dados SQL do Azure.
ServerWorkspaceFeature

Se o servidor existente tem ou não um workspace criado e se ele permite a conexão do workspace
UserIdentity

Configuração de identidade do Azure Active Directory para um recurso.

AdministratorType

Tipo do administrador de sever.

Nome Tipo Description
ActiveDirectory

string

IdentityType

O tipo de identidade. Defina isso como "SystemAssigned" para criar e atribuir automaticamente uma entidade de segurança do Azure Active Directory para o recurso.

Nome Tipo Description
None

string

SystemAssigned

string

SystemAssigned,UserAssigned

string

UserAssigned

string

PrincipalType

Tipo principal do administrador de sever.

Nome Tipo Description
Application

string

Group

string

User

string

PrivateEndpointConnectionProperties

Propriedades de uma conexão de ponto de extremidade privado.

Nome Tipo Description
groupIds

string[]

IDs de grupo.
privateEndpoint

PrivateEndpointProperty

Ponto de extremidade privado ao qual a conexão pertence.
privateLinkServiceConnectionState

PrivateLinkServiceConnectionStateProperty

Estado de conexão da conexão de ponto de extremidade privado.
provisioningState

PrivateEndpointProvisioningState

Estado da conexão de ponto de extremidade privado.

PrivateEndpointProperty

Nome Tipo Description
id

string

ID do recurso do ponto de extremidade privado.

PrivateEndpointProvisioningState

Estado da conexão de ponto de extremidade privado.

Nome Tipo Description
Approving

string

Dropping

string

Failed

string

Ready

string

Rejecting

string

PrivateLinkServiceConnectionStateActionsRequire

As ações necessárias para a conexão do serviço de link privado.

Nome Tipo Description
None

string

PrivateLinkServiceConnectionStateProperty

Nome Tipo Description
actionsRequired

PrivateLinkServiceConnectionStateActionsRequire

As ações necessárias para a conexão do serviço de link privado.
description

string

A descrição da conexão do serviço de link privado.
status

PrivateLinkServiceConnectionStateStatus

A conexão do serviço de link privado status.

PrivateLinkServiceConnectionStateStatus

A conexão do serviço de link privado status.

Nome Tipo Description
Approved

string

Disconnected

string

Pending

string

Rejected

string

ResourceIdentity

Configuração de identidade do Azure Active Directory para um recurso.

Nome Tipo Description
principalId

string

A ID da entidade de segurança do Azure Active Directory.
tenantId

string

A ID do locatário do Azure Active Directory.
type

IdentityType

O tipo de identidade. Defina isso como "SystemAssigned" para criar e atribuir automaticamente uma entidade de segurança do Azure Active Directory para o recurso.
userAssignedIdentities

<string,  UserIdentity>

As IDs de recurso das identidades atribuídas pelo usuário a serem usadas

Server

Um servidor de banco de dados SQL do Azure.

Nome Tipo Description
id

string

ID do recurso.
identity

ResourceIdentity

A identidade do Azure Active Directory do servidor.
kind

string

Tipo de sql server. Esses são metadados usados para a experiência de portal do Azure.
location

string

Local do recurso.
name

string

Nome do recurso.
properties.administratorLogin

string

Nome de usuário do administrador para o servidor. Depois de criado, ele não pode ser alterado.
properties.administratorLoginPassword

string

A senha de logon do administrador (necessária para a criação do servidor).
properties.administrators

ServerExternalAdministrator

O administrador do Azure Active Directory do servidor.
properties.federatedClientId

string

A ID do cliente usada para o cenário de CMK entre locatários
properties.fullyQualifiedDomainName

string

O nome de domínio totalmente qualificado do servidor.
properties.keyId

string

Um URI cmk da chave a ser usada para criptografia.
properties.minimalTlsVersion

string

Versão mínima do TLS. Valores permitidos: '1.0', '1.1', '1.2'
properties.primaryUserAssignedIdentityId

string

A ID do recurso de uma identidade atribuída pelo usuário a ser usada por padrão.
properties.privateEndpointConnections

ServerPrivateEndpointConnection[]

Lista de conexões de ponto de extremidade privado em um servidor
properties.publicNetworkAccess

ServerNetworkAccessFlag

Se o acesso ao ponto de extremidade público é permitido ou não para este servidor. O valor é opcional, mas, se passado, deve ser 'Habilitado' ou 'Desabilitado'
properties.restrictOutboundNetworkAccess

ServerNetworkAccessFlag

Se deseja ou não restringir o acesso à rede de saída para este servidor. O valor é opcional, mas, se passado, deve ser 'Habilitado' ou 'Desabilitado'
properties.state

string

O estado do servidor.
properties.version

string

A versão do servidor.
properties.workspaceFeature

ServerWorkspaceFeature

Se o servidor existente tem ou não um workspace criado e se ele permite a conexão do workspace
tags

object

Marcas de recurso.
type

string

Tipo de recurso.

ServerExternalAdministrator

Propriedades de um administrador do Active Directory.

Nome Tipo Description
administratorType

AdministratorType

Tipo do administrador de sever.
azureADOnlyAuthentication

boolean

Somente autenticação do Azure Active Directory habilitada.
login

string

Nome de logon do administrador do servidor.
principalType

PrincipalType

Tipo principal do administrador de sever.
sid

string

SID (ID do objeto) do administrador do servidor.
tenantId

string

ID do locatário do administrador.

ServerNetworkAccessFlag

Se o acesso ao ponto de extremidade público é permitido ou não para este servidor. O valor é opcional, mas, se passado, deve ser 'Habilitado' ou 'Desabilitado'

Nome Tipo Description
Disabled

string

Enabled

string

ServerPrivateEndpointConnection

Uma conexão de ponto de extremidade privado em um servidor

Nome Tipo Description
id

string

ID do recurso.
properties

PrivateEndpointConnectionProperties

Propriedades de conexão de ponto de extremidade privado

ServerUpdate

Uma solicitação de atualização para um servidor de banco de dados SQL do Azure.

Nome Tipo Description
identity

ResourceIdentity

Identidade do servidor
properties.administratorLogin

string

Nome de usuário do administrador para o servidor. Depois de criado, ele não pode ser alterado.
properties.administratorLoginPassword

string

A senha de logon do administrador (necessária para a criação do servidor).
properties.administrators

ServerExternalAdministrator

O administrador do Azure Active Directory do servidor.
properties.federatedClientId

string

A ID do cliente usada para o cenário de CMK entre locatários
properties.fullyQualifiedDomainName

string

O nome de domínio totalmente qualificado do servidor.
properties.keyId

string

Um URI cmk da chave a ser usada para criptografia.
properties.minimalTlsVersion

string

Versão mínima do TLS. Valores permitidos: '1.0', '1.1', '1.2'
properties.primaryUserAssignedIdentityId

string

A ID do recurso de uma identidade atribuída pelo usuário a ser usada por padrão.
properties.privateEndpointConnections

ServerPrivateEndpointConnection[]

Lista de conexões de ponto de extremidade privado em um servidor
properties.publicNetworkAccess

ServerNetworkAccessFlag

Se o acesso ao ponto de extremidade público é permitido ou não para este servidor. O valor é opcional, mas, se passado, deve ser 'Habilitado' ou 'Desabilitado'
properties.restrictOutboundNetworkAccess

ServerNetworkAccessFlag

Se deseja ou não restringir o acesso à rede de saída para este servidor. O valor é opcional, mas, se passado, deve ser 'Habilitado' ou 'Desabilitado'
properties.state

string

O estado do servidor.
properties.version

string

A versão do servidor.
properties.workspaceFeature

ServerWorkspaceFeature

Se o servidor existente tem ou não um workspace criado e se ele permite a conexão do workspace
tags

object

Marcas de recurso.

ServerWorkspaceFeature

Se o servidor existente tem ou não um workspace criado e se ele permite a conexão do workspace

Nome Tipo Description
Connected

string

Disconnected

string

UserIdentity

Configuração de identidade do Azure Active Directory para um recurso.

Nome Tipo Description
clientId

string

A ID do cliente do Azure Active Directory.
principalId

string

A ID da entidade de segurança do Azure Active Directory.