Create and fetch resources with Axway Central CLI

Creating and fetch different Amplify Central resources using the CLI.

3 minute read

Before You Start

Objectives

  • Learn how to create and fetch various types of resources via the Axway Central CLI create and get commands.
  • Learn about the information the Axway Central CLI provides when you fetch the resources you have created.

Create a resource

Axway Central CLI supports creating several resources from either a YAML or JSON file, or Stdin. For example:

axway central create -f <path_to_file>  # Create resources defined in a YAML or JSON file.

Fetch a resource

You can query for a singular resource or multiple resources, and the CLI will display a table of the most important information about the specified resource.

axway central get <Resource> # Get a list of the resources

axway central get <Resource1>,<Resource2>,...,<ResourceN> # Get a list of multiple resources

axway central get <Resource> <Name> -s/--scope <Scope Name> # Get a specific resource by name

Create and fetch examples

The following are examples of how you can use Amplify Central samples to create and fetch different resources.

Consumer instances

You can use the sdkconsumerinstance.json sample to create a consumer instance. Then, you can fetch information about your consumer instances as follows:

axway central get consumerinstances

Alternatively, you can use a short name:

axway central get consumeri

Resource(s) successfully retrieved:

NAME           AGE           TITLE                RESOURCE KIND    SCOPE KIND   SCOPE NAME
consumerinst1  a month ago   consumerinst1 title  ConsumerInstance Environment  awsgtw-us-east-2

Consumer subscription definitions

You can use the apisubscription.json sample to create a consumer subscription definition. Then, you can fetch information about your consumer subscription definitions as follows:

axway central get consumersubscriptiondefs

Alternatively, you can use a short name:

axway central get consumersd

Resource(s) successfully retrieved:

NAME             AGE           TITLE                 RESOURCE KIND                  SCOPE KIND   SCOPE NAME
consumersubdef1  a month ago   consumersubdef1 title ConsumerSubscriptionDefinition Environment  awsgtw-us-east-2

Secrets

You can use the apisecret.json sample to create a secret. Then, you can fetch information about your secrets as follows:

axway central get secret

Alternatively, you can use a short name:

axway central get secrets

Resource(s) successfully retrieved:

NAME        AGE           TITLE       RESOURCE KIND  SCOPE KIND   SCOPE NAME
secretname  4 months ago  secrettitle Secret         Environment  apigtw-v77

Webhooks

You can use the apiwebhook.json sample to create a Webhook. Then, you can then fetch information about your Webhooks as follows:

axway central get webhooks

Alternatively, you can use a short name:

axway central get wh

Resource(s) successfully retrieved:

NAME                       AGE           TITLE                             RESOURCE KIND  SCOPE KIND   SCOPE NAME
streams-extension-webhook  a month ago   Streams Extension Webhook         Webhook        Environment  streams-dataplane-integrations
webhook                    6 months ago  Webhook to invoke requestbin.com  Webhook        Environment  cisco-b2bi
msflow                     7 months ago  webhook1 title                    Webhook        Environment  swaggerhub
msflow                     7 months ago  webhook1 title                    Webhook        Environment  azure
subscriptionwebhook        4 months ago  subscriptionwebhook               Webhook        Environment  apigtw-v77

More sample resources

You can practice the above pattern of creating and fetching resources using our sample files:

Run axway central get to see the entire list of resources supported by the Axway Central CLI.


Last modified April 1, 2021: Update cli_create_fetch_resources.md (7e8cbb6e)