Servers - Update

Atualiza um servidor.

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

Parâmetros de URI

Name In Required Type 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

Name Type Description
identity

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

O administrador 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 do 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 de recurso de uma identidade atribuída pelo usuário a ser usada por padrão.

properties.publicNetworkAccess

Se o acesso de 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

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

A versão do servidor.

tags
  • object

Marcas de recurso.

Respostas

Name Type Description
200 OK

Atualizou com êxito o servidor.

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 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 recursos na assinatura ou o suporte ao recurso está desabilitado na região no momento.

  • 400 PasswordTooShort - A senha fornecida é muito curta

  • 400 AadOnlyAuthenticationIsEnabled - Azure Active Directory Somente a Autenticação 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 Windows Banco de Dados 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álida ou ausente. Selecione entre Usuário, Aplicativo ou Grupo.

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

  • 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 das solicitações máximas 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 das solicitações máximas que podem ser processadas por recursos disponíveis.

Exemplos

Update a server

Sample Request

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

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

Sample Response

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

Definições

AdministratorType

Tipo do administrador de sever.

IdentityType

O tipo de identidade. Defina isso como "SystemAssigned" para criar e atribuir automaticamente uma entidade de 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

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

ResourceIdentity

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

Server

Um servidor Banco de Dados SQL do Azure.

ServerExternalAdministrator

Propriedades de um administrador do active directory.

ServerNetworkAccessFlag

Se o acesso de 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 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

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

AdministratorType

Tipo do administrador de sever.

Name Type Description
ActiveDirectory
  • string

IdentityType

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

Name Type Description
None
  • string
SystemAssigned
  • string
SystemAssigned,UserAssigned
  • string
UserAssigned
  • string

PrincipalType

Tipo principal do administrador de sever.

Name Type Description
Application
  • string
Group
  • string
User
  • string

PrivateEndpointConnectionProperties

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

Name Type Description
groupIds
  • string[]

IDs de grupo.

privateEndpoint

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

privateLinkServiceConnectionState

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

provisioningState

Estado da conexão de ponto de extremidade privado.

PrivateEndpointProperty

Name Type Description
id
  • string

ID do recurso do ponto de extremidade privado.

PrivateEndpointProvisioningState

Estado da conexão de ponto de extremidade privado.

Name Type 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.

Name Type Description
None
  • string

PrivateLinkServiceConnectionStateProperty

Name Type Description
actionsRequired

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

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

PrivateLinkServiceConnectionStateStatus

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

Name Type Description
Approved
  • string
Disconnected
  • string
Pending
  • string
Rejected
  • string

ResourceIdentity

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

Name Type Description
principalId
  • string

A Azure Active Directory id da entidade de segurança.

tenantId
  • string

O Azure Active Directory id do locatário.

type

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

userAssignedIdentities

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

Server

Um servidor Banco de Dados SQL do Azure.

Name Type Description
id
  • string

ID do recurso.

identity

A identidade Azure Active Directory do servidor.

kind
  • string

Tipo de sql server. Esses são metadados usados para a experiência 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

O administrador 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 do 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 de recurso de uma identidade atribuída pelo usuário a ser usada por padrão.

properties.privateEndpointConnections

Lista de conexões de ponto de extremidade privado em um servidor

properties.publicNetworkAccess

Se o acesso de 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

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

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.

Name Type Description
administratorType

Tipo do administrador de sever.

azureADOnlyAuthentication
  • boolean

Azure Active Directory somente autenticação habilitada.

login
  • string

Nome de logon do administrador do servidor.

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 de ponto de extremidade público é permitido ou não para este servidor. O valor é opcional, mas, se passado, deve ser 'Habilitado' ou 'Desabilitado'

Name Type Description
Disabled
  • string
Enabled
  • string

ServerPrivateEndpointConnection

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

Name Type Description
id
  • string

ID do recurso.

properties

Propriedades de conexão de ponto de extremidade privado

ServerUpdate

Uma solicitação de atualização para um servidor Banco de Dados SQL do Azure.

Name Type Description
identity

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

O administrador 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 do 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 de recurso de uma identidade atribuída pelo usuário a ser usada por padrão.

properties.privateEndpointConnections

Lista de conexões de ponto de extremidade privado em um servidor

properties.publicNetworkAccess

Se o acesso de 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

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

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

Name Type Description
Connected
  • string
Disconnected
  • string

UserIdentity

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

Name Type Description
clientId
  • string

A ID do cliente Azure Active Directory.

principalId
  • string

A Azure Active Directory id da entidade de segurança.