Before performing any task using API services, you must review the prerequisites. General prerequisites apply to all services. Prerequisites that are service-specific are common to all endpoints for the service, but may vary depending upon the service role for example, administrator or user.

See Organization and service user roles in VMware Aria Automation.

General prerequisites for all services

Before performing any task for any service, the following prerequisites must be satisfied:

Prerequisites specific to API services

The following table lists prerequisites that are specific to the services with use cases in this guide.
Note: Every service includes an API version variable. If you choose not to assign a value to the apiVersion or to assign it to a different value, review the information in API versioning.
Table 1. Prerequisites for VMware Aria Automation Service Use Cases
Product: Service Service prerequisites Role-specific prerequisites
Automation Assembler: Blueprint service

To access the Swagger documentation for the Blueprint API, see https://<your_FQDN>/blueprint/api/swagger/ui/.

Verify that the Blueprint API version variable is assigned as in the following example.
api_version='2019-09-12'
Verify that you are at least an organization member in VMware Aria Automation with a Automation Assembler administrator service role.
Automation Service Broker: Catalog service

To access the Swagger documentation for the Catalog API, see https://<your_FQDN>/deployment/api/swagger/swagger-ui.html?urls.primaryName=catalog.

Verify that the Catalog API version variable is assigned as in the following example.
api_version='2020-08-25'
Verify that you are at least an organization member in VMware Aria Automation with a Automation Service Broker administrator service role.
Automation Pipelines: Pipelines service

To access the Swagger documentation for the Pipelines API, see https://<your_FQDN>/pipeline/api/swagger/swagger-ui.html.

Verify that the Pipelines API version variable is assigned as in the following example.
api_version='2019-10-17'
Verify that you are at least an organization member in VMware Aria Automation with a Automation Pipelines administrator service role.
Automation Service Broker: Deployment service

To access the Swagger documentation for the Deployment API, see https://<your_FQDN>/deployment/api/swagger/swagger-ui.html?urls.primaryName=deployments.

Note: For the Automation Assembler: Deployment service, use the prerequisites for the Automation Assembler: Infrastructure as a Service (IaaS) service.
Verify that the Deployment API version variable is assigned as in the following example.
api_version='2020-08-25'
Verify that you are at least an organization member in VMware Aria Automation with a Automation Service Broker administrator service role.
Automation Assembler: Infrastructure as a Service (IaaS) service

To access the Swagger documentation for the IaaS API, see https://<your_FQDN>/iaas/api/swagger/ui/.

Verify that the IaaS API version variable is assigned as in the following example.
api_version='2021-07-15'

If you do not assign a value to the apiVersion variable or you assign it to a value other than 2021-07-15, the IaaS API behavior will default to value of the previous version or 2019-01-15.

Automation Service Broker: Policies service

To access the Swagger documentation for the Policies API, see https://<your_FQDN>/deployment/api/swagger/swagger-ui.html?urls.primaryName=policies.

Verify that the Policies API version is assigned as in the following example.
api_version='2020-08-25'
Verify that you are at least an organization member in VMware Aria Automation with a Automation Service Broker administrator service role.
All products: Project service

To access the Swagger documentation for the Projects API, see https://<your_FQDN>/project/api/swagger/swagger-ui.html.

Verify that the Projects API version variable is assigned as in the following example.
api_version='2019-01-15'
Verify that you are at least an organization member in VMware Aria Automation with an administrator service role.