CreateDirectory - 创建目录 - 云SSO

接口说明

使用说明

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

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

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

使用限制

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

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

调试

授权信息

下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：

操作：是指具体的权限点。
访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
资源类型：是指操作中支持授权的资源类型。具体说明如下：
- 对于必选的资源类型，用前面加 * 表示。
- 对于不支持资源级授权的操作，用全部资源表示。
条件关键字：是指云产品自身定义的条件关键字。
关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。

操作

访问级别

资源类型

条件关键字

关联操作

cloudsso:CreateDirectory

create

*Directory

acs:cloudsso:{#regionId}:{#accountId}:directory/*

无

ram:CreateServiceLinkedRole

请求参数

名称	类型	必填	描述	示例值
DirectoryName	string	否	目录名称。该参数必须全局唯一。格式：包含小写字母、数字或短划线（-）。不能以短划线（-）开头或结尾，且不能有两个连续的短划线（-）。不能以`d-`开头。长度：2~64 个字符。说明如果不指定，则由系统自动生成。	example

返回参数

名称	类型	描述	示例值
	object	返回结果。
RequestId	string	请求 ID。	ADADC31D-90EE-5459-99B0-D83DF07769A3
Directory	object	目录信息。
DirectoryId	string	目录 ID。	d-00fc2p61****
CreateTime	string	目录创建时间（UTC 时间）。	2021-10-10T04:04:04Z
UpdateTime	string	目录修改时间（UTC 时间）。	2021-10-10T04:04:04Z
Region	string	目录所在的地域 ID。	cn-shanghai
DirectoryName	string	目录名称。	example

示例

正常返回示例

JSON格式

{
  "RequestId": "ADADC31D-90EE-5459-99B0-D83DF07769A3",
  "Directory": {
    "DirectoryId": "d-00fc2p61****",
    "CreateTime": "2021-10-10T04:04:04Z",
    "UpdateTime": "2021-10-10T04:04:04Z",
    "Region": "cn-shanghai",
    "DirectoryName": "example"
  }
}

错误码

访问错误中心查看更多错误码。

变更历史

更多信息，参考变更详情。