沙盒管理端点
Adobe Experience Platform中的沙盒提供了独立的开发环境,允许您在不影响生产环境的情况下测试功能、运行实验以及进行自定义配置。 此 /sandboxes
中的端点 Sandbox API允许您在Platform中以编程方式管理沙箱。
快速入门
本指南中使用的API端点是 Sandbox API. 在继续之前,请查看 快速入门指南 有关相关文档的链接、阅读本文档中示例API调用的指南,以及有关成功调用任何Experience PlatformAPI所需的所需标头的重要信息。
检索沙盒列表 list
您可以向以下网站发出GET请求,列出属于贵组织的所有沙箱(处于活动状态或其他状态): /sandboxes
端点。
API格式
GET /sandboxes?{QUERY_PARAMS}
{QUERY_PARAMS}
请求
curl -X GET \
https://platform.adobe.io/data/foundation/sandbox-management/sandboxes?&limit=4&offset=1 \
-H 'Authorization: Bearer {ACCESS_TOKEN}' \
-H 'x-api-key: {API_KEY}' \
-H 'x-gw-ims-org-id: {ORG_ID}' \
-H 'x-sandbox-name: {SANDBOX_NAME}'
响应
成功的响应将返回属于您组织的沙盒列表,包括详细信息,例如 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}"
},
{
"name": "dev-2",
"title": "Development 2",
"state": "creating",
"type": "development",
"region": "VA7",
"isDefault": false,
"eTag": 1,
"createdDate": "2019-09-07 10:16:02",
"lastModifiedDate": "2019-09-07 10:16:02",
"createdBy": "{USER_ID}",
"modifiedBy": "{USER_ID}"
}
],
"_page": {
"limit": 4,
"count": 4
},
"_links": {
"next": {
"href": "https://platform.adobe.io:443/data/foundation/sandbox-management/sandboxes/?limit={limit}&offset={offset}",
"templated": true
},
"prev": {
"href": "https://platform.adobe.io:443/data/foundation/sandbox-management/sandboxes?offset=0&limit=1",
"templated": null
},
"page": {
"href": "https://platform.adobe.io:443/data/foundation/sandbox-management/sandboxes?offset=1&limit=1",
"templated": null
}
}
}
name
title
state
沙盒的当前处理状态。 沙盒的状态可以是以下任一状态:
creating
:沙盒已创建,但仍由系统配置。active
:沙盒已创建并处于活动状态。failed
:由于错误,沙盒无法由系统配置并被禁用。deleted
:已手动禁用沙盒。
type
development
和 production
.isDefault
eTag
查找沙盒 lookup
您可以通过发出包含沙盒的GET请求来查找单个沙盒 name
属性。
API格式
GET /sandboxes/{SANDBOX_NAME}
{SANDBOX_NAME}
name
要查找的沙盒的属性。请求
以下请求检索名为“dev-2”的沙盒。
curl -X GET \
https://platform.adobe.io/data/foundation/sandbox-management/sandboxes/dev-2 \
-H 'Authorization: Bearer {ACCESS_TOKEN}' \
-H 'x-api-key: {API_KEY}' \
-H 'x-gw-ims-org-id: {ORG_ID}' \
响应
成功响应将返回沙盒的详细信息,包括其 name
, title
, state
、和 type
.
{
"name": "dev-2",
"title": "Development 2",
"state": "creating",
"type": "development",
"region": "VA7",
"isDefault": false,
"eTag": 1,
"createdDate": "2019-09-07 10:16:02",
"lastModifiedDate": "2019-09-07 10:16:02",
"createdBy": "{USER_ID}",
"modifiedBy": "{USER_ID}"
}
name
title
state
沙盒的当前处理状态。 沙盒的状态可以是以下任一状态:
- 创建:沙盒已创建,但仍由系统配置。
- 活动:沙盒已创建并处于活动状态。
- 失败:由于错误,沙盒无法由系统配置并被禁用。
- 已删除:已手动禁用沙盒。
type
development
和 production
.isDefault
eTag
创建沙盒 create
您可以通过向以下网站发出POST请求来创建新的开发或生产沙盒: /sandboxes
端点。
创建开发沙盒
要创建开发沙盒,您必须提供 type
属性值为的属性 development
请求有效负载中的。
API格式
POST /sandboxes
请求
以下请求创建一个名为“acme-dev”的新开发沙盒。
curl -X POST \
https://platform.adobe.io/data/foundation/sandbox-management/sandboxes \
-H 'Authorization: Bearer {ACCESS_TOKEN}' \
-H 'x-api-key: {API_KEY}' \
-H 'x-gw-ims-org-id: {ORG_ID}' \
-H 'Content-Type: application/json' \
-d '{
"name": "acme-dev",
"title": "Acme Business Group dev",
"type": "development"
}'
name
title
type
development
.响应
成功响应会返回新创建的沙盒的详细信息,表明其 state
是“创建”。
{
"name": "acme-dev",
"title": "Acme Business Group dev",
"state": "creating",
"type": "development",
"region": "VA7"
}
state
将变为“活动”或“失败”。创建生产沙盒
要创建生产沙盒,您必须提供 type
属性值为的属性 production
请求有效负载中的。
API格式
POST /sandboxes
请求
以下请求创建一个名为“acme”的新生产沙盒。
curl -X POST \
https://platform.adobe.io/data/foundation/sandbox-management/sandboxes \
-H 'Authorization: Bearer {ACCESS_TOKEN}' \
-H 'x-api-key: {API_KEY}' \
-H 'x-gw-ims-org-id: {ORG_ID}' \
-H `Accept: application/json` \
-H 'Content-Type: application/json' \
-d '{
"name": "acme",
"title": "Acme Business Group",
"type": "production"
}'
name
title
type
production
.响应
成功响应会返回新创建的沙盒的详细信息,表明其 state
是“创建”。
{
"name": "acme",
"title": "Acme Business Group",
"state": "creating",
"type": "production",
"region": "VA7"
}
state
将变为“活动”或“失败”。更新沙盒 put
您可以通过发出包含沙盒的PATCH请求来更新沙盒中的一个或多个字段 name
以及要在请求有效负载中更新的属性中跟踪的数据。
title
属性可以更新。API格式
PATCH /sandboxes/{SANDBOX_NAME}
{SANDBOX_NAME}
name
要更新的沙盒的属性。请求
以下请求将更新 title
名为“acme”的沙盒的属性。
curl -X PATCH \
https://platform.adobe.io/data/foundation/sandbox-management/sandboxes/acme \
-H 'Authorization: Bearer {ACCESS_TOKEN}' \
-H 'x-api-key: {API_KEY}' \
-H 'x-gw-ims-org-id: {ORG_ID}' \
-H 'Content-Type: application/json'
-d '{
"title": "Acme Business Group prod"
}'
响应
成功的响应返回HTTP状态200 (确定)以及新更新的沙盒的详细信息。
{
"name": "acme",
"title": "Acme Business Group prod",
"state": "active",
"type": "production",
"region": "VA7"
}
重置沙盒 reset
沙盒具有“工厂重置”功能,可从沙盒中删除所有非默认资源。 您可以通过发出包含沙盒的PUT请求来重置沙盒 name
在请求路径中。
API格式
PUT /sandboxes/{SANDBOX_NAME}
{SANDBOX_NAME}
name
要重置的沙盒的属性。validationOnly
validationOnly=true
检查您即将重置的沙盒是否包含任何Adobe Analytics、Adobe Audience Manager或区段共享数据。请求
以下请求重置名为“acme-dev”的沙盒。
curl -X PUT \
https://platform.adobe.io/data/foundation/sandbox-management/sandboxes/acme-dev?validationOnly=true \
-H 'Authorization: Bearer {ACCESS_TOKEN}' \
-H 'x-api-key: {API_KEY}' \
-H 'x-gw-ims-org-id: {ORG_ID}' \
-H 'Content-Type: application/json'
-d '{
"action": "reset"
}'
action
响应
成功响应会返回已更新沙盒的详细信息,表明其 state
是“重置”。
{
"id": "d8184350-dbf5-11e9-875f-6bf1873fec16",
"name": "acme-dev",
"title": "Acme Business Group dev",
"state": "resetting",
"type": "development",
"region": "VA7"
}
如果Adobe Analytics也在使用其中托管的身份图形来执行,则无法重置默认的生产沙盒和任何用户创建的生产沙盒 Cross Device Analytics (CDA) 功能,或者Adobe Audience Manager也在使用其中托管的身份图用于 基于人员的目标(PBD) 功能。
以下是可阻止沙盒重置的可能异常列表:
{
"status": 400,
"title": "Sandbox `{SANDBOX_NAME}` cannot be reset. The identity graph hosted in this sandbox is also being used by Adobe Analytics for the Cross Device Analytics (CDA) feature.",
"type": "http://ns.adobe.com/aep/errors/SMS-2074-400"
},
{
"status": 400,
"title": "Sandbox `{SANDBOX_NAME}` cannot be reset. The identity graph hosted in this sandbox is also being used by Adobe Audience Manager for the People Based Destinations (PBD) feature.",
"type": "http://ns.adobe.com/aep/errors/SMS-2075-400"
},
{
"status": 400,
"title": "Sandbox `{SANDBOX_NAME}` cannot be reset. The identity graph hosted in this sandbox is also being used by Adobe Audience Manager for the People Based Destinations (PBD) feature, as well by Adobe Analytics for the Cross Device Analytics (CDA) feature.",
"type": "http://ns.adobe.com/aep/errors/SMS-2076-400"
},
{
"status": 400,
"title": "Warning: Sandbox `{SANDBOX_NAME}` is used for bi-directional segment sharing with Adobe Audience Manager or Audience Core Service.",
"type": "http://ns.adobe.com/aep/errors/SMS-2077-400"
}
您可以继续重置用于与进行双向区段共享的生产沙盒 Audience Manager 或 Audience Core Service 通过添加 ignoreWarnings
参数到您的请求。
API格式
PUT /sandboxes/{SANDBOX_NAME}?ignoreWarnings=true
{SANDBOX_NAME}
name
要重置的沙盒的属性。ignoreWarnings
请求
以下请求重置名为“acme”的生产沙盒。
curl -X PUT \
https://platform.adobe.io/data/foundation/sandbox-management/sandboxes/acme?ignoreWarnings=true \
-H 'Authorization: Bearer {ACCESS_TOKEN}' \
-H 'x-api-key: {API_KEY}' \
-H 'x-gw-ims-org-id: {ORG_ID}' \
-H 'Content-Type: application/json'
-d '{
"action": "reset"
}'
响应
成功响应会返回已更新沙盒的详细信息,表明其 state
是“重置”。
{
"id": "d8184350-dbf5-11e9-875f-6bf1873fec16",
"name": "acme",
"title": "Acme Business Group prod",
"state": "resetting",
"type": "production",
"region": "VA7"
}
删除沙盒 delete
您可以通过发出包含沙盒的DELETE请求来删除沙盒 name
在请求路径中。
status
属性将重命名为“deleted”并停用它。 删除沙盒后,GET请求仍可以检索沙盒的详细信息。API格式
DELETE /sandboxes/{SANDBOX_NAME}
{SANDBOX_NAME}
name
要删除的沙盒的。validationOnly
validationOnly=true
检查您即将重置的沙盒是否包含任何Adobe Analytics、Adobe Audience Manager或区段共享数据。ignoreWarnings
请求
以下请求删除名为“acme”的生产沙盒。
curl -X DELETE \
https://platform.adobe.io/data/foundation/sandbox-management/sandboxes/acme?ignoreWarnings=true \
-H 'Authorization: Bearer {ACCESS_TOKEN}' \
-H 'x-api-key: {API_KEY}' \
-H 'x-gw-ims-org-id: {ORG_ID}'
响应
成功的响应将返回沙盒的更新详细信息,显示其 state
为“已删除”。
{
"name": "acme",
"title": "Acme Business Group prod",
"state": "deleted",
"type": "development",
"region": "VA7"
}