Sdílet prostřednictvím

Managed Instance Administrators - Create Or Update

  • Reference
Služba:
SQL Database
Verze rozhraní API:
2021-11-01

Vytvoří nebo aktualizuje správce spravované instance.

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

Parametry identifikátoru URI

Name V Vyžadováno Typ Description
administratorName
 path True

AdministratorName

managedInstanceName
 path True

string

Název spravované instance.
resourceGroupName
 path True

string

Název skupiny prostředků, která prostředek obsahuje. Tuto hodnotu můžete získat z rozhraní API Resource Manager Azure nebo z portálu.
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 Vyžadováno Typ Description
properties.administratorType True

ManagedInstanceAdministratorType

Typ správce spravované instance.
properties.login True

string

Přihlašovací jméno správce spravované instance.
properties.sid True

string

IDENTIFIKÁTOR SID (ID objektu) správce spravované instance.
properties.tenantId

string

ID tenanta správce spravované instance.

Odpovědi

Name Typ Description
200 OK

ManagedInstanceAdministrator

Správce spravované instance se úspěšně aktualizoval.
201 Created

ManagedInstanceAdministrator

Správce spravované instance se úspěšně vytvořil.
202 Accepted

Přijato
Other Status Codes

Chybové odpovědi: ***

  • 400 InvalidManagedServerAdministratorType – neplatný typ správce zadaný ve vlastnostech.

  • 400 InvalidResourceRequestBody – prostředek nebo vlastnosti prostředku v textu požadavku jsou prázdné nebo neplatné.

  • 400 InvalidManagedServerAzureADAdminDeleteOperation – Uživatel se při nastavení AzureADOnlyAuthentication pokusil odstranit správce Azure Active Azure spravovaného serveru. Nejprve použijte rozhraní API azureADOnlyAuthentications.

  • 400 InvalidManagedServerAADOnlyAuthTypePropertyName – Typ ověřování pouze spravovaného serveru Azure Active Directory by měl být výchozí.

  • 400 InvalidParameterValue – parametru byla přidělena neplatná hodnota.

  • 400 InvalidLoginName – zadané přihlašovací jméno je neplatné.

  • 400 PrincipalNotFoundInTenant – Služba AzureAD Lookup nevrátila žádné výsledky pro tento název.

  • 400 ServerPrincipalHasDuplicateDisplayNameInAad – Vyhledávání AzureAD vrátilo více výsledků pro tento název.

  • 400 ManagedInstanceIsBusy – Spravovaná instance je zaneprázdněná jiným požadavkem.

  • 400 InvalidPrincipalType – Tento typ objektu zabezpečení není podporován ve službě Windows Azure SQL Database.

  • 400 ServerPrincipalCreateLoginBadSyntax – Při provádění příkazu Create Login pro správce Azure AD došlo k chybě syntaxe.

  • 400 ServicePrincipalLookupInAadFailed – Vyhledávání AzureAD selhalo kvůli chybám infrastruktury služby.

  • 400 TenantNotFoundInActiveDirectory – Tenant není k dispozici ve službě Active Directory.

  • 400 InvalidUsername – zadané uživatelské jméno obsahuje neplatné znaky.

  • 400 ManagedInstanceHasNoPermissionsToAccessAad – pokus o provedení operace, která zahrnuje neexistující přihlášení nebo přihlášení, pro které spouštěný objekt zabezpečení nemá žádná oprávnění.

  • 403 ServicePrincipalLookupInAadFailedIdentityForbidden – Vyhledávání AzureAD selhalo, protože MSI nebylo uděleno oprávnění ke čtení v AAD.

  • 404 ServerNotInSubscription – zadaný server v zadaném předplatném neexistuje.

  • 404 ManagedInstanceNotInSubscriptionResourceGroup – Zadaná spravovaná instance v zadané skupině prostředků a předplatném neexistuje.

  • 404 SubscriptionNotFound –Požadované předplatné nebylo nalezeno.

  • 404 OperationIdNotFound – operace s ID neexistuje.

  • 404 ResourceNotFound – Požadovaný prostředek se nenašel.

  • 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 ServerPrincipalAlreadyExists – pokus o vytvoření objektu zabezpečení serveru s názvem, který není jedinečný.

  • 409 ServerPrincipalCurrentlyLoggedIn – vysvětlení.

  • 409 ServerPrincipalOwnsJobs – pokus o odebrání přihlášení, pokud má aktivní úlohy.

  • 409 ServerPrincipalIsGrantorOfPermissions – pokus o vyřazení objektu zabezpečení serveru, který je udělovačem oprávnění.

  • 409 ServerPrincipalOwnsDatabase – Před zrušením přihlášení změňte vlastníka databází.

  • 409 ServerPrincipalUsedInTriggerOrEventNotification – pokus o vyřazení přihlášení, který se používá jako kontext spuštění triggeru nebo oznámení události.

  • 409 ServerPrincipalOwnsObjects – pokus o odstranění přihlášení, které vlastní objekty.

  • 429 SubscriptionTooManyCreateUpdateRequests – požadavky nad maximální počet 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 maximální počet 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.

  • 500 OperationTimedOut – časový limit operace vypršel a automaticky se vrátila zpět. Opakujte operaci.

  • 500 ActiveDirectoryLookupTimedOut – operaci nelze v tuto chvíli dokončit. Zkuste to později.

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

  • 504 RequestTimeout – Žádost o službu překročila povolený časový limit.

Příklady

Create administrator of managed instance
Update administrator of managed instance

Create administrator of managed instance

Ukázkový požadavek

PUT https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/managedInstances/managedInstance/administrators/ActiveDirectory?api-version=2021-11-01

{
  "properties": {
    "administratorType": "ActiveDirectory",
    "login": "bob@contoso.com",
    "sid": "44444444-3333-2222-1111-000000000000",
    "tenantId": "55555555-4444-3333-2222-111111111111"
  }
}

Ukázková odpověď

Stavový kód:
200 
{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/managedInstances/managedInstance/administrators/ActiveDirectory",
  "name": "ActiveDirectory",
  "properties": {
    "administratorType": "ActiveDirectory",
    "login": "bob@contoso.com",
    "sid": "44444444-3333-2222-1111-000000000000",
    "tenantId": "55555555-4444-3333-2222-111111111111"
  },
  "type": "Microsoft.Sql/managedInstances/administrators"
}
Stavový kód:
201 
{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/managedInstances/managedInstance/administrators/ActiveDirectory",
  "name": "ActiveDirectory",
  "properties": {
    "administratorType": "ActiveDirectory",
    "login": "bob@contoso.com",
    "sid": "44444444-3333-2222-1111-000000000000",
    "tenantId": "55555555-4444-3333-2222-111111111111"
  },
  "type": "Microsoft.Sql/managedInstances/administrators"
}
Stavový kód:
202

Update administrator of managed instance

Ukázkový požadavek

PUT https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/managedInstances/managedInstance/administrators/ActiveDirectory?api-version=2021-11-01

{
  "properties": {
    "administratorType": "ActiveDirectory",
    "login": "bob@contoso.com",
    "sid": "44444444-3333-2222-1111-000000000000",
    "tenantId": "55555555-4444-3333-2222-111111111111"
  }
}

Ukázková odpověď

Stavový kód:
200 
{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/managedInstances/managedInstance/administrators/ActiveDirectory",
  "name": "ActiveDirectory",
  "properties": {
    "administratorType": "ActiveDirectory",
    "login": "bob@contoso.com",
    "sid": "44444444-3333-2222-1111-000000000000",
    "tenantId": "55555555-4444-3333-2222-111111111111"
  },
  "type": "Microsoft.Sql/managedInstances/administrators"
}
Stavový kód:
201 
{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/managedInstances/managedInstance/administrators/ActiveDirectory",
  "name": "ActiveDirectory",
  "properties": {
    "administratorType": "ActiveDirectory",
    "login": "bob@contoso.com",
    "sid": "44444444-3333-2222-1111-000000000000",
    "tenantId": "55555555-4444-3333-2222-111111111111"
  },
  "type": "Microsoft.Sql/managedInstances/administrators"
}
Stavový kód:
202

Definice

Name Description
AdministratorName
ManagedInstanceAdministrator

Správce Azure SQL spravované instance.
ManagedInstanceAdministratorType

Typ správce spravované instance.

AdministratorName

Name Typ Description
ActiveDirectory

string

ManagedInstanceAdministrator

Správce Azure SQL spravované instance.

Name Typ Description
id

string

ID prostředku.
name

string

Název prostředku.
properties.administratorType

ManagedInstanceAdministratorType

Typ správce spravované instance.
properties.login

string

Přihlašovací jméno správce spravované instance.
properties.sid

string

IDENTIFIKÁTOR SID (ID objektu) správce spravované instance.
properties.tenantId

string

ID tenanta správce spravované instance.
type

string

Typ prostředku.

ManagedInstanceAdministratorType

Typ správce spravované instance.

Name Typ Description
ActiveDirectory

string