Extremo de administración del Simulador para pruebas

Los entornos limitados de Adobe Experience Platform proporcionan entornos de desarrollo aislados que le permiten probar funciones, ejecutar experimentos y realizar configuraciones personalizadas sin afectar a su entorno de producción. La variable /sandboxes en la variable Sandbox La API de le permite administrar mediante programación entornos limitados en Platform.

Primeros pasos

El extremo de API utilizado en esta guía forma parte de la variable Sandbox API. Antes de continuar, revise la guía de introducción para ver vínculos a documentación relacionada, una guía para leer las llamadas de API de ejemplo en este documento e información importante sobre los encabezados necesarios para realizar llamadas correctamente a cualquier API de Experience Platform.

Recuperar una lista de entornos limitados

Puede enumerar todos los entornos limitados pertenecientes a su organización de IMS (activa o de otro tipo) realizando una solicitud de GET al /sandboxes punto final.

Formato de API

GET /sandboxes?{QUERY_PARAMS}
Parámetro Descripción
{QUERY_PARAMS} Parámetros de consulta opcionales para filtrar los resultados por. Consulte la sección sobre parámetros de consulta para obtener más información.

Solicitud

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}'

Respuesta

Una respuesta correcta devuelve una lista de entornos limitados pertenecientes a su organización, incluidos detalles como name, title, statey 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
        }
    }
}
Propiedad Descripción
name Nombre del simulador de pruebas. Esta propiedad se utiliza con fines de búsqueda en llamadas a la API.
title Nombre para mostrar del simulador para pruebas.
state Estado de procesamiento actual del simulador de pruebas. El estado de un simulador para pruebas puede ser cualquiera de los siguientes:
  • creating: Se ha creado el simulador para pruebas, pero el sistema sigue aprovisionándolo.
  • active: El simulador para pruebas se crea y se activa.
  • failed: Debido a un error, el simulador de pruebas no pudo ser aprovisionado por el sistema y está deshabilitado.
  • deleted: El simulador para pruebas se ha desactivado manualmente.
type El tipo de entorno limitado. Los tipos de entornos limitados admitidos incluyen development y production.
isDefault Una propiedad booleana que indica si este entorno limitado es el entorno limitado de producción predeterminado para la organización.
eTag Identificador de una versión específica del simulador de pruebas. Este valor, que se utiliza para el control de versiones y la eficacia del almacenamiento en caché, se actualiza cada vez que se realiza un cambio en el simulador para pruebas.

Buscar un simulador para pruebas

Puede buscar un entorno limitado individual realizando una solicitud de GET que incluya el name en la ruta de solicitud.

Formato de API

GET /sandboxes/{SANDBOX_NAME}
Parámetro Descripción
{SANDBOX_NAME} La variable name propiedad del simulador de pruebas que desea buscar.

Solicitud

La siguiente solicitud recupera un entorno limitado denominado "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}' \

Respuesta

Una respuesta correcta devuelve los detalles del simulador de pruebas, incluido su name, title, statey 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}"
}
Propiedad Descripción
name Nombre del simulador de pruebas. Esta propiedad se utiliza con fines de búsqueda en llamadas a la API.
title Nombre para mostrar del simulador para pruebas.
state Estado de procesamiento actual del simulador de pruebas. El estado de un simulador para pruebas puede ser cualquiera de los siguientes:
  • creación: Se ha creado el simulador para pruebas, pero el sistema sigue aprovisionándolo.
  • active: El simulador para pruebas se crea y se activa.
  • failed: Debido a un error, el simulador de pruebas no pudo ser aprovisionado por el sistema y está deshabilitado.
  • eliminado: El simulador para pruebas se ha desactivado manualmente.
type El tipo de entorno limitado. Los tipos de entorno limitado admitidos actualmente son: development y production.
isDefault Una propiedad booleana que indica si este entorno limitado es el entorno limitado predeterminado para la organización. Normalmente, este es el simulador para pruebas de producción.
eTag Identificador de una versión específica del simulador de pruebas. Este valor, que se utiliza para el control de versiones y la eficacia del almacenamiento en caché, se actualiza cada vez que se realiza un cambio en el simulador para pruebas.

Creación de un simulador de pruebas

NOTA

Cuando se crea un nuevo simulador para pruebas, primero debe agregar ese nuevo simulador para pruebas al perfil del producto en Adobe Admin Console antes de empezar a usar el nuevo simulador de pruebas. Consulte la documentación sobre administración de permisos para un perfil de producto para obtener información sobre cómo aprovisionar un entorno limitado a un perfil de producto.

Puede crear un nuevo entorno limitado de desarrollo o producción realizando una solicitud de POST al /sandboxes punto final.

Creación de un entorno limitado de desarrollo

Para crear un entorno limitado de desarrollo, debe proporcionar una type atributo con un valor de development en la carga útil de la solicitud.

Formato de API

POST /sandboxes

Solicitud

La siguiente solicitud crea un nuevo entorno limitado de desarrollo denominado "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"
  }'
Propiedad Descripción
name Identificador que se utilizará para acceder al simulador para pruebas en futuras solicitudes. Este valor debe ser único y se recomienda hacerlo lo más descriptivo posible. Este valor no puede contener espacios ni caracteres especiales.
title Un nombre legible que se utiliza con fines de visualización en la interfaz de usuario de Platform.
type Tipo de simulador de pruebas que se va a crear. Para un entorno limitado que no sea de producción, este valor debe ser development.

Respuesta

Una respuesta correcta devuelve los detalles del entorno limitado recién creado, lo que muestra que state es "crear".

{
    "name": "acme-dev",
    "title": "Acme Business Group dev",
    "state": "creating",
    "type": "development",
    "region": "VA7"
}
NOTA

Los entornos limitados tardan unos 30 segundos en ser aprovisionados por el sistema, tras lo cual su state se convertirá en "activo" o "fallido".

Creación de un simulador para pruebas de producción

Para crear un simulador para pruebas de producción, debe proporcionar un type atributo con un valor de production en la carga útil de la solicitud.

Formato de API

POST /sandboxes

Solicitud

La siguiente solicitud crea un nuevo entorno limitado de producción denominado "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"
}'
Propiedad Descripción
name Identificador que se utilizará para acceder al simulador para pruebas en futuras solicitudes. Este valor debe ser único y se recomienda hacerlo lo más descriptivo posible. Este valor no puede contener espacios ni caracteres especiales.
title Un nombre legible que se utiliza con fines de visualización en la interfaz de usuario de Platform.
type Tipo de simulador de pruebas que se va a crear. Para un simulador para pruebas de producción, este valor debe ser production.

Respuesta

Una respuesta correcta devuelve los detalles del entorno limitado recién creado, lo que muestra que state es "crear".

{
    "name": "acme",
    "title": "Acme Business Group",
    "state": "creating",
    "type": "production",
    "region": "VA7"
}
NOTA

Los entornos limitados tardan unos 30 segundos en ser aprovisionados por el sistema, tras lo cual su state se convertirá en "activo" o "fallido".

Actualizar un simulador para pruebas

Puede actualizar uno o varios campos de un simulador de pruebas realizando una solicitud de PATCH que incluya el name en la ruta de solicitud y la propiedad que se va a actualizar en la carga útil de solicitud.

NOTA

Actualmente solo hay un simulador de pruebas title se puede actualizar.

Formato de API

PATCH /sandboxes/{SANDBOX_NAME}
Parámetro Descripción
{SANDBOX_NAME} La variable name propiedad del simulador de pruebas que desea actualizar.

Solicitud

La siguiente solicitud actualiza el title propiedad del simulador de pruebas denominado "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"
  }'

Respuesta

Una respuesta correcta devuelve el estado HTTP 200 (OK) con los detalles del entorno limitado recién actualizado.

{
    "name": "acme",
    "title": "Acme Business Group prod",
    "state": "active",
    "type": "production",
    "region": "VA7"
}

Restablecer un simulador para pruebas

Los entornos limitados tienen una función de "restablecimiento de fábrica" que elimina todos los recursos no predeterminados de un entorno limitado. Puede restablecer un simulador para pruebas realizando una solicitud de PUT que incluya el name en la ruta de solicitud.

Formato de API

PUT /sandboxes/{SANDBOX_NAME}
Parámetro Descripción
{SANDBOX_NAME} La variable name propiedad del simulador de pruebas que desea restablecer.
validationOnly Un parámetro opcional que permite realizar una comprobación previa de la operación de restablecimiento del simulador para pruebas sin realizar la solicitud real. Establezca este parámetro como validationOnly=true para comprobar si el simulador para pruebas que va a restablecer contiene datos de uso compartido de Adobe Analytics, Adobe Audience Manager o segmentos.

Solicitud

La siguiente solicitud restablece un simulador de pruebas denominado "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"
  }'
Propiedad Descripción
action Este parámetro debe proporcionarse en la carga útil de la solicitud con un valor de "reset" para restablecer el simulador para pruebas.

Respuesta

NOTA

Una vez que se restablece un simulador para pruebas, el sistema tarda unos 30 segundos en aprovisionar.

Una respuesta correcta devuelve los detalles del simulador de pruebas actualizado, mostrando que su valor state es "restablecer".

{
    "id": "d8184350-dbf5-11e9-875f-6bf1873fec16",
    "name": "acme-dev",
    "title": "Acme Business Group dev",
    "state": "resetting",
    "type": "development",
    "region": "VA7"
}

El entorno limitado de producción predeterminado y los entornos limitados de producción creados por el usuario no se pueden restablecer si Adobe Analytics también está utilizando el gráfico de identidad alojado en él para el Análisis entre dispositivos (CDA) o si el gráfico de identidad alojado en él también está siendo utilizado por Adobe Audience Manager para la función People Based Destinations (PBD) función.

A continuación se muestra una lista de posibles excepciones que podrían impedir que se restablezca un simulador para pruebas:

{
    "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"
}

Puede proceder a restablecer un simulador para pruebas de producción que se utilice para el uso compartido bidireccional de segmentos con Audience Manager o Audience Core Service añadiendo la variable ignoreWarnings a su solicitud.

Formato de API

PUT /sandboxes/{SANDBOX_NAME}?ignoreWarnings=true
Parámetro Descripción
{SANDBOX_NAME} La variable name propiedad del simulador de pruebas que desea restablecer.
ignoreWarnings Un parámetro opcional que le permite omitir la comprobación de validación y forzar el restablecimiento de un simulador para pruebas de producción que se utiliza para el uso compartido de segmentos bidireccionales con Audience Manager o Audience Core Service. Este parámetro no se puede aplicar a un entorno limitado de producción predeterminado.

Solicitud

La siguiente solicitud restablece un simulador de pruebas de producción denominado "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"
  }'

Respuesta

Una respuesta correcta devuelve los detalles del simulador de pruebas actualizado, mostrando que su valor state es "restablecer".

{
    "id": "d8184350-dbf5-11e9-875f-6bf1873fec16",
    "name": "acme",
    "title": "Acme Business Group prod",
    "state": "resetting",
    "type": "production",
    "region": "VA7"
}

Eliminación de un simulador para pruebas

IMPORTANTE

No se puede eliminar el entorno limitado de producción predeterminado.

Puede eliminar un simulador para pruebas realizando una solicitud de DELETE que incluya el name en la ruta de solicitud.

NOTA

Al realizar esta llamada de API, se actualiza el status para "eliminar" y la desactiva. Las solicitudes de GET aún pueden recuperar los detalles del entorno limitado una vez que se han eliminado.

Formato de API

DELETE /sandboxes/{SANDBOX_NAME}
Parámetro Descripción
{SANDBOX_NAME} La variable name del simulador de pruebas que desea eliminar.
validationOnly Un parámetro opcional que permite realizar una comprobación previa de la operación de eliminación del simulador para pruebas sin realizar la solicitud real. Establezca este parámetro como validationOnly=true para comprobar si el simulador para pruebas que va a restablecer contiene datos de uso compartido de Adobe Analytics, Adobe Audience Manager o segmentos.
ignoreWarnings Un parámetro opcional que le permite omitir la comprobación de validación y forzar la eliminación de un simulador para pruebas de producción creado por el usuario que se utiliza para el uso compartido de segmentos bidireccionales con Audience Manager o Audience Core Service. Este parámetro no se puede aplicar a un entorno limitado de producción predeterminado.

Solicitud

La siguiente solicitud elimina un simulador para pruebas de producción denominado "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}'

Respuesta

Una respuesta correcta devuelve los detalles actualizados del entorno limitado, lo que muestra que su valor state se "elimina".

{
    "name": "acme",
    "title": "Acme Business Group prod",
    "state": "deleted",
    "type": "development",
    "region": "VA7"
}

En esta página