Servers - Update

Služba:

SQL Database

Verze rozhraní API:

2021-11-01

Aktualizace serveru.

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

Parametry identifikátoru URI

Name	V	Vyžadováno	Typ	Description
resourceGroupName	path	True	string	Název skupiny prostředků, která obsahuje prostředek. Tuto hodnotu můžete získat z rozhraní API azure Resource Manager nebo z portálu.
serverName	path	True	string	Název serveru.
subscriptionId	path	True	string	ID předplatného, které identifikuje předplatné Azure.
api-version	query	True	string	Verze rozhraní API, která se má použít pro požadavek.

Text požadavku

Name	Typ	Description
identity	ResourceIdentity	Identita serveru
properties.administratorLogin	string	Uživatelské jméno správce serveru. Po vytvoření se nedá změnit.
properties.administratorLoginPassword	string	Přihlašovací heslo správce (vyžadované pro vytvoření serveru)
properties.administrators	ServerExternalAdministrator	Správce azure Active Directory serveru.
properties.federatedClientId	string	ID klienta použitého pro scénář cmk mezi tenanty
properties.keyId	string	Identifikátor URI CMK klíče, který se má použít k šifrování.
properties.minimalTlsVersion	string	Minimální verze protokolu TLS. Povolené hodnoty: 1.0, 1.1, 1.2
properties.primaryUserAssignedIdentityId	string	ID prostředku identity přiřazené uživatelem, které se má použít ve výchozím nastavení.
properties.publicNetworkAccess	ServerNetworkAccessFlag	Určuje, jestli je pro tento server povolený přístup k veřejnému koncovému bodu. Hodnota je volitelná, ale pokud je předána, musí být Povolená nebo Zakázaná.
properties.restrictOutboundNetworkAccess	ServerNetworkAccessFlag	Zda se má omezit odchozí síťový přístup pro tento server. Hodnota je volitelná, ale pokud je předána, musí být Povolená nebo Zakázaná.
properties.version	string	Verze serveru.
tags	object	Značky prostředků.

Odpovědi

Name	Typ	Description
200 OK	Server	Server se úspěšně aktualizoval.
202 Accepted		Přijato
Other Status Codes		Chybové odpovědi: *** 400 MissingIdentityId –Při nastavení typu identity userAssigned se neposkytne žádná identita přiřazená uživatelem. 400 InvalidPrimaryIdentityId – Uživatel poskytuje hodnotu PrimaryUserIdentityId, ale stejná hodnota není uvedená v parametru IdentityId. 400 PECsNotExistingToDenyPublicNetworkAccess – Nelze nastavit Odepřít přístup k veřejné síti na Hodnotu Ano, protože pro přístup k serveru není povolený žádný privátní koncový bod. Nastavte privátní koncové body a zkuste operaci zopakovat (https://docs.microsoft.com/azure/sql-database/sql-database-private-endpoint-overview#how-to-set-up-private-link-for-azure-sql-database). 400 NameAlreadyExists – zadaný název již existuje. 400 UmissingAkvPermissions – PrimaryUserAssignedIdentityId poskytnuté uživatelem nemá přístup k zadanému Id klíče. 400 MissingPrimaryIdentity – PrimaryUserAssignedIdentityId zadané uživatelem nemá přístup k id klíče zadanému uživatelem. 400 ProvisioningDisabled – zobrazí chybovou zprávu z operace prostředků authorizer tak, jak je, beze změn. 400 PrimaryIdentityMissingPermissionForKeyId – id klíče poskytuje uživatel během vytváření, ale primaryUserAssignedIdentityId není k dispozici ve volání rozhraní API. 400 InvalidIdentityTypeForKeyId – id klíče poskytne uživatel během vytváření, ale typ identity není nastavený na UserAssigned. 400 InvalidLoginName – zadané přihlašovací jméno je neplatné. 400 InvalidUsername (Neplatné uživatelské jméno) – zadané uživatelské jméno obsahuje neplatné znaky. 400 Ipv6FeatureNotEnabled – Uživatel se pokusil zapnout podporu IPv6 na serveru bez povolení příznaku funkce pro předplatné nebo je podpora funkcí v této oblasti aktuálně zakázaná. 400 PasswordTooShort – zadané heslo je příliš krátké. 400 AadOnlyAuthenticationIsEnabled – Je povolené pouze ověřování Azure Active Directory. Obraťte se na správce systému. 400 RegionDoesNotSupportVersion – uživatel se pokusil vytvořit server zadané verze v umístění, kde se tato verze serveru nepodporuje. 400 PasswordTooLong – zadané heslo je příliš dlouhé. 400 PasswordNotComplex – zadané heslo není dostatečně složité. 400 InvalidParameterValue – parametru byla přiřazena neplatná hodnota. 400 InvalidLocation – bylo zadáno neplatné umístění. 400 InvalidServerName – zadaný neplatný název serveru. 400 InvalidIdentifier – identifikátor obsahuje null nebo neplatný znak unicode. 400 TokenTooLong – zadaný token je příliš dlouhý. 400 RegionDoesNotAllowProvisioning – vybrané umístění nepřijímá nové databázové servery windows Azure SQL. To se může později změnit. 400 ServerNotFound – požadovaný server nebyl nalezen. 400 InvalidMinimalTlsVersion – neplatná minimální verze protokolu TLS. 400 InvalidExternalAdministratorLogin – neplatné nebo chybějící přihlašovací jméno externího správce. 400 InvalidExternalAdministratorSid – neplatné nebo chybějící ID objektu externího správce. 400 InvalidExternalAdministratorTenantId – neplatné nebo chybějící ID tenanta externího správce. 400 ExternalAdministratorPrincipalType – neplatný nebo chybějící typ objektu zabezpečení externího správce. Vyberte možnost Uživatel, Aplikace nebo Skupina. 400 MissingExternalAdministratorWithAadOnlyAuth – Pokud chcete použít pouze ověřování Azure AD, uveďte podrobnosti o externím správci. 400 ExternalAdministratorLoginSameAsSqlAdmin – Jména správce Azure Active Directory a účtu správce serveru se musí lišit. Zadejte jiné hodnoty. 404 SubscriptionDoesNotHaveServer – požadovaný server nebyl nalezen. 404 ServerNotInSubscriptionResourceGroup – zadaný server neexistuje v zadané skupině prostředků a předplatném. 404 OperationIdNotFound – operace s ID neexistuje. 404 SubscriptionNotFound –Požadované předplatné nebylo nalezeno. 409 OperationCancelled – operace byla zrušena uživatelem. 409 OperationInterrupted – Operaci s prostředkem nebylo možné dokončit, protože byla přerušena jinou operací se stejným prostředkem. 409 UpsertLogicalServerRequestAlreadyInProgress – probíhající požadavek logického serveru již probíhá. Zkuste prosím požadavek zopakovat později. 409 ServerDisabled – Server je zakázaný. 409 ConflictingServerOperation – aktuálně probíhá operace pro server. 409 SubscriptionDisabled – Předplatné je zakázané. 409 ServerQuotaExceed – Server nelze přidat do předplatného, protože překročí kvótu. 409 ServerAlreadyExists – duplicitní název serveru. 429 SubscriptionTooManyCreateUpdateRequests – požadavky nad rámec maximálního počtu požadavků, které je možné zpracovat dostupnými prostředky. 429 SubscriptionTooManyRequests – požadavky nad rámec maximálního počtu požadavků, které je možné zpracovat dostupnými prostředky. 429 SubscriptionTooManyCreateUpdateRequests – požadavky nad rámec maximálního počtu požadavků, které je možné zpracovat dostupnými prostředky. 429 SubscriptionTooManyRequests – požadavky nad rámec maximálního počtu požadavků, které je možné zpracovat dostupnými prostředky. 429 ConflictingSubscriptionOperation – aktuálně probíhá operace pro předplatné. 500 OperationTimedOut – časový limit operace vypršel a automaticky se vrátila zpět. Opakujte operaci. 503 TooManyRequests – požadavky nad rámec maximálního počtu požadavků, které je možné zpracovat dostupnými prostředky. 503 TooManyRequests – požadavky nad rámec maximálního počtu požadavků, které je možné zpracovat dostupnými prostředky.

Příklady

Update a server

Ukázkový požadavek

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

Ukázková odpověď

Stavový kód:

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

Stavový kód:

202

Definice

Name	Description
AdministratorType	Typ správce serveru.
IdentityType	Typ identity. Tuto možnost nastavte na SystemAssigned, aby se k prostředku automaticky vytvořil a přiřadil objekt zabezpečení Azure Active Directory.
PrincipalType	Typ objektu zabezpečení správce serveru.
PrivateEndpointConnectionProperties	Vlastnosti připojení privátního koncového bodu.
PrivateEndpointProperty
PrivateEndpointProvisioningState	Stav připojení privátního koncového bodu.
PrivateLinkServiceConnectionStateActionsRequire	Akce vyžadované pro připojení služby private link.
PrivateLinkServiceConnectionStateProperty
PrivateLinkServiceConnectionStateStatus	Stav připojení služby private link.
ResourceIdentity	Konfigurace identity Azure Active Directory pro prostředek
Server	Databázový server Azure SQL.
ServerExternalAdministrator	Vlastnosti správce služby Active Directory.
ServerNetworkAccessFlag	Určuje, jestli je pro tento server povolený přístup k veřejnému koncovému bodu. Hodnota je volitelná, ale pokud je předána, musí být Povolená nebo Zakázaná.
ServerPrivateEndpointConnection	Připojení privátního koncového bodu pod serverem
ServerUpdate	Žádost o aktualizaci pro databázový server Azure SQL.
ServerWorkspaceFeature	Určuje, jestli má existující server vytvořený pracovní prostor a jestli umožňuje připojení z pracovního prostoru.
UserIdentity	Konfigurace identity Azure Active Directory pro prostředek

AdministratorType

Typ správce serveru.

Name	Typ	Description
ActiveDirectory	string

IdentityType

Typ identity. Tuto možnost nastavte na SystemAssigned, aby se k prostředku automaticky vytvořil a přiřadil objekt zabezpečení Azure Active Directory.

Name	Typ	Description
None	string
SystemAssigned	string
SystemAssigned,UserAssigned	string
UserAssigned	string

PrincipalType

Typ objektu zabezpečení správce serveru.

Name	Typ	Description
Application	string
Group	string
User	string

PrivateEndpointConnectionProperties

Vlastnosti připojení privátního koncového bodu.

Name	Typ	Description
groupIds	string[]	ID skupin.
privateEndpoint	PrivateEndpointProperty	Privátní koncový bod, ke kterému připojení patří.
privateLinkServiceConnectionState	PrivateLinkServiceConnectionStateProperty	Stav připojení privátního koncového bodu.
provisioningState	PrivateEndpointProvisioningState	Stav připojení privátního koncového bodu.

PrivateEndpointProperty

Name	Typ	Description
id	string	ID prostředku privátního koncového bodu

PrivateEndpointProvisioningState

Stav připojení privátního koncového bodu.

Name	Typ	Description
Approving	string
Dropping	string
Failed	string
Ready	string
Rejecting	string

PrivateLinkServiceConnectionStateActionsRequire

Akce vyžadované pro připojení služby private link.

Name	Typ	Description
None	string

PrivateLinkServiceConnectionStateProperty

Name	Typ	Description
actionsRequired	PrivateLinkServiceConnectionStateActionsRequire	Akce vyžadované pro připojení služby private link.
description	string	Popis připojení služby private link.
status	PrivateLinkServiceConnectionStateStatus	Stav připojení služby private link.

PrivateLinkServiceConnectionStateStatus

Stav připojení služby private link.

Name	Typ	Description
Approved	string
Disconnected	string
Pending	string
Rejected	string

ResourceIdentity

Konfigurace identity Azure Active Directory pro prostředek

Name	Typ	Description
principalId	string	ID objektu zabezpečení Služby Azure Active Directory.
tenantId	string	ID tenanta Azure Active Directory
type	IdentityType	Typ identity. Tuto možnost nastavte na SystemAssigned, aby se k prostředku automaticky vytvořil a přiřadil objekt zabezpečení Azure Active Directory.
userAssignedIdentities	<string,  UserIdentity>	ID prostředků identit přiřazených uživatelem, které se mají použít

Server

Databázový server Azure SQL.

Name	Typ	Description
id	string	ID prostředku.
identity	ResourceIdentity	Identita Azure Active Directory serveru.
kind	string	Druh sql serveru. Toto jsou metadata používaná pro Azure Portal prostředí.
location	string	Umístění prostředku.
name	string	Název prostředku.
properties.administratorLogin	string	Uživatelské jméno správce serveru. Po vytvoření se nedá změnit.
properties.administratorLoginPassword	string	Přihlašovací heslo správce (vyžadované pro vytvoření serveru)
properties.administrators	ServerExternalAdministrator	Správce azure Active Directory serveru.
properties.federatedClientId	string	ID klienta použitého pro scénář cmk mezi tenanty
properties.fullyQualifiedDomainName	string	Plně kvalifikovaný název domény serveru.
properties.keyId	string	Identifikátor URI CMK klíče, který se má použít k šifrování.
properties.minimalTlsVersion	string	Minimální verze protokolu TLS. Povolené hodnoty: 1.0, 1.1, 1.2
properties.primaryUserAssignedIdentityId	string	ID prostředku identity přiřazené uživatelem, které se má použít ve výchozím nastavení.
properties.privateEndpointConnections	ServerPrivateEndpointConnection[]	Seznam připojení privátních koncových bodů na serveru
properties.publicNetworkAccess	ServerNetworkAccessFlag	Určuje, jestli je pro tento server povolený přístup k veřejnému koncovému bodu. Hodnota je volitelná, ale pokud je předána, musí být Povolená nebo Zakázaná.
properties.restrictOutboundNetworkAccess	ServerNetworkAccessFlag	Zda se má omezit odchozí síťový přístup pro tento server. Hodnota je volitelná, ale pokud je předána, musí být Povolená nebo Zakázaná.
properties.state	string	Stav serveru.
properties.version	string	Verze serveru.
properties.workspaceFeature	ServerWorkspaceFeature	Určuje, jestli má existující server vytvořený pracovní prostor a jestli umožňuje připojení z pracovního prostoru.
tags	object	Značky prostředků.
type	string	Typ prostředku.

ServerExternalAdministrator

Vlastnosti správce služby Active Directory.

Name	Typ	Description
administratorType	AdministratorType	Typ správce serveru.
azureADOnlyAuthentication	boolean	Povoleno pouze ověřování v Azure Active Directory.
login	string	Přihlašovací jméno správce serveru.
principalType	PrincipalType	Typ objektu zabezpečení správce serveru.
sid	string	IDENTIFIKÁTOR SID (ID objektu) správce serveru.
tenantId	string	ID tenanta správce.

ServerNetworkAccessFlag

Určuje, jestli je pro tento server povolený přístup k veřejnému koncovému bodu. Hodnota je volitelná, ale pokud je předána, musí být Povolená nebo Zakázaná.

Name	Typ	Description
Disabled	string
Enabled	string

ServerPrivateEndpointConnection

Připojení privátního koncového bodu pod serverem

Name	Typ	Description
id	string	ID prostředku.
properties	PrivateEndpointConnectionProperties	Vlastnosti připojení privátního koncového bodu

ServerUpdate

Žádost o aktualizaci pro databázový server Azure SQL.

Name	Typ	Description
identity	ResourceIdentity	Identita serveru
properties.administratorLogin	string	Uživatelské jméno správce serveru. Po vytvoření se nedá změnit.
properties.administratorLoginPassword	string	Přihlašovací heslo správce (vyžadované pro vytvoření serveru)
properties.administrators	ServerExternalAdministrator	Správce azure Active Directory serveru.
properties.federatedClientId	string	ID klienta použitého pro scénář cmk mezi tenanty
properties.fullyQualifiedDomainName	string	Plně kvalifikovaný název domény serveru.
properties.keyId	string	Identifikátor URI CMK klíče, který se má použít k šifrování.
properties.minimalTlsVersion	string	Minimální verze protokolu TLS. Povolené hodnoty: 1.0, 1.1, 1.2
properties.primaryUserAssignedIdentityId	string	ID prostředku identity přiřazené uživatelem, které se má použít ve výchozím nastavení.
properties.privateEndpointConnections	ServerPrivateEndpointConnection[]	Seznam připojení privátních koncových bodů na serveru
properties.publicNetworkAccess	ServerNetworkAccessFlag	Určuje, jestli je pro tento server povolený přístup k veřejnému koncovému bodu. Hodnota je volitelná, ale pokud je předána, musí být Povolená nebo Zakázaná.
properties.restrictOutboundNetworkAccess	ServerNetworkAccessFlag	Zda se má omezit odchozí síťový přístup pro tento server. Hodnota je volitelná, ale pokud je předána, musí být Povolená nebo Zakázaná.
properties.state	string	Stav serveru.
properties.version	string	Verze serveru.
properties.workspaceFeature	ServerWorkspaceFeature	Určuje, jestli má existující server vytvořený pracovní prostor a jestli umožňuje připojení z pracovního prostoru.
tags	object	Značky prostředků.

ServerWorkspaceFeature

Určuje, jestli má existující server vytvořený pracovní prostor a jestli umožňuje připojení z pracovního prostoru.

Name	Typ	Description
Connected	string
Disconnected	string

UserIdentity

Konfigurace identity Azure Active Directory pro prostředek

Name	Typ	Description
clientId	string	ID klienta Azure Active Directory.
principalId	string	ID objektu zabezpečení Služby Azure Active Directory.