Servers - Update

Actualiza un servidor.

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

Parámetros de identificador URI

Nombre En Requerido Tipo Description
resourceGroupName
path True

string

Nombre del grupo de recursos que contiene el recurso. Puede obtener este valor en la API del Administrador de recursos o el portal de Azure.

serverName
path True

string

El nombre del servidor.

subscriptionId
path True

string

El id. de suscripción que identifica una suscripción de Azure.

api-version
query True

string

La versión de API que se usará para la solicitud.

Cuerpo de la solicitud

Nombre Tipo Description
identity

ResourceIdentity

Identidad del servidor

properties.administratorLogin

string

Nombre de usuario del administrador para el servidor. Una vez creado, no se puede cambiar.

properties.administratorLoginPassword

string

Contraseña de inicio de sesión del administrador (necesaria para la creación del servidor).

properties.administrators

ServerExternalAdministrator

Administrador de Azure Active Directory del servidor.

properties.federatedClientId

string

El identificador de cliente que se usa para el escenario de CMK entre inquilinos

properties.keyId

string

URI de CMK de la clave que se va a usar para el cifrado.

properties.minimalTlsVersion

string

Versión mínima de TLS. Valores permitidos: '1.0', '1.1', '1.2'

properties.primaryUserAssignedIdentityId

string

Identificador de recurso de una identidad asignada por el usuario que se va a usar de forma predeterminada.

properties.publicNetworkAccess

ServerNetworkAccessFlag

Si se permite o no el acceso al punto de conexión público para este servidor. El valor es opcional, pero si se pasa, debe ser "Habilitado" o "Deshabilitado".

properties.restrictOutboundNetworkAccess

ServerNetworkAccessFlag

Si se va a restringir o no el acceso de red saliente a este servidor. El valor es opcional, pero si se pasa, debe ser "Habilitado" o "Deshabilitado".

properties.version

string

Versión del servidor.

tags

object

Etiquetas del recurso.

Respuestas

Nombre Tipo Description
200 OK

Server

Se actualizó correctamente el servidor.

202 Accepted

Aceptado

Other Status Codes

Respuestas de error: ***

  • 400 MissingIdentityId: no se proporciona ninguna identidad asignada por el usuario cuando el tipo de identidad está establecido en UserAssigned

  • 400 InvalidPrimaryIdentityId: el usuario proporciona un valor para PrimaryUserIdentityId, pero el mismo no aparece en el parámetro IdentityId.

  • 400 PECsNotExistingToDenyPublicNetworkAccess: no se puede establecer Denegar el acceso a la red pública en Sí, ya que no hay ningún punto de conexión privado habilitado para acceder al servidor. Configure puntos de conexión privados y vuelva a intentar la operación (https://docs.microsoft.com/azure/sql-database/sql-database-private-endpoint-overview#how-to-set-up-private-link-for-azure-sql-database).

  • 400 NameAlreadyExists: el nombre proporcionado ya existe.

  • 400 UmiMissingAkvPermissions: PrimaryUserAssignedIdentityId proporcionado por el usuario no tiene acceso a KeyId proporcionado

  • 400 MissingPrimaryIdentity: PrimaryUserAssignedIdentityId proporcionado por el usuario no tiene acceso a KeyId proporcionado.

  • 400 ProvisioningDisabled: muestra el mensaje de error del autorizador de operaciones de recursos tal y como está, sin cambios

  • 400 PrimaryIdentityMissingPermissionForKeyId: el usuario proporciona KeyId durante la creación, pero PrimaryUserAssignedIdentityId no se proporciona en la llamada API.

  • 400 InvalidIdentityTypeForKeyId: el usuario proporciona KeyId durante la creación, pero el tipo de identidad no está establecido en "UserAssigned".

  • 400 InvalidLoginName: el nombre de inicio de sesión proporcionado no es válido.

  • 400 InvalidUsername: el nombre de usuario proporcionado contiene caracteres no válidos.

  • 400 Ipv6FeatureNotEnabled: el usuario intentó activar la compatibilidad con Ipv6 en el servidor sin habilitar la marca de características en la suscripción o la compatibilidad con características está deshabilitada actualmente en la región.

  • 400 PasswordTooShort: la contraseña proporcionada es demasiado corta.

  • 400 AadOnlyAuthenticationIsEnabled: la autenticación solo de Azure Active Directory está habilitada. Póngase en contacto con el administrador del sistema.

  • 400 RegionDoesNotSupportVersion: un usuario intentó crear un servidor de una versión especificada en una ubicación donde no se admite esa versión del servidor.

  • 400 PasswordTooLong: la contraseña proporcionada es demasiado larga.

  • 400 PasswordNotComplex: la contraseña proporcionada no es lo suficientemente compleja.

  • 400 InvalidParameterValue: se ha dado un valor no válido a un parámetro.

  • 400 InvalidLocation: se especificó una ubicación no válida.

  • 400 InvalidServerName: nombre de servidor no válido especificado.

  • 400 InvalidIdentifier: el identificador contiene NULL o un carácter unicode no válido.

  • 400 TokenTooLong: el token proporcionado es demasiado largo.

  • 400 RegionDoesNotAllowProvisioning: la ubicación seleccionada no acepta nuevos servidores de Windows Azure SQL Database. Esto puede cambiar más adelante.

  • 400 ServerNotFound: no se encontró el servidor solicitado.

  • 400 InvalidMinimalTlsVersion: versión mínima de TLS no válida.

  • 400 InvalidExternalAdministratorLogin: nombre de inicio de sesión de administrador externo no válido o que falta.

  • 400 InvalidExternalAdministratorSid: identificador de objeto de administrador externo no válido o que falta.

  • 400 InvalidExternalAdministratorTenantId: identificador de inquilino de administrador externo no válido o que falta.

  • 400 ExternalAdministratorPrincipalType: tipo principal de administrador externo no válido o que falta. Seleccione usuario, aplicación o grupo.

  • 400 MissingExternalAdministratorWithAadOnlyAuth: para usar la autenticación solo de Azure AD, proporcione detalles de un administrador externo.

  • 400 ExternalAdministratorLoginSameAsSqlAdmin: los nombres del administrador de Azure Active Directory y de la cuenta de administrador del servidor deben ser diferentes. Proporcione valores diferentes.

  • 404 SubscriptionDoesNotHaveServer: no se encontró el servidor solicitado.

  • 404 ServerNotInSubscriptionResourceGroup: el servidor especificado no existe en el grupo de recursos y la suscripción especificados.

  • 404 OperationIdNotFound: la operación con id. no existe.

  • 404 SubscriptionNotFound: no se encontró la suscripción solicitada.

  • 409 OperationCancelled: el usuario canceló la operación.

  • 409 OperationInterrupted: no se pudo completar la operación en el recurso porque se interrumpió por otra operación en el mismo recurso.

  • 409 UpsertLogicalServerRequestAlreadyInProgress: una solicitud de servidor lógico en curso ya está en curso, vuelva a intentar la solicitud más tarde.

  • 409 ServerDisabled: el servidor está deshabilitado.

  • 409 ConflictingServerOperation: una operación está actualmente en curso para el servidor.

  • 409 SubscriptionDisabled: la suscripción está deshabilitada.

  • 409 ServerQuotaExceeded: el servidor no se puede agregar a una suscripción porque superará la cuota.

  • 409 ServerAlreadyExists: nombre de servidor duplicado.

  • 429 SuscripciónTooManyCreateUpdateRequests: solicitudes más allá del número máximo de solicitudes que pueden procesar los recursos disponibles.

  • 429 SubscriptionTooManyRequests: solicitudes más allá del número máximo de solicitudes que pueden procesar los recursos disponibles.

  • 429 SuscripciónTooManyCreateUpdateRequests: solicitudes más allá del número máximo de solicitudes que pueden procesar los recursos disponibles.

  • 429 SubscriptionTooManyRequests: solicitudes más allá del número máximo de solicitudes que pueden procesar los recursos disponibles.

  • 429 ConflictingSubscriptionOperation: una operación está actualmente en curso para la suscripción.

  • 500 OperationTimedOut: se agota el tiempo de espera de la operación y se revierte automáticamente. Vuelva a intentar la operación y,

  • 503 TooManyRequests: solicitudes más allá del número máximo de solicitudes que se pueden procesar mediante recursos disponibles.

  • 503 TooManyRequests: solicitudes más allá del número máximo de solicitudes que se pueden procesar mediante recursos disponibles.

Ejemplos

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-11-01

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

Definiciones

Nombre Description
AdministratorType

Tipo del administrador del servidor.

IdentityType

Tipo de identidad. Establézcalo en "SystemAssigned" para crear y asignar automáticamente una entidad de seguridad de Azure Active Directory para el recurso.

PrincipalType

Tipo principal del administrador del servidor.

PrivateEndpointConnectionProperties

Propiedades de una conexión de punto de conexión privado.

PrivateEndpointProperty
PrivateEndpointProvisioningState

Estado de la conexión de punto de conexión privado.

PrivateLinkServiceConnectionStateActionsRequire

Las acciones necesarias para la conexión del servicio Private Link.

PrivateLinkServiceConnectionStateProperty
PrivateLinkServiceConnectionStateStatus

Estado de conexión del servicio Private Link.

ResourceIdentity

Configuración de identidad de Azure Active Directory para un recurso.

Server

Un servidor de base de datos Azure SQL.

ServerExternalAdministrator

Propiedades de un administrador de Active Directory.

ServerNetworkAccessFlag

Si se permite o no el acceso al punto de conexión público para este servidor. El valor es opcional, pero si se pasa, debe ser "Habilitado" o "Deshabilitado".

ServerPrivateEndpointConnection

Una conexión de punto de conexión privado en un servidor

ServerUpdate

Solicitud de actualización de un servidor de base de datos de Azure SQL.

ServerWorkspaceFeature

Si el servidor existente tiene o no un área de trabajo creada y si permite la conexión desde el área de trabajo

UserIdentity

Configuración de identidad de Azure Active Directory para un recurso.

AdministratorType

Tipo del administrador del servidor.

Nombre Tipo Description
ActiveDirectory

string

IdentityType

Tipo de identidad. Establézcalo en "SystemAssigned" para crear y asignar automáticamente una entidad de seguridad de Azure Active Directory para el recurso.

Nombre Tipo Description
None

string

SystemAssigned

string

SystemAssigned,UserAssigned

string

UserAssigned

string

PrincipalType

Tipo principal del administrador del servidor.

Nombre Tipo Description
Application

string

Group

string

User

string

PrivateEndpointConnectionProperties

Propiedades de una conexión de punto de conexión privado.

Nombre Tipo Description
groupIds

string[]

Identificadores de grupo.

privateEndpoint

PrivateEndpointProperty

Punto de conexión privado al que pertenece la conexión.

privateLinkServiceConnectionState

PrivateLinkServiceConnectionStateProperty

Estado de conexión de la conexión del punto de conexión privado.

provisioningState

PrivateEndpointProvisioningState

Estado de la conexión de punto de conexión privado.

PrivateEndpointProperty

Nombre Tipo Description
id

string

Identificador de recurso del punto de conexión privado.

PrivateEndpointProvisioningState

Estado de la conexión de punto de conexión privado.

Nombre Tipo Description
Approving

string

Dropping

string

Failed

string

Ready

string

Rejecting

string

PrivateLinkServiceConnectionStateActionsRequire

Las acciones necesarias para la conexión del servicio Private Link.

Nombre Tipo Description
None

string

PrivateLinkServiceConnectionStateProperty

Nombre Tipo Description
actionsRequired

PrivateLinkServiceConnectionStateActionsRequire

Las acciones necesarias para la conexión del servicio Private Link.

description

string

Descripción de la conexión del servicio private link.

status

PrivateLinkServiceConnectionStateStatus

Estado de conexión del servicio Private Link.

PrivateLinkServiceConnectionStateStatus

Estado de conexión del servicio Private Link.

Nombre Tipo Description
Approved

string

Disconnected

string

Pending

string

Rejected

string

ResourceIdentity

Configuración de identidad de Azure Active Directory para un recurso.

Nombre Tipo Description
principalId

string

Identificador de entidad de seguridad de Azure Active Directory.

tenantId

string

Identificador de inquilino de Azure Active Directory.

type

IdentityType

Tipo de identidad. Establézcalo en "SystemAssigned" para crear y asignar automáticamente una entidad de seguridad de Azure Active Directory para el recurso.

userAssignedIdentities

<string,  UserIdentity>

Identificadores de recurso de las identidades asignadas por el usuario que se van a usar

Server

Un servidor de base de datos Azure SQL.

Nombre Tipo Description
id

string

Identificador del recurso.

identity

ResourceIdentity

Identidad de Azure Active Directory del servidor.

kind

string

Tipo de sql Server. Estos son los metadatos que se usan para la experiencia de Azure Portal.

location

string

Ubicación del recurso

name

string

Nombre del recurso.

properties.administratorLogin

string

Nombre de usuario del administrador para el servidor. Una vez creado, no se puede cambiar.

properties.administratorLoginPassword

string

Contraseña de inicio de sesión del administrador (necesaria para la creación del servidor).

properties.administrators

ServerExternalAdministrator

Administrador de Azure Active Directory del servidor.

properties.federatedClientId

string

El identificador de cliente que se usa para el escenario de CMK entre inquilinos

properties.fullyQualifiedDomainName

string

Nombre de dominio completo del servidor.

properties.keyId

string

URI de CMK de la clave que se va a usar para el cifrado.

properties.minimalTlsVersion

string

Versión mínima de TLS. Valores permitidos: '1.0', '1.1', '1.2'

properties.primaryUserAssignedIdentityId

string

Identificador de recurso de una identidad asignada por el usuario que se va a usar de forma predeterminada.

properties.privateEndpointConnections

ServerPrivateEndpointConnection[]

Lista de conexiones de punto de conexión privado en un servidor

properties.publicNetworkAccess

ServerNetworkAccessFlag

Si se permite o no el acceso al punto de conexión público para este servidor. El valor es opcional, pero si se pasa, debe ser "Habilitado" o "Deshabilitado".

properties.restrictOutboundNetworkAccess

ServerNetworkAccessFlag

Si se va a restringir o no el acceso de red saliente para este servidor. El valor es opcional, pero si se pasa, debe ser "Habilitado" o "Deshabilitado".

properties.state

string

Estado del servidor.

properties.version

string

Versión del servidor.

properties.workspaceFeature

ServerWorkspaceFeature

Si el servidor existente tiene o no un área de trabajo creada y si permite la conexión desde el área de trabajo

tags

object

Etiquetas del recurso.

type

string

Tipo de recurso.

ServerExternalAdministrator

Propiedades de un administrador de Active Directory.

Nombre Tipo Description
administratorType

AdministratorType

Tipo del administrador del servidor.

azureADOnlyAuthentication

boolean

Autenticación solo de Azure Active Directory habilitada.

login

string

Nombre de inicio de sesión del administrador del servidor.

principalType

PrincipalType

Tipo principal del administrador del servidor.

sid

string

SID (id. de objeto) del administrador del servidor.

tenantId

string

Id. de inquilino del administrador.

ServerNetworkAccessFlag

Si se permite o no el acceso al punto de conexión público para este servidor. El valor es opcional, pero si se pasa, debe ser "Habilitado" o "Deshabilitado".

Nombre Tipo Description
Disabled

string

Enabled

string

ServerPrivateEndpointConnection

Una conexión de punto de conexión privado en un servidor

Nombre Tipo Description
id

string

Identificador del recurso.

properties

PrivateEndpointConnectionProperties

Propiedades de conexión de punto de conexión privado

ServerUpdate

Solicitud de actualización de un servidor de base de datos de Azure SQL.

Nombre Tipo Description
identity

ResourceIdentity

Identidad del servidor

properties.administratorLogin

string

Nombre de usuario del administrador para el servidor. Una vez creado, no se puede cambiar.

properties.administratorLoginPassword

string

Contraseña de inicio de sesión del administrador (necesaria para la creación del servidor).

properties.administrators

ServerExternalAdministrator

Administrador de Azure Active Directory del servidor.

properties.federatedClientId

string

El identificador de cliente que se usa para el escenario de CMK entre inquilinos

properties.fullyQualifiedDomainName

string

Nombre de dominio completo del servidor.

properties.keyId

string

URI de CMK de la clave que se va a usar para el cifrado.

properties.minimalTlsVersion

string

Versión mínima de TLS. Valores permitidos: '1.0', '1.1', '1.2'

properties.primaryUserAssignedIdentityId

string

Identificador de recurso de una identidad asignada por el usuario que se va a usar de forma predeterminada.

properties.privateEndpointConnections

ServerPrivateEndpointConnection[]

Lista de conexiones de punto de conexión privado en un servidor

properties.publicNetworkAccess

ServerNetworkAccessFlag

Si se permite o no el acceso al punto de conexión público para este servidor. El valor es opcional, pero si se pasa, debe ser "Habilitado" o "Deshabilitado".

properties.restrictOutboundNetworkAccess

ServerNetworkAccessFlag

Si se va a restringir o no el acceso de red saliente para este servidor. El valor es opcional, pero si se pasa, debe ser "Habilitado" o "Deshabilitado".

properties.state

string

Estado del servidor.

properties.version

string

Versión del servidor.

properties.workspaceFeature

ServerWorkspaceFeature

Si el servidor existente tiene o no un área de trabajo creada y si permite la conexión desde el área de trabajo

tags

object

Etiquetas del recurso.

ServerWorkspaceFeature

Si el servidor existente tiene o no un área de trabajo creada y si permite la conexión desde el área de trabajo

Nombre Tipo Description
Connected

string

Disconnected

string

UserIdentity

Configuración de identidad de Azure Active Directory para un recurso.

Nombre Tipo Description
clientId

string

Identificador de cliente de Azure Active Directory.

principalId

string

Identificador de entidad de seguridad de Azure Active Directory.