Servers - Create Or Update

Referência

Service:: SQL Database

API Version:: 2021-11-01

Cria ou atualiza um servidor.

PUT 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	Obrigatório	Tipo	Description
location	True	string	Local do recurso.
identity		ResourceIdentity	A identidade do Azure Active Directory 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 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

Nome	Tipo	Description
200 OK	Server	O servidor foi atualizado com êxito.
201 Created	Server	O servidor foi criado 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 Provisionamento Desabilitado – 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 é 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. 400 PasswordTooShort - A senha fornecida é muito curta 400 AadOnlyAuthenticationIsEnabled – 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 do 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á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. 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 contínua já está em andamento, tente sua solicitação novamente mais tarde. 409 Servidor Desabilitado – 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 das solicitações máximas 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 SubscriptionTooManyCreateUpdateRequests – Solicitações além das solicitações máximas 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. 503 TooManyRequests – Solicitações além das solicitações máximas que podem ser processadas por recursos disponíveis.

Exemplos

Create server

PUT 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",
    "administrators": {
      "principalType": "User",
      "login": "bob@contoso.com",
      "sid": "00000011-1111-2222-2222-123456789111",
      "tenantId": "00000011-1111-2222-2222-123456789111",
      "azureADOnlyAuthentication": true
    },
    "publicNetworkAccess": "Enabled",
    "restrictOutboundNetworkAccess": "Enabled"
  },
  "location": "Japan East"
}


import com.azure.core.util.Context;
import com.azure.resourcemanager.sql.fluent.models.ServerInner;
import com.azure.resourcemanager.sql.models.PrincipalType;
import com.azure.resourcemanager.sql.models.ServerExternalAdministrator;
import com.azure.resourcemanager.sql.models.ServerNetworkAccessFlag;
import java.util.UUID;

/** Samples for Servers CreateOrUpdate. */
public final class Main {
    /*
     * x-ms-original-file: specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/ServerCreate.json
     */
    /**
     * Sample code: Create server.
     *
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void createServer(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getServers().createOrUpdate("sqlcrudtest-7398", "sqlcrudtest-4645",
            new ServerInner().withLocation("Japan East").withAdministratorLogin("dummylogin")
                .withAdministratorLoginPassword("fakeTokenPlaceholder")
                .withPublicNetworkAccess(ServerNetworkAccessFlag.ENABLED)
                .withAdministrators(new ServerExternalAdministrator().withPrincipalType(PrincipalType.USER)
                    .withLogin("bob@contoso.com").withSid(UUID.fromString("00000011-1111-2222-2222-123456789111"))
                    .withTenantId(UUID.fromString("00000011-1111-2222-2222-123456789111"))
                    .withAzureADOnlyAuthentication(true))
                .withRestrictOutboundNetworkAccess(ServerNetworkAccessFlag.ENABLED),
            Context.NONE);
    }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Sample Response

Status code:: 200

{
  "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": "Enabled",
    "restrictOutboundNetworkAccess": "Enabled",
    "administrators": {
      "principalType": "User",
      "login": "bob@contoso.com",
      "sid": "00000011-1111-2222-2222-123456789111",
      "tenantId": "00000011-1111-2222-2222-123456789111",
      "azureADOnlyAuthentication": true
    },
    "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"
          }
        }
      }
    ]
  }
}

Status code:: 201

{
  "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",
    "publicNetworkAccess": "Enabled",
    "restrictOutboundNetworkAccess": "Enabled",
    "version": "12.0",
    "state": "Ready",
    "administrators": {
      "principalType": "User",
      "login": "bob@contoso.com",
      "sid": "00000011-1111-2222-2222-123456789111",
      "tenantId": "00000011-1111-2222-2222-123456789111",
      "azureADOnlyAuthentication": true
    },
    "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"
          }
        }
      }
    ]
  }
}

Status code:: 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
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

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