UIP o activos

Sintaxis y opciones para `uip o activos`, que gestiona los activos de Orchestrator (Texto, Bool, Entero, Credencial, Secreto) en una carpeta.

Gestionar activos de Orchestrator: valores de configuración con nombre utilizados por las automatizaciones en runtime (Texto, Bool, Entero, Credencial, Secreto). La mayoría de las operaciones tienen un ámbito de carpeta.

Para las convenciones de recursos cruzados (autenticación, ámbito de carpeta, tipos de clave, sobre de salida), consulta la uip or descripción general.

Sinopsis

uip or assets list             [--folder-path <path> | --folder-key <key> | --all-folders] [-n <name>] [--type <type>] [-l, --limit <n>] [--offset <n>] [--sort-by <field>] [--all-fields]
uip or assets get              <asset-key> [--all-fields]
uip or assets create           <name> <value> --folder-path <path> | --folder-key <key> [--type <type>] [-s <scope>] [-d <desc>] [--has-default] [--tags <list>] [--credential-store-key <guid>]
uip or assets update           <asset-key> [<value>] [flags as for create]
uip or assets delete           <asset-key> --yes
uip or assets get-folders      <asset-key>
uip or assets share            <asset-key> --folder-path <path> | --folder-key <key>
uip or assets unshare          <asset-key> --folder-path <path> | --folder-key <key>
uip or assets get-asset-value  <asset-key> --folder-path <path> | --folder-key <key> [--executor-key <guid>]

Lista

Enumerar activos. Requiere --folder-path, --folder-key o --all-folders (para enumerar en todas las carpetas accesibles). Filtros: -n, --name <name>, --type <Text|Bool|Integer|Credential|Secret> (no distingue entre mayúsculas y minúsculas). Los valores de credencial y secreto se omiten de los resultados. --sort-by <field> ordena los resultados (por ejemplo, Name asc, Id desc); --all-fields devuelve la respuesta completa de la API en lugar del resumen seleccionado.

uip or assets list --folder-path Shared --type Credential

get

Obtener detalles del activo por clave. Multicarpeta : no se necesita carpeta. No se devuelven los valores de credencial/secreto. --all-fields devuelve la respuesta completa de la API.

uip or assets get a1b2c3d4-0000-0000-0000-000000000001

Crear

Crea un activo en una carpeta. Requiere <name> y <value>. Marcadores: --type <Text|Bool|Integer|Credential|Secret> (predeterminado: Text), -s, --scope <Global|PerRobot> (predeterminado: Global), -d, --description, --has-default, --tags <comma-list>, --credential-store-key <guid> (requerido para Credential/Secret). Los valores booleanos deben ser true/false; El entero debe ser un número entero; La credencial utiliza el formato username:password (excepto cuando está respaldada por un almacén de credenciales externo de solo lectura; entonces <value> es el nombre de búsqueda externo).

uip or assets create ApiEndpoint "https://api.example.com" \
  --folder-path Shared --type Text

Actualizar

Actualizar un activo por clave. Carpeta cruzada. <value> es opcional; solo se cambian los campos proporcionados. Mismas marcas de tipo/ámbito/etiquetas que create.

uip or assets update a1b2c3d4-0000-0000-0000-000000000001 \
  "https://api.new.example.com" --description "Production API"

Eliminar

Eliminar un activo por clave. Carpeta cruzada. Requiere -y, --yes: la CLI nunca solicita operaciones destructivas.

uip or assets delete a1b2c3d4-0000-0000-0000-000000000010 --yes

Obtener carpetas

Enumera cada carpeta con la que se comparte el activo, más el recuento total.

uip or assets get-folders a1b2c3d4-0000-0000-0000-000000000001

compartir/dejar de compartir

Añade o elimina el activo de una carpeta. Requiere --folder-path o --folder-key.

uip or assets share a1b2c3d4-0000-0000-0000-000000000001 \
  --folder-path "Production"
uip or assets unshare a1b2c3d4-0000-0000-0000-000000000001 \
  --folder-path "Production"

obtener valor del activo

Devuelve el valor del activo para el usuario actual (predeterminado) o para un ejecutor determinado (--executor-key <guid>). Requiere --folder-path o --folder-key. Los activos de tipo credencial servidos por un almacén externo solo se pueden leer a través de --executor-key; el comando muestra esa corrección cuando obtiene un 403.

uip or assets get-asset-value a1b2c3d4-0000-0000-0000-000000000001 \
  --folder-path Shared

Códigos de salida

Consulta Códigos de salida para el contrato compartido. delete sale de 1 si se omite -y, --yes.

Comandos relacionados

• uip or buckets, uip or queues : recursos complementarios en el ámbito de la carpeta.
• uip or credential-stores list : busca el --credential-store-key necesario para los activos de Credencial/Secreto.

Ver también

• Información generaluip or : convenciones compartidas para cada verbo uip or .
• Tutorial: gestionar activos y colas de Orchestrator : patrones masivos e implementación impulsada por CSV.