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 |
---|---|---|---|---|
resource
|
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. |
server
|
path | True |
string |
El nombre del servidor. |
subscription
|
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 |
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 |
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 |
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 |
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 |
Se actualizó correctamente el servidor. |
|
202 Accepted |
Aceptado |
|
Other Status Codes |
Respuestas de error: ***
|
Ejemplos
Update a server
Solicitud de ejemplo
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"
}
}
Respuesta de muestra
{
"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 |
---|---|
Administrator |
Tipo del administrador del servidor. |
Identity |
Tipo de identidad. Establézcalo en "SystemAssigned" para crear y asignar automáticamente una entidad de seguridad de Azure Active Directory para el recurso. |
Principal |
Tipo principal del administrador del servidor. |
Private |
Propiedades de una conexión de punto de conexión privado. |
Private |
|
Private |
Estado de la conexión de punto de conexión privado. |
Private |
Las acciones necesarias para la conexión del servicio Private Link. |
Private |
|
Private |
Estado de conexión del servicio Private Link. |
Resource |
Configuración de identidad de Azure Active Directory para un recurso. |
Server |
Un servidor de base de datos Azure SQL. |
Server |
Propiedades de un administrador de Active Directory. |
Server |
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". |
Server |
Una conexión de punto de conexión privado en un servidor |
Server |
Solicitud de actualización de un servidor de base de datos de Azure SQL. |
Server |
Si el servidor existente tiene o no un área de trabajo creada y si permite la conexión desde el área de trabajo |
User |
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 |
Punto de conexión privado al que pertenece la conexión. |
|
privateLinkServiceConnectionState |
Estado de conexión de la conexión del punto de conexión privado. |
|
provisioningState |
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 |
Las acciones necesarias para la conexión del servicio Private Link. |
|
description |
string |
Descripción de la conexión del servicio private link. |
status |
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 |
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,
User |
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 |
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 |
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 |
Lista de conexiones de punto de conexión privado en un servidor |
|
properties.publicNetworkAccess |
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 |
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 |
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 |
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 |
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 |
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 |
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 |
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 |
Lista de conexiones de punto de conexión privado en un servidor |
|
properties.publicNetworkAccess |
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 |
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 |
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. |