リテンションポリシーを作成します。
true
ポリシーの有効期限が近付いたときにファイルの所有者と共同所有者に通知するかどうか。
次の値のいずれか1つ: true
,false
true
ファイルの所有者がリテンションを延長できるかどうか。
次の値のいずれか1つ: true
,false
リテンションポリシーの期間が終了に近づいたときに通知されるユーザーのリスト。
"Policy to retain all reports for at least one month"
リテンションポリシーのテキストによる追加の説明。
"permanently_delete"
リテンションポリシーの廃棄アクション。permanently_delete
に設定すると、ポリシーによって保持されているコンテンツが完全に削除されます。remove_retention
に設定すると、コンテンツへのリテンションポリシーの適用が解除され、リテンションポリシーの有効期限が切れた後は、ユーザーがコンテンツを削除できるようになります。
次の値のいずれか1つ: permanently_delete
,remove_retention
"Some Policy Name"
リテンションポリシーの名前
"finite"
リテンションポリシーのタイプ。リテンションポリシーのタイプは、finite
(コンテンツを保持する期間が事前にわかっている場合)、またはindefinite
(コンテンツを保持する期間が不明な場合) のいずれかになります。
次の値のいずれか1つ: finite
,indefinite
"365"
リテンションポリシーの期間。この値はリテンションポリシーがコンテンツに割り当てられた後、有効である日数を示します。ポリシーのpolicy_type
がindefinite
である場合は、retention_length
もindefinite
になります。
"modifiable"
以下のリテンションの種類を指定します。
modifiable
: リテンションポリシーを変更できます。たとえば、フォルダの追加と削除、ポリシー期間の短縮と延長、または割り当ての削除を行うことができます。リテンションポリシーが規制目的に関連していない場合はこの種類を使用してください。
non_modifiable
: フォルダの追加、期間の延長、ポリシーの撤回、廃棄アクションまたは通知設定の変更という限られた方法でしかリテンションポリシーを変更できません。割り当ての削除やポリシー期間の短縮など、その他の操作は実行できません。規制に関するリテンションポリシーを確実に遵守する場合はこの種類を使用してください。
次の値のいずれか1つ: modifiable
,non_modifiable
新しいリテンションポリシーオブジェクトを返します。
infinite
リテンションポリシーにretention_length
が指定された場合、誤ったdisposition_action
が設定された場合、または説明の文字数が上限の500文字を超える場合は、bad_request
エラーを返します。
指定した名前を持つリテンションポリシーがすでに存在する場合は、エラーを返します
予期しないクライアントエラー。
curl -i -X POST "https://api.box.com/2.0/retention_policies" \
-H "authorization: Bearer <ACCESS_TOKEN>" \
-H "content-type: application/json" \
-d '{
"policy_name": "Some Policy Name",
"policy_type": "finite",
"retention_length": 365,
"disposition_action": "permanently_delete"
}'
await client.retentionPolicies.createRetentionPolicy({
policyName: getUuid(),
policyType: 'finite' as CreateRetentionPolicyRequestBodyPolicyTypeField,
dispositionAction:
'remove_retention' as CreateRetentionPolicyRequestBodyDispositionActionField,
retentionLength: '1',
description: description,
canOwnerExtendRetention: false,
retentionType:
'modifiable' as CreateRetentionPolicyRequestBodyRetentionTypeField,
} satisfies CreateRetentionPolicyRequestBody);
client.retention_policies.create_retention_policy(
get_uuid(),
CreateRetentionPolicyPolicyType.FINITE.value,
CreateRetentionPolicyDispositionAction.REMOVE_RETENTION.value,
description=description,
retention_length="1",
retention_type=CreateRetentionPolicyRetentionType.MODIFIABLE.value,
can_owner_extend_retention=False,
)
await client.RetentionPolicies.CreateRetentionPolicyAsync(requestBody: new CreateRetentionPolicyRequestBody(policyName: Utils.GetUUID(), policyType: CreateRetentionPolicyRequestBodyPolicyTypeField.Finite, dispositionAction: CreateRetentionPolicyRequestBodyDispositionActionField.RemoveRetention) { RetentionLength = "1", Description = description, CanOwnerExtendRetention = false, RetentionType = CreateRetentionPolicyRequestBodyRetentionTypeField.Modifiable });
BoxRetentionPolicy.createIndefinitePolicy(api, name);
policy_name = 'Test Indefinite Policy Name'
disposition_action = 'remove_retention'
indefinite_retention_policy = client.create_retention_policy(policy_name, disposition_action, float('inf'))
print(f'Indefinite Retention Policy ID is {indefinite_retention_policy.id} and the policy name is {indefinite_retention_policy.policy_name}')
var policyParams = new BoxRetentionPolicyRequest()
{
PolicyName = "Important Documents!",
PolicyType = "finite",
RetentionLength = 365,
DispositionAction = "remove_retention"
};
BoxRetentionPolicy policy = await client.RetentionPoliciesManager
.CreateRetentionPolicyAsync(policyParams);
client.retentionPolicies.create(
'Tax Documents',
client.retentionPolicies.policyTypes.INDEFINITE,
client.retentionPolicies.dispositionActions.REMOVE_RETENTION)
).then(policy => {
/* policy -> {
type: 'retention_policy',
id: '123456789',
policy_name: 'Tax Documents',
policy_type: 'indefinite',
retention_length: 'indefinite',
retention_type: 'modifiable',
description: 'Policy to retain all reports',
disposition_action: 'remove_retention',
can_owner_extend_retention: false,
status: 'active',
are_owners_notified: true,
custom_notification_recipients: []
assignment_counts: { enterprise: 0, folder: 1, metadata_template: 0 },
created_by:
{ type: 'user',
id: '11111',
name: 'Example User',
login: 'user@example.com' },
created_at: '2015-05-01T11:12:54-07:00',
modified_at: '2015-06-08T11:11:50-07:00' }
*/
});
client.retentionPolicy.create(
name: "Test Indefinite Policy Name",
type: .indefinite,
dispositionAction: .removeRetention
) { result in
guard case let .success(retentionPolicy) = result else {
print("Error creating retention policy")
return
}
print("Retention policy: \(retentionPolicy.id) was created")
}
{
"id": "12345",
"type": "retention_policy",
"are_owners_notified": false,
"assignment_counts": {
"enterprise": 1,
"folder": 1,
"metadata_template": 1
},
"can_owner_extend_retention": false,
"created_at": "2012-12-12T10:53:43-08:00",
"created_by": {
"id": "11446498",
"type": "user",
"login": "ceo@example.com",
"name": "Aaron Levie"
},
"custom_notification_recipients": [
{
"id": "11446498",
"type": "user",
"name": "Aaron Levie",
"login": "ceo@example.com"
}
],
"description": "Policy to retain all reports for at least one month",
"disposition_action": "permanently_delete",
"modified_at": "2012-12-12T10:53:43-08:00",
"policy_name": "Some Policy Name",
"policy_type": "finite",
"retention_length": "365",
"retention_type": "non_modifiable",
"status": "active"
}