Named values are useful for creating shared variables including email address and secret keys that can be reused across APIs within a workspace.They are used by API policies.

Adding workspace named values

You can add Named values to your workspace by following these steps:

  1. Select the My workspaces link from the top navigation menu or the task link options within the body of the Home page. This will show you the My workspaces page with a list of your workspaces.
  2. Select the Named values option from the left side menu option. This will show you the **Workspace named values ** page with a list of workspace Named values.
  3. Select the Add link at the top right of the Named value list table header. This will show you the Add a workspace named value page and form with the following fields:
  • Name the friendly name given to the Workspace named value (may only contain letters, numbers, dash, and underscore)
  • Description - short description for the Workspace named value
  • Value type - identifies the type of Workspace named value (Plain-text or Secret)
  • Value - actual value assigned to the Workspace named value
  1. Enter a name for your workspace into the Name text box.
  2. Enter a description for your workspace named value into the Description text box.
  3. Select a type from the Value type list options (Plain-text(APIM) or Secret(APIM)) for your workspace Named value.
  4. Enter the value for your workspace Named value into the Value text box.
  5. Select the Save named value button. Or Return to named values link to cancel.

Viewing workspace named values list

You can add Named values to a workspace by following these steps:

  1. Select the My workspaces link from the top navigation menu or the task link options within the body of the Home page. This will show you the **Workspace named values ** page with a list of workspace Named values.
  2. Select the Named values option from the left side menu option. This will show you the **Workspace named values ** page with a list of workspace Named values.
  3. Select the View link next to the Named value from the list. This will show you the Workspace named value page with the following details:
  • Delete named value link at the top of the detail - allows you to delete a workspace named value
  • Name - the friendly name given to the Workspace named value
  • Value type - identifies the type of Workspace named value (Plain-text or Secret)
  • Status - indicates the status of the Workspace named value
  • Value - value assigned to the Workspace named value
  • Edit link - allows you to change the value assigned to the Workspace named value

Editing workspace named values

You can add Named values to a workspace by following these steps:

  1. Select the My workspaces link from the top navigation menu or the task link options within the body of the Home page. This will show you the My workspaces page with a list of your workspaces.
  2. Select the Named values option from the left side menu option. This will show you the **Workspace named values ** page with a list of workspace Named values.
  3. Select the View link next to the Named value from the list. This will display the Workspace named value page with the following details:
  • Delete named value link at the top of the detail - allows you to delete a workspace named value
  • Name - the friendly name given to the Workspace named value
  • Value type - identifies the type of Workspace named value (Plain-text or Secret)
  • Status - indicates the status of the Workspace named value
  • Value - value assigned to the Workspace named value
  • Edit link - allows you to change the value assigned to the Workspace named value
  1. Select the Edit link to the right of the value entry for the Named value. This will show you the Edit workspace named value page and form.
  2. Type in the new text for the Decription or Value - which are the only fields you can change.
  3. Select the Save named value button. Or the Return to named value link to cancel.

When a workspace named value is changed, the status will be change to 'Updating' before finally changing to 'Active'.

Viewing workspace named values detail

You can view a workspace named value detail by following these steps:

  1. Select the My workspaces link from the top navigation menu or the task link options within the body of the Home page. This will show you the My workspaces page with a list of your workspaces.
  2. Select the Named values option from the left side menu option. This will show you the **Workspace named values ** page with your list of workspace Named values.
  3. Select the View link next to the Named value from the list. This will show you the Workspace named value detail page with the following details:
  • Delete named value link at the top of the detail - allows you to delete a workspace named value
  • Name - the friendly name given to the Workspace named value
  • Value type - identifies the type of Workspace named value (Plain-text or Secret)
  • Status - indicates the status of the Workspace named value
  • Value - value assigned to the Workspace named value
  • Edit link - allows you to change the value assigned to the Workspace named value

Deleting workspace named values

You can delete any added workspace Named values by following these steps:

  1. Select the My workspaces link from the top navigation menu or the task link options within the body of the Home page. This will show you the My workspaces page with a list of your workspaces.
  2. Select the Named values option from the left side menu option. This will show you the **Workspace named values ** page with a list of workspace Named values.
  3. Select the Delete link next to the Named value from the list. This will show you the Delete workspace named value page.
  4. Select the Delete named value button. Or the Return to workspace named values link to cancel.

Deleting a Workspace named value is permanent and cannot be reverved. Additionally, note that once a Workspace named value is deleted the Status changes from 'Active' to 'Deleting' before finally being deleted.