Service Catalog Python SDK call example-Service Catalog(ServiceCatalog)-阿里云帮助中心

Use the Python SDK to call the Service Catalog ListPortfolios operation and query product portfolios.

Step 1: Review the OpenAPI documentation

Read the API overview to find the ListPortfolios operation and learn about the required parameters and permissions.

Step 2: Create and authorize a RAM user

Identity

You can use an Alibaba Cloud account, a RAM user, or a RAM role to call this operation. For more information, see Identities.

This example uses a RAM user to call the operation.

Log on to the Resource Access Management (RAM) console and create a RAM user for OpenAPI calls only. This generates an AccessKey pair that you must save. For more information, see Create a RAM user.

Authorization

Console

Log on to the RAM console.
On the Users page, find the user you created, and in the Operation column, click Add Permissions.
In the Add Permissions panel, grant permissions to the RAM user.
1. For Authorized Scope, select Alibaba Cloud Account.
2. For Permission Policy, enter the keyword servicecatalog in the search box. Select a permission policy based on the principle of least privilege.
  - AliyunServiceCatalogAdminFullAccess: Grants administrative permissions for Service Catalog.
  - AliyunServiceCatalogAdminReadOnlyAccess: Grants read-only administrative permissions for Service Catalog.
    
    Note
    If a system policy cannot meet your requirements, you can create a custom policy. For more information, see Create a custom permission policy and Grant permissions to a RAM user.
    
    This example uses the AliyunServiceCatalogAdminReadOnlyAccess system policy.
Click OK.

API

Grant a custom policy

Call the CreatePolicy operation to create a custom policy. For more information, see Policy elements and Policy examples.
Call the AttachPolicyToUser operation to attach the permission policy to the specified RAM user. Set the PolicyType parameter to Custom.

Grant a system policy

Call the AttachPolicyToUser operation to attach a permission policy to the specified RAM user. Set the PolicyType parameter to System and the PolicyName parameter to AliyunServiceCatalogAdminFullAccess or AliyunServiceCatalogAdminReadOnlyAccess

AliyunServiceCatalogAdminFullAccess: Grants administrative permissions for Service Catalog.
AliyunServiceCatalogAdminReadOnlyAccess: Grants read-only administrative permissions for Service Catalog.

This example uses the AliyunServiceCatalogAdminReadOnlyAccess system policy.

Credentials

Go to the details page of the RAM user. On the Authentication tab, view the AccessKey pair in the User AccessKeys section. You can also click Create AccessKey to create an AccessKey pair. For more information, see Create an AccessKey pair.

Important

The AccessKey secret of a RAM user is displayed only when the AccessKey pair is created and cannot be retrieved later. Save it in a secure location.

Step 3: Call the API operation

This example uses the Python SDK. The process is similar for other language SDKs. For more information, see Service Catalog SDK. You can also use other methods. For more information, see Invocation methods.

Prepare the Python environment

Download and install Python 3.

After installation, run python --version to verify the installation.

Configure environment variables

To avoid hardcoding your AccessKey pair in code, this example uses environment variables. For more information, see Configure credentials in environment variables on Linux, macOS, and Windows.

Install dependencies

pip install alibabacloud_credentials
pip install alibabacloud_servicecatalog20210901==1.1.4
pip install alibabacloud_tea_console

Download the sample code

In OpenAPI Explorer, go to the ListPortfolios debugging page.
Enter the request parameters and click Initiate Call to verify that the request is successful.
On the SDK Example tab, select the Python tab, and click Download the complete project. to download the Python SDK sample code package.
Extract the sample code package on your computer and navigate to the alibabacloud_sample directory.

Run the sample code

Run the following command:

python sample.py

The following output is returned:

{
	"headers": {
		"date": "Fri, 14 Jul 2023 06:29:19 GMT",
		"content-type": "application/json;charset=utf-8",
		"content-length": "577",
		"connection": "keep-alive",
		"keep-alive": "timeout=25",
		"access-control-allow-origin": "*",
		"access-control-expose-headers": "*",
		"x-acs-request-id": "A453CDA5-B557-57A5-A05B-48F14646****",
		"x-acs-trace-id": "131ed76192b0df2396bb6fb51342****",
		"etag": "5+OC5aIgno6FJurD4O1s****"
	},
	"statusCode": 200,
	"body": {
		"PageNumber": 1,
		"PageSize": 10,
		"PortfolioDetails": [{
			"CreateTime": "2023-07-14T06:11:31Z",
			"Description": "",
			"PortfolioArn": "acs:servicecatalog:cn-hangzhou:151266687691****:portfolio/port-bp1ac4uk39****",
			"PortfolioId": "port-bp1ac4uk39****",
			"PortfolioName": "test",
			"ProviderName": "test"
		}, {
			"CreateTime": "2022-09-23T01:32:59Z",
			"Description": "",
			"PortfolioArn": "acs:servicecatalog:cn-hangzhou:151266687691****:portfolio/port-bp1rfbwd2f****",
			"PortfolioId": "port-bp1rfbwd2f****",
			"PortfolioName": "abc",
			"ProviderName": "abc"
		}],
		"RequestId": "A453CDA5-B557-57A5-A05B-48F1464622A4",
		"TotalCount": 2
	}
}