メインコンテンツへスキップ
POST
/
shield_lists
cURL
curl --request POST \
  --url https://api.box.com/2.0/shield_lists \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'box-version: <box-version>' \
  --data '
{
  "name": "My Shield List",
  "content": {
    "type": "country",
    "country_codes": [
      "US",
      "PL"
    ]
  },
  "description": "A list of things that are shielded"
}
'
{
  "id": "90fb0e17-c332-40ed-b4f9-fa8908fbbb24",
  "type": "shield_list",
  "name": "Shield List Name",
  "enterprise": {
    "id": "1910967",
    "type": "enterprise"
  },
  "created_at": "2025-01-13T15:31:01.896Z",
  "updated_at": "2025-01-13T15:31:01.896Z",
  "content": {
    "type": "country",
    "country_codes": [
      "US",
      "PL"
    ]
  },
  "description": "A list of things that are shielded"
}
Box SDKのバージョニング戦略について詳しく学ぶ。」

承認

Authorization
string
header
必須

The access token received from the authorization server in the OAuth 2.0 flow.

ヘッダー

box-version
enum<string>
必須

Version header.

利用可能なオプション:
2025.0

ボディ

application/json

Shieldリスト作成リクエストのスキーマ。

name
string
必須

Shieldリストの名前。

:

"My Shield List"

content
Shieldリストのコンテンツ (国) · object
必須

このShieldリストの要素の種類を指定し、要素自体を含めます。公開APIで統合のShieldリストを更新することはできません。

description
string

Shieldリストの説明 (省略可)。

:

"A list of things that are shielded"

レスポンス

Shieldリストオブジェクトを返します。

ShieldリストのStandard版の表示。

id
string
必須

Shieldリストの一意の識別子。

:

"90fb0e17-c332-40ed-b4f9-fa8908fbbb24"

type
string
必須

オブジェクトのタイプ。

:

"shield_list"

name
string
必須

Shieldリストの名前。

:

"Shield List Name"

enterprise
企業の参照 · object
必須

このリストが属している企業。

created_at
string<date-time>
必須

このShieldリストが作成された日時を示すISO日時文字列。

:

"2025-01-13T15:31:01.896Z"

updated_at
string<date-time>
必須

このShieldリストが更新された日時を示すISO日時文字列。

:

"2025-01-13T15:31:01.896Z"

content
Shieldリストのコンテンツ (国) · object
必須

このShieldリストの要素のタイプを指定し、要素自体を含めます。

description
string

Shieldリストの説明。

:

"A list of things that are shielded"