Prerequisites for API Use Case Examples

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 vRealize Automation.

General prerequisites for all services

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

Verify that you have an active access token. See Getting Your Authentication Token.
Verify that the URL variable is assigned.
```
url='https://appliance.domain.com'
```

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 vRealize Automation Service Use Cases
Product: Service	Service prerequisites	Role-specific prerequisites
Cloud Assembly: Blueprint service To access the Swagger documentation for the Blueprint API, see `https://<vRA-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 vRealize Automation with a Cloud Assembly administrator service role.
Service Broker: Catalog service To access the Swagger documentation for the Catalog API, see `https://<vRA-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 vRealize Automation with a Service Broker administrator service role.
Code Stream: Code Stream service To access the Swagger documentation for the Code Stream API, see `https://<vRA-FQDN>/pipeline/api/swagger/swagger-ui.html`.	Verify that the Code Stream 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 vRealize Automation with a Code Stream administrator service role.
Service Broker: Deployment service To access the Swagger documentation for the Deployment API, see `https://<vRA-FQDN>/deployment/api/swagger/swagger-ui.html?urls.primaryName=deployments`. Note: For the Cloud Assembly: Deployment service, use the prerequisites for the Cloud Assembly: 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 vRealize Automation with a Service Broker administrator service role.
Cloud Assembly: Infrastructure as a Service (IaaS) service To access the Swagger documentation for the IaaS API, see `https://<vRA-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.	Verify that you are an organization owner in VMware vRealize Automation with a Cloud Assembly administrator service role. If working with cloud accounts, verify that you have cloud administrator credentials. See Credentials required for working with cloud accounts in vRealize Automation.
Service Broker: Policies service To access the Swagger documentation for the Policies API, see `https://<vRA-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 vRealize Automation with a Service Broker administrator service role.
All products: Project service To access the Swagger documentation for the Projects API, see `https://<vRA-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 vRealize Automation with an administrator service role.