Udostępnij za pośrednictwem

Managed Instance Administrators - Create Or Update

  • Odwołanie
Usługa:
SQL Database
Wersja interfejsu API:
2021-11-01

Tworzy lub aktualizuje administratora wystąpienia zarządzanego.

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

Parametry identyfikatora URI

Nazwa W Wymagane Typ Opis
administratorName
 path True

AdministratorName

managedInstanceName
 path True

string

Nazwa wystąpienia zarządzanego.
resourceGroupName
 path True

string

Nazwa grupy zasobów zawierającej zasób. Tę wartość można uzyskać z interfejsu API usługi Azure Resource Manager lub portalu.
subscriptionId
 path True

string

Identyfikator subskrypcji identyfikujący subskrypcję platformy Azure.
api-version
 query True

string

Wersja interfejsu API do użycia dla żądania.

Treść żądania

Nazwa Wymagane Typ Opis
properties.administratorType True

ManagedInstanceAdministratorType

Typ administratora wystąpienia zarządzanego.
properties.login True

string

Nazwa logowania administratora wystąpienia zarządzanego.
properties.sid True

string

Identyfikator SID (identyfikator obiektu) administratora wystąpienia zarządzanego.
properties.tenantId

string

Identyfikator dzierżawy administratora wystąpienia zarządzanego.

Odpowiedzi

Nazwa Typ Opis
200 OK

ManagedInstanceAdministrator

Pomyślnie zaktualizowano administratora wystąpienia zarządzanego.
201 Created

ManagedInstanceAdministrator

Pomyślnie utworzono administratora wystąpienia zarządzanego.
202 Accepted

Zaakceptowano
Other Status Codes

Odpowiedzi na błędy: ***

  • 400 InvalidManagedServerAdministratorType — nieprawidłowy typ administratora określony we właściwościach.

  • 400 InvalidResourceRequestBody — właściwości zasobu lub zasobu w treści żądania są puste lub nieprawidłowe.

  • 400 InvalidManagedServerAzureADAdminDeleteOperation — użytkownik próbował usunąć zarządzany serwer azure Active Azure admin po ustawieniu usługi AzureADOnlyAuthentication. Najpierw użyj interfejsu API azureADOnlyAuthentications.

  • 400 InvalidManagedServerAADOnlyAuthTypePropertyName — typ uwierzytelniania tylko dla usługi Azure Active Directory serwera zarządzanego powinien mieć wartość Domyślna

  • 400 InvalidParameterValue — podano nieprawidłową wartość dla parametru.

  • 400 InvalidLoginName — podana nazwa logowania jest nieprawidłowa.

  • 400 PrincipalNotFoundInTenant — wyszukiwanie usługi AzureAD nie zwróciło żadnych wyników dla tej nazwy.

  • 400 ServerPrincipalHasDuplicateDisplayNameInAad — wyszukiwanie usługi AzureAD zwróciło wiele wyników dla tej nazwy.

  • 400 ManagedInstanceIsBusy — wystąpienie zarządzane jest zajęte innym żądaniem.

  • 400 InvalidPrincipalType — ten typ podmiotu zabezpieczeń nie jest obsługiwany w usłudze Windows Azure SQL Database.

  • 400 ServerPrincipalCreateLoginBadSyntax — wystąpił błąd składni podczas wykonywania instrukcji Create Login dla administratora Azure AD.

  • 400 ServicePrincipalLookupInAadFailed — wyszukiwanie usługi AzureAD nie powiodło się z powodu błędów infrastruktury usługi.

  • 400 TenantNotFoundInActiveDirectory — dzierżawa nie jest dostępna w usłudze Active Directory.

  • 400 InvalidUsername — podana nazwa użytkownika zawiera nieprawidłowe znaki.

  • 400 ManagedInstanceHasNoPermissionsToAccessAad — próba wykonania operacji, która obejmuje nie istniejące logowanie lub logowanie, na którym wykonywanie podmiotu zabezpieczeń nie ma uprawnień.

  • 403 ServicePrincipalLookupInAadFailedIdentityForbidden — wyszukiwanie usługi AzureAD nie powiodło się, ponieważ tożsamość usługi zarządzanej nie otrzymała uprawnień do odczytu w usłudze AAD.

  • 404 ServerNotInSubscription — określony serwer nie istnieje w określonej subskrypcji.

  • 404 ManagedInstanceNotInSubscriptionResourceGroup — określone wystąpienie zarządzane nie istnieje w określonej grupie zasobów i subskrypcji.

  • 404 SubscriptionNotFound — nie można odnaleźć żądanej subskrypcji.

  • 404 OperationIdNotFound — operacja o identyfikatorze nie istnieje.

  • 404 ResourceNotFound — żądany zasób nie został znaleziony.

  • 409 OperationCancelled — operacja została anulowana przez użytkownika.

  • 409 Operacja przerwana — nie można ukończyć operacji na zasobie, ponieważ została przerwana przez inną operację na tym samym zasobie.

  • 409 ServerPrincipalAlreadyExists — próba utworzenia podmiotu zabezpieczeń serwera o innej nazwie.

  • 409 ServerPrincipalCurrentlyLoggedIn — objaśnienie.

  • 409 ServerPrincipalOwnsJobs — próba usunięcia identyfikatora logowania, gdy ma aktywne zadania.

  • 409 ServerPrincipalIsGrantorOfPermissions — próba porzucenia podmiotu zabezpieczeń serwera, który jest podmiotem przyznającym uprawnienia.

  • 409 ServerPrincipalOwnsDatabase — zmień właściciela baz danych przed usunięciem nazwy logowania.

  • 409 ServerPrincipalUsedInTriggerOrEventNotification — próba porzucenia logowania, która jest używana jako kontekst wykonywania wyzwalacza lub powiadomienia o zdarzeniu.

  • 409 ServerPrincipalOwnsObjects — próba porzucania nazwy logowania będącej właścicielem obiektów.

  • 429 SubscriptionTooManyCreateUpdateRequests — żądania wykraczające poza maksymalne żądania, które mogą być przetwarzane przez dostępne zasoby.

  • 429 SubscriptionTooManyRequests — żądania wykraczające poza maksymalną liczbę żądań, które mogą być przetwarzane przez dostępne zasoby.

  • 429 SubscriptionTooManyCreateUpdateRequests — żądania wykraczające poza maksymalne żądania, które mogą być przetwarzane przez dostępne zasoby.

  • 429 SubscriptionTooManyRequests — żądania wykraczające poza maksymalną liczbę żądań, które mogą być przetwarzane przez dostępne zasoby.

  • 500 OperationTimedOut — upłynął limit czasu operacji i automatycznie wycofano. Ponów próbę wykonania operacji.

  • 500 ActiveDirectoryLookupTimedOut — nie można ukończyć tej operacji. Spróbuj ponownie później.

  • 503 TooManyRequests — żądania wykraczające poza maksymalne żądania, które mogą być przetwarzane przez dostępne zasoby.

  • 503 TooManyRequests — żądania wykraczające poza maksymalne żądania, które mogą być przetwarzane przez dostępne zasoby.

  • 504 RequestTimeout — żądanie usługi przekroczyło dozwolony limit czasu.

Przykłady

Create administrator of managed instance
Update administrator of managed instance

Create administrator of managed instance

Przykładowe żądanie

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

Przykładowa odpowiedź

Kod stanu:
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"
}
Kod stanu:
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"
}
Kod stanu:
202

Update administrator of managed instance

Przykładowe żądanie

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

Przykładowa odpowiedź

Kod stanu:
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"
}
Kod stanu:
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"
}
Kod stanu:
202

Definicje

Nazwa Opis
AdministratorName
ManagedInstanceAdministrator

Administrator wystąpienia zarządzanego Azure SQL.
ManagedInstanceAdministratorType

Typ administratora wystąpienia zarządzanego.

AdministratorName

Nazwa Typ Opis
ActiveDirectory

string

ManagedInstanceAdministrator

Administrator wystąpienia zarządzanego Azure SQL.

Nazwa Typ Opis
id

string

Identyfikator zasobu.
name

string

Nazwa zasobu.
properties.administratorType

ManagedInstanceAdministratorType

Typ administratora wystąpienia zarządzanego.
properties.login

string

Nazwa logowania administratora wystąpienia zarządzanego.
properties.sid

string

Identyfikator SID (identyfikator obiektu) administratora wystąpienia zarządzanego.
properties.tenantId

string

Identyfikator dzierżawy administratora wystąpienia zarządzanego.
type

string

Typ zasobu.

ManagedInstanceAdministratorType

Typ administratora wystąpienia zarządzanego.

Nazwa Typ Opis
ActiveDirectory

string