Crear unifiedGroupSourceCreate unifiedGroupSource

15/01/2021
Tiempo de lectura: 3 minutos

Espacio de nombres: microsoft.graphNamespace: microsoft.graph

Importante

Las API de la /beta versión de Microsoft Graph están sujetas a cambios.APIs under the /beta version in Microsoft Graph are subject to change. No se admite el uso de estas API en aplicaciones de producción.Use of these APIs in production applications is not supported. Para determinar si una API está disponible en v1.0, usa el selector de versiones.To determine whether an API is available in v1.0, use the Version selector.

Cree un nuevo objeto unifiedGroupSource.Create a new unifiedGroupSource object.

PermisosPermissions

Se requiere uno de los siguientes permisos para llamar a esta API. Para obtener más información, incluido cómo elegir permisos, vea Permisos.One of the following permissions is required to call this API. To learn more, including how to choose permissions, see Permissions.

Tipo de permisoPermission type	Permisos (de menos a más privilegiados)Permissions (from least to most privileged)
Delegado (cuenta profesional o educativa)Delegated (work or school account)	User.ReadUser.Read
Delegado (cuenta personal de Microsoft)Delegated (personal Microsoft account)	No admitida.Not supported.
AplicaciónApplication	No admitida.Not supported.

Solicitud HTTPHTTP request

POST /compliance/ediscovery/cases/4c8f8f70-7785-4bd4-b296-c98376a2c5e1/custodians/2192ca408ea2410eba3bec8ae873be6b/unifiedGroupSources

Encabezados de solicitudRequest headers

NombreName	DescripciónDescription
AuthorizationAuthorization	{token} de portador. Obligatorio.Bearer {token}. Required.
Content-TypeContent-Type	application/json. Obligatorio.application/json. Required.

Cuerpo de la solicitudRequest body

En el cuerpo de la solicitud, proporcione una representación JSON del objeto unifiedGroupSource.In the request body, supply a JSON representation of the unifiedGroupSource object.

En la tabla siguiente se muestran las propiedades necesarias para crear el objeto unifiedGroupSource.The following table shows the properties that are required when you create the unifiedGroupSource.

PropiedadProperty	TipoType	DescripciónDescription
includedSourcesincludedSources	sourceTypesourceType	Especifica qué orígenes se incluyen en este grupo.Specifies which sources are included in this group. Los valores posibles son `mailbox` y `site`.Possible values are: `mailbox`, `site`.
group@odata.bindgroup@odata.bind	StringString	Identificador del grupo.ID of the group. Para obtener el identificador de grupo, use la operación de grupos de lista.To get the group ID, use the List groups operation.

RespuestaResponse

Si se realiza correctamente, este método devuelve un código 201 Created de respuesta y un objeto unifiedGroupSource en el cuerpo de la respuesta.If successful, this method returns a 201 Created response code and a unifiedGroupSource object in the response body.

EjemplosExamples

SolicitudRequest

POST https://graph.microsoft.com/beta/compliance/ediscovery/cases/{ediscoveryCaseId}/custodians/{custodianId}/unifiedGroupSources
Content-Type: application/json
Content-length: 219

{
  "group@odata.bind": "/groups/000044f9-47c8-4a87-bccf-291fbf006a54",
  "includedSources":  "mailbox, site"
}


GraphServiceClient graphClient = new GraphServiceClient( authProvider );

var unifiedGroupSource = new Microsoft.Graph.Ediscovery.UnifiedGroupSource
{
    IncludedSources = Microsoft.Graph.Ediscovery.SourceType.Mailbox | Microsoft.Graph.Ediscovery.SourceType.Site,
    AdditionalData = new Dictionary<string, object>()
    {
        {"group@odata.bind", "/groups/000044f9-47c8-4a87-bccf-291fbf006a54"}
    }
};

await graphClient.Compliance.Ediscovery.Cases["{ediscoveryCaseId}"].Custodians["{custodianId}"].UnifiedGroupSources
    .Request()
    .AddAsync(unifiedGroupSource);

Importante

Los SDK de Microsoft Graph usan la versión v 1.0 de la API de forma predeterminada y no admiten todos los tipos, las propiedades y las API disponibles en la versión beta.Microsoft Graph SDKs use the v1.0 version of the API by default, and do not support all the types, properties, and APIs available in the beta version. Para obtener más información sobre cómo obtener acceso a la API beta con el SDK, vea usar los SDK de Microsoft Graph con la API de la versión beta.For details about accessing the beta API with the SDK, see Use the Microsoft Graph SDKs with the beta API.

Lea la documentación del SDK para obtener más información sobre cómo Agregar el SDK a su proyecto y crear una instancia de authProvider.Read the SDK documentation for details about how to add the SDK to your project and create an authProvider instance.


const options = {
    authProvider,
};

const client = Client.init(options);

const unifiedGroupSource = {
  group@odata.bind: "/groups/000044f9-47c8-4a87-bccf-291fbf006a54",
  includedSources:  "mailbox, site"
};

let res = await client.api('/compliance/ediscovery/cases/{ediscoveryCaseId}/custodians/{custodianId}/unifiedGroupSources')
    .version('beta')
    .post(unifiedGroupSource);

Importante


MSHTTPClient *httpClient = [MSClientFactory createHTTPClientWithAuthenticationProvider:authenticationProvider];

NSString *MSGraphBaseURL = @"https://graph.microsoft.com/beta/";
NSMutableURLRequest *urlRequest = [NSMutableURLRequest requestWithURL:[NSURL URLWithString:[MSGraphBaseURL stringByAppendingString:@"/compliance/ediscovery/cases/{ediscoveryCaseId}/custodians/{custodianId}/unifiedGroupSources"]]];
[urlRequest setHTTPMethod:@"POST"];
[urlRequest setValue:@"application/json" forHTTPHeaderField:@"Content-Type"];

MSGraphEdiscoveryUnifiedGroupSource *unifiedGroupSource = [[MSGraphEdiscoveryUnifiedGroupSource alloc] init];
[unifiedGroupSource setIncludedSources: [MSGraphEdiscoverySourceType mailbox]];

NSError *error;
NSData *unifiedGroupSourceData = [unifiedGroupSource getSerializedDataWithError:&error];
[urlRequest setHTTPBody:unifiedGroupSourceData];

MSURLSessionDataTask *meDataTask = [httpClient dataTaskWithRequest:urlRequest 
    completionHandler: ^(NSData *data, NSURLResponse *response, NSError *nserror) {

        //Request Completed

}];

[meDataTask execute];

Importante


IGraphServiceClient graphClient = GraphServiceClient.builder().authenticationProvider( authProvider ).buildClient();

UnifiedGroupSource unifiedGroupSource = new UnifiedGroupSource();
unifiedGroupSource.additionalDataManager().put("group@odata.bind", new JsonPrimitive("/groups/000044f9-47c8-4a87-bccf-291fbf006a54"));
unifiedGroupSource.includedSources = EnumSet.of(SourceType.MAILBOX,SourceType.SITE);

graphClient.compliance().ediscovery().cases("{ediscoveryCaseId}").custodians("{custodianId}").unifiedGroupSources()
    .buildRequest()
    .post(unifiedGroupSource);

Importante

RespuestaResponse

Nota: Se puede acortar el objeto de respuesta que se muestra aquí para mejorar la legibilidad.Note: The response object shown here might be shortened for readability.

HTTP/1.1 201 Created
Content-Type: application/json

{
  "group@odata.bind": "/groups/000044f9-47c8-4a87-bccf-291fbf006a54",
  "includedSources":  "mailbox, site",
  "id": "14202dd90a1f4ccc84929586326c7104",
  "displayName": "SFA Videos",
  "createdDateTime": "2020-03-13T22:38:00.8985662Z",
  "createdBy": {
      "user": {
          "id": "efee1b77-fb3b-4f65-99d6-274c11914d12",
          "displayName": "Megan Bowen"
      }
  }
}

Crear unifiedGroupSourceCreate unifiedGroupSource

PermisosPermissions

Solicitud HTTPHTTP request

Encabezados de solicitudRequest headers

Cuerpo de la solicitudRequest body

RespuestaResponse

EjemplosExamples

SolicitudRequest

RespuestaResponse

¿Le ha resultado útil esta página?

¿Le ha resultado útil esta página?