Dela via


Servers - Update

Uppdaterar en server.

PATCH https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}?api-version=2023-08-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. Detta kan endast användas vid serverskapningstid. Om det används för serveruppdatering ignoreras det eller så resulterar det i ett fel. För uppdateringar måste enskilda API:er användas.

properties.federatedClientId

string (uuid)

Klient-ID:t som används för cmk-scenario mellan klientorganisationer

properties.isIPv6Enabled

ServerNetworkAccessFlag

Om du vill aktivera IPv6-stöd för den här servern eller inte. Värdet är valfritt, men om det skickas in måste det vara "Aktiverat" eller "Inaktiverat"

properties.keyId

string

En CMK-URI för nyckeln som ska användas för kryptering.

properties.minimalTlsVersion

MinimalTlsVersion

Minimal TLS-version. Tillåtna värden: "None", 1.0", "1.1", "1.2", "1.3"

properties.primaryUserAssignedIdentityId

string

Resurs-ID för en användartilldelad identitet som ska användas som standard.

properties.publicNetworkAccess

ServerPublicNetworkAccessFlag

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

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 in 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

Accepterad

Sidhuvuden

Location: string

Other Status Codes

ErrorResponse

Felsvar: ***

  • 400 ManagedInstanceStoppingOrS toppad – Konfliktåtgärd som skickas när instansen är i stopptillstånd

  • 400 ManagedInstanceStarting – Konfliktåtgärd som skickas när instansen är i starttillstånd

  • 400 NameAlreadyExistsSoftDeleted – Servernamnet som begärs tas av en server i mjukt borttaget tillstånd. Rensa eller återställa servern för att avblockera.

  • 400 MissingIdentityId – Ingen användartilldelad identitet tillhandahålls när identitetstypen är inställd på UserAssigned

  • 400 InvalidPrimaryIdentityId – Användaren tillhandahåller ett värde för PrimaryUserIdentityId men detsamma 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 utföra åtgärden 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 som tillhandahålls

  • 400 MissingPrimaryIdentity – PrimaryUserAssignedIdentityId som tillhandahålls av användaren har inte åtkomst till KeyId

  • 400 ProvisioningDisabled – Visar felmeddelande från resursåtgärdsauktoriseraren 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 funktionsflagga för prenumerationen, eller så är funktionsstödet 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 gavs till 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 CMKOperationNotAllowed – Användaren försökte utföra en åtgärd på servern när servern inte hade Åtkomst till Azure Key Vault.

  • 400 ServerNotFound – Den begärda servern hittades inte.

  • 400 RegionDoesNotAllowProvisioning – Den valda platsen accepterar inte nya Windows Azure SQL Database-servrar. Detta kan ändras vid ett senare tillfälle.

  • 400 InvalidMinimalTlsVersion – Ogiltig minimal TLS-version.

  • 400 InvalidExternalAdministratorLogin – Ogiltigt eller saknade inloggningsnamn för extern administratör.

  • 400 InvalidExternalAdministratorSid – Ogiltigt eller saknat objekt-ID för extern administratör.

  • 400 InvalidExternalAdministratorTenantId – Ogiltigt eller saknat klient-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 Endast Azure AD-autentisering.

  • 400 ExternalAdministratorLoginSameAsSqlAdmin – Namnen på Azure Active Directory-administratören och serveradministratörskontot måste vara olika. Ange olika värden.

  • 400 ServerAdministratorNameAlreadyExists – Användaren försökte ange den externa administratören och huvudnamnet finns redan i huvuddatabasen.

  • 404 ServerNotInSubscriptionResourceGroup – Den angivna servern finns inte i den angivna resursgruppen och prenumerationen.

  • 404 SubscriptionDoesNotHaveServer – Den begärda servern hittades inte

  • 404 OperationIdNotFound – Åtgärden med ID finns inte.

  • 404 SubscriptionNotFound – Det gick inte att hitta den begärda prenumerationen.

  • 409 CannotCancelOperation – hanteringsåtgärden är i ett tillstånd som inte kan avbrytas.

  • 409 OperationCancelled – Åtgärden har avbrutits av användaren.

  • 409 Åtgärd avbröts – 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 – Duplicera servernamn.

  • 429 SubscriptionTooManyCreateUpdateRequests – Begäranden utöver maximalt antal begäranden som kan bearbetas av tillgängliga resurser.

  • 429 SubscriptionTooManyRequests – Begäranden utöver maxbegä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 maxbegä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 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

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

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

Exempelsvar

{
  "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",
    "isIPv6Enabled": "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"
          }
        }
      }
    ]
  }
}
Location: https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.Sql/locations/japaneast/serverOperationResults/00000000-0000-0000-0000-000000000000?api-version=2023-05-01

Definitioner

Name Description
AdministratorType

Typ av administratör för serverservern.

ErrorAdditionalInfo

Ytterligare information om resurshanteringsfelet.

ErrorDetail

Felinformationen.

ErrorResponse

Felsvar

ExternalGovernanceStatus

Status för extern styrning.

IdentityType

Identitetstypen. Ställ in detta på "SystemAssigned" för att automatiskt skapa och tilldela ett Azure Active Directory-huvudnamn för resursen.

MinimalTlsVersion

Minimal TLS-version. Tillåtna värden: "None", 1.0", "1.1", "1.2", "1.3"

PrincipalType

Huvudtyp för sever-administratören.

PrivateEndpointConnectionProperties

Egenskaper för en privat slutpunktsanslutning.

PrivateEndpointProperty
PrivateEndpointProvisioningState

Tillståndet 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 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 in måste det vara "Aktiverat" eller "Inaktiverat"

ServerPrivateEndpointConnection

En privat slutpunktsanslutning under en server

ServerPublicNetworkAccessFlag

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

ServerUpdate

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

ServerWorkspaceFeature

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

UserIdentity

Azure Active Directory-identitetskonfiguration för en resurs.

AdministratorType

Typ av administratör för serverservern.

Värde Description
ActiveDirectory

ErrorAdditionalInfo

Ytterligare information om resurshanteringsfelet.

Name Typ Description
info

object

Ytterligare information.

type

string

Ytterligare informationstyp.

ErrorDetail

Felinformationen.

Name Typ Description
additionalInfo

ErrorAdditionalInfo[]

Ytterligare information om felet.

code

string

Felkoden.

details

ErrorDetail[]

Felinformationen.

message

string

Felmeddelandet.

target

string

Felmålet.

ErrorResponse

Felsvar

Name Typ Description
error

ErrorDetail

Felobjektet.

ExternalGovernanceStatus

Status för extern styrning.

Värde Description
Disabled
Enabled

IdentityType

Identitetstypen. Ställ in detta på "SystemAssigned" för att automatiskt skapa och tilldela ett Azure Active Directory-huvudnamn för resursen.

Värde Description
None
SystemAssigned
SystemAssigned,UserAssigned
UserAssigned

MinimalTlsVersion

Minimal TLS-version. Tillåtna värden: "None", 1.0", "1.1", "1.2", "1.3"

Värde Description
1.0
1.1
1.2
1.3
None

PrincipalType

Huvudtyp för sever-administratören.

Värde Description
Application
Group
User

PrivateEndpointConnectionProperties

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åndet för den privata slutpunktsanslutningen.

PrivateEndpointProperty

Name Typ Description
id

string

Resurs-ID för den privata slutpunkten.

PrivateEndpointProvisioningState

Tillståndet för den privata slutpunktsanslutningen.

Värde Description
Approving
Dropping
Failed
Ready
Rejecting

PrivateLinkServiceConnectionStateActionsRequire

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

Värde Description
None

PrivateLinkServiceConnectionStateProperty

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

Anslutningsstatus för tjänsten private link.

Värde Description
Approved
Disconnected
Pending
Rejected

ResourceIdentity

Azure Active Directory-identitetskonfiguration för en resurs.

Name Typ Description
principalId

string (uuid)

Huvud-ID:t för Azure Active Directory.

tenantId

string (uuid)

Klient-ID:t för Azure Active Directory.

type

IdentityType

Identitetstypen. Ställ in detta på "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

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-portalen.

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. Detta kan endast användas vid serverskapningstid. Om det används för serveruppdatering ignoreras det eller så resulterar det i ett fel. För uppdateringar måste enskilda API:er användas.

properties.externalGovernanceStatus

ExternalGovernanceStatus

Status för extern styrning.

properties.federatedClientId

string (uuid)

Klient-ID:t som används för cmk-scenario mellan klientorganisationer

properties.fullyQualifiedDomainName

string

Serverns fullständigt kvalificerade domännamn.

properties.isIPv6Enabled

ServerNetworkAccessFlag

Om du vill aktivera IPv6-stöd för den här servern eller inte. Värdet är valfritt, men om det skickas in måste det vara "Aktiverat" eller "Inaktiverat"

properties.keyId

string

En CMK-URI för nyckeln som ska användas för kryptering.

properties.minimalTlsVersion

MinimalTlsVersion

Minimal TLS-version. Tillåtna värden: "None", 1.0", "1.1", "1.2", "1.3"

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

ServerPublicNetworkAccessFlag

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

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 in 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 skapat en arbetsyta eller inte och om den tillåter anslutning från arbetsytan

tags

object

Resurstaggar.

type

string

Resurstyp.

ServerExternalAdministrator

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

Name Typ Description
administratorType

AdministratorType

Typ av administratör för serverservern.

azureADOnlyAuthentication

boolean

Endast Azure Active Directory-autentisering aktiverat.

login

string

Serveradministratörens inloggningsnamn.

principalType

PrincipalType

Huvudtyp för sever-administratören.

sid

string (uuid)

SID (objekt-ID) för serveradministratören.

tenantId

string (uuid)

Administratörens klientorganisations-ID.

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 in måste det vara "Aktiverat" eller "Inaktiverat"

Värde Description
Disabled
Enabled

ServerPrivateEndpointConnection

En privat slutpunktsanslutning under en server

Name Typ Description
id

string

Resurs-ID.

properties

PrivateEndpointConnectionProperties

Egenskaper för privat slutpunktsanslutning

ServerPublicNetworkAccessFlag

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

Värde Description
Disabled
Enabled
SecuredByPerimeter

ServerUpdate

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. Detta kan endast användas vid serverskapningstid. Om det används för serveruppdatering ignoreras det eller så resulterar det i ett fel. För uppdateringar måste enskilda API:er användas.

properties.externalGovernanceStatus

ExternalGovernanceStatus

Status för extern styrning.

properties.federatedClientId

string (uuid)

Klient-ID:t som används för cmk-scenario mellan klientorganisationer

properties.fullyQualifiedDomainName

string

Serverns fullständigt kvalificerade domännamn.

properties.isIPv6Enabled

ServerNetworkAccessFlag

Om du vill aktivera IPv6-stöd för den här servern eller inte. Värdet är valfritt, men om det skickas in måste det vara "Aktiverat" eller "Inaktiverat"

properties.keyId

string

En CMK-URI för nyckeln som ska användas för kryptering.

properties.minimalTlsVersion

MinimalTlsVersion

Minimal TLS-version. Tillåtna värden: "None", 1.0", "1.1", "1.2", "1.3"

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

ServerPublicNetworkAccessFlag

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

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 in 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 skapat en arbetsyta eller inte och om den tillåter anslutning från arbetsytan

tags

object

Resurstaggar.

ServerWorkspaceFeature

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

Värde Description
Connected
Disconnected

UserIdentity

Azure Active Directory-identitetskonfiguration för en resurs.

Name Typ Description
clientId

string (uuid)

Azure Active Directory-klient-ID: t.

principalId

string (uuid)

Huvud-ID:t för Azure Active Directory.