CreateDirectory_云SSO_API文档

插件下载了解更多
VS Code 插件
安装插件之前,确保已安装 VS Code安装插件之前,确保已安装 VS Code
Alibaba Cloud Developer Toolkit is a collection of extensions that can help access Alibaba Cloud services in Visual Studio Code.
JetBrains 插件
安装插件之前,确保已安装 JetBrains IDE安装插件之前,确保已安装 JetBrains IDE
The Alibaba Cloud Developer Toolkit for JetBrains makes it easier to access Alibaba Cloud services.

接口说明

使用说明

目录是云 SSO 中的实例。使用云 SSO 前必须先创建一个目录,所有云 SSO 资源都必须在目录中维护。

您需要选择一个地域作为云 SSO 目录的所在地域。阿里云确保所有云 SSO 相关数据都只会保存在该地域,但与您在何处部署 ECS、RDS 等云资源无关,您在全球都可以登录并访问任何地域的云资源。您可以根据安全合规需求及目标用户所在地理位置选择适合您的地域。如果没有特殊的安全合规需求,一般情况下建议您选择与目标用户所在地理位置最为接近的地域,这样可以进一步提升用户的访问速度。目前,支持在华东 2(上海)、中国(香港)、美国(硅谷)和德国(法兰克福)四个地域创建目录。

本文将提供一个示例,在华东 2(上海)地域创建名为example的目录。

使用限制

  • 一个管理账号只能创建一个目录。
  • 如果您想修改目录所在的地域,您必须先删除已有目录,然后在其他地域创建新的目录。

流控信息

请求速率为5/1(s)。

授权信息

如下是此API对应的授权信息,用于RAM权限策略语句的Action元素中,为RAM用户或RAM角色授予调用此API的权限。请通过 RAM 访问控制设置,使用方法可参考访问控制帮助文档

具体说明如下:展开详情

操作访问级别资源类型条件关键字关联操作
cloudsso:CreateDirectory
Create
Directory
acs:cloudsso:{#regionId}:{#accountId}:directory/*
ram:CreateServiceLinkedRole

请求参数

字段名称字段详情
DirectoryNamestring

目录名称。该参数必须全局唯一。展开详情

示例值:example参考取值来源:
    GetDirectory
    UpdateDirectory

返回参数

字段名称字段详情
RequestIdstring

请求 ID。

示例值:ADADC31D-90EE-5459-99B0-D83DF07769A3
Directoryobject

目录信息。

返回示例

变更历史

变更时间变更内容概要操作
2021-06-21
新增OpenAPI,创建目录

相关示例

开通云SSO、创建目录并配置MFA登录
2022-07-12