CLI集成示例
阿里云CLI(Alibaba Cloud Command Line Interface)是基于OpenAPI构建的通用命令行工具,您可以通过阿里云CLI实现自动化管理和维护云SSO。本文将为您介绍云SSO管理员使用阿里云CLI调用云SSO的操作步骤和示例。
前置概念
阅读本文前,若您还不了解阿里云CLI,请参见什么是阿里云CLI。
安装阿里云CLI
使用阿里云CLI前,您需要先安装阿里云CLI。阿里云CLI为用户提供了Windows、Linux和macOS三种操作系统下的安装服务,请根据您使用设备的操作系统选择对应的安装服务。
Windows:在Windows上安装阿里云CLI。
Linux:在Linux上安装阿里云CLI。
macOS:在macOS上安装阿里云CLI。
您也可使用阿里云提供的云命令行Cloud Shell调试阿里云CLI命令。关于云命令行的更多信息,请参见什么是云命令行。
配置阿里云CLI
具体操作步骤,请参见使用CLI登录云SSO并访问阿里云资源。
生成CLI命令示例
登录云SSO API调试列表。
在API调试界面左侧搜索框中可搜索您需要使用的API。在参数配置中根据API文档信息填写参数,单击参数配置右侧的CLI示例页签即可生成携带参数的命令示例。
单击运行命令
按钮,可唤出云命令行Cloud Shell并在其中快速完成命令调试。
单击复制
按钮,将CLI示例复制到剪贴板中,可粘贴至本地Shell工具中运行。
复制CLI示例到本地Shell工具中进行调试时请注意参数格式。关于阿里云CLI命令参数使用格式的详细信息,请参见参数格式说明。
OpenAPI门户生成示例中会默认添加
--region
选项,复制命令到本地调用时阿里云CLI将忽略默认身份凭证配置及环境变量设置中的地域信息,优先使用指定的地域调用命令,您可根据需要对该选项进行删除或保留。
调用API
命令结构
阿里云CLI的通用命令行结构如下。更多详情,请参见命令结构。
aliyun <command> <subcommand> [options and parameters]
常用命令选项
在阿里云CLI中,您可根据需要使用命令行选项,用来修改命令的默认行为或为命令提供额外功能。常用命令行选项如下:
--profile <profileName>
:使用--profile
选项并指定有效配置名称profileName
后,阿里云CLI将忽略默认身份凭证配置及环境变量设置,优先使用指定的配置进行命令调用。--help
:在需要获取帮助的命令层级处键入--help
选项,即可获取该命令的帮助信息。更多详情,请参见获取帮助信息。
更多详细信息,请参见API命令可用选项。
调用示例
示例一:以下代码示例将为您展示如何使用--help
选项获取云SSO支持阿里云CLI调用API列表。您也可在API概览中查看支持调用的API。
执行命令。
aliyun cloudsso --help
输出结果。
示例二:以下代码示例将为您展示如何使用阿里云CLI调用云SSO中的CreateUser
命令,创建一个云SSO用户Alice
。
执行命令。
aliyun cloudsso CreateUser --region cn-shanghai --DirectoryId 'd-00fc2p61****' --UserName Alice
输出结果。
{ "User": { "Status": "Enabled", "UserName": "Alice", "Email": "", "Description": "", "UserId": "u-004ds*************", "FirstName": "", "CreateTime": "2024-05-16T10:49:27Z", "ProvisionType": "Manual", "DisplayName": "", "UpdateTime": "2024-05-16T10:49:27Z", "LastName": "" }, "RequestId": "E5D5256C-3981-5EB8-AB9C-30DF641D4DC9" }
说明如果调用云SSO API后返回错误,您需要根据返回的错误码提示检查传入的请求参数及其取值是否正确。
您也可以记录下调用返回的RequestID或SDK报错信息,通过阿里云OpenAPI诊断平台进行自助诊断。