Server Trust Groups - Create Or Update

Referenz

Dienst:: SQL Database

API-Version:: 2021-11-01

Erstellt oder aktualisiert eine Serververtrauensgruppe.

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

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
locationName	path	True	string	Der Name der Region, in der sich die Ressource befindet.
resourceGroupName	path	True	string	Der Name der Ressourcengruppe, die die Ressource enthält. Dieser Wert kann über die Azure-Ressourcen-Manager-API oder das Portal abgerufen werden.
serverTrustGroupName	path	True	string	Der Name der Serververtrauensgruppe.
subscriptionId	path	True	string	Abonnement-ID für ein Azure-Abonnement.
api-version	query	True	string	API-Version, die für die Anforderung verwendet werden soll.

Anforderungstext

Name	Erforderlich	Typ	Beschreibung
properties.groupMembers	True	ServerInfo[]	Gruppenmitgliederinformationen für die Serververtrauensgruppe.
properties.trustScopes	True	TrustScopes[]	Vertrauensbereich der Server-Vertrauensstellungsgruppe.

Antworten

Name	Typ	Beschreibung
200 OK	ServerTrustGroup	Die Serververtrauensgruppe wurde erfolgreich aktualisiert.
201 Created	ServerTrustGroup	Die Serververtrauensgruppe wurde erfolgreich erstellt.
202 Accepted		Akzeptiert
Other Status Codes		Fehlerantworten: *** 400 ServerTrustGroupCreateRequestInvalid: Die Ressourcen- oder Ressourceneigenschaften im Anforderungstext sind leer oder ungültig. 400 ServerTrustGroupCreateRequestInvalidGroupMembers: Die Gruppenmitgliedereigenschaft im Anforderungstext ist leer oder ungültig. 400 ServerTrustGroupCreateRequestInvalidGroupMembersCount: Die Gruppenmitgliedereigenschaft weist eine ungültige Anzahl von Servern auf. 400 ServerTrustGroupCreateRequestInvalidServer: Das angegebene ServerId-Feld im Anforderungstext der Serververtrauensgruppe erstellen ist leer oder ungültig. 400 ServerTrustGroupCreateRequestDuplicateServer: Mindestens einer der bereitgestellten Server sind Duplikate. 400 ServerTrustGroupCreateRequestInvalidTrustScopes: Die Vertrauensbereichseigenschaft im Anforderungstext ist leer oder ungültig. 400 ServerTrustGroupCreateRequestInvalidTrustScopesValue: Die Vertrauensbereichseigenschaft im Anforderungstext weist einen ungültigen Wert auf. 400 ServerTrustGroupCreateRequestInvalidGroupMembersCount2: Die Gruppenmitgliedereigenschaft weist eine ungültige Anzahl von Servern auf. 404 ServerTrustGroupNotFound: Die Serververtrauensgruppe mit dem angegebenen Namen ist nicht vorhanden. 404 OperationIdNotFound: Der Vorgang mit der ID ist nicht vorhanden. 404 ResourceNotFound: Die angeforderte Ressource wurde nicht gefunden. 404 OperationIdNotFound: Der Vorgang mit der ID ist nicht vorhanden. 406 ServerTrustGroupMemberIsBusy : Das Gruppenmitglied "{0}" hat keinen gültigen Zustand und kann keinen Serververtrauensgruppenvorgang ausführen. 406 ServerTrustGroupInInInvalidState : Die SQL-Vertrauensgruppe "{0}" ist ausgelastet und kann den angeforderten Vorgang nicht ausführen. 406 ServerTrustGroupMemberNotFound : Das Gruppenmitglied "{0}" wurde nicht gefunden, daher können wir keinen Serververtrauensgruppenvorgang ausführen. 409 OperationCancelled: Der Vorgang wurde vom Benutzer abgebrochen. 409 OperationInterrupted: Der Vorgang für die Ressource konnte nicht abgeschlossen werden, da er durch einen anderen Vorgang für dieselbe Ressource unterbrochen wurde. 429 SubscriptionTooManyCreateUpdateRequests: Anforderungen, die über die maximale Anzahl von Anforderungen hinausgehen, die von verfügbaren Ressourcen verarbeitet werden können. 429 SubscriptionTooManyRequests: Anforderungen, die über die maximale Anzahl von Anforderungen hinausgehen, die von verfügbaren Ressourcen verarbeitet werden können. 500 OperationTimedOut: Der Vorgang ist timeout und wird automatisch zurückgesetzt. Wiederholen Sie den Vorgang. 503 TooManyRequests: Anforderungen, die über die maximale Anzahl von Anforderungen hinausgehen, die von verfügbaren Ressourcen verarbeitet werden können.

Beispiele

Create server trust group

PUT https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/locations/Japan East/serverTrustGroups/server-trust-group-test?api-version=2021-11-01

{
  "properties": {
    "groupMembers": [
      {
        "serverId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/managedInstances/managedInstance-1"
      },
      {
        "serverId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/managedInstances/managedInstance-2"
      }
    ],
    "trustScopes": [
      "GlobalTransactions",
      "ServiceBroker"
    ]
  }
}


import com.azure.resourcemanager.sql.fluent.models.ServerTrustGroupInner;
import com.azure.resourcemanager.sql.models.ServerInfo;
import com.azure.resourcemanager.sql.models.ServerTrustGroupPropertiesTrustScopesItem;
import java.util.Arrays;

/**
 * Samples for ServerTrustGroups CreateOrUpdate.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/ServerTrustGroupCreate.json
     */
    /**
     * Sample code: Create server trust group.
     * 
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void createServerTrustGroup(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getServerTrustGroups().createOrUpdate("Default", "Japan East",
            "server-trust-group-test",
            new ServerTrustGroupInner().withGroupMembers(Arrays.asList(new ServerInfo().withServerId(
                "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/managedInstances/managedInstance-1"),
                new ServerInfo().withServerId(
                    "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/managedInstances/managedInstance-2")))
                .withTrustScopes(Arrays.asList(ServerTrustGroupPropertiesTrustScopesItem.GLOBAL_TRANSACTIONS,
                    ServerTrustGroupPropertiesTrustScopesItem.SERVICE_BROKER)),
            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

Beispiel für eine Antwort

Statuscode:: 200

{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/locations/Japan East/serverTrustGroups/server-trust-group-test",
  "name": "server-trust-group-test",
  "properties": {
    "groupMembers": [
      {
        "serverId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/managedInstances/managedInstance-1"
      },
      {
        "serverId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/managedInstances/managedInstance-2"
      }
    ],
    "trustScopes": [
      "GlobalTransactions",
      "ServiceBroker"
    ]
  },
  "type": "Microsoft.Sql/locations/serverTrustGroups"
}

Statuscode:: 201

{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/locations/Japan East/serverTrustGroups/server-trust-group-test",
  "name": "server-trust-group-test",
  "properties": {
    "groupMembers": [
      {
        "serverId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/managedInstances/managedInstance-1"
      },
      {
        "serverId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/managedInstances/managedInstance-2"
      }
    ],
    "trustScopes": [
      "GlobalTransactions",
      "ServiceBroker"
    ]
  },
  "type": "Microsoft.Sql/locations/serverTrustGroups"
}

Statuscode:: 202

Definitionen

Name	Beschreibung
ServerInfo	Serverinformationen für die Serververtrauensgruppe.
ServerTrustGroup	Eine Serververtrauensgruppe.
TrustScopes	Vertrauensbereich der Server-Vertrauensstellungsgruppe.

ServerInfo

Serverinformationen für die Serververtrauensgruppe.

Name	Typ	Beschreibung
serverId	string	Server-ID.

ServerTrustGroup

Eine Serververtrauensgruppe.

Name	Typ	Beschreibung
id	string	Ressourcen-ID
name	string	Name der Ressource.
properties.groupMembers	ServerInfo[]	Gruppenmitgliederinformationen für die Serververtrauensgruppe.
properties.trustScopes	TrustScopes[]	Vertrauensbereich der Server-Vertrauensstellungsgruppe.
type	string	Der Ressourcentyp.

TrustScopes

Vertrauensbereich der Server-Vertrauensstellungsgruppe.

Name	Typ	Beschreibung
GlobalTransactions	string
ServiceBroker	string

Freigeben über