Getting Organization Parameters
You can get a resource representation of the organization with the specified ID.
Request
GET https://<hostname>:4443/v6/Organizations/{organizationId}?extendedView=<boolean> |
Request Headers
The request header must contain an authorization token of the current session.
Request Parameters
The following parameters must be specified in the URL of the request:
Parameter | Type | Description |
---|---|---|
organizationId | string | Specifies the identification number of the Microsoft 365 organization. For more information on how to get this parameter, see Getting Organizations. |
extendedView | boolean | Defines the representation of the organization properties that will be returned to the client. The following values are available:
The default value is true. |
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
Properties
The /Organizations/{organizationId} resource can contain different properties depending on the organization type:
The /Organizations/{organizationId} resource for the Microsoft 365 organization has the following properties:
Property | Type | Description |
---|---|---|
type | string | Specifies the organization type. The following types are available:
|
region | string | Specifies Microsoft Azure region where Microsoft 365 organization datacenter is located. The following values are available:
|
isExchangeOnline | boolean | If set to true, indicates that this organization contains Microsoft 365 Exchange components. |
isSharePointOnline | boolean | If set to true, indicates that this organization contains Microsoft 365 SharePoint components. |
isTeamsOnline | boolean | If set to true, indicates that this organization contains Microsoft Teams components. |
isTeamsChatsOnline | boolean | If set to true, indicates that this organization contains team chats. Note: This property is available starting from Veeam Backup for Microsoft 365 version 6a (build 6.1.0.222). |
exchangeOnlineSettings | Specifies Microsoft 365 Exchange organization connection settings. | |
sharePointOnlineSettings | Specifies Microsoft 365 SharePoint organization connection settings. | |
id | string | Specifies the ID of the organization added to Veeam Backup for Microsoft 365. |
name | string | Specifies the name of the Microsoft 365 organization. |
isBackedup | boolean | If set to true, indicates that this organization had already been processed by a backup job. |
firstBackuptime | UTC | Specifies the time when this organization was processed by a backup job for the first time. |
lastBackuptime | UTC | Specifies the time when this organization was processed by a backup job for the last time. |
_links | Dictionary of string [key] and Object [value] | Links to related resources (navigation property). |
The /Organizations/{organizationId} resource for the on-premises organization has the following properties:
Property | Type | Description |
---|---|---|
type | string | Specifies the organization type. The following types are available:
|
isExchange | boolean | If set to true, indicates that this organization contains on-premises Microsoft Exchange components. |
isSharePoint | boolean | If set to true, indicates that this organization contains on-premises Microsoft SharePoint components. |
exchangeSettings | Specifies on-premises Microsoft Exchange organization connection settings. | |
sharePointSettings | Specifies on-premises Microsoft SharePoint organization connection settings. | |
id | string | Specifies the ID of the organization added to Veeam Backup for Microsoft 365. |
name | string | Specifies the name of the on-premises organization. |
isBackedup | boolean | If set to true, indicates that this organization had already been processed by a backup job. |
firstBackuptime | UTC | Specifies the time when this organization was processed by a backup job for the first time. |
lastBackuptime | UTC | Specifies the time when this organization was processed by a backup job for the last time. |
_links | Dictionary of string [key] and Object [value] | Links to related resources (navigation property). |
The /Organizations/{organizationId} resource for the Hybrid organization has the following properties:
Property | Type | Description |
---|---|---|
type | string | Specifies the organization type. The following types are available:
|
isExchange | boolean | If set to true, indicates that this organization contains on-premises Microsoft Exchange components. |
isSharePoint | boolean | If set to true, indicates that this organization contains on-premises Microsoft SharePoint components. |
office365Settings | Specifies Microsoft 365 settings for the Hybrid organization. | |
exchangeOnlineSettings | Specifies Microsoft 365 settings for the Hybrid organization. | |
sharePointOnlineSettings | ||
exchangeSettings | Specifies on-premises Microsoft Exchange settings. | |
sharePointSettings | Specifies on-premises Microsoft SharePoint settings. | |
id | string | Specifies the ID of the organization added to Veeam Backup for Microsoft 365. |
name | string | Specifies the name of the Hybrid organization. |
isBackedup | boolean | If set to true, indicates that this organization has already been processed by a backup job. |
firstBackuptime | UTC | Specifies the time when this organization was processed by a backup job for the first time. |
lastBackuptime | UTC | Specifies the time when this organization was processed by a backup job for the last time. |
_links | Dictionary of string [key] and Object [value] | Links to related resources (navigation property). |
Specifies the following Microsoft 365 settings for the Hybrid organization:
Property | Type | Description |
---|---|---|
isExchangeOnline | boolean | If set to true, indicates that this organization contains Microsoft 365 Exchange components. |
isSharePointOnline | boolean | If set to true, indicates that this organization contains Microsoft 365 SharePoint components. |
isTeamsOnline | boolean | If set to true, indicates that this organization contains Microsoft Teams components. |
isTeamsChatsOnline | boolean | If set to true, indicates that this organization contains team chats. Note: This property is available starting from Veeam Backup for Microsoft 365 version 6a (build 6.1.0.222). |
exchangeOnlineSettings | Specifies Microsoft 365 Exchange organization connection settings. | |
sharePointOnlineSettings | Specifies Microsoft 365 SharePoint organization connection settings. | |
region | string | Specifies Microsoft Azure region where Microsoft 365 organization datacenter is located. The following values are available:
|
Specifies the following settings for connecting to the Microsoft 365 organization components:
Property | Type | Description |
---|---|---|
account | string | Specifies the user account for authenticating to the Microsoft 365 organization. |
password | string | Specifies the password for authenticating to the Microsoft 365 organization. |
grantAdminAccess | string | Specifies that the user will be granted rights for accessing site collections and sites. |
useMfa | boolean | If set to true, indicates that the Veeam Backup for Microsoft 365 will use modern authentication to connect to the organization. |
applicationId | string | For modern authentication against the Microsoft 365 organization. Specifies an application ID for connecting to the Microsoft 365 organization. |
applicationCertificateThumbprint | string | For modern authentication against the Microsoft 365 organization. Specifies an application certificate thumbprint for connecting to the Microsoft 365 organization. |
useCustomVeeamAADApplication | boolean | For native authentication against the Microsoft 365 organization. If set to true, indicates that the Veeam Backup for Microsoft 365 will use Veeam Azure AD Application for a connection to the Microsoft 365 organization. |
Specifies the following on-premises Microsoft Exchange settings:
Property | Type | Description |
---|---|---|
serverName | string | Specifies Microsoft Exchange server EWS endpoint URL. |
grantImpersonation | boolean | If set to true, indicates that backup jobs will be able to process all mailboxes within Exchange organization. |
userName | string | Specifies the user name for authenticating to the on-premises Microsoft Exchange organization. |
useSSL | boolean | If set to true, indicates that Veeam Backup for Microsoft 365 uses a secure connection with Microsoft Exchange organization server. |
skipCAverification | boolean | If set to true, indicates that Certificate Authority verification check will not be performed. |
skipCommonNameVerification | boolean | If set to true, indicates that Common Name verification check will not be performed. |
skipRevocationCheck | boolean | If set to true, indicates that the check of certificate expiration against the certificate revocation list will not be performed. |
configureThrottlingPolicy | boolean | If set to true, indicates that VeeamArchiverThrottlingPolicy will be configured for connecting with Microsoft Exchange organization server. VeeamArchiverThrottlingPolicy overrides existing Exchange throttling policies and provides unlimited network bandwidth. |
Specifies the following on-premises Microsoft SharePoint settings:
Property | Type | Description |
---|---|---|
serverName | string | Specifies Microsoft SharePoint server EWS endpoint URL. |
serverPort | integer | Specifies a port for connection to the Microsoft SharePoint server. Default server port is 5985. |
grantImpersonation | boolean | If set to true, indicates that backup jobs will be able to process all items within SharePoint organization. |
userName | string | Specifies the user name for authenticating to the on-premises Microsoft SharePoint organization. |
useSSL | boolean | If set to true, indicates that Veeam Backup for Microsoft 365 uses a secure connection with Microsoft SharePoint organization server. |
skipCAverification | boolean | If set to true, indicates that Certificate Authority verification check will not be performed. |
skipCommonNameVerification | boolean | If set to true, indicates that Common Name verification check will not be performed. |
skipRevocationCheck | boolean | If set to true, indicates that the check of certificate expiration against the certificate revocation list will not be performed. |
Example
The example returns a resource representation of the organization with the ID 40dfa255-2762-43e5-8320-dff7a9201f90.
Request: GET https://abc.tech.local:4443/v6/Organizations/40dfa255-2762-43e5-8320-dff7a9201f90?extendedView=true
Request Header: Authorization: Bearer <Access-Token>
Response: 200 OK
Response Body: { "isTeamsOnline": true, "isTeamsChatsOnline": true, "exchangeOnlineSettings": { "useApplicationOnlyAuth": true, "officeOrganizationName": "abc.onmicrosoft.com", "account": "admin@abc.onmicrosoft.com", "grantAdminAccess": true, "useMfa": true, "applicationId": "a1cc0b32-c468-49a7-b4da-945927135cf2", "applicationCertificateThumbprint": "4827CDE8F66C1E34A51B50644C67012BA5B07BE9" }, "sharePointOnlineSettings": { "useApplicationOnlyAuth": true, "officeOrganizationName": "abc.onmicrosoft.com", "sharePointSaveAllWebParts": false, "account": "admin@abc.onmicrosoft.com", "grantAdminAccess": true, "useMfa": true, "applicationId": "a1cc0b32-c468-49a7-b4da-945927135cf2", "applicationCertificateThumbprint": "4827CDE8F66C1E34A51B50644C67012BA5B07BE9" }, "isExchangeOnline": true, "isSharePointOnline": true, "type": "Office365", "region": "Worldwide", "id": "40dfa255-2762-43e5-8320-dff7a9201f90", "name": "abc.onmicrosoft.com", "officeName": "abc.onmicrosoft.com", "isBackedup": true, "firstBackuptime": "2020-10-14T14:14:15.8178322Z", "lastBackuptime": "2020-12-13T22:02:17.6204765Z", "_links": { "self": { "href": "/v6/organizations/40dfa255-2762-43e5-8320-dff7a9201f90" }, "jobs": { "href": "/v6/organizations/40dfa255-2762-43e5-8320-dff7a9201f90/jobs" }, "groups": { "href": "/v6/organizations/40dfa255-2762-43e5-8320-dff7a9201f90/groups" }, "users": { "href": "/v6/organizations/40dfa255-2762-43e5-8320-dff7a9201f90/users" }, "sites": { "href": "/v6/organizations/40dfa255-2762-43e5-8320-dff7a9201f90/sites" }, "teams": { "href": "/v6/organizations/40dfa255-2762-43e5-8320-dff7a9201f90/teams" }, "usedRepositories": { "href": "/v6/organizations/40dfa255-2762-43e5-8320-dff7a9201f90/usedRepositories" } }, "_actions": {} } |