Server Azure AD Administrators - Create Or Update

Referens

Tjänst:: SQL Database

API-version:: 2021-11-01

Skapar eller uppdaterar en befintlig Azure Active Directory-administratör.

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

URI-parametrar

Name	I	Obligatorisk	Typ	Description
administratorName	path	True	AdministratorName	Namnet på serverns active directory-administratör.
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.
serverName	path	True	string	Namnet på servern.
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	AdministratorType	Typ av administratör för serverservern.
properties.login	True	string	Serveradministratörens inloggningsnamn.
properties.sid	True	string	SID (objekt-ID) för serveradministratören.
properties.tenantId		string	Administratörens klientorganisations-ID.

Svar

Name	Typ	Description
200 OK	ServerAzureADAdministrator	En Azure Active Directory-administratör har uppdaterats.
201 Created	ServerAzureADAdministrator	En Azure Active Directory-administratör har skapats.
202 Accepted		Har godkänts
Other Status Codes		Felsvar: *** 400 InvalidServerAdministratorTypePropertyName – Serverns active directory-administratörstyp bör vara ActiveDirectory 400 InvalidResourceRequestBody – Resursen eller resursegenskaperna i begärandetexten är tomma eller ogiltiga. 400 InvalidServerAzureADOnlyAuthenticationParameter – Användaren försökte ange parametern AzureADOnlyAuthentication till false, vilket inte är tillåtet. Använd azureADOnlyAuthentications API i stället. 400 InvalidServerAzureADAdminDeleteOperation – Användaren försökte ta bort serverns Azure Active Azure-administratör när AzureADOnlyAuthentication har angetts. Använd först API:et azureADOnlyAuthentications. 400 ServerAdministratorNameAlreadyExists – Användaren försökte ange den externa administratören och huvudnamnet finns redan i huvuddatabasen. 404 SubscriptionDoesNotHaveServer – den begärda servern hittades inte 404 ServerNotInSubscriptionResourceGroup – Den angivna servern finns inte i den angivna resursgruppen och prenumerationen. 404 OperationIdNotFound – Åtgärden med ID finns 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. 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. 503 TooManyRequests – Begäranden utöver maximalt antal begäranden som kan bearbetas av tillgängliga resurser.

Exempel

Creates or updates an existing Azure Active Directory administrator.

PUT https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/sqlcrudtest-4799/providers/Microsoft.Sql/servers/sqlcrudtest-6440/administrators/ActiveDirectory?api-version=2021-11-01

{
  "properties": {
    "administratorType": "ActiveDirectory",
    "login": "bob@contoso.com",
    "sid": "c6b82b90-a647-49cb-8a62-0d2d3cb7ac7c",
    "tenantId": "c6b82b90-a647-49cb-8a62-0d2d3cb7ac7c"
  }
}


import com.azure.resourcemanager.sql.fluent.models.ServerAzureADAdministratorInner;
import com.azure.resourcemanager.sql.models.AdministratorName;
import com.azure.resourcemanager.sql.models.AdministratorType;
import java.util.UUID;

/**
 * Samples for ServerAzureADAdministrators CreateOrUpdate.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/AdministratorCreateOrUpdate.json
     */
    /**
     * Sample code: Creates or updates an existing Azure Active Directory administrator.
     * 
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void createsOrUpdatesAnExistingAzureActiveDirectoryAdministrator(
        com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getServerAzureADAdministrators().createOrUpdate("sqlcrudtest-4799",
            "sqlcrudtest-6440", AdministratorName.ACTIVE_DIRECTORY,
            new ServerAzureADAdministratorInner().withAdministratorType(AdministratorType.ACTIVE_DIRECTORY)
                .withLogin("bob@contoso.com").withSid(UUID.fromString("c6b82b90-a647-49cb-8a62-0d2d3cb7ac7c"))
                .withTenantId(UUID.fromString("c6b82b90-a647-49cb-8a62-0d2d3cb7ac7c")),
            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/sqlcrudtest-4799/providers/Microsoft.Sql/servers/sqlcrudtest-6440/administrators/ActiveDirectory",
  "name": "ActiveDirectory",
  "type": "Microsoft.Sql/servers/administrators",
  "properties": {
    "administratorType": "ActiveDirectory",
    "login": "bob@contoso.com",
    "sid": "c6b82b90-a647-49cb-8a62-0d2d3cb7ac7c",
    "tenantId": "c6b82b90-a647-49cb-8a62-0d2d3cb7ac7c",
    "azureADOnlyAuthentication": true
  }
}

Statuskod:: 201

{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/sqlcrudtest-4799/providers/Microsoft.Sql/servers/sqlcrudtest-6440/administrators/ActiveDirectory",
  "name": "activeDirectory",
  "type": "Microsoft.Sql/servers/administrators",
  "properties": {
    "administratorType": "ActiveDirectory",
    "login": "bob@contoso.com",
    "sid": "c6b82b90-a647-49cb-8a62-0d2d3cb7ac7c",
    "tenantId": "c6b82b90-a647-49cb-8a62-0d2d3cb7ac7c",
    "azureADOnlyAuthentication": true
  }
}

Statuskod:: 202

Definitioner

Name	Description
AdministratorName	Namnet på serverns active directory-administratör.
AdministratorType	Typ av administratör för serverservern.
ServerAzureADAdministrator	Azure Active Directory-administratör.

AdministratorName

Namnet på serverns active directory-administratör.

Name	Typ	Description
ActiveDirectory	string

AdministratorType

Typ av administratör för serverservern.

Name	Typ	Description
ActiveDirectory	string

ServerAzureADAdministrator

Azure Active Directory-administratör.

Name	Typ	Description
id	string	Resurs-ID.
name	string	Resursnamn.
properties.administratorType	AdministratorType	Typ av administratör för serverservern.
properties.azureADOnlyAuthentication	boolean	Endast Azure Active Directory-autentisering aktiverat.
properties.login	string	Serveradministratörens inloggningsnamn.
properties.sid	string	SID (objekt-ID) för serveradministratören.
properties.tenantId	string	Administratörens klientorganisations-ID.
type	string	Resurstyp.

Dela via