Servers - Create Or Update

Referencia

Szolgáltatás:: SQL Database

API-verzió:: 2021-11-01

Kiszolgálót hoz létre vagy frissít.

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

URI-paraméterek

Name	In	Kötelező	Típus	Description
resourceGroupName	path	True	string	Az erőforrást tartalmazó erőforráscsoport neve. Ezt az értéket az Azure Resource Manager API-ból vagy a portálról szerezheti be.
serverName	path	True	string	A kiszolgáló neve.
subscriptionId	path	True	string	Az Azure-előfizetést azonosító előfizetés-azonosító.
api-version	query	True	string	A kéréshez használni kívánt API-verzió.

Kérelem törzse

Name	Kötelező	Típus	Description
location	True	string	Erőforrás helye.
identity		ResourceIdentity	A kiszolgáló Azure Active Directory-identitása.
properties.administratorLogin		string	A kiszolgáló rendszergazdai felhasználóneve. A létrehozás után nem módosítható.
properties.administratorLoginPassword		string	A rendszergazda bejelentkezési jelszava (a kiszolgáló létrehozásához szükséges).
properties.administrators		ServerExternalAdministrator	A kiszolgáló Azure Active Directory-rendszergazdája.
properties.federatedClientId		string	A bérlők közötti CMK-forgatókönyvhöz használt ügyfélazonosító
properties.keyId		string	A titkosításhoz használandó kulcs CMK URI-ja.
properties.minimalTlsVersion		string	Minimális TLS-verzió. Engedélyezett értékek: "1.0", "1.1", "1.2"
properties.primaryUserAssignedIdentityId		string	Egy felhasználó által hozzárendelt identitás erőforrás-azonosítója, amelyet alapértelmezés szerint használni szeretne.
properties.publicNetworkAccess		ServerNetworkAccessFlag	Azt jelzi, hogy engedélyezve van-e a nyilvános végponthoz való hozzáférés ehhez a kiszolgálóhoz. Az érték megadása nem kötelező, de ha be van adva, akkor "Engedélyezve" vagy "Letiltva" értékűnek kell lennie.
properties.restrictOutboundNetworkAccess		ServerNetworkAccessFlag	A kiszolgáló kimenő hálózati hozzáférésének korlátozása. Az érték megadása nem kötelező, de ha be van adva, akkor "Engedélyezve" vagy "Letiltva" értékűnek kell lennie.
properties.version		string	A kiszolgáló verziója.
tags		object	Erőforráscímkék.

Válaszok

Name	Típus	Description
200 OK	Server	A kiszolgáló frissítése sikerült.
201 Created	Server	A kiszolgáló létrehozása sikerült.
202 Accepted		Elfogadva
Other Status Codes		Hibaválaszok: *** 400 MissingIdentityId – Nincs felhasználó által hozzárendelt identitás, ha az identitástípus UserAssigned értékre van állítva 400 InvalidPrimaryIdentityId – A felhasználó a PrimaryUserIdentityId értéket adja meg, de ugyanez nem szerepel az IdentityId paraméterben. 400 PECsNotExistingToDenyPublicNetworkAccess – Nem lehet a Nyilvános hálózati hozzáférés megtagadása beállítást Igen értékre állítani, mivel nincs engedélyezve privát végpont a kiszolgáló eléréséhez. Állítson be privát végpontokat, és próbálkozzon újra a művelettel (https://docs.microsoft.com/azure/sql-database/sql-database-private-endpoint-overview#how-to-set-up-private-link-for-azure-sql-database). 400 NameAlreadyExists – A megadott név már létezik. 400 UmiMissingAkvPermissions – A felhasználó által megadott PrimaryUserAssignedIdentityId nem rendelkezik hozzáféréssel a megadott KeyId azonosítóhoz 400 MissingPrimaryIdentity – A felhasználó által megadott PrimaryUserAssignedIdentityId nem rendelkezik hozzáféréssel a megadott KeyId azonosítóhoz 400 ProvisioningDisabled – Hibaüzenetet jelenít meg az erőforrás-művelet engedélyezője részéről, módosítás nélkül 400 PrimaryIdentityMissingPermissionForKeyId – A kulcsazonosítót a felhasználó biztosítja a létrehozás során, de a PrimaryUserAssignedIdentityId nem szerepel az API-hívásban 400 InvalidIdentityTypeForKeyId – A kulcsazonosítót a felhasználó adja meg a létrehozás során, de az identitástípus nincs "UserAssigned" értékre állítva 400 InvalidLoginName – A megadott bejelentkezési név érvénytelen. 400 InvalidUsername – A megadott felhasználónév érvénytelen karaktereket tartalmaz. 400 Ipv6FeatureNotEnabled – A felhasználó megpróbálta bekapcsolni az Ipv6-támogatást a kiszolgálón anélkül, hogy engedélyezné a funkciójelzőt az előfizetésben, vagy a szolgáltatástámogatás jelenleg le van tiltva a régióban. 400 PasswordTooShort – A megadott jelszó túl rövid 400 AadOnlyAuthenticationIsEnabled – Csak Azure Active Directory-hitelesítés engedélyezve van. Lépjen kapcsolatba a rendszergazdával. 400 RegionDoesNotSupportVersion – Egy felhasználó olyan helyen próbált létrehozni egy adott verziójú kiszolgálót, ahol a kiszolgáló verziója nem támogatott. 400 PasswordTooLong – A megadott jelszó túl hosszú. 400 PasswordNotComplex – A megadott jelszó nem elég bonyolult. 400 InvalidParameterValue – Érvénytelen értéket adott meg egy paraméternek. 400 InvalidLocation – Érvénytelen hely van megadva. 400 InvalidServerName – Érvénytelen kiszolgálónév van megadva. 400 InvalidIdentifier – Az azonosító NULL értéket vagy érvénytelen Unicode-karaktert tartalmaz. 400 TokenTooLong – A megadott token túl hosszú. 400 RegionDoesNotAllowProvisioning – A kijelölt hely nem fogadja el az új Windows Azure SQL adatbázis-kiszolgálókat. Ez később változhat. 400 ServerNotFound – A kért kiszolgáló nem található. 400 InvalidMinimalTlsVersion – Érvénytelen minimális TLS-verzió. 400 InvalidExternalAdministratorLogin – Érvénytelen vagy hiányzó külső rendszergazdai bejelentkezési név. 400 InvalidExternalAdministratorSid – Érvénytelen vagy hiányzó külső rendszergazdai objektumazonosító. 400 InvalidExternalAdministratorTenantId – Érvénytelen vagy hiányzó külső rendszergazdai bérlőazonosító. 400 ExternalAdministratorPrincipalType – Érvénytelen vagy hiányzó külső rendszergazdai egyszerű típus. Válasszon a Felhasználó, az Alkalmazás vagy a Csoport lehetőség közül. 400 MissingExternalAdministratorWithAadOnlyAuth – A csak Azure AD hitelesítés használatához adja meg egy külső rendszergazda adatait. 400 ExternalAdministratorLoginSameAsSqlAdmin – Az Azure Active Directory rendszergazdájának és a kiszolgálói rendszergazdai fióknak eltérőnek kell lennie. Adjon meg különböző értékeket. 404 SubscriptionDoesNotHaveServer – A kért kiszolgáló nem található 404 ServerNotInSubscriptionResourceGroup – A megadott kiszolgáló nem létezik a megadott erőforráscsoportban és előfizetésben. 404 OperationIdNotFound – Az azonosítóval rendelkező művelet nem létezik. 404 SubscriptionNotFound – A kért előfizetés nem található. 409 OperationCancelled – A felhasználó megszakította a műveletet. 409 OperationInterrupted – Az erőforráson végzett művelet nem hajtható végre, mert ugyanazon az erőforráson egy másik művelet megszakította. 409 UpsertLogicalServerRequestAlreadyInProgress – Egy folyamatban lévő logikai kiszolgálói kérelem már folyamatban van, próbálkozzon újra később. 409 ServerDisabled – A kiszolgáló le van tiltva. 409 ConflictingServerOperation – Folyamatban van egy művelet a kiszolgálóhoz. 409 SubscriptionDisabled – Az előfizetés le van tiltva. 409 ServerQuotaExceeded – A kiszolgáló nem vehető fel előfizetésbe, mert az túllépi a kvótát. 409 ServerAlreadyExists – Duplikált kiszolgálónév. 429 SubscriptionTooManyCreateUpdateRequests – Az elérhető erőforrások által feldolgozható maximális kérelmeken túli kérések. 429 SubscriptionTooManyRequests – Az elérhető erőforrások által feldolgozható maximális kérelmeken túli kérések. 429 SubscriptionTooManyCreateUpdateRequests – Az elérhető erőforrások által feldolgozható maximális kérelmeken túli kérések. 429 SubscriptionTooManyRequests – Az elérhető erőforrások által feldolgozható maximális kérelmeken túli kérések. 429 ConflictingSubscriptionOperation – Folyamatban van egy művelet az előfizetéshez. 500 OperationTimedOut – A művelet túllépte az időkorlátot, és automatikusan visszagördült. Please retry the operation. 503 TooManyRequests – Az elérhető erőforrások által feldolgozható maximális kérelmeken túli kérések. 503 TooManyRequests – Az elérhető erőforrások által feldolgozható maximális kérelmeken túli kérések.

Példák

Create server

PUT 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",
    "administrators": {
      "principalType": "User",
      "login": "bob@contoso.com",
      "sid": "00000011-1111-2222-2222-123456789111",
      "tenantId": "00000011-1111-2222-2222-123456789111",
      "azureADOnlyAuthentication": true
    },
    "publicNetworkAccess": "Enabled",
    "restrictOutboundNetworkAccess": "Enabled"
  },
  "location": "Japan East"
}


import com.azure.resourcemanager.sql.fluent.models.ServerInner;
import com.azure.resourcemanager.sql.models.PrincipalType;
import com.azure.resourcemanager.sql.models.ServerExternalAdministrator;
import com.azure.resourcemanager.sql.models.ServerNetworkAccessFlag;
import java.util.UUID;

/**
 * Samples for Servers CreateOrUpdate.
 */
public final class Main {
    /*
     * x-ms-original-file: specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/ServerCreate.json
     */
    /**
     * Sample code: Create server.
     * 
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void createServer(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getServers().createOrUpdate("sqlcrudtest-7398", "sqlcrudtest-4645",
            new ServerInner().withLocation("Japan East").withAdministratorLogin("dummylogin")
                .withAdministratorLoginPassword("fakeTokenPlaceholder")
                .withPublicNetworkAccess(ServerNetworkAccessFlag.ENABLED)
                .withAdministrators(new ServerExternalAdministrator().withPrincipalType(PrincipalType.USER)
                    .withLogin("bob@contoso.com").withSid(UUID.fromString("00000011-1111-2222-2222-123456789111"))
                    .withTenantId(UUID.fromString("00000011-1111-2222-2222-123456789111"))
                    .withAzureADOnlyAuthentication(true))
                .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

Mintaválasz

Állapotkód:: 200

{
  "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": "Enabled",
    "restrictOutboundNetworkAccess": "Enabled",
    "administrators": {
      "principalType": "User",
      "login": "bob@contoso.com",
      "sid": "00000011-1111-2222-2222-123456789111",
      "tenantId": "00000011-1111-2222-2222-123456789111",
      "azureADOnlyAuthentication": true
    },
    "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"
          }
        }
      }
    ]
  }
}

Állapotkód:: 201

{
  "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",
    "publicNetworkAccess": "Enabled",
    "restrictOutboundNetworkAccess": "Enabled",
    "version": "12.0",
    "state": "Ready",
    "administrators": {
      "principalType": "User",
      "login": "bob@contoso.com",
      "sid": "00000011-1111-2222-2222-123456789111",
      "tenantId": "00000011-1111-2222-2222-123456789111",
      "azureADOnlyAuthentication": true
    },
    "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"
          }
        }
      }
    ]
  }
}

Állapotkód:: 202

Definíciók

Name	Description
AdministratorType	A rendszergazda típusa.
IdentityType	Az identitás típusa. Állítsa ezt a "SystemAssigned" értékre, hogy automatikusan létrehozhasson és hozzárendelhessen egy Azure Active Directory-tagot az erőforráshoz.
PrincipalType	A rendszergazda egyszerű típusa.
PrivateEndpointConnectionProperties	Privát végpontkapcsolat tulajdonságai.
PrivateEndpointProperty
PrivateEndpointProvisioningState	A privát végpontkapcsolat állapota.
PrivateLinkServiceConnectionStateActionsRequire	A privát kapcsolat szolgáltatáskapcsolatához szükséges műveletek.
PrivateLinkServiceConnectionStateProperty
PrivateLinkServiceConnectionStateStatus	A privát kapcsolati szolgáltatás kapcsolati állapota.
ResourceIdentity	Azure Active Directory-identitáskonfiguráció egy erőforráshoz.
Server	Egy Azure SQL adatbázis-kiszolgáló.
ServerExternalAdministrator	Egy Active Directory-rendszergazda tulajdonságai.
ServerNetworkAccessFlag	Azt jelzi, hogy engedélyezve van-e a nyilvános végponthoz való hozzáférés ehhez a kiszolgálóhoz. Az érték megadása nem kötelező, de ha be van adva, akkor "Engedélyezve" vagy "Letiltva" értékűnek kell lennie.
ServerPrivateEndpointConnection	Privát végpontkapcsolat egy kiszolgáló alatt
ServerWorkspaceFeature	Azt jelzi, hogy a meglévő kiszolgáló rendelkezik-e létrehozott munkaterületsel, és engedélyezi-e a munkaterületről való csatlakozást
UserIdentity	Azure Active Directory-identitáskonfiguráció egy erőforráshoz.

AdministratorType

A rendszergazda típusa.

Name	Típus	Description
ActiveDirectory	string

IdentityType

Az identitás típusa. Állítsa ezt a "SystemAssigned" értékre, hogy automatikusan létrehozhasson és hozzárendelhessen egy Azure Active Directory-tagot az erőforráshoz.

Name	Típus	Description
None	string
SystemAssigned	string
SystemAssigned,UserAssigned	string
UserAssigned	string

PrincipalType

A rendszergazda egyszerű típusa.

Name	Típus	Description
Application	string
Group	string
User	string

PrivateEndpointConnectionProperties

Privát végpontkapcsolat tulajdonságai.

Name	Típus	Description
groupIds	string[]	Csoportazonosítók.
privateEndpoint	PrivateEndpointProperty	Privát végpont, amelyhez a kapcsolat tartozik.
privateLinkServiceConnectionState	PrivateLinkServiceConnectionStateProperty	A privát végpont kapcsolati állapota.
provisioningState	PrivateEndpointProvisioningState	A privát végpontkapcsolat állapota.

PrivateEndpointProperty

Name	Típus	Description
id	string	A privát végpont erőforrás-azonosítója.

PrivateEndpointProvisioningState

A privát végpontkapcsolat állapota.

Name	Típus	Description
Approving	string
Dropping	string
Failed	string
Ready	string
Rejecting	string

PrivateLinkServiceConnectionStateActionsRequire

A privát kapcsolat szolgáltatáskapcsolatához szükséges műveletek.

Name	Típus	Description
None	string

PrivateLinkServiceConnectionStateProperty

Name	Típus	Description
actionsRequired	PrivateLinkServiceConnectionStateActionsRequire	A privát kapcsolat szolgáltatáskapcsolatához szükséges műveletek.
description	string	A private link szolgáltatás kapcsolatának leírása.
status	PrivateLinkServiceConnectionStateStatus	A privát kapcsolati szolgáltatás kapcsolati állapota.

PrivateLinkServiceConnectionStateStatus

A privát kapcsolati szolgáltatás kapcsolati állapota.

Name	Típus	Description
Approved	string
Disconnected	string
Pending	string
Rejected	string

ResourceIdentity

Azure Active Directory-identitáskonfiguráció egy erőforráshoz.

Name	Típus	Description
principalId	string	Az Azure Active Directory egyszerű azonosítója.
tenantId	string	Az Azure Active Directory-bérlő azonosítója.
type	IdentityType	Az identitás típusa. Állítsa ezt a "SystemAssigned" értékre, hogy automatikusan létrehozhasson és hozzárendelhessen egy Azure Active Directory-tagot az erőforráshoz.
userAssignedIdentities	<string, UserIdentity>	A felhasználó által hozzárendelt identitások használandó erőforrás-azonosítói

Server

Egy Azure SQL adatbázis-kiszolgáló.

Name	Típus	Description
id	string	Erőforrás-azonosító.
identity	ResourceIdentity	A kiszolgáló Azure Active Directory-identitása.
kind	string	Az SQL Server típusa. Ez a Azure Portal élményhez használt metaadatok.
location	string	Erőforrás helye.
name	string	Erőforrás neve.
properties.administratorLogin	string	A kiszolgáló rendszergazdai felhasználóneve. A létrehozás után nem módosítható.
properties.administratorLoginPassword	string	A rendszergazda bejelentkezési jelszava (a kiszolgáló létrehozásához szükséges).
properties.administrators	ServerExternalAdministrator	A kiszolgáló Azure Active Directory-rendszergazdája.
properties.federatedClientId	string	A bérlők közötti CMK-forgatókönyvhöz használt ügyfélazonosító
properties.fullyQualifiedDomainName	string	A kiszolgáló teljes tartományneve.
properties.keyId	string	A titkosításhoz használandó kulcs CMK URI-ja.
properties.minimalTlsVersion	string	Minimális TLS-verzió. Engedélyezett értékek: "1.0", "1.1", "1.2"
properties.primaryUserAssignedIdentityId	string	Egy felhasználó által hozzárendelt identitás erőforrás-azonosítója, amelyet alapértelmezés szerint használni szeretne.
properties.privateEndpointConnections	ServerPrivateEndpointConnection[]	A kiszolgálón található privát végpontkapcsolatok listája
properties.publicNetworkAccess	ServerNetworkAccessFlag	Azt jelzi, hogy engedélyezve van-e a nyilvános végponthoz való hozzáférés ehhez a kiszolgálóhoz. Az érték megadása nem kötelező, de ha be van adva, akkor "Engedélyezve" vagy "Letiltva" értékűnek kell lennie.
properties.restrictOutboundNetworkAccess	ServerNetworkAccessFlag	A kiszolgáló kimenő hálózati hozzáférésének korlátozása. Az érték megadása nem kötelező, de ha be van adva, akkor "Engedélyezve" vagy "Letiltva" értékűnek kell lennie.
properties.state	string	A kiszolgáló állapota.
properties.version	string	A kiszolgáló verziója.
properties.workspaceFeature	ServerWorkspaceFeature	Azt jelzi, hogy a meglévő kiszolgáló rendelkezik-e létrehozott munkaterületsel, és engedélyezi-e a munkaterületről való csatlakozást
tags	object	Erőforráscímkék.
type	string	Erőforrástípus.

ServerExternalAdministrator

Egy Active Directory-rendszergazda tulajdonságai.

Name	Típus	Description
administratorType	AdministratorType	A rendszergazda típusa.
azureADOnlyAuthentication	boolean	Csak az Azure Active Directory-hitelesítés engedélyezve van.
login	string	A kiszolgálóadminisztrátor bejelentkezési neve.
principalType	PrincipalType	A rendszergazda egyszerű típusa.
sid	string	A kiszolgálóadminisztrátor SID-azonosítója (objektumazonosítója).
tenantId	string	A rendszergazda bérlőazonosítója.

ServerNetworkAccessFlag

Azt jelzi, hogy engedélyezve van-e a nyilvános végponthoz való hozzáférés ehhez a kiszolgálóhoz. Az érték megadása nem kötelező, de ha be van adva, akkor "Engedélyezve" vagy "Letiltva" értékűnek kell lennie.

Name	Típus	Description
Disabled	string
Enabled	string

ServerPrivateEndpointConnection

Privát végpontkapcsolat egy kiszolgáló alatt

Name	Típus	Description
id	string	Erőforrás-azonosító.
properties	PrivateEndpointConnectionProperties	Privát végpont kapcsolati tulajdonságai

ServerWorkspaceFeature

Azt jelzi, hogy a meglévő kiszolgáló rendelkezik-e létrehozott munkaterületsel, és engedélyezi-e a munkaterületről való csatlakozást

Name	Típus	Description
Connected	string
Disconnected	string

UserIdentity