Server Trust Groups - Create Or Update

Servicio:: SQL Database

Versión de la API:: 2021-11-01

Crea o actualiza un grupo de confianza de servidor.

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

Parámetros de identificador URI

Nombre	En	Requerido	Tipo	Description
locationName	path	True	string	Nombre de la región donde se encuentra el recurso.
resourceGroupName	path	True	string	Nombre del grupo de recursos que contiene el recurso. Puede obtener este valor desde la API de Azure Resource Manager o el portal.
serverTrustGroupName	path	True	string	Nombre del grupo de confianza del servidor.
subscriptionId	path	True	string	Identificador de suscripción que identifica una suscripción de Azure.
api-version	query	True	string	Versión de la API que se va a usar para la solicitud.

Cuerpo de la solicitud

Nombre	Requerido	Tipo	Description
properties.groupMembers	True	ServerInfo[]	Información de los miembros del grupo de confianza del servidor.
properties.trustScopes	True	TrustScopes[]	Ámbito de confianza del grupo de confianza del servidor.

Respuestas

Nombre	Tipo	Description
200 OK	ServerTrustGroup	Se actualizó correctamente el grupo de confianza del servidor.
201 Created	ServerTrustGroup	Se creó correctamente el grupo de confianza del servidor.
202 Accepted		Aceptado
Other Status Codes		Respuestas de error: *** 400 ServerTrustGroupCreateRequestInvalid: las propiedades de recurso o recurso del cuerpo de la solicitud están vacías o no son válidas 400 ServerTrustGroupCreateRequestInvalidGroupMembers: la propiedad de miembros del grupo en el cuerpo de la solicitud está vacía o no es válida. 400 ServerTrustGroupCreateRequestInvalidGroupMembersCount: la propiedad de miembros del grupo tiene un número no válido de servidores 400 ServerTrustGroupCreateRequestInvalidServer: el campo serverId especificado en el cuerpo de la solicitud del grupo de confianza de servidor está vacío o no es válido. 400 ServerTrustGroupCreateRequestDuplicateServer: uno o varios de los servidores proporcionados son duplicados. 400 ServerTrustGroupCreateRequestInvalidTrustScopes: la propiedad de ámbito de confianza del cuerpo de la solicitud está vacía o no es válida. 400 ServerTrustGroupCreateRequestInvalidTrustScopesValue: la propiedad de ámbito de confianza del cuerpo de la solicitud tiene un valor no válido. 400 ServerTrustGroupCreateRequestInvalidGroupMembersCount2: la propiedad de miembros del grupo tiene un número no válido de servidores 404 ServerTrustGroupNotFound: el grupo de confianza del servidor con el nombre especificado no existe. 404 OperationIdNotFound: la operación con id. no existe. 404 ResourceNotFound: no se encontró el recurso solicitado. 404 OperationIdNotFound: la operación con id. no existe. 406 ServerTrustGroupMemberIsBusy: el miembro de grupo '{0}' no está en un estado válido y no puede realizar la operación del grupo de confianza del servidor. 406 ServerTrustGroupInInvalidState: el grupo de confianza de SQL '{0}' está ocupado y no puede realizar la operación solicitada. 406 ServerTrustGroupMemberNotFound: no se encuentra el miembro del grupo '{0}' , por lo que no se puede realizar la operación del grupo de confianza del servidor. 409 OperationCancelled: el usuario canceló la operación. 409 OperationInterrupted: no se pudo completar la operación en el recurso porque se interrumpió otra operación en el mismo recurso. 429 SubscriptionTooManyCreateUpdateRequests: solicitudes más allá de las solicitudes máximas que pueden procesar los recursos disponibles. 429 SubscriptionTooManyRequests: solicitudes más allá de las solicitudes máximas que los recursos disponibles pueden procesar. 500 OperationTimedOut: la operación agota el tiempo de espera y se revierte automáticamente. Vuelva a intentar la operación. 503 TooManyRequests: solicitudes más allá de las solicitudes máximas que pueden procesar los recursos disponibles.

Ejemplos

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

Respuesta de muestra

status code:: 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"
}

status code:: 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"
}

status code:: 202

Definiciones

Nombre	Description
ServerInfo	Información del servidor para el grupo de confianza del servidor.
ServerTrustGroup	Un grupo de confianza de servidor.
TrustScopes	Ámbito de confianza del grupo de confianza del servidor.

ServerInfo

Object

Información del servidor para el grupo de confianza del servidor.

Nombre	Tipo	Description
serverId	string	Id. de servidor.

ServerTrustGroup