Add a
Microsoft Azure
Cloud Account

To create a
Microsoft Azure
cloud account, you make a POST request. The request body includes parameters specific to
Microsoft Azure
that are required to create the cloud account.
  • Verify that all general prerequisites and prerequisites for the
    Automation Assembler
    Infrastructure as a Service (IaaS) service have been satisfied. See Prerequisites for API Use Case Examples.
  • Verify that you have the following parameters for the new cloud account:
    • Microsoft Azure
      subscription ID
    • Microsoft Azure
      tenant ID
    • Microsoft Azure
      client application ID
    • Microsoft Azure
      client application secret key
As an alternative to using the
cloud-accounts
API call, you can use a
cloud-accounts-azure
API call that creates a
Microsoft Azure
cloud account with fewer input parameters.
  1. Assign the
    Microsoft Azure
    account variables.
    azure_subscription_id='<
    your_azure_subscription_id
    >' azure_tenant_id='<
    your_azure_tenant_id
    >' azure_client_application_id='<
    your_azure_client_application_id
    >' azure_client_application_secret_key='<
    your_azure_client_application_secret_key
    >'
  2. Submit a request to create a
    Microsoft Azure
    cloud account with default cloud zones.
    curl -X POST \ "$url/iaas/api/cloud-accounts?apiVersion=$api_version" \ -H 'Content-Type: application/json' \ -H "Authorization: Bearer $access_token" \ -d '{ "cloudAccountType":"azure", "privateKeyId":"'$azure_client_application_id'", "privateKey":"'$azure_client_application_secret_key'", "cloudAccountProperties": { "userLink":"'$azure_subscription_id'", "azureTenantId":"'$azure_tenant_id'" }, "regionIds":["<
    your_region_id
    >"], "createDefaultZones":true, "name":"<
    your_azure_cloud_account
    >", "description": "This is a demo Azure cloud account", }' | jq "."
  3. Submit a request to create a
    Microsoft Azure
    cloud account with the
    cloud-accounts-azure
    API call.
    curl -X POST \ "$url/iaas/api/cloud-accounts-azure?apiVersion=$api_version" \ -H 'Content-Type: application/json' \ -H "Authorization: Bearer $access_token" \ -d '{ "name":"<
    your_azure_cloud_account
    >", "description": "This is a demo Azure cloud account", "subscriptionId": "'$azure_subscription_id'", "tenantId": "'$azure_tenant_id'", "clientApplicationId": "'$azure_client_application_id'", "clientApplicationSecretKey": "'$azure_client_application_secret_key'", "regionIds": [ "<
    your_region_id1
    >", "<
    your_region_id2
    >" ], "createDefaultZones": true, "tags": [ { "key": "env", "value": "dev" } ] }' | jq "."
  4. List all cloud accounts.
    curl -X GET $url/iaas/api/cloud-accounts?apiVersion=$api_version -H 'Content-Type: application/json' -H "Authorization: Bearer $access_token" | jq "."
  5. Examine the response and verify that the name and ID of the
    Microsoft Azure
    cloud account you created is listed.
Create a
Microsoft Azure
Cloud Account
Assign the required variables.
$ url='https://appliance.domain.com' $ api_version='
2021-07-15
' $ azure_subscription_id='r1e31415-4a08-4072-be4a-19de37d12345' $ azure_tenant_id='s39138ca-3abc-4b4a-a4d6-cd92d9dd62f0' $ azure_client_application_id='te21wxyz-b183-42ac-cd84-3c4a2459b9a9' $ azure_client_application_secret_key='udv6lY8MwpP5ABCDfSztP3ABCDEaLMNOPQRmDEUeiI0='
Create a cloud account named
demo-azure-account
.
$ curl -X POST \ "$url/iaas/api/cloud-accounts?apiVersion=$api_version" \ -H 'Content-Type: application/json' \ -H "Authorization: Bearer $access_token" \ -d '{ "cloudAccountType":"azure", "privateKeyId":"'$azure_client_application_id'", "privateKey":"'$azure_client_application_secret_key'", "cloudAccountProperties": { "userLink":"'$azure_subscription_id'", "azureTenantId":"'$azure_tenant_id'" }, "regionIds":["eastus"], "createDefaultZones":true, "name": "demo-azure-account", "description": "This is a demo Azure cloud account", }' | jq "."
A snippet of the response from your request shows the account ID.
... "tags": [], "name": "demo-azure-account", "id": "c8c3c9bfdb449475-7f703c5265a63d87-f8e705d89b2569e1aac66c6d00bf4fc7ef4b1c44100f0e944af31eb8ba3d2a5a-f4226a20b65c4675574bc5fbff6c0", "updatedAt": "
2022-04-02
", "organizationId": "8327d53f-91ea-420a-8613-ba8f3149db95", ...