Servers - Update

Tjänst:

SQL Database

API-version:

2021-11-01

Uppdateringar en server.

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

URI-parametrar

Name	I	Obligatorisk	Typ	Description
resourceGroupName	path	True	string	Namnet på resursgruppen som innehåller resursen. Du kan hämta det här värdet från Azure Resource Manager-API:et eller portalen.
serverName	path	True	string	Namnet på servern.
subscriptionId	path	True	string	Det prenumerations-ID som identifierar en Azure-prenumeration.
api-version	query	True	string	DEN API-version som ska användas för begäran.

Begärandetext

Name	Typ	Description
identity	ResourceIdentity	Serveridentitet
properties.administratorLogin	string	Administratörsanvändarnamn för servern. När den har skapats kan den inte ändras.
properties.administratorLoginPassword	string	Administratörens inloggningslösenord (krävs för att skapa servern).
properties.administrators	ServerExternalAdministrator	Azure Active Directory-administratören för servern.
properties.federatedClientId	string	Klient-ID:t som används för cmk-scenario mellan klientorganisationer
properties.keyId	string	En CMK-URI för nyckeln som ska användas för kryptering.
properties.minimalTlsVersion	string	Minimal TLS-version. Tillåtna värden: "1.0", "1.1", "1.2"
properties.primaryUserAssignedIdentityId	string	Resurs-ID för en användartilldelad identitet som ska användas som standard.
properties.publicNetworkAccess	ServerNetworkAccessFlag	Om offentlig slutpunktsåtkomst tillåts för den här servern eller inte. Värdet är valfritt, men om det skickas måste det vara Aktiverat eller Inaktiverat
properties.restrictOutboundNetworkAccess	ServerNetworkAccessFlag	Om du vill begränsa utgående nätverksåtkomst för den här servern eller inte. Värdet är valfritt, men om det skickas måste det vara Aktiverat eller Inaktiverat
properties.version	string	Serverns version.
tags	object	Resurstaggar.

Svar

Name	Typ	Description
200 OK	Server	Servern har uppdaterats.
202 Accepted		Har godkänts
Other Status Codes		Felsvar: *** 400 MissingIdentityId – Ingen användartilldelad identitet anges när identitetstypen är inställd på UserAssigned 400 InvalidPrimaryIdentityId – Användaren anger ett värde för PrimaryUserIdentityId men samma värde visas inte i parametern IdentityId 400 PECsNotExistingToDenyPublicNetworkAccess – Det går inte att ange Neka åtkomst till offentligt nätverk till Ja eftersom det inte finns någon privat slutpunkt aktiverad för åtkomst till servern. Konfigurera privata slutpunkter och försök igen (https://docs.microsoft.com/azure/sql-database/sql-database-private-endpoint-overview#how-to-set-up-private-link-for-azure-sql-database). 400 NameAlreadyExists – Det angivna namnet finns redan. 400 UmiMissingAkvPermissions – PrimaryUserAssignedIdentityId som tillhandahålls av användaren har inte åtkomst till KeyId 400 MissingPrimaryIdentity – PrimaryUserAssignedIdentityId som tillhandahålls av användaren har inte åtkomst till KeyId 400 ProvisioningDisabled – visar felmeddelandet från resursåtgärden authorizer som den är, utan ändringar 400 PrimaryIdentityMissingPermissionForKeyId – KeyId tillhandahålls av användaren under skapande men PrimaryUserAssignedIdentityId anges inte i API-anropet 400 InvalidIdentityTypeForKeyId – KeyId tillhandahålls av användaren under skapande men identitetstypen är inte inställd på "UserAssigned" 400 InvalidLoginName – det angivna inloggningsnamnet är ogiltigt. 400 InvalidUsername – Angivet användarnamn innehåller ogiltiga tecken. 400 Ipv6FeatureNotEnabled – Användaren försökte aktivera Ipv6-stöd på servern utan att aktivera funktionsflaggan för prenumerationen, eller så är funktionsstödet för närvarande inaktiverat i regionen. 400 PasswordTooShort – Det angivna lösenordet är för kort 400 AadOnlyAuthenticationIsEnabled – Endast Azure Active Directory-autentisering är aktiverat. Kontakta systemadministratören. 400 RegionDoesNotSupportVersion – En användare försökte skapa en server med en angiven version på en plats där serverversionen inte stöds. 400 PasswordTooLong – Det angivna lösenordet är för långt. 400 PasswordNotComplex – Det angivna lösenordet är inte tillräckligt komplext. 400 InvalidParameterValue – ett ogiltigt värde angavs för en parameter. 400 InvalidLocation – en ogiltig plats har angetts. 400 InvalidServerName – Ogiltigt servernamn har angetts. 400 InvalidIdentifier – identifieraren innehåller NULL eller ett ogiltigt unicode-tecken. 400 TokenTooLong – den angivna token är för lång. 400 RegionDoesNotAllowProvisioning – Den valda platsen accepterar inte nya Windows Azure SQL Database-servrar. Detta kan ändras vid ett senare tillfälle. 400 ServerNotFound – Den begärda servern hittades inte. 400 InvalidMinimalTlsVersion – Ogiltig minimal TLS-version. 400 InvalidExternalAdministratorLogin – Ogiltigt eller saknat inloggningsnamn för extern administratör. 400 InvalidExternalAdministratorSid – Ogiltigt eller saknat objekt-ID för extern administratör. 400 InvalidExternalAdministratorTenantId – Ogiltigt eller saknat klientorganisations-ID för extern administratör. 400 ExternalAdministratorPrincipalType – Ogiltig eller saknad extern administratörshuvudnamnstyp. Välj från Användare, Program eller Grupp. 400 MissingExternalAdministratorWithAadOnlyAuth – Ange information om en extern administratör för att kunna använda Azure AD endast autentisering. 400 ExternalAdministratorLoginSameAsSqlAdmin – Namnen på Azure Active Directory-administratören och för serveradministratörskontot måste vara olika. Ange olika värden. 404 SubscriptionDoesNotHaveServer – Den begärda servern hittades inte 404 ServerNotInSubscriptionResourceGroup – Den angivna servern finns inte i den angivna resursgruppen och prenumerationen. 404 OperationIdNotFound – åtgärden med ID finns inte. 404 SubscriptionNotFound – Det gick inte att hitta den begärda prenumerationen. 409 OperationCancelled – Åtgärden har avbrutits av användaren. 409 OperationInterrupted – Det gick inte att slutföra åtgärden på resursen eftersom den avbröts av en annan åtgärd på samma resurs. 409 UpsertLogicalServerRequestAlreadyInProgress – En pågående logisk serverbegäran pågår redan. Försök igen senare. 409 ServerDisabled – Servern är inaktiverad. 409 ConflictingServerOperation – en åtgärd pågår för närvarande för servern. 409 SubscriptionDisabled – Prenumerationen är inaktiverad. 409 ServerQuotaExceeded – Servern kan inte läggas till i en prenumeration eftersom den överskrider kvoten. 409 ServerAlreadyExists – Duplicerat servernamn. 429 SubscriptionTooManyCreateUpdateRequests – begäranden utöver maximalt antal begäranden som kan bearbetas av tillgängliga resurser. 429 SubscriptionTooManyRequests – begäranden utöver maximalt antal begäranden som kan bearbetas av tillgängliga resurser. 429 SubscriptionTooManyCreateUpdateRequests – begäranden utöver maximalt antal begäranden som kan bearbetas av tillgängliga resurser. 429 SubscriptionTooManyRequests – begäranden utöver maximalt antal begäranden som kan bearbetas av tillgängliga resurser. 429 ConflictingSubscriptionOperation – en åtgärd pågår för närvarande för prenumerationen. 500 OperationTimedOut – Tidsgränsen för åtgärden uppnåddes och återställdes automatiskt. Försök att utföra åtgärden igen. 503 TooManyRequests – begäranden utöver maximalt antal begäranden som kan bearbetas av tillgängliga resurser. 503 TooManyRequests – begäranden utöver maximalt antal begäranden som kan bearbetas av tillgängliga resurser.

Exempel

Update a server

Exempelbegäran

HTTP

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

Java

import com.azure.resourcemanager.sql.models.ServerNetworkAccessFlag;
import com.azure.resourcemanager.sql.models.ServerUpdate;

/**
 * Samples for Servers Update.
 */
public final class Main {
    /*
     * x-ms-original-file: specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/ServerUpdate.json
     */
    /**
     * Sample code: Update a server.
     * 
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void updateAServer(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getServers().update("sqlcrudtest-7398", "sqlcrudtest-4645",
            new ServerUpdate().withAdministratorLogin("dummylogin")
                .withAdministratorLoginPassword("fakeTokenPlaceholder")
                .withPublicNetworkAccess(ServerNetworkAccessFlag.DISABLED)
                .withRestrictOutboundNetworkAccess(ServerNetworkAccessFlag.ENABLED),
            com.azure.core.util.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

Exempelsvar

Statuskod:

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

Statuskod:

202

Definitioner

Name	Description
AdministratorType	Typ av serveradministratör.
IdentityType	Identitetstypen. Ange "SystemAssigned" (SystemAssigned) för att automatiskt skapa och tilldela ett Azure Active Directory-huvudnamn för resursen.
PrincipalType	Huvudtyp för serveradministratören.
PrivateEndpointConnectionProperties	Egenskaper för en privat slutpunktsanslutning.
PrivateEndpointProperty
PrivateEndpointProvisioningState	Tillstånd för den privata slutpunktsanslutningen.
PrivateLinkServiceConnectionStateActionsRequire	De åtgärder som krävs för privat länktjänstanslutning.
PrivateLinkServiceConnectionStateProperty
PrivateLinkServiceConnectionStateStatus	Anslutningsstatus för tjänsten Private Link.
ResourceIdentity	Azure Active Directory-identitetskonfiguration för en resurs.
Server	En Azure SQL Database-server.
ServerExternalAdministrator	Egenskaper för en Active Directory-administratör.
ServerNetworkAccessFlag	Om offentlig slutpunktsåtkomst tillåts för den här servern eller inte. Värdet är valfritt, men om det skickas måste det vara Aktiverat eller Inaktiverat
ServerPrivateEndpointConnection	En privat slutpunktsanslutning under en server
ServerUpdate	En uppdateringsbegäran för en Azure SQL Database-server.
ServerWorkspaceFeature	Om en befintlig server har en arbetsyta skapad eller inte och om den tillåter anslutning från arbetsytan
UserIdentity	Azure Active Directory-identitetskonfiguration för en resurs.

AdministratorType

Uppräkning

Typ av serveradministratör.

Värde	Description
ActiveDirectory

IdentityType

Uppräkning

Identitetstypen. Ange "SystemAssigned" (SystemAssigned) för att automatiskt skapa och tilldela ett Azure Active Directory-huvudnamn för resursen.

Värde	Description
None
SystemAssigned
SystemAssigned,UserAssigned
UserAssigned

PrincipalType

Uppräkning

Huvudtyp för serveradministratören.

Värde	Description
Application
Group
User

PrivateEndpointConnectionProperties

Objekt

Egenskaper för en privat slutpunktsanslutning.

Name	Typ	Description
groupIds	string[]	Grupp-ID:t.
privateEndpoint	PrivateEndpointProperty	Privat slutpunkt som anslutningen tillhör.
privateLinkServiceConnectionState	PrivateLinkServiceConnectionStateProperty	Anslutningstillstånd för den privata slutpunktsanslutningen.
provisioningState	PrivateEndpointProvisioningState	Tillstånd för den privata slutpunktsanslutningen.

PrivateEndpointProperty

Objekt

Name	Typ	Description
id	string	Resurs-ID för den privata slutpunkten.

PrivateEndpointProvisioningState

Uppräkning

Tillstånd för den privata slutpunktsanslutningen.

Värde	Description
Approving
Dropping
Failed
Ready
Rejecting

PrivateLinkServiceConnectionStateActionsRequire

Uppräkning

De åtgärder som krävs för privat länktjänstanslutning.

Värde	Description
None

PrivateLinkServiceConnectionStateProperty

Objekt

Name	Typ	Description
actionsRequired	PrivateLinkServiceConnectionStateActionsRequire	De åtgärder som krävs för privat länktjänstanslutning.
description	string	Beskrivning av tjänstanslutningen för privat länk.
status	PrivateLinkServiceConnectionStateStatus	Anslutningsstatus för tjänsten Private Link.

PrivateLinkServiceConnectionStateStatus

Uppräkning

Anslutningsstatus för tjänsten Private Link.

Värde	Description
Approved
Disconnected
Pending
Rejected

ResourceIdentity

Objekt

Azure Active Directory-identitetskonfiguration för en resurs.

Name	Typ	Description
principalId	string	Huvud-ID:t för Azure Active Directory.
tenantId	string	Klient-ID:t för Azure Active Directory.
type	IdentityType	Identitetstypen. Ange "SystemAssigned" (SystemAssigned) för att automatiskt skapa och tilldela ett Azure Active Directory-huvudnamn för resursen.
userAssignedIdentities	<string,  UserIdentity>	Resurs-ID:n för de användartilldelade identiteter som ska användas

Server

Objekt

En Azure SQL Database-server.

Name	Typ	Description
id	string	Resurs-ID.
identity	ResourceIdentity	Azure Active Directory-identiteten för servern.
kind	string	Typ av SQL-server. Det här är metadata som används för Azure Portal upplevelse.
location	string	Resursplats.
name	string	Resursnamn.
properties.administratorLogin	string	Administratörsanvändarnamn för servern. När den har skapats kan den inte ändras.
properties.administratorLoginPassword	string	Administratörens inloggningslösenord (krävs för att skapa servern).
properties.administrators	ServerExternalAdministrator	Azure Active Directory-administratören för servern.
properties.federatedClientId	string	Klient-ID:t som används för cmk-scenario mellan klientorganisationer
properties.fullyQualifiedDomainName	string	Serverns fullständigt kvalificerade domännamn.
properties.keyId	string	En CMK-URI för nyckeln som ska användas för kryptering.
properties.minimalTlsVersion	string	Minimal TLS-version. Tillåtna värden: "1.0", "1.1", "1.2"
properties.primaryUserAssignedIdentityId	string	Resurs-ID för en användartilldelad identitet som ska användas som standard.
properties.privateEndpointConnections	ServerPrivateEndpointConnection[]	Lista över privata slutpunktsanslutningar på en server
properties.publicNetworkAccess	ServerNetworkAccessFlag	Om offentlig slutpunktsåtkomst tillåts för den här servern eller inte. Värdet är valfritt, men om det skickas måste det vara Aktiverat eller Inaktiverat
properties.restrictOutboundNetworkAccess	ServerNetworkAccessFlag	Om du vill begränsa utgående nätverksåtkomst för den här servern eller inte. Värdet är valfritt, men om det skickas måste det vara Aktiverat eller Inaktiverat
properties.state	string	Serverns tillstånd.
properties.version	string	Serverns version.
properties.workspaceFeature	ServerWorkspaceFeature	Om en befintlig server har en arbetsyta skapad eller inte och om den tillåter anslutning från arbetsytan
tags	object	Resurstaggar.
type	string	Resurstyp.

ServerExternalAdministrator

Objekt

Egenskaper för en Active Directory-administratör.

Name	Typ	Description
administratorType	AdministratorType	Typ av serveradministratör.
azureADOnlyAuthentication	boolean	Endast Azure Active Directory-autentisering aktiverat.
login	string	Serveradministratörens inloggningsnamn.
principalType	PrincipalType	Huvudtyp för serveradministratören.
sid	string	SID (objekt-ID) för serveradministratören.
tenantId	string	Administratörens klientorganisations-ID.

ServerNetworkAccessFlag

Uppräkning

Om offentlig slutpunktsåtkomst tillåts för den här servern eller inte. Värdet är valfritt, men om det skickas måste det vara Aktiverat eller Inaktiverat

Värde	Description
Disabled
Enabled

ServerPrivateEndpointConnection

Objekt

En privat slutpunktsanslutning under en server

Name	Typ	Description
id	string	Resurs-ID.
properties	PrivateEndpointConnectionProperties	Egenskaper för privat slutpunktsanslutning

ServerUpdate

Objekt

En uppdateringsbegäran för en Azure SQL Database-server.

Name	Typ	Description
identity	ResourceIdentity	Serveridentitet
properties.administratorLogin	string	Administratörsanvändarnamn för servern. När den har skapats kan den inte ändras.
properties.administratorLoginPassword	string	Administratörens inloggningslösenord (krävs för att skapa servern).
properties.administrators	ServerExternalAdministrator	Azure Active Directory-administratören för servern.
properties.federatedClientId	string	Klient-ID:t som används för cmk-scenario mellan klientorganisationer
properties.fullyQualifiedDomainName	string	Serverns fullständigt kvalificerade domännamn.
properties.keyId	string	En CMK-URI för nyckeln som ska användas för kryptering.
properties.minimalTlsVersion	string	Minimal TLS-version. Tillåtna värden: "1.0", "1.1", "1.2"
properties.primaryUserAssignedIdentityId	string	Resurs-ID för en användartilldelad identitet som ska användas som standard.
properties.privateEndpointConnections	ServerPrivateEndpointConnection[]	Lista över privata slutpunktsanslutningar på en server
properties.publicNetworkAccess	ServerNetworkAccessFlag	Om offentlig slutpunktsåtkomst tillåts för den här servern eller inte. Värdet är valfritt, men om det skickas måste det vara Aktiverat eller Inaktiverat
properties.restrictOutboundNetworkAccess	ServerNetworkAccessFlag	Om du vill begränsa utgående nätverksåtkomst för den här servern eller inte. Värdet är valfritt, men om det skickas måste det vara Aktiverat eller Inaktiverat
properties.state	string	Serverns tillstånd.
properties.version	string	Serverns version.
properties.workspaceFeature	ServerWorkspaceFeature	Om en befintlig server har en arbetsyta skapad eller inte och om den tillåter anslutning från arbetsytan
tags	object	Resurstaggar.

ServerWorkspaceFeature

Uppräkning

Om en befintlig server har en arbetsyta skapad eller inte och om den tillåter anslutning från arbetsytan

Värde	Description
Connected
Disconnected

UserIdentity

Objekt

Azure Active Directory-identitetskonfiguration för en resurs.

Name	Typ	Description
clientId	string	Azure Active Directory-klient-ID: t.
principalId	string	Huvud-ID:t för Azure Active Directory.