Lectura de la entrada desde la línea de mandatos

Si un mandato developer toolkit toma un archivo como parámetro de entrada, puede dirigir el mandato para que lea la entrada directamente desde la línea de mandatos en lugar de proporcionar un archivo aparte; esto puede ser útil al escribir scripts para automatizar las operaciones de línea de mandatos, por ejemplo.

Lectura de la entrada desde un archivo

Muchos mandatos developer toolkit que crean o actualizan objetos nuevos en API Connect toman un archivo como parámetro de entrada. Por ejemplo:

Registrar un nuevo servicio de pasarela:

apic gateway-services:create [flags] GATEWAY_SERVICE_FILE

Actualizar una organización de proveedores:
```
apic orgs:update [flags] ORG_FILE
```

Crear un catálogo:

apic catalogs:create [flags] CATALOG_FILE

Crear una organización de consumidores:

apic consumer-orgs:create [flags] CONSUMER_ORG_FILE

Registrar una nueva aplicación de desarrollador:
```
apic apps:create [flags] APP_FILE
```

Cree un servidor de correo electrónico:

apic mail-servers:create [flags] MAIL_SERVER_FILE

Actualizar la lista de aplicaciones que se suscriben a un producto:
```
apic subscriptions:update [flags] SUBSCRIPTION_FILE
```

Puede formatear el archivo de entrada como archivo YAML (el valor predeterminado) o como un archivo JSON. Para utilizar un archivo JSON como entrada, incluya el parámetro --format json .

Lectura de la entrada desde la línea de mandatos

Como alternativa a proporcionar al mandato un nombre de archivo explícito, puede utilizar un guion (-) en lugar del parámetro de nombre de archivo. A continuación, el mandato leerá el contenido directamente desde la línea de mandatos, como se muestra en los ejemplos siguientes.

Registre un nuevo servicio de pasarela de DataPower® Gateway (v5 compatible) :

apic gateway-services:create --server platform-api.myserver.com --org admin --availability-zone availability-zone-default -
Reading GATEWAY_SERVICE_FILE arg from stdin
name: dpgw-service
title: DataPower gateway service, compatible with v5
gateway_service_type: datapower-gateway
endpoint: 'https://mygwhost.com:3000'
api_endpoint_base: 'https://mygwhost.com:9443'
sni:
  - host: '*'
    tls_server_profile_url: https://platform-api.myserver.com/api/orgs/75203636-f038-4287-a732-24af4bf7059d/tls-server-profiles/3c0a0e93-6aa4-4288-b09c-eccf4901b104
visibility:
  type: public

Nota: Puede obtener el valor de la propiedad tls_server_profile_url para un perfil de servidor TLS utilizando el mandato siguiente, que lista los URL para todos los perfiles de servidor TLS:

apic tls-server-profiles --org organization_name --server mgmt_endpoint_url

Crear una organización de proveedores:

apic orgs:create --server platform-api.myserver.com -
Reading ORG_FILE arg from stdin
name: development
title: Development organization
owner_url: https://platform-api.myserver.com/api/user-registries/1bbbd414-22f1-47cf-8eac-2050530d29a7/c082d755-866e-4394-959f-fbb264c6c3a1/users/2db491c7-2d0f-4f60-a8ae-f38d07481f21

Nota: Puede obtener el valor de la propiedad owner_url utilizando el mandato siguiente, que devuelve la propiedad url para un usuario específico:

apic users:get username --user-registry user_registry_name --server mgmt_endpoint_url --org organization_name --fields url --output -

Crear un catálogo:

apic catalogs:create --server platform-api.myserver.com --org myorg -
Reading CATALOG_FILE arg from stdin
name: production
title: Production Catalog
summary: Catalog containing APIs in production use

Crear una organización de consumidores:

apic consumer-orgs:create --server platform-api.myserver.com --catalog sandbox --org myorg -
Reading CONSUMER_ORG_FILE arg from stdin
name: finance-apps
title: Developers of finance applications
owner_url: https://platform-api.myserver.com/api/user-registries/a1fb8159-fda1-410f-93ab-a0ea5fd04535/70ce7ec3-e83f-4c87-9f3c-4662ad108bbc/users/fddd5df5-c178-4a34-ab92-0a48344d5c9b

Nota: Puede obtener el valor de la propiedad owner_url utilizando el mandato siguiente, que devuelve la propiedad url para un usuario específico:

apic users:get username --user-registry user_registry_name --server mgmt_endpoint_url --org organization_name --fields url --output -

Registrar una nueva aplicación de desarrollador:

apic apps:create --server consumer-api.myserver.com --org my-consumer-org --mode consumer -
Reading APP_FILE arg from stdin
name: finance
title: Finance application
summary: Mobile app for personal finance management

Cree un servidor de correo electrónico:

apic mail-servers:create --org admin --server platform-api.myserver.com  -
Reading MAIL_SERVER_FILE arg from stdin
title: My email server
name: my-email-server
host: smtp.myemail.com
port: 20
credentials:
  username: me@myemail.com
  password: password

Crear una nueva suscripción para suscribir una aplicación a un producto:

apic subscriptions:create --app myapp --catalog sandbox --org myorg --server platform-api.myserver.com --consumer-org my-consumer-org -
Reading SUBSCRIPTION_FILE arg from stdin
product_url: https://platform-api.myserver.com/api/catalogs/960733c1-d7f7-4b90-9bc7-69dbfbe4ce31/ca34537d-adf4-4320-8495-a7feaa62d679/products/638015c6-a8b0-452e-841f-2ac441ab6962
plan: default-plan

Nota: Puede obtener el valor de propiedad product_url para un producto utilizando el mandato siguiente, que lista los URL para todas las versiones de un producto dado el nombre del producto:

apic products:list product_name --scope catalog --catalog catalog_name --org provider_org_name --server mgmt_endpoint_url