Managed Instance Administrators - Create Or Update

Referens

Tjänst:: SQL Database

API-version:: 2021-11-01

Skapar eller uppdaterar en administratör för hanterad instans.

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

URI-parametrar

Name	I	Obligatorisk	Typ	Description
administratorName	path	True	AdministratorName
managedInstanceName	path	True	string	Namnet på den hanterade instansen.
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.
subscriptionId	path	True	string	Prenumerations-ID:t som identifierar en Azure-prenumeration.
api-version	query	True	string	DEN API-version som ska användas för begäran.

Begärandetext

Name	Obligatorisk	Typ	Description
properties.administratorType	True	ManagedInstanceAdministratorType	Typ av administratör för den hanterade instansen.
properties.login	True	string	Inloggningsnamn för administratören för den hanterade instansen.
properties.sid	True	string	SID (objekt-ID) för administratören för den hanterade instansen.
properties.tenantId		string	Klientorganisations-ID för administratören för den hanterade instansen.

Svar

Name	Typ	Description
200 OK	ManagedInstanceAdministrator	Administratören för den hanterade instansen har uppdaterats.
201 Created	ManagedInstanceAdministrator	Administratören för den hanterade instansen har skapats.
202 Accepted		Har godkänts
Other Status Codes		Felsvar: *** 400 InvalidManagedServerAdministratorType – Ogiltig administratörstyp som anges i egenskaper. 400 InvalidResourceRequestBody – Resursen eller resursegenskaperna i begärandetexten är tomma eller ogiltiga. 400 InvalidManagedServerAzureADAdminDeleteOperation – Användaren försökte ta bort den hanterade servern Azure Active Azure-administratören när AzureADOnlyAuthentication har angetts. Använd först API:et azureADOnlyAuthentications. 400 InvalidManagedServerAADOnlyAuthTypePropertyName – Hanterad server Azure Active Directory endast autentiseringstyp bör vara standard 400 InvalidParameterValue – ett ogiltigt värde gavs till en parameter. 400 InvalidLoginName – det angivna inloggningsnamnet är ogiltigt. 400 PrincipalNotFoundInTenant – AzureAD Lookup returnerade inga resultat för det här namnet. 400 ServerPrincipalHasDuplicateDisplayNameInAad – AzureAD Lookup returnerade flera resultat för det här namnet. 400 ManagedInstanceIsBusy – Hanterad instans är upptagen med en annan begäran. 400 InvalidPrincipalType – Den här huvudnamnstypen stöds inte i Windows Azure SQL Database. 400 ServerPrincipalCreateLoginBadSyntax – Det uppstod ett syntaxfel när du körde Create Login-instruktionen för Azure AD Administrator. 400 ServicePrincipalLookupInAadFailed – AzureAD Lookup misslyckades på grund av fel i tjänstinfrastrukturen. 400 TenantNotFoundInActiveDirectory – Klientorganisationen är inte tillgänglig i Active Directory. 400 InvalidUsername – Det angivna användarnamnet innehåller ogiltiga tecken. 400 ManagedInstanceHasNoPermissionsToAccessAad – Försök att utföra åtgärden, vilket innebär en icke-befintlig inloggning eller inloggning som kör huvudkontot inte har några behörigheter. 403 ServicePrincipalLookupInAadFailedIdentityForbidden – AzureAD Lookup misslyckades eftersom MSI inte beviljades läsbehörighet för AAD. 404 ServerNotInSubscription – Den angivna servern finns inte i den angivna prenumerationen. 404 ManagedInstanceNotInSubscriptionResourceGroup – Angiven hanterad instans finns inte i den angivna resursgruppen och prenumerationen. 404 SubscriptionNotFound – Den begärda prenumerationen hittades inte. 404 OperationIdNotFound – Åtgärden med ID finns inte. 404 ResourceNotFound – Den begärda resursen hittades inte. 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 ServerPrincipalAlreadyExists – Försök att skapa serverhuvudnamn med ett icke-unikt namn. 409 ServerPrincipalCurrentlyLoggedIn – självförklarande. 409 ServerPrincipalOwnsJobs – Försök att ta bort en inloggning när den har aktiva jobb. 409 ServerPrincipalIsGrantorOfPermissions – Försök att ta bort ett serverhuvudnamn, som är en behörighetsbeviljare. 409 ServerPrincipalOwnsDatabase – Ändra ägare till databaserna innan du släpper inloggningen. 409 ServerPrincipalUsedInTriggerOrEventNotification – Försök att släppa inloggningen, som används som körningskontext för en utlösare eller händelseavisering. 409 ServerPrincipalOwnsObjects – Försök att släppa en inloggning som äger objekt. 429 SubscriptionTooManyCreateUpdateRequests – begäranden utöver maximalt antal begäranden som kan bearbetas av tillgängliga resurser. 429 SubscriptionTooManyRequests – Begäranden utöver maximalt antal begä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 maximalt antal begäranden som kan bearbetas av tillgängliga resurser. 500 OperationTimedOut – Tidsgränsen för åtgärden uppnåddes och återställdes automatiskt. Försök att utföra åtgärden igen. 500 ActiveDirectoryLookupTimedOut – Det gick inte att slutföra åtgärden just nu. Försök igen senare. 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. 504 RequestTimeout – Tjänstbegäran överskred den tillåtna tidsgränsen.

Exempel

Create administrator of managed instance

Update administrator of managed instance

Create administrator of managed instance

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


import com.azure.resourcemanager.sql.fluent.models.ManagedInstanceAdministratorInner;
import com.azure.resourcemanager.sql.models.AdministratorName;
import com.azure.resourcemanager.sql.models.ManagedInstanceAdministratorType;
import java.util.UUID;

/**
 * Samples for ManagedInstanceAdministrators CreateOrUpdate.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/ManagedInstanceAdministratorCreate.
     * json
     */
    /**
     * Sample code: Create administrator of managed instance.
     * 
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void createAdministratorOfManagedInstance(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getManagedInstanceAdministrators().createOrUpdate(
            "Default-SQL-SouthEastAsia", "managedInstance", AdministratorName.ACTIVE_DIRECTORY,
            new ManagedInstanceAdministratorInner()
                .withAdministratorType(ManagedInstanceAdministratorType.ACTIVE_DIRECTORY).withLogin("bob@contoso.com")
                .withSid(UUID.fromString("44444444-3333-2222-1111-000000000000")).withTenantId(
                    UUID.fromString("55555555-4444-3333-2222-111111111111")),
            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

Exempelsvar

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

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

Statuskod:: 202

Update administrator of managed instance

Exempelbegäran

HTTP
Java

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


import com.azure.resourcemanager.sql.fluent.models.ManagedInstanceAdministratorInner;
import com.azure.resourcemanager.sql.models.AdministratorName;
import com.azure.resourcemanager.sql.models.ManagedInstanceAdministratorType;
import java.util.UUID;

/**
 * Samples for ManagedInstanceAdministrators CreateOrUpdate.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/ManagedInstanceAdministratorUpdate.
     * json
     */
    /**
     * Sample code: Update administrator of managed instance.
     * 
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void updateAdministratorOfManagedInstance(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getManagedInstanceAdministrators().createOrUpdate(
            "Default-SQL-SouthEastAsia", "managedInstance", AdministratorName.ACTIVE_DIRECTORY,
            new ManagedInstanceAdministratorInner()
                .withAdministratorType(ManagedInstanceAdministratorType.ACTIVE_DIRECTORY).withLogin("bob@contoso.com")
                .withSid(UUID.fromString("44444444-3333-2222-1111-000000000000")).withTenantId(
                    UUID.fromString("55555555-4444-3333-2222-111111111111")),
            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

Exempelsvar

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

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

Statuskod:: 202

Definitioner

Name	Description
AdministratorName
ManagedInstanceAdministrator	En Azure SQL administratör för hanterad instans.
ManagedInstanceAdministratorType	Typ av administratör för den hanterade instansen.

AdministratorName

Name	Typ	Description
ActiveDirectory	string

ManagedInstanceAdministrator

En Azure SQL administratör för hanterad instans.

Name	Typ	Description
id	string	Resurs-ID.
name	string	Resursnamn.
properties.administratorType	ManagedInstanceAdministratorType	Typ av administratör för den hanterade instansen.
properties.login	string	Inloggningsnamn för administratören för den hanterade instansen.
properties.sid	string	SID (objekt-ID) för administratören för den hanterade instansen.
properties.tenantId	string	Klientorganisations-ID för administratören för den hanterade instansen.
type	string	Resurstyp.

ManagedInstanceAdministratorType

Typ av administratör för den hanterade instansen.

Name	Typ	Description
ActiveDirectory	string

Dela via

Managed Instance Administrators - Create Or Update

URI-parametrar

Begärandetext

Svar

Exempel

Create administrator of managed instance

Exempelbegäran

Exempelsvar

Update administrator of managed instance

Exempelbegäran

Exempelsvar

Definitioner

AdministratorName

ManagedInstanceAdministrator

ManagedInstanceAdministratorType

Ytterligare resurser