Utilización de los mandatos drupal-state

Puede utilizar los mandatos drupal-state para almacenar y recuperar información sobre el estado del sistema Portal del desarrollador .

La información sobre el estado del sistema del Portal del desarrollador se almacena en la base de datos del Portal del desarrollador y, por lo tanto, esta información se pierde si la base de datos se descarta o el sitio del Portal del desarrollador se vuelve a instalar desde la configuración.

Los mandatos drupal-state se pueden utilizar para establecer, actualizar, obtener o suprimir un valor de clave de estado. Por ejemplo, puede utilizar los mandatos drupal-state para habilitar e inhabilitar la modalidad de mantenimiento para el Portal del desarrollador; para obtener más información, consulte el escenario Cómo habilitar e inhabilitar la modalidad de mantenimiento en el Portal del desarrollador.

Aviso: Utilice el mandato drupal-state con precaución. Este mandato le permite modificar claves para el estado del sitio del Portal del desarrollador . El uso incorrecto de este mandato puede desactivar el Portal del desarrolladory, a continuación, es necesario restaurarlo a partir de una copia de seguridad.

Iniciar sesión como organización de proveedores:
```
apic login --server management_server --realm provider/identity_provider --username provider_username --password provider_password
```
Puede determinar qué proveedor de identidad usar en el parámetro --realm especificando el comando siguiente para ver la lista de todos los proveedores de identidad disponibles (no es necesario iniciar sesión para ejecutar este comando):
```
apic identity-providers:list --scope provider --server platform_api_endpoint_url --fields title,realm
```
Por ejemplo:
```
apic identity-providers:list --scope provider --server platform_api_endpoint_url --fields title,realm 
total_results: 2
results:
  - title: API Manager User Registry
    realm: provider/default-idp-2
  - title: Corporate LDAP user registry
    realm: provider/corporate-ldap
```
El valor title debería permitirle determinar qué proveedor de identidad utilizar; a continuación, puede copiar el parámetro --realm correspondiente directamente desde el valor realm visualizado. Para cualquier proveedor de identidad que su administrador haya creado después de la instalación de API Connect , los nombres se determinan en el momento de la creación. El registro de usuarios local predeterminado del gestor de API para iniciar sesión como miembro de una organización de proveedores es default-idp-2.
Para obtener todos los detalles del mandato apic login , consulte Inicio de sesión en un servidor de gestión.
Cree una nueva clave de estado Drupal o actualice una clave existente y establezca el valor.
```
apic --mode portaladmin drupal-state:set -server management_server --catalog catalogid/name --org orgid/name  --input_format input_format_type --state_key state_key_name --state_value state_value
```
Donde:
- management_server es la URL del endpoint del servidor de gestión (obligatorio).
- catalogid/name es el ID o nombre del catálogo al que pertenece el sitio (obligatorio).
- orgid/name es el ID o nombre de la organización de proveedores a la que pertenece el catálogo (obligatorio).
- input_format_type es el formato de entrada del valor para la clave de estado. Puede ser string, integer, float, boolean, jsono yaml. El valor predeterminado es auto, lo que significa que puede omitir este parámetro, y la CLI del kit de herramientas decidirá qué formato utilizar.
- state_key_name es el nombre de la clave de estado, por ejemplo system.cron_last (obligatorio).
- state_value es el valor que se asigna a la clave de estado (obligatorio).
- --format es el formato de salida. Puede ser json, yaml, go-template=..., go-template-file=.... El valor predeterminado es yaml.
Por ejemplo, para crear una clave nueva denominada testKeyy establecer el valor en 123:
```
apic --mode portaladmin drupal-state:set -s my.management.server.com -o myorg -c dev-catalog --input_format yaml --state_key testKey --state_value 123
Successfully set state testKey to the value of 123
```

Obtener el valor de una clave de estado Drupal determinada.

apic --mode portaladmin drupal-state:get --server management_server --catalog catalogid/name --org orgid/name  --format format_type --state_key state_key_name

Por ejemplo, para obtener el valor de la clave de estado testKey:

apic --mode portaladmin drupal-state:get -s my.management.server.com -c dev-catalog -o myorg --format yaml --state_key testKey
testKey: 123

Suprimir una clave de estado Drupal específica y su valor.

apic --mode portaladmin drupal-state:delete --server management_server --catalog catalogid/name --org orgid/name --state_key state_key_name

Por ejemplo, para suprimir la clave de estado testKey y su valor:

apic --mode portaladmin drupal-state:delete -s my.management.server.com -c dev-catalog -o myorg --state_key testKey
The key/value was successfully deleted.