Table of contents

Dávkové zpracování | Rozhraní Graph API konceptyBatch processing | Graph API concepts

Jimaco Brannian|Poslední aktualizace: 22. 6. 2018
|
1 Přispěvatel

Platí pro: Graph API | Azure Active Directory (AD)Applies to: Graph API | Azure Active Directory (AD)

S Azure AD Graph API můžete dávkové operace na entity ke snížení zbytečné komunikace se serverem.With Azure AD Graph API, you can batch operations on entities to reduce roundtrips to the server.Dávkování své žádosti snižuje nároky na síť a vaše operace bude dokončeno rychleji.Batching your requests reduces network overhead, and your operations will complete more quickly.

Důležité

Důrazně doporučujeme použít Microsoft Graph místo Azure AD Graph API pro přístup k prostředkům Azure Active Directory.We strongly recommend that you use Microsoft Graph instead of Azure AD Graph API to access Azure Active Directory resources.Náš vývojový program jsou nyní soustředit na Microsoft Graph a dále jsou plánované pro Azure AD Graph API.Our development efforts are now concentrated on Microsoft Graph and no further enhancements are planned for Azure AD Graph API.Je velmi omezený počet scénářů, pro které Azure AD Graph API může být vhodné; Další informace najdete v tématu Microsoft Graph nebo Azure AD Graph příspěvku na blogu v Office Dev Center.There are a very limited number of scenarios for which Azure AD Graph API might still be appropriate; for more information, see the Microsoft Graph or the Azure AD Graph blog post in the Office Dev Center.Všimněte si, že není aktuálně podporované dávkové zpracování v aplikaci Microsoft Graph; musíte použít Azure AD Graph API pro tuto funkci.Note that batch processing is not currently supported in Microsoft Graph; you will need to use Azure AD Graph API for this feature.

Podpora rozhraní Graph API pro dávkové žádosti OData Graph API support for OData batch requests

Sémantika pro dávkové zpracování entity jsou definovány OData 3.0 dávkové zpracování specifikace.The semantics for entity batch processing are defined by the OData 3.0 Batch Processing Specification.Specifikace prostředí OData definuje následující koncepty pro dávkové požadavky:The OData specification defines the following concepts for batch requests:

  • Dotaz je jeden dotaz nebo funkce volání.A query is a single query or function invocation.
  • Sady změn je skupina jednoho nebo více vložit, aktualizovat nebo odstranit operace, akce volání nebo volání služby.A change set is a group of one or more insert, update, or delete operations, action invocations, or service invocations.
  • Batch je kontejner operace, včetně jeden nebo více změnit sady a dotaz operace.A batch is a container of operations, including one or more change sets and query operations.

Rozhraní Graph API podporuje podmnožinu funkcí definované specifikací OData:The Graph API supports a subset of the functionality defined by the OData specification:

  • Jeden batch může obsahovat maximálně pět dotazy nebo změnit sady kombinaci.A single batch can contain a maximum of five queries and/or change sets combined.
  • Sady změn může obsahovat maximálně jeden zdrojový objekt změny a až 20 operace přidat odkaz a odstraní propojení kombinaci.A change set can contain a maximum of one source object modification and up to 20 add-link and delete-link operations combined.Všechny operace v sadě změn musí být u jedné zdrojové entity.All operations in the change set must be on a single source entity.

Rozhraní Graph API dávkových žádostí Graph API batch requests

Následující části popisují postup vytvoření dávkového požadavku, jak interpretovat dávkové odpovědi a zobrazit ukázky jednotlivých.The following sections describe how to construct a batch request, how to interpret the batch response, and show samples of each.

Syntaxe požadavku batchBatch request syntax

K provedení dávkového požadavku, zadejte možnost $batch v identifikátoru URI požadavku.To perform a batch request, specify the $batch option on the request URI.Příklad:For example:

https://graph.windows.net/contoso.onmicrosoft.com/$batch?api-version=1.6

Dávkového požadavku je odeslat na server s direktivu jeden POST.A batch request is sent to the server with a single POST directive.

Datové části je vícedílné zprávě standardu MIME obsahující dávky a jeho základní dotazy a sady změn.The payload is a multi-part MIME message containing the batch and its constituent queries and change sets.Datová část obsahuje dva typy MIME hranic:The payload includes two types of MIME boundaries:

  • Hranice batch odděluje jednotlivé sady dotazu nebo změny v dávce.A batch boundary separates each query and/or change set in the batch.
  • Hranice sadu změn odděluje jednotlivé operace v rámci sady změn.A change set boundary separates individual operations within a change set.

Jednotlivé požadavky v rámci sady změn je stejný jako požadavek při této operace je volána samostatně.An individual request within a change set is identical to a request made when that operation is called by itself.Příklad:For example:

  • Chcete-li určit formát datové části (JSON nebo ATOM) pro každou operaci v této sady změn, patří odpovídající Content-Type a v případě potřeby, hlavičky Accept.To specify the payload format (JSON or ATOM) for each operation in the change set, include the appropriate Content-Type and, if needed, Accept headers.
  • Při vytváření entity potlačit echo obsahu odpovědi, zadejte hlavičku Prefer s hodnotou obsah no vrátí pro každou operaci vložení v sadě změn.To suppress the response content echo when creating an entity, specify the Prefer header with the return-no-content value for each insert operation in a change set.

Ukázková žádostSample request

Následující příklad ukazuje dávkového požadavku, která obsahuje pět položky:The following example shows a batch request that contains five items:

  1. A Změna nastavení, která vytvoří uživatele, testuser@contoso.onmicrosoft.com (POST).A change set that creates a user, testuser@contoso.onmicrosoft.com (POST).Tato operace zahrnuje Prefer: obsah odpovědi ne záhlaví potlačit nevrátila nově vytvořeného uživatele.This operation includes the Prefer: response-no-content header to suppress the newly created user being returned.
  2. Sady změn, který aktualizuje vlastnosti oddělení a pracovní zařazení nového uživatele (oprava) a nastaví její manager navigační vlastnosti (PUT).A change set that updates the Department and Job Title properties of the new user (PATCH), and sets its manager navigation property (PUT).
  3. Dotaz pro správce nového uživatele (GET).A query for the manager of the new user (GET).
  4. Sady změn, které odstraní nového uživatele (odstranit).A change set that deletes the new user (DELETE).
  5. Dotaz pro uživatele (GET).A query for the user (GET).Tato operace selže, protože byl uživatel odstraněn v předchozím kroku.This operation will fail because the user was deleted in the previous step.
POST https://graph.windows.net/contoso.onmicrosoft.com/$batch?api-version=1.5 HTTP/1.1
Authorization: Bearer ey … jQA
Content-Type: multipart/mixed; boundary=batch_36522ad7-fc75-4b56-8c71-56071383e77b 
Host: graph.windows.net
Content-Length: 2961

--batch_36522ad7-fc75-4b56-8c71-56071383e77b 
Content-Type: multipart/mixed; boundary=changeset_77162fcd-b8da-41ac-a9f8-9357efbbd620 
Content-Length: 631       

--changeset_77162fcd-b8da-41ac-a9f8-9357efbbd620 
Content-Type: application/http 
Content-Transfer-Encoding: binary 

POST /contoso.onmicrosoft.com/users?api-version=1.5 HTTP/1.1
Content-Type: application/json
Accept: application/json
Content-Length: 256
Prefer: return-no-content
Host: graph.windows.net

{
    "accountEnabled": true,
    "displayName": "Test User",
    "mailNickname": "testuser",
    "passwordProfile": { "password" : "Test1234", "forceChangePasswordNextLogin": false },
    "userPrincipalName": "testuser@contoso.onmicrosoft.com"
}

--changeset_77162fcd-b8da-41ac-a9f8-9357efbbd620----batch_36522ad7-fc75-4b56-8c71-56071383e77b 
Content-Type: multipart/mixed; boundary=changeset_4b2cbfb7-011d-4edb-8bbf-e044f9830aaf 
Content-Length: 909

--changeset_4b2cbfb7-011d-4edb-8bbf-e044f9830aaf 
Content-Type: application/http 
Content-Transfer-Encoding: binary 

PATCH /contoso.onmicrosoft.com/users/testuser@contoso.onmicrosoft.com?api-version=1.5 HTTP/1.1
Content-Type: application/json
Accept: application/json
Content-Length: 72
Host: graph.windows.net

{
    "department": "Engineering",
    "jobTitle": "Test Engineer"
}

--changeset_4b2cbfb7-011d-4edb-8bbf-e044f9830aaf 
Content-Type: application/http 
Content-Transfer-Encoding: binary 

PUT /contoso.onmicrosoft.com/users/testuser@contoso.onmicrosoft.com/$links/manager?api-version=1.5 HTTP/1.1
Content-Type: application/json
Accept: application/json
Content-Length: 112
Host: graph.windows.net

{
  "url":"https://graph.windows.net/contoso.onmicrosoft.com/users/a71e4d1c-ce99-40dc-8d4b-390eac63e039"
}

--changeset_4b2cbfb7-011d-4edb-8bbf-e044f9830aaf----batch_36522ad7-fc75-4b56-8c71-56071383e77b 
Content-Type: application/http 
Content-Transfer-Encoding:binary

GET /contoso.onmicrosoft.com/users/testuser@contoso.onmicrosoft.com/$links/manager?api-version=1.5 HTTP/1.1
Accept: application/json
Host: graph.windows.net

--batch_36522ad7-fc75-4b56-8c71-56071383e77b 
Content-Type: multipart/mixed; boundary=changeset_9a0b5878-0f4a-4f57-91c5-9792cdd5ef20 
Content-Length: 331       

--changeset_9a0b5878-0f4a-4f57-91c5-9792cdd5ef20 
Content-Type: application/http 
Content-Transfer-Encoding: binary 

DELETE /contoso.onmicrosoft.com/users/testuser@contoso.onmicrosoft.com?api-version=1.5 HTTP/1.1
Accept: application/json
Host: graph.windows.net


--changeset_9a0b5878-0f4a-4f57-91c5-9792cdd5ef20----batch_36522ad7-fc75-4b56-8c71-56071383e77b 
Content-Type: application/http 
Content-Transfer-Encoding:binary

GET /contoso.onmicrosoft.com/users/testuser@contoso.onmicrosoft.com?api-version=1.5 HTTP/1.1
Accept: application/json
Host: graph.windows.net

--batch_36522ad7-fc75-4b56-8c71-56071383e77b--

Syntaxe odpověď dávky Batch response syntax

Odpověď se vrátí celkové stavový kód pro dávkový požadavek a jednotlivé stavové kódy a výsledek fragmenty pro každou položku v dávce.The response returns an overall status code for the batch request, and individual status codes and result fragments for each item in the batch.Odpověď je vícedílné zprávě standardu MIME zahrnující batch hranice a změně sady hranice.The response is a multi-part MIME message that includes batch boundaries and change set boundaries.

Za předpokladu, že dávkový požadavek byl správně ověřen a byla úspěšně přijata pomocí rozhraní Graph API, dávkovou žádost vrátí stavový kód 202 platnýchi v případě, že jeden z operace v dávce selže.Assuming that the batch request has been properly authenticated and has been successfully received by the Graph API, the batch request returns status code 202 Accepted, even if one of the operations in the batch fails.Pokud žádost o dávkové samotné selže, dojde k chybě před provedením jakékoli operace v dávce.If the batch request itself fails, it fails before any operation in the batch is executed.Například dávkovou žádost může selhat z důvodu chyby ověřování, ve kterém případ stavový kód označí tohoto selhání.For example, the batch request may fail due to an authentication error, in which case the status code will indicate that failure.

Fragment odpověď pro položku dotazu obsahuje kód jednoho stavu, který udává úspěch nebo selhání operace, stejně jako žádné příslušné text odpovědi.The response fragment for a query item contains a single status code that indicates either the success or failure of the operation as well as any response body appropriate.

Operace v sadě změn se zpracovávají atomicky; To znamená buď úspěšné všechny operace v sadě změn nebo celý změně sady selže.The operations in a change set are processed atomically; that is, either all operations in the change set succeed, or the entire change set fails.Rozhraní Graph API bude pokračovat zpracování operace změnit nastavení, dokud jeden server selže.The Graph API continues processing operations in the change set until one fails.Pokud operace selže, všechny předchozí operace v sadě změny budou vráceny.If an operation fails, all preceding operations in the change set are rolled back.

Pokud všechny operace v sadě změn úspěšně zpracována, kód stavu (a odpovědi) pro každou operaci v rámci této sady změn v rámci odpověď sady změn.If all operations in a change set are successfully processed, the status code (and response body) for each operation within the change set appears within the change set response.Pokud se nezdaří operace v sadě změn, se vrátí jenom jeden stavový kód pro sadu změn.If an operation in a change set fails, then only a single status code is returned for the change set.To bude kód stavu (a odpovědi) vrácená operací se nezdařilo; například 400 – Chybný požadavek nebo 404 nebyl nalezen.This will be the status code (and response body) returned by the failed operation; for example, 400 Bad Request or 404 Not Found.

Ukázková odpověďSample response

Následující příklad ukazuje odpovědi pro dávkové operace odeslaných v požadavku ukázka uvedené výše.The following example shows the response for the batch operation sent in the sample request shown above.Je nastaven stav pro dávkový požadavek samotné 202 platných.The status for the batch request itself is set to 202 Accepted.Znamená to, že existuje žádné problémy s dávkového požadavku sám sebe.This indicates that there no problems with the batch request itself.Odpověď na každou položku v dávce jsou odděleny dávkové odpovědi identifikátor hranic a každá odpověď operace v rámci sady změn je oddělený s changesetresponse hranic identifikátor.The response to each item in the batch is delimited with the batchresponse boundary identifier and each response to an operation within a change set is delimited with a changesetresponse boundary identifier.

Fragmenty odpovědi pro každou položku batch jsou následující:The following lists the response fragments for each batch item:

  1. Stav požadavku POST k vytvoření nového uživatele nastaven na 204 ne obsahu.The status for the POST request to create the new user is set to 204 No Content.Důvodem je, že Prefer záhlaví byla nastavena na return-no-content v požadavku.This is because the Prefer header was set to return-no-content in the request.Označuje, že uživatel byl úspěšně vytvořen.It indicates that the user was successfully created.
  2. Odpověď pro položku druhý batch obsahuje dva 204 ne obsahu odpovědi, jeden pro aktualizaci objektu uživatele (oprava) a jeden pro nastavení správce odkaz (PUT) v této sady změn.The response for the second batch item contains two 204 No Content responses, one for the user object update (PATCH) and one for setting the manager link (PUT) in the change set.To znamená, že oba operace byla úspěšná.This indicates that both operations were successful.
  3. Odpovědi na požadavek načíst uživatele správce, vrátí odkaz na správce a stav 200 OK.The response for the request to read the user’s manager, returns the link to the manager and a status of 200 OK.
  4. Stav pro pokus o odstranění uživatele, je 204 ne obsahu.The status for the attempt to delete the user, is 204 No Content.To znamená, že operace byla úspěšnáThis indicates that the operation was successful
  5. Stav pro pokus o čtení Odstraněný uživatel je 404 nebyl nalezen a odpovědi obsahuje kód a zpráva, která určuje, že uživatel (prostředků) nebyl nalezen.The status for the attempt to read the deleted user, is 404 Not Found and the response contains a code and message that indicates that the user (resource) was not found.
HTTP/1.1 202 Accepted
Cache-Control: no-cache
Pragma: no-cache
Content-Type: multipart/mixed; boundary=batchresponse_1eb70252-25d2-466c-9a1d-7a3f45378b06
Expires: -1
Server: Microsoft-IIS/8.5
ocp-aad-diagnostics-server-name: Nv0YIi2YUldDWu0YPQAXsYwXQ4ttyr7ded6Waf8xyCc=
request-id: 2f7d2f81-3441-4c2a-b494-25cd1d6ce624
client-request-id: f40c00af-3e1f-4198-9261-386f0e3aecc6
x-ms-gateway-rewrite: false
x-ms-dirapi-data-contract-version: 1.5
ocp-aad-session-key: cdhenl3mgHuI3vaRRIQ14uXdwRLUqirNpDXjJP42EzUEvqhhn2NFr22ulR4PsqrM1UD_eSUDItt7J9kUQhNvTT_48q90coHHt2RutCIgPNg.lD81Z0iS2SaHbqkfAaDvbbigoX7ak7rfiUGFby0LOIE
X-Content-Type-Options: nosniff
DataServiceVersion: 1.0;
Strict-Transport-Security: max-age=31536000; includeSubDomains
X-AspNet-Version: 4.0.30319
X-Powered-By: ASP.NET
X-Powered-By: ASP.NET
Date: Tue, 20 Jan 2015 23:21:15 GMT
Content-Length: 3065

--batchresponse_1eb70252-25d2-466c-9a1d-7a3f45378b06
Content-Type: multipart/mixed; boundary=changesetresponse_8a63ce5e-ed31-4de6-bc90-9d3ff31debbb--changesetresponse_8a63ce5e-ed31-4de6-bc90-9d3ff31debbb
Content-Type: application/http
Content-Transfer-Encoding: binary

HTTP/1.1 204 No Content
X-Content-Type-Options: nosniff
Cache-Control: no-cache
Preference-Applied: return-no-content
DataServiceVersion: 3.0;
Location: https://graph.windows.net/contoso.onmicrosoft.com/directoryObjects/6a287a96-ede9-44d2-b685-d6fc03a124c5/Microsoft.DirectoryServices.User
DataServiceId: https://graph.windows.net/contoso.onmicrosoft.com/directoryObjects/6a287a96-ede9-44d2-b685-d6fc03a124c5


--changesetresponse_8a63ce5e-ed31-4de6-bc90-9d3ff31debbb----batchresponse_1eb70252-25d2-466c-9a1d-7a3f45378b06
Content-Type: multipart/mixed; boundary=changesetresponse_11ba5cf0-9fba-4995-9f15-bd5c9981cdd6--changesetresponse_11ba5cf0-9fba-4995-9f15-bd5c9981cdd6
Content-Type: application/http
Content-Transfer-Encoding: binary

HTTP/1.1 204 No Content
X-Content-Type-Options: nosniff
Cache-Control: no-cache
DataServiceVersion: 1.0;


--changesetresponse_11ba5cf0-9fba-4995-9f15-bd5c9981cdd6
Content-Type: application/http
Content-Transfer-Encoding: binary

HTTP/1.1 204 No Content
X-Content-Type-Options: nosniff
Cache-Control: no-cache
DataServiceVersion: 1.0;


--changesetresponse_11ba5cf0-9fba-4995-9f15-bd5c9981cdd6----batchresponse_1eb70252-25d2-466c-9a1d-7a3f45378b06
Content-Type: application/http
Content-Transfer-Encoding: binary

HTTP/1.1 200 OK
DataServiceVersion: 3.0;
Content-Type: application/json;odata=minimalmetadata;streaming=true;charset=utf-8
X-Content-Type-Options: nosniff
Cache-Control: no-cache

{
  "odata.metadata":"https://graph.windows.net/contoso.onmicrosoft.com/$metadata#directoryObjects/$links/manager",
  "url":"https://graph.windows.net/contoso.onmicrosoft.com/directoryObjects/a71e4d1c-ce99-40dc-8d4b-390eac63e039/Microsoft.DirectoryServices.User"
}
--batchresponse_1eb70252-25d2-466c-9a1d-7a3f45378b06
Content-Type: multipart/mixed; boundary=changesetresponse_bb215a84-f91e-4486-a771-ba2cc5d429d1--changesetresponse_bb215a84-f91e-4486-a771-ba2cc5d429d1
Content-Type: application/http
Content-Transfer-Encoding: binary

HTTP/1.1 204 No Content
X-Content-Type-Options: nosniff
Cache-Control: no-cache
DataServiceVersion: 1.0;


--changesetresponse_bb215a84-f91e-4486-a771-ba2cc5d429d1----batchresponse_1eb70252-25d2-466c-9a1d-7a3f45378b06
Content-Type: application/http
Content-Transfer-Encoding: binary

HTTP/1.1 404 Not Found
X-Content-Type-Options: nosniff
Cache-Control: no-cache
DataServiceVersion: 3.0;
Content-Type: application/json;odata=minimalmetadata;streaming=true;charset=utf-8

{
  "odata.error":
    {
      "code":"Request_ResourceNotFound",
      "message":
        {
          "lang":"en",
          "value":"Resource 'testuser@contoso.onmicrosoft.com' does not exist or one of its queried reference-property objects are not present."
        }
    }
}
--batchresponse_1eb70252-25d2-466c-9a1d-7a3f45378b06--

Ukázka chybové odpovědiSample error response

Jak je popsáno výše, rozhraní Graph API vrátí kód chyby z 202 platných pro celý batch, pokud ho může přijmout na listu; který je, že pokud je ve správném formátu dávkovou žádost a nejsou žádné chyby, jako je například chyby ověřování.As discussed above, the Graph API returns an error code of 202 Accepted for the entire batch if it can accept the batch; that is, if the batch request is well-formed and there are no errors, such as an authentication error.Rozhraní Graph API, jinak vrátí příslušná chybová a nezpracovává dávky.Otherwise, the Graph API returns the appropriate error and does not process the batch.Pokud jednotlivé položky v dávce selže, bude obsahovat fragment odpovědi pro tuto položku Stav kód a odpovědi obsahu, která označuje, že chyba.If an individual item within the batch fails then the response fragment for that item will contain a status code and response body that indicates that error.Operace uvnitř změnu nastavena nezdaří, vrátí odpověď jedné fragment pro sadu celý změn a tento fragment bude obsahovat stav kód a odpovědi body přidružené k selhání operace.When an operation inside a change set fails, a single response fragment will be returned for the entire change set and that fragment will contain the status code and response body associated with the failed operation.

Následující příklad ukazuje na odpověď od dávková žádost obsahující sadu ve které jedna operace se nezdařila změn.The following example shows a response from batch request that contains a change set in which one of the operations failed.Všimněte si, že odpověď dávky vrátí stavový kód 202 platných.Note that the batch response returns status code 202 Accepted.Vrátí stavový kód pro sadu změn označuje, že operace se nezdařila se stavem 404 nebyl nalezen.The status code returned for the change set indicates that an operation failed with a status of 404 Not Found.Další informace o chybě je součástí odpovědi pro neúspěšnou operaci.Additional error information is included in the response body for the failed operation.Kód element určuje kód chyby rozhraní Graph API a zpráva element obsahuje řetězec chybové zprávy.The code element specifies the Graph API error code and the message element contains the error message string.V tomto příkladu má byl čitelnější odsazeny text odpovědi.In this example, the response body has been indented for readability.

HTTP/1.1 202 Accepted
Cache-Control: no-cache
Pragma: no-cache
Content-Type: multipart/mixed; boundary=batchresponse_3ac28387-a100-4758-8998-8b9ec36f9fdc
Expires: -1
Server: Microsoft-IIS/8.5
ocp-aad-diagnostics-server-name: 1l3fvSoDCV+VKoBCuHRN+HIwCACBOck3dqmtCGj+aiU=
request-id: e434261b-c32f-48b4-b21d-3e1beab6d525
client-request-id: 236bf26e-b4e8-40a4-b6fb-d41105a7b178
x-ms-gateway-rewrite: false
x-ms-dirapi-data-contract-version: 1.5
ocp-aad-session-key: 9aOaAUxX95OZ0ctrYbeLUproN-37GypZXrss0PYKhEfqamKRG-C68hFcCw5h-ZCWFqBrXPrldGEnjq4CKKr0bW91tjrdo-BlwAqHxbP5jq4.FaXtVZni3cSsWFRMSjQAbjiluPcEvZofwp9OH3t1fyk
X-Content-Type-Options: nosniff
DataServiceVersion: 1.0;
Strict-Transport-Security: max-age=31536000; includeSubDomains
X-AspNet-Version: 4.0.30319
X-Powered-By: ASP.NET
X-Powered-By: ASP.NET
Date: Wed, 21 Jan 2015 21:13:25 GMT
Content-Length: 779

--batchresponse_3ac28387-a100-4758-8998-8b9ec36f9fdc
Content-Type: multipart/mixed; boundary=changesetresponse_72ba9a5a-2da3-4d39-ae4f-dd9527efd742--changesetresponse_72ba9a5a-2da3-4d39-ae4f-dd9527efd742
Content-Type: application/http
Content-Transfer-Encoding: binary

HTTP/1.1 404 Not Found
X-Content-Type-Options: nosniff
DataServiceVersion: 3.0;
Content-Type: application/json;odata=minimalmetadata;streaming=true;charset=utf-8

{
  "odata.error":
    {
      "code":"Request_ResourceNotFound",
      "message":
        {
          "lang":"en",
          "value":"Resource 'eeeeeeee-eeee-eeee-eeee-eeeeeeeeeeee' does not exist or one of its queried reference-property objects are not present."
        }
    }
}
--changesetresponse_72ba9a5a-2da3-4d39-ae4f-dd9527efd742----batchresponse_3ac28387-a100-4758-8998-8b9ec36f9fdc--

Následující příklad ukazuje, pro referenci generovaný výše odpověď dávky.For reference, the following example shows the batch that generated the response above.Obsahuje sadu jediné změny, která přidá tři uživatele do skupiny.It contains a single change set that adds three users to a group.ID objektu pro poslední dva uživatelé jsou smyšlené: eeeeeeee-eeee-eeee-eeee-eeeeeeeeeeee a ffffffff-ffff-ffff-ffff-ffffffffffff.The Object IDs for the last two users are fictitious: eeeeeeee-eeee-eeee-eeee-eeeeeeeeeeee and ffffffff-ffff-ffff-ffff-ffffffffffff.Adresu batch URL a hlavičky přidružené žádosti byly vynechány jako stručný výtah.The batch URL and associated request headers are omitted for brevity.

--batch_36522ad7-fc75-4b56-8c71-56071383e77b 
Content-Type: multipart/mixed; boundary=changeset_5a769eb2-d1a7-4a10-94f6-d1a5ed5c4bc0 
Content-Length: 1432

--changeset_5a769eb2-d1a7-4a10-94f6-d1a5ed5c4bc0 
Content-Type: application/http 
Content-Transfer-Encoding: binary 

POST /contoso.onmicrosoft.com/groups/fc15e7ef-993f-4865-bf37-317d9b8017b8/$links/members?api-version=1.5 HTTP/1.1
Content-Type: application/json
Accept: application/json
Content-Length: 112
Host: graph.windows.net

{
  "url":"https://graph.windows.net/contoso.onmicrosoft.com/users/a71e4d1c-ce99-40dc-8d4b-390eac63e039"
}

--changeset_5a769eb2-d1a7-4a10-94f6-d1a5ed5c4bc0 
Content-Type: application/http 
Content-Transfer-Encoding: binary 

POST /contoso.onmicrosoft.com/groups/fc15e7ef-993f-4865-bf37-317d9b8017b8/$links/members?api-version=1.5 HTTP/1.1
Content-Type: application/json
Accept: application/json
Content-Length: 112
Host: graph.windows.net

{
  "url":"https://graph.windows.net/contoso.onmicrosoft.com/users/eeeeeeee-eeee-eeee-eeee-eeeeeeeeeeee
"
}

--changeset_5a769eb2-d1a7-4a10-94f6-d1a5ed5c4bc0 
Content-Type: application/http 
Content-Transfer-Encoding: binary 

POST /contoso.onmicrosoft.com/groups/fc15e7ef-993f-4865-bf37-317d9b8017b8/$links/members?api-version=1.5 HTTP/1.1
Content-Type: application/json
Accept: application/json
Content-Length: 112
Host: graph.windows.net

{
  "url":"https://graph.windows.net/contoso.onmicrosoft.com/users/ffffffff-ffff-ffff-ffff-ffffffffffff"
}

--changeset_5a769eb2-d1a7-4a10-94f6-d1a5ed5c4bc0----batch_36522ad7-fc75-4b56-8c71-56071383e77b--

Další zdroje informací Additional resources

© 2018 Microsoft