terms_of_use_agreements_files_versions

Creates, updates, deletes, gets or lists a terms_of_use_agreements_files_versions resource.

Overview

Name	terms_of_use_agreements_files_versions
Type	Resource
Id	entra_id.identity_governance.terms_of_use_agreements_files_versions

Fields

The following fields are returned by SELECT queries:

get

Retrieved navigation property

Name	Datatype	Description
id	string	The unique identifier for an entity. Read-only.
createdDateTime	string (date-time)	The date time representing when the file was created. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z. (pattern: ^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$)
displayName	string	Localized display name of the policy file of an agreement. The localized display name is shown to end users who view the agreement.
fileData		Data that represents the terms of use PDF document. Read-only.
fileName	string	Name of the agreement file (for example, TOU.pdf). Read-only.
isDefault	boolean	If none of the languages matches the client preference, indicates whether this is the default agreement file. If none of the files are marked as default, the first one is treated as the default. Read-only.
isMajorVersion	boolean	Indicates whether the agreement file is a major version update. Major version updates invalidate the agreement's acceptances on the corresponding language.
language	string	The language of the agreement file in the format 'languagecode2-country/regioncode2'. 'languagecode2' is a lowercase two-letter code derived from ISO 639-1, while 'country/regioncode2' is derived from ISO 3166 and usually consists of two uppercase letters, or a BCP-47 language tag. For example, U.S. English is en-US. Read-only.

list

Retrieved collection

Name	Datatype	Description
id	string	The unique identifier for an entity. Read-only.
createdDateTime	string (date-time)	The date time representing when the file was created. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z. (pattern: ^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$)
displayName	string	Localized display name of the policy file of an agreement. The localized display name is shown to end users who view the agreement.
fileData		Data that represents the terms of use PDF document. Read-only.
fileName	string	Name of the agreement file (for example, TOU.pdf). Read-only.
isDefault	boolean	If none of the languages matches the client preference, indicates whether this is the default agreement file. If none of the files are marked as default, the first one is treated as the default. Read-only.
isMajorVersion	boolean	Indicates whether the agreement file is a major version update. Major version updates invalidate the agreement's acceptances on the corresponding language.
language	string	The language of the agreement file in the format 'languagecode2-country/regioncode2'. 'languagecode2' is a lowercase two-letter code derived from ISO 639-1, while 'country/regioncode2' is derived from ISO 3166 and usually consists of two uppercase letters, or a BCP-47 language tag. For example, U.S. English is en-US. Read-only.

Methods

The following methods are available for this resource:

Name	Accessible by	Required Params	Optional Params	Description
get	select	agreement_id, agreement_file_localization_id, agreement_file_version_id		Read-only. Customized versions of the terms of use agreement in the Microsoft Entra tenant.
list	select	agreement_id, agreement_file_localization_id		Read-only. Customized versions of the terms of use agreement in the Microsoft Entra tenant.
insert	insert	agreement_id, agreement_file_localization_id
update	update	agreement_id, agreement_file_localization_id, agreement_file_version_id
delete	delete	agreement_id, agreement_file_localization_id, agreement_file_version_id	If-Match

Parameters

Parameters can be passed in the WHERE clause of a query. Check the Methods section to see which parameters are required or optional for each operation.

Name	Datatype	Description
agreement_file_localization_id	string	The unique identifier of agreementFileLocalization
agreement_file_version_id	string	The unique identifier of agreementFileVersion
agreement_id	string	The unique identifier of agreement
If-Match	string	ETag

SELECT examples

get

Read-only. Customized versions of the terms of use agreement in the Microsoft Entra tenant.

SELECT
id,
createdDateTime,
displayName,
fileData,
fileName,
isDefault,
isMajorVersion,
language
FROM entra_id.identity_governance.terms_of_use_agreements_files_versions
WHERE agreement_id = '{{ agreement_id }}' -- required
AND agreement_file_localization_id = '{{ agreement_file_localization_id }}' -- required
AND agreement_file_version_id = '{{ agreement_file_version_id }}' -- required
;

list

Read-only. Customized versions of the terms of use agreement in the Microsoft Entra tenant.

SELECT
id,
createdDateTime,
displayName,
fileData,
fileName,
isDefault,
isMajorVersion,
language
FROM entra_id.identity_governance.terms_of_use_agreements_files_versions
WHERE agreement_id = '{{ agreement_id }}' -- required
AND agreement_file_localization_id = '{{ agreement_file_localization_id }}' -- required
;

INSERT examples

insert

No description available.

INSERT INTO entra_id.identity_governance.terms_of_use_agreements_files_versions (
id,
createdDateTime,
displayName,
fileData,
fileName,
isDefault,
isMajorVersion,
language,
agreement_id,
agreement_file_localization_id
)
SELECT 
'{{ id }}',
'{{ createdDateTime }}',
'{{ displayName }}',
'{{ fileData }}',
'{{ fileName }}',
{{ isDefault }},
{{ isMajorVersion }},
'{{ language }}',
'{{ agreement_id }}',
'{{ agreement_file_localization_id }}'
RETURNING
id,
createdDateTime,
displayName,
fileData,
fileName,
isDefault,
isMajorVersion,
language
;

Manifest

# Description fields are for documentation purposes
- name: terms_of_use_agreements_files_versions
props:
  - name: agreement_id
    value: "{{ agreement_id }}"
    description: Required parameter for the terms_of_use_agreements_files_versions resource.
  - name: agreement_file_localization_id
    value: "{{ agreement_file_localization_id }}"
    description: Required parameter for the terms_of_use_agreements_files_versions resource.
  - name: id
    value: "{{ id }}"
    description: |
      The unique identifier for an entity. Read-only.
  - name: createdDateTime
    value: "{{ createdDateTime }}"
    description: |
      The date time representing when the file was created. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z.
  - name: displayName
    value: "{{ displayName }}"
    description: |
      Localized display name of the policy file of an agreement. The localized display name is shown to end users who view the agreement.
  - name: fileData
    value: "{{ fileData }}"
    description: |
      Data that represents the terms of use PDF document. Read-only.
  - name: fileName
    value: "{{ fileName }}"
    description: |
      Name of the agreement file (for example, TOU.pdf). Read-only.
  - name: isDefault
    value: {{ isDefault }}
    description: |
      If none of the languages matches the client preference, indicates whether this is the default agreement file. If none of the files are marked as default, the first one is treated as the default. Read-only.
  - name: isMajorVersion
    value: {{ isMajorVersion }}
    description: |
      Indicates whether the agreement file is a major version update. Major version updates invalidate the agreement's acceptances on the corresponding language.
  - name: language
    value: "{{ language }}"
    description: |
      The language of the agreement file in the format 'languagecode2-country/regioncode2'. 'languagecode2' is a lowercase two-letter code derived from ISO 639-1, while 'country/regioncode2' is derived from ISO 3166 and usually consists of two uppercase letters, or a BCP-47 language tag. For example, U.S. English is en-US. Read-only.

UPDATE examples

update

No description available.

UPDATE entra_id.identity_governance.terms_of_use_agreements_files_versions
SET 
id = '{{ id }}',
createdDateTime = '{{ createdDateTime }}',
displayName = '{{ displayName }}',
fileData = '{{ fileData }}',
fileName = '{{ fileName }}',
isDefault = {{ isDefault }},
isMajorVersion = {{ isMajorVersion }},
language = '{{ language }}'
WHERE 
agreement_id = '{{ agreement_id }}' --required
AND agreement_file_localization_id = '{{ agreement_file_localization_id }}' --required
AND agreement_file_version_id = '{{ agreement_file_version_id }}' --required
RETURNING
id,
createdDateTime,
displayName,
fileData,
fileName,
isDefault,
isMajorVersion,
language;

DELETE examples

delete

No description available.

DELETE FROM entra_id.identity_governance.terms_of_use_agreements_files_versions
WHERE agreement_id = '{{ agreement_id }}' --required
AND agreement_file_localization_id = '{{ agreement_file_localization_id }}' --required
AND agreement_file_version_id = '{{ agreement_file_version_id }}' --required
AND If-Match = '{{ If-Match }}'
;