Getting SharePoint Sites
You can get a resource representation of organization SharePoint sites.
Request
GET https://<hostname>:4443/v6/RestoreSessions/{restoreSessionId}/Organization/Sites?parentId=<string> |
Request Headers
The request header must contain an authorization token of the current session.
Request Parameters
The following parameter must be specified in the URL of the request:
Parameter | Type | Description |
---|---|---|
restoreSessionId | string | Specifies the identification number of the restore session. For more information on how to get this parameter, see Getting Restore Sessions. |
The following optional parameter can be specified in the URL of the request:
Parameter | Type | Description |
---|---|---|
parentId | string | Specifies what information the server will return in the resource representation. The following values are available:
If you do not specify this parameter, the server will return a representation of all top-level SharePoint sites with their subsites. Thus, the server will require longer time to execute the request. |
Request Body
None.
Response
The server returns the following response to the client.
Response Codes
A successfully completed operation returns a response code 200 OK.
Response Headers
The response to this request contains the following headers. The response may also include additional standard HTTPS headers.
Header | Description |
---|---|
Content-length | The length of the response body. |
Content-type | The media type and syntax of the response body message: application/json; charset=utf-8 |
Response Body
In the response body the server returns a resource representation of the /RestoreSessions/{restoreSessionId}/Organization/Sites resource.
Examples
Example 1
The example returns a resource representation of the organization SharePoint sites.
Request: GET https://abc.tech.local:4443/v6/RestoreSessions/6a50c1ce-07e1-4ee9-9158-9150acb5c2eb/organization/sites
Request Header: Authorization: Bearer <Access-Token>
Response: 200 OK
Response Body: { "offset": 0, "limit": 30, "results": [ { "id": "b3184e77-b95b-45f7-96cc-180a20b61cbd8507931c-4561-4ddf-bc90-411aba44bb39", "name": "Administrator", "url": "http://server/sites/mySite", "_links": { "self": { "href": "/v6/RestoreSessions/6a50c1ce-07e1-4ee9-9158-9150acb5c2eb/organization/sites/b3184e77-b95b-45f7-96cc-180a20b61cbd8507931c-4561-4ddf-bc90-411aba44bb39" }, "sites": { "href": "/v6/RestoreSessions/6a50c1ce-07e1-4ee9-9158-9150acb5c2eb/organization/sites?parentId=b3184e77-b95b-45f7-96cc-180a20b61cbd8507931c-4561-4ddf-bc90-411aba44bb39" }, "libraries": { "href": "/v6/RestoreSessions/6a50c1ce-07e1-4ee9-9158-9150acb5c2eb/organization/sites/b3184e77-b95b-45f7-96cc-180a20b61cbd8507931c-4561-4ddf-bc90-411aba44bb39/libraries" }, "lists": { "href": "/v6/RestoreSessions/6a50c1ce-07e1-4ee9-9158-9150acb5c2eb/organization/sites/b3184e77-b95b-45f7-96cc-180a20b61cbd8507931c-4561-4ddf-bc90-411aba44bb39/lists" }, "documents": { "href": "/v6/RestoreSessions/6a50c1ce-07e1-4ee9-9158-9150acb5c2eb/organization/sites/b3184e77-b95b-45f7-96cc-180a20b61cbd8507931c-4561-4ddf-bc90-411aba44bb39/documents" }, "items": { "href": "/v6/RestoreSessions/6a50c1ce-07e1-4ee9-9158-9150acb5c2eb/organization/sites/b3184e77-b95b-45f7-96cc-180a20b61cbd8507931c-4561-4ddf-bc90-411aba44bb39/items" }, "folders": { "href": "/v6/RestoreSessions/6a50c1ce-07e1-4ee9-9158-9150acb5c2eb/organization/sites/b3184e77-b95b-45f7-96cc-180a20b61cbd8507931c-4561-4ddf-bc90-411aba44bb39/folders" } } }, { "id": "724011c3-a540-4684-b24f-3e2ab4ef6380df26ea7d-6468-4846-bdf5-4e88d871ed11", "name": "CopyTo User", "url": "http://server/personal/orgUser", "_links": { "self": { "href": "/v6/RestoreSessions/6a50c1ce-07e1-4ee9-9158-9150acb5c2eb/organization/sites/724011c3-a540-4684-b24f-3e2ab4ef6380df26ea7d-6468-4846-bdf5-4e88d871ed11" }, "sites": { "href": "/v6/RestoreSessions/6a50c1ce-07e1-4ee9-9158-9150acb5c2eb/organization/sites?parentId=724011c3-a540-4684-b24f-3e2ab4ef6380df26ea7d-6468-4846-bdf5-4e88d871ed11" }, "libraries": { "href": "/v6/RestoreSessions/6a50c1ce-07e1-4ee9-9158-9150acb5c2eb/organization/sites/724011c3-a540-4684-b24f-3e2ab4ef6380df26ea7d-6468-4846-bdf5-4e88d871ed11/libraries" }, "lists": { "href": "/v6/RestoreSessions/6a50c1ce-07e1-4ee9-9158-9150acb5c2eb/organization/sites/724011c3-a540-4684-b24f-3e2ab4ef6380df26ea7d-6468-4846-bdf5-4e88d871ed11/lists" }, "documents": { "href": "/v6/RestoreSessions/6a50c1ce-07e1-4ee9-9158-9150acb5c2eb/organization/sites/724011c3-a540-4684-b24f-3e2ab4ef6380df26ea7d-6468-4846-bdf5-4e88d871ed11/documents" }, "items": { "href": "/v6/RestoreSessions/6a50c1ce-07e1-4ee9-9158-9150acb5c2eb/organization/sites/724011c3-a540-4684-b24f-3e2ab4ef6380df26ea7d-6468-4846-bdf5-4e88d871ed11/items" }, "folders": { "href": "/v6/RestoreSessions/6a50c1ce-07e1-4ee9-9158-9150acb5c2eb/organization/sites/724011c3-a540-4684-b24f-3e2ab4ef6380df26ea7d-6468-4846-bdf5-4e88d871ed11/folders" } } } ], "_links": { "self": { "href": "/v6/RestoreSessions/6a50c1ce-07e1-4ee9-9158-9150acb5c2eb/organization/sites?offset=0&limit=30" } } } |
Example 2
The example returns a resource representation of the organization SharePoint subsites of a site with the specified ID.
Request: GET https://abc.tech.local:4443/v6/RestoreSessions/6a50c1ce-07e1-4ee9-9158-9150acb5c2eb/organization/sites?parentId=b3184e77-b95b-45f7-96cc-180a20b61cbd8507931c-4561-4ddf-bc90-411aba44bb39
Request Header: Authorization: Bearer <Access-Token>
Response: 200 OK
Response Body: { "offset": 0, "limit": 30, "results": [ { "id": "b3184e77-b95b-45f7-96cc-180a20b61cbd8507931c-4561-4ddf-bc90-411aba44bb39", "name": "Administrator", "url": "http://server/sites/mySite", "_links": { "self": { "href": "/v6/RestoreSessions/6a50c1ce-07e1-4ee9-9158-9150acb5c2eb/organization/sites/b3184e77-b95b-45f7-96cc-180a20b61cbd8507931c-4561-4ddf-bc90-411aba44bb39" }, "sites": { "href": "/v6/RestoreSessions/6a50c1ce-07e1-4ee9-9158-9150acb5c2eb/organization/sites?parentId=b3184e77-b95b-45f7-96cc-180a20b61cbd8507931c-4561-4ddf-bc90-411aba44bb39" }, "libraries": { "href": "/v6/RestoreSessions/6a50c1ce-07e1-4ee9-9158-9150acb5c2eb/organization/sites/b3184e77-b95b-45f7-96cc-180a20b61cbd8507931c-4561-4ddf-bc90-411aba44bb39/libraries" }, "lists": { "href": "/v6/RestoreSessions/6a50c1ce-07e1-4ee9-9158-9150acb5c2eb/organization/sites/b3184e77-b95b-45f7-96cc-180a20b61cbd8507931c-4561-4ddf-bc90-411aba44bb39/lists" }, "documents": { "href": "/v6/RestoreSessions/6a50c1ce-07e1-4ee9-9158-9150acb5c2eb/organization/sites/b3184e77-b95b-45f7-96cc-180a20b61cbd8507931c-4561-4ddf-bc90-411aba44bb39/documents" }, "items": { "href": "/v6/RestoreSessions/6a50c1ce-07e1-4ee9-9158-9150acb5c2eb/organization/sites/b3184e77-b95b-45f7-96cc-180a20b61cbd8507931c-4561-4ddf-bc90-411aba44bb39/items" }, "folders": { "href": "/v6/RestoreSessions/6a50c1ce-07e1-4ee9-9158-9150acb5c2eb/organization/sites/b3184e77-b95b-45f7-96cc-180a20b61cbd8507931c-4561-4ddf-bc90-411aba44bb39/folders" } } }, { "id": "724011c3-a540-4684-b24f-3e2ab4ef6380df26ea7d-6468-4846-bdf5-4e88d871ed11", "name": "CopyTo User", "url": "http://server/personal/orgUser", "_links": { "self": { "href": "/v6/RestoreSessions/6a50c1ce-07e1-4ee9-9158-9150acb5c2eb/organization/sites/724011c3-a540-4684-b24f-3e2ab4ef6380df26ea7d-6468-4846-bdf5-4e88d871ed11" }, "sites": { "href": "/v6/RestoreSessions/6a50c1ce-07e1-4ee9-9158-9150acb5c2eb/organization/sites?parentId=724011c3-a540-4684-b24f-3e2ab4ef6380df26ea7d-6468-4846-bdf5-4e88d871ed11" }, "libraries": { "href": "/v6/RestoreSessions/6a50c1ce-07e1-4ee9-9158-9150acb5c2eb/organization/sites/724011c3-a540-4684-b24f-3e2ab4ef6380df26ea7d-6468-4846-bdf5-4e88d871ed11/libraries" }, "lists": { "href": "/v6/RestoreSessions/6a50c1ce-07e1-4ee9-9158-9150acb5c2eb/organization/sites/724011c3-a540-4684-b24f-3e2ab4ef6380df26ea7d-6468-4846-bdf5-4e88d871ed11/lists" }, "documents": { "href": "/v6/RestoreSessions/6a50c1ce-07e1-4ee9-9158-9150acb5c2eb/organization/sites/724011c3-a540-4684-b24f-3e2ab4ef6380df26ea7d-6468-4846-bdf5-4e88d871ed11/documents" }, "items": { "href": "/v6/RestoreSessions/6a50c1ce-07e1-4ee9-9158-9150acb5c2eb/organization/sites/724011c3-a540-4684-b24f-3e2ab4ef6380df26ea7d-6468-4846-bdf5-4e88d871ed11/items" }, "folders": { "href": "/v6/RestoreSessions/6a50c1ce-07e1-4ee9-9158-9150acb5c2eb/organization/sites/724011c3-a540-4684-b24f-3e2ab4ef6380df26ea7d-6468-4846-bdf5-4e88d871ed11/folders" } } } ], "_links": { "self": { "href": "/v6/RestoreSessions/6a50c1ce-07e1-4ee9-9158-9150acb5c2eb/organization/sites?offset=0&limit=30" } } } |