調用CreateDirectory建立目錄。
介面說明
使用說明
目錄是雲 SSO 中的執行個體。使用雲 SSO 前必須先建立一個目錄,所有雲 SSO 資源都必須在目錄中維護。
您需要選擇一個地區作為雲 SSO 目錄的所在地區。阿里雲確保所有雲 SSO 相關資料都只會儲存在該地區,但與您在何處部署 ECS、RDS 等雲資源無關,您在全球都可以登入並訪問任何地區的雲資源。您可以根據安全合規需求及目標使用者所在地理位置選擇適合您的地區。如果沒有特殊的安全合規需求,一般情況下建議您選擇與目標使用者所在地理位置最為接近的地區,這樣可以進一步提升使用者的訪問速度。目前,支援在華東 2(上海)、中國(香港)、美國(矽谷)和德國(法蘭克福)四個地區建立目錄。
本文將提供一個樣本,在華東 2(上海)地區建立名為example的目錄。
使用限制
一個管理帳號只能建立一個目錄。
如果您想修改目錄所在的地區,您必須先刪除已有目錄,然後在其他地區建立新的目錄。
調試
您可以在OpenAPI Explorer中直接運行該介面,免去您計算簽名的困擾。運行成功後,OpenAPI Explorer可以自動產生SDK程式碼範例。
調試
授權資訊
|
操作 |
存取層級 |
資源類型 |
條件關鍵字 |
關聯操作 |
|
cloudsso:CreateDirectory |
create |
*Directory
|
無 |
|
請求參數
|
名稱 |
類型 |
必填 |
描述 |
樣本值 |
| DirectoryName |
string |
否 |
目錄名稱。該參數必須全域唯一。 格式:包含小寫字母、數字或短劃線(-)。不能以短劃線(-)開頭或結尾,且不能有兩個連續的短劃線(-)。不能以 長度: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"
}
}
錯誤碼
訪問錯誤中心查看更多錯誤碼。
變更歷史
更多資訊,參考變更詳情。