Create a working environment with BYOL licensing

Contributors netapp-ranuk

You can use this workflow to create a new Cloud Volumes ONTAP working environment using bring your own license (BYOL) licensing.

Note the following when using BYOL licensing:

  • A marketplace subscription is not required.

  • A NetApp Support Site (NSS) key is required to register the system for support.

  • You can add more volumes after creating the working environment. You can choose to create a volume using either NFS, CIFS, or iSCSI protocol.

1. Select the region

Perform the workflow Get regions and choose the name value of the required region for the region parameter in step 10.

2. Select the workspace

Perform the workflow Get tenants and choose the workspacePublicId value for the tenantId parameter in step 10.

3. Select the VNets

Perform the workflow Get VNets and do the following:

  • Choose the id value of the desired vnet from the virtualNetworks for the vnetId parameter in step 10.

  • Choose the cidr value of the desired cidr from the virtualNetworks for the cidr parameter in step 10.

  • Choose the id of the desired subnet from the virtualNetworkscidrssubnets for the subnetId parameter in step 10.

  • Choose the id of the desired security group from the securityGroups field for the securityGroupId parameter in step 10.

4. Select the Azure availability zone

Perform the workflow Get Availability Zones and choose the number from zones for the availabilityZone parameter in step 10.

5. Select Azure packages configuration

Perform the Get Azure Packages workflow and choose the name of the desired package item for the packageName parameter.

6. Obtain the required NSS key

An NSS key is required when using BYOL licensing. You can create a key or select an existing key, and include the NSS key in the nssAccount parameter in step 10.

  • To create a new NSS key using the Cloud Manager web user interface, perform the task Add NSS credentials key and choose the id.

  • To select an existing NSS key, perform the workflow Get NSS keys and choose the id of the required NSS user.

7. Select Azure cloud provider accounts

Perform the Get Azure Cloud Provider Accounts workflow and choose the publicId of the desired cloud provider account item from the azureAccounts for the cloudProviderAccount parameter.

8. Select the Azure permutations

Perform the Get Azure Permutations workflow and pick the desired permutation:

  • Choose the ontapVersion of the desired permutation for the ontapVersion field inside the vsaMetadata parameter in step 10.

  • Choose the type of the desired license item from the license parameter for the licenseType field inside the vsaMetadata parameter in step 10.

  • Choose the instanceType of the desired permutation for the instanceType field inside the vsaMetadata parameter in step 10.

9. Select the Azure storage account types

Perform the Get Azure Storage Account Types workflow and pick the desired storage type.

  • Choose the diskType of the desired storage type item for the storageType parameter in step 10.

  • Choose the size of the desired disk size from the sizessize field for the size field inside the diskSize parameter in step 10.

  • Choose the unit of the desired disk size from the sizessize field for the unit field inside the diskSize parameter in step 10.

10. Create the working environment

HTTP method Path

POST

/occm/api/azure/vsa/working-environments

curl example
curl --location --request POST 'https://cloudmanager.cloud.netapp.com/occm/api/azure/vsa/working-environments' --header 'x-agent-id: <AGENT_ID>' //1 --header 'Authorization: Bearer <ACCESS_TOKEN>' //2 --header 'Content-Type: application/json' --d @JSONinput

(1) Replace <AGENT_ID> with your agent ID.
(2) Replace <ACCESS_TOKEN> with your obtained bearer access token.

Input

The JSON input example includes the minimum list of parameters. This request uses BYOL licensing as indicated in the licenseType parameter. The serialNumber is required.

JSON input example
{
  "name": "Azure123",
  "tenantId": "tenantID",
  "region": "eastus2",
  "packageName": "azure_custom",
  "dataEncryptionType": "AZURE",
  "vsaMetadata": {
    "ontapVersion": "ONTAP-9.9.0X5.T1.azure",
    "licenseType": "azure-cot-premium-byol",
    "instanceType": "Standard_DS3_v2"
  },
  "nssAccount": "x0x0x000-0000-000x-00xx-xxxxxc0000xx",
  "subnetId": "/subscriptions/x000xx00-0x00-0000-000x-x00xxxx0x00/resourceGroups/occm_group_eastus2/providers/Microsoft.Network/virtualNetworks/Vnet1/subnets/ProxySubnet",
  "svmPassword": "password",
  "vnetId": "/subscriptions/x000xx00-0x00-0000-000x-x00xxxx0x00/resourceGroups/occm_group_eastus2/providers/Microsoft.Network/virtualNetworks/Vnet1",
  "cidr": "10.0.0.0/16",
  "diskSize": {
    "size": 1,
    "unit": "TB"
  },
  "storageType": "Premium_LRS",
  "resourceGroup": "Azure123-rg",
  "serialNumber": "90320130000000005001",
  "subscriptionId": "x000xx00-0x00-0000-000x-x00xxxx0x00",
  "cloudProviderAccount": "ManagedServiceIdentity",
  "availabilityZone": 2
}
Output

The JSON output example includes an example of the VsaWorkingEnvironmentRresponse response.

JSON output example

{
    "publicId": "VsaWorkingEnvironment-uFPaNkrv",
    "name": "Azure123",
    "tenantId": "tenantID",
    "svmName": "svm_Azure123",
    "creatorUserEmail": "user_mail",
    "status": null,
    "providerProperties": null,
    "reservedSize": null,
    "clusterProperties": null,
    "ontapClusterProperties": null,
    "cloudProviderName": "Azure",
    "snapshotPolicies": null,
    "actionsRequired": null,
    "activeActions": null,
    "replicationProperties": null,
    "schedules": null,
    "svms": null,
    "workingEnvironmentType": "VSA",
    "supportRegistrationProperties": null,
    "supportRegistrationInformation": null,
    "capacityFeatures": null,
    "encryptionProperties": null,
    "supportedFeatures": null,
    "isHA": false,
    "haProperties": null,
    "k8sProperties": null,
    "fpolicyProperties": null,
    "saasProperties": null,
    "cbsProperties": null,
    "complianceProperties": null,
    "monitoringProperties": null
}