Use ROS SDK for Python - Resource Orchestration Service - Alibaba Cloud Documentation Center

This topic describes how to install Resource Orchestration Service (ROS) SDK for Python. This topic also provides sample code that you can run to use ROS SDK for Python.

Install ROS SDK for Python

Download and install ROS SDK for Python.

Note For more information, see SDK overview.

Initialize ROS SDK for Python.

Import the required software packages.

import sys
from typing import List
from alibabacloud_ros20190910.client import Client as ROS20190910Client
from alibabacloud_tea_openapi import models as open_api_models
from alibabacloud_ros20190910 import models as ros20190910_models

Initialize the SDK client.

def create_client(
        access_key_id: str,
        access_key_secret: str,
) -> ROS20190910Client:
    """
    Use your AccessKey pair to initialize the client. 
    @param access_key_id:
    @param access_key_secret:
    @return: Client
    @throws Exception
    """
    config = open_api_models.Config(
        # Your AccessKey ID. 
        access_key_id=access_key_id,
        # Your AccessKey secret. 
        access_key_secret=access_key_secret,
    )
    # The domain name that you want to access. 
    config.endpoint = 'ros.aliyuncs.com'
    return ROS20190910Client(config)


client = create_client(AK, SECRET)

Examples

Query the list of available regions
You can call the DescribeRegions operation to query the list of available regions. For more information about the DescribeRegions operation, see DescribeRegions.
```
def describe_region():
    """describe regions list """
    describe_regions_request = ros20190910_models.DescribeRegionsRequest()
    response = client.describe_regions(describe_regions_request)

    return response
```

Create a stack

You can call the CreateStack operation to create a stack. For more information about the CreateStack operation, see CreateStack.

In this example, the following parameters are specified:

region_id: the ID of the region to which the stack belongs.
stack_name: the name of the stack. The name must be unique within an Alibaba Cloud account.
timeout_in_minutes: the timeout period that is allowed to create the stack. Unit: minutes. If a stack is not created within the specified timeout period, the stack fails to be created.
template_body: the body of the template.
parameters: the parameters that are required to create the stack. You must specify both ParameterKey and ParameterValue.

The following sample code provides an example on how to specify the parameters:

stack_name = "MyStack"
region_id = "cn-shenzhen"
timeout = 60
template_body = """
    {
      "ROSTemplateFormatVersion": "2015-09-01",
      "Parameters": {
        "VpcName": {
          "Type": "String",
          "Description": "Vpc Name",
          "Label": "Vpc Name"
        },
        "CidrBlock": {
          "Type": "String",
          "Description": "Vpc CidrBlock",
          "Label": "Vpc CidrBlock"
         }
        },
      "Resources": {
        "Vpc": {
          "Type": "ALIYUN::ECS::VPC",
          "Properties": {
            "CidrBlock": {
              "Ref": "CidrBlock"
            },
            "VpcName": {
              "Ref": "VpcName"
            }
          }
        }
      }
    }
"""
parameters = [
        ros20190910_models.CreateStackRequestParameters(
            parameter_key='CidrBlock',
            parameter_value='192.168.0.0/16'
        ),
        ros20190910_models.CreateStackRequestParameters(
            parameter_key='VpcName',
            parameter_value='TestVpc'
        )
    ]

The following sample code provides an example on how to create the stack:

def create_stack(region_id, stack_name, template_body, timeout_in_minutes=40, parameters=[]):
    """create stack"""
    create_stack_request = ros20190910_models.CreateStackRequest(
        region_id=region_id,
        stack_name=stack_name,
        # If the length of the template body exceeds the upper limit, we recommend that you use the TemplateURL parameter to prevent request failures caused by excessively long URLs. 
        # You can also add parameters to the HTTP POST request body. 
        template_body=template_body,
        timeout_in_minutes=timeout_in_minutes,
        parameters=parameters,
        disable_rollback=True
    )
    response = client.create_stack(create_stack_request)

    return response

Query the information about a stack

You can call the GetStack operation to query the information about a stack. For more information about the GetStack operation, see GetStack.

def get_stack(region_id, stack_id):
    """get descriptions of the stack"""
    get_stack_request = ros20190910_models.GetStackRequest(
        region_id=region_id,
        stack_id=stack_id,
    )
    response = client.get_stack(get_stack_request)
    return response

Delete a stack

You can call the DeleteStack operation to delete a stack. For more information about the DeleteStack operation, see DeleteStack.

def delete_stack(region_id, stack_id):
    """delete stack"""
    delete_stack_request = ros20190910_models.DeleteStackRequest(
        region_id=region_id,
        stack_id=stack_id,
    )
    response = client.delete_stack(delete_stack_request)
    return response

Complete sample code

The following sample code provides an example on how to query the list of available regions and how to create, query, and delete a stack:

from time import sleep
from alibabacloud_ros20190910.client import Client as ROS20190910Client
from alibabacloud_tea_openapi import models as open_api_models
from alibabacloud_ros20190910 import models as ros20190910_models

AK = '<yourAccessKeyId>'
SECRET = '<yourAccessKeySecret>'
REGION = '<yourRegionId>'  # The region ID, such as 'cn-beijing' and 'cn-hangzhou'. 

def create_client(
        access_key_id: str,
        access_key_secret: str,
) -> ROS20190910Client:
    """
    Use your AccessKey pair to initialize the client. 
    @param access_key_id:
    @param access_key_secret:
    @return: Client
    @throws Exception
    """
    config = open_api_models.Config(
        # Your AccessKey ID. 
        access_key_id=access_key_id,
        # Your AccessKey secret. 
        access_key_secret=access_key_secret,
    )
    # The domain name that you want to access. 
    config.endpoint = 'ros.aliyuncs.com'
    return ROS20190910Client(config)


client = create_client(AK, SECRET)

def describe_region():
    """describe regions list """
    describe_regions_request = ros20190910_models.DescribeRegionsRequest()
    response = client.describe_regions(describe_regions_request)

    return response


def create_stack(region_id, stack_name, template_body, timeout_in_minutes=40, parameters=[]):
    """create stack"""
    create_stack_request = ros20190910_models.CreateStackRequest(
        region_id=region_id,
        stack_name=stack_name,
        # If the length of the template body exceeds the upper limit, we recommend that you use the TemplateURL parameter to prevent request failures caused by excessively long URLs. 
        # You can also add parameters to the HTTP POST request body. 
        template_body=template_body,
        timeout_in_minutes=timeout_in_minutes,
        parameters=parameters,
        disable_rollback=True
    )
    response = client.create_stack(create_stack_request)

    return response.body


def get_stack(region_id, stack_id):
    """get descriptions of the stack"""
    get_stack_request = ros20190910_models.GetStackRequest(
        region_id=region_id,
        stack_id=stack_id,
    )
    response = client.get_stack(get_stack_request)
    return response.body


def delete_stack(region_id, stack_id):
    """delete stack"""
    delete_stack_request = ros20190910_models.DeleteStackRequest(
        region_id=region_id,
        stack_id=stack_id,
    )
    response = client.delete_stack(delete_stack_request)
    return response.body


if __name__ == '__main__':
    test_template = """
        {
          "ROSTemplateFormatVersion": "2015-09-01",
          "Parameters": {
            "VpcName": {
              "Type": "String",
              "Description": "Vpc Name",
              "Label": "Vpc Name"
            },
            "CidrBlock": {
              "Type": "String",
              "Description": "Vpc CidrBlock",
              "Label": "Vpc CidrBlock"
             }
            },
          "Resources": {
            "Vpc": {
              "Type": "ALIYUN::ECS::VPC",
              "Properties": {
                "CidrBlock": {
                  "Ref": "CidrBlock"
                },
                "VpcName": {
                  "Ref": "VpcName"
                }
              }
            }
          }
        }
    """

    parameters = [
        ros20190910_models.CreateStackRequestParameters(
            parameter_key='CidrBlock',
            parameter_value='192.168.0.0/16'
        ),
        ros20190910_models.CreateStackRequestParameters(
            parameter_key='VpcName',
            parameter_value='TestVpc'
        )
    ]
    region_id = REGION
    describe_region()
    stack = create_stack(region_id, 'MyStack', test_template, parameters=parameters, timeout_in_minutes=60)
    stack_status = None
    while True:
        stack_info = get_stack(region_id, stack.stack_id)
        stack_status = stack_info.status
        print('Stack ID: {}, Stack status: {}'.format(stack.stack_id, stack_status))
        # Wait until the stack is created. 
        if stack_status == 'CREATE_COMPLETE':
            break
        sleep(3)
    delete_stack(region_id, stack.stack_id)