リテンションポリシー割り当てのリストを取得

get
https://api.box.com/2.0
/retention_policies/:retention_policy_id/assignments/

指定したリテンションポリシーに関連付けられているすべてのリテンションポリシー割り当てのリストを返します。

Request

Bearer [ACCESS_TOKEN]
application/json

Path Parameters

stringin pathrequired
982312

リテンションポリシーのID。

Query Parameters

stringin queryoptional
folder

取得するリテンションポリシー割り当てのタイプ。

Value is one of folder,enterprise

integer / int64in queryoptional
10001000

返す項目の1ページあたりの最大数。

stringin queryoptional
JV9IRGZmieiBasejOG9yDCRNgd2ymoZIbjsxbJMjIs3kioVii

結果が返される開始位置のマーカー。マーカーベースのページ割りを使用している場合に使用されます。

これを使用するには、usemarkertrueに設定する必要があります。

Response

指定したリテンションポリシーに関連付けられているリテンションポリシー割り当てのリストを返します。

不明なtypeが指定された場合は、エラーを返します。

予期しないクライアントエラー。

get
リテンションポリシー割り当てのリストを取得
You can now try out some of our APIs live, right here in the documentation.
Log in

Request Example

cURL
curl -i -X GET "https://api.box.com/2.0/retention_policies/982312/assignments" \
     -H "Authorization: Bearer <ACCESS_TOKEN>"
.NET
BoxCollectionMarkerBased<BoxRetentionPolicyAssignment> assignments = await client.RetentionPoliciesManager
    .GetRetentionPolicyAssignmentsAsync(retentionPolicyId: "11111");
Java
BoxRetentionPolicy policy = new BoxRetentionPolicy(api, id);
Iterable<BoxRetentionPolicyAssignment.Info> allAssignments = policy.getAllAssignments("assigned_by");
Iterable<BoxRetentionPolicyAssignment.Info> folderAssignments = policy.getFolderAssignments(50, "assigned_by");
Iterable<BoxRetentionPolicyAssignment.Info> enterpriseAssignments = policy.getEnterpriseAssignments();
for (BoxRetentionPolicyAssignments.Info assignmentInfo : allAssignments) {
	// Do something with the assignment.
}
for (BoxRetentionPolicyAssignments.Info assignmentInfo : folderAssignments) {
	// Do something with the assignment.
}
for (BoxRetentionPolicyAssignments.Info assignmentInfo : enterpriseAssignments) {
	// Do something with the assignment.
}
Node
client.retentionPolicies
	.getAssignments('123456789', { type: 'folder' })
	.then((assignments) => {
		/* assignments -> {
			entries: [ { type: 'retention_policy_assignment', id: '12345678' } ],
			limit: 100,
			next_marker: 'someMarkerString' }
		*/
	});

Response Example

{
  "entries": [
    {
      "id": 11446498,
      "type": "retention_policy_assignment",
      "retention_policy": {
        "id": 12345,
        "type": "retention_policy",
        "policy_name": "Some Policy Name",
        "retention_length": 365,
        "disposition_action": "permanently_delete"
      },
      "assigned_to": {
        "id": 11446498,
        "type": "file"
      },
      "assigned_by": {
        "id": 11446498,
        "type": "user",
        "name": "Aaron Levie",
        "login": "ceo@example.com"
      },
      "assigned_at": "2012-12-12T10:53:43-08:00"
    }
  ],
  "limit": 1000,
  "next_marker": 3000,
  "prev_marker": 1000
}