使用可能なサンドボックスエンドポイント
NOTE
Sandbox API で提供される他のエンドポイントとは異なり、このエンドポイントは、サンドボックス管理のアクセス権限を持たないユーザーも含め、すべてのユーザーが使用できます。
現在のユーザーが使用できるサンドボックスのリストを作成するには、使用可能なサンドボックスのエンドポイントに対してGETリクエストを実行します。
API 形式
GET /{QUERY_PARAMS}
パラメーター
説明
{QUERY_PARAMS}
結果をフィルタリングするためのオプションのクエリパラメーターです。 詳しくは、 付録文書 を参照してください。
リクエスト
curl -X GET \
https://platform.adobe.io/data/foundation/sandbox-management/?limit=3&offset=1 \
-H 'Authorization: Bearer {ACCESS_TOKEN}' \
-H 'x-api-key: {API_KEY}' \
-H 'x-gw-ims-org-id: {ORG_ID}'
応答
正常な応答は、現在のユーザーが使用できるサンドボックスのリスト ( 例えば、 name
, title
, state
、および type
.
{
"sandboxes": [
{
"name": "prod",
"title": "Production",
"state": "active",
"type": "production",
"region": "VA7",
"isDefault": true,
"eTag": 2,
"createdDate": "2019-09-04 04:57:24",
"lastModifiedDate": "2019-09-04 04:57:24",
"createdBy": "{USER_ID}",
"modifiedBy": "{USER_ID}"
},
{
"name": "dev",
"title": "Development",
"state": "active",
"type": "development",
"region": "VA7",
"isDefault": false,
"eTag": 1,
"createdDate": "2019-09-03 22:27:48",
"lastModifiedDate": "2019-09-03 22:27:48",
"createdBy": "{USER_ID}",
"modifiedBy": "{USER_ID}"
},
{
"name": "stage",
"title": "Staging",
"state": "active",
"type": "development",
"region": "VA7",
"isDefault": false,
"eTag": 1,
"createdDate": "2019-09-03 22:27:48",
"lastModifiedDate": "2019-09-03 22:27:48",
"createdBy": "{USER_ID}",
"modifiedBy": "{USER_ID}"
}
],
"_page": {
"limit": 3,
"count": 1
},
"_links": {
"page": {
"href": "https://platform.adobe.io:443/data/foundation/sandbox-management/?limit={limit}&offset={offset}",
"templated": true
}
}
}
プロパティ
説明
name
サンドボックスの名前。API 呼び出しで参照目的に使用されます。
title
サンドボックスの表示名。
state
サンドボックスの現在の処理状態。サンドボックスの状態は、次のいずれかになります。
creating
:サンドボックスは作成されましたが、システムによって引き続きプロビジョニングされています。active
:サンドボックスが作成され、アクティブです。failed
:エラーが原因で、サンドボックスはシステムでプロビジョニングできず、無効になっています。deleted
:サンドボックスは手動で無効にされています。
type
サンドボックスタイプ(「開発」または「実稼働」)。
isDefault
このサンドボックスが組織のデフォルトの実稼動サンドボックスであるかどうかを示すブール型プロパティです。
eTag
サンドボックスの特定のバージョンの識別子。バージョン管理とキャッシュの効率化に使用され、この値はサンドボックスに変更が追加されるたびに更新されます。
recommendation-more-help
e243ad8f-a318-46b3-9930-159a80f82b42