Oracle Unified Directory SCIM REST API

グループの作成

post

/iam/directory/oud/scim/v1/Groups

ディレクトリ内にグループを作成するために使用します。レスポンスには、グループに関する詳細が含まれます。

リクエスト

サポートされているメディア・タイプ

application/scim+json

作成する必要があるユーザー

ルート・スキーマ: POSTANDPUTRequestForGROUP

型: object

ソースを表示

schemas(必須): array schemas

スキーマ・タイプに含めるスキーマ。
urn:ietf:params:scim:schemas:core:2.0:Group(required): object Core Group Properties
urn:ietf:params:scim:schemas:extension:oracle:2.0:OUD:Group: object Oracle specific Group Properties

{
    "type":"object",
    "required":[
        "schemas",
        "urn:ietf:params:scim:schemas:core:2.0:Group"
    ],
    "properties":{
        "schemas":{
            "description":"The Schemas to be included for the schema type.",
            "type":"array",
            "items":{
                "type":"object",
                "enum":[
                    "urn:ietf:params:scim:schemas:core:2.0:Group",
                    "urn:ietf:params:scim:schemas:extension:oracle:2.0:OUD:Group"
                ]
            }
        },
        "urn:ietf:params:scim:schemas:core:2.0:Group":{
            "$ref":"#/definitions/Core Group Properties"
        },
        "urn:ietf:params:scim:schemas:extension:oracle:2.0:OUD:Group":{
            "$ref":"#/definitions/Oracle specific Group Properties"
        }
    }
}

ネストされたスキーマ: schemas

型: array

スキーマ・タイプに含めるスキーマ。

ソースを表示

配列: オブジェクト items

{
    "description":"The Schemas to be included for the schema type.",
    "type":"array",
    "items":{
        "type":"object",
        "enum":[
            "urn:ietf:params:scim:schemas:core:2.0:Group",
            "urn:ietf:params:scim:schemas:extension:oracle:2.0:OUD:Group"
        ]
    }
}

ネストされたスキーマ: Core Group Properties

型: object

ソースを表示

displayName(required): string

グループの表示名。
members(required): array members

グループに属するメンバー。

{
    "type":"object",
    "required":[
        "members",
        "displayName"
    ],
    "properties":{
        "members":{
            "type":"array",
            "description":"Members belonging to the Group.",
            "items":{
                "type":"string"
            }
        },
        "displayName":{
            "type":"string",
            "description":"Display name for the group."
        }
    }
}

ネストされたスキーマ: Oracle specific Group Properties

型: object

ソースを表示

businessCategory: array businessCategory

グループのビジネス・カテゴリ。
description: array description

グループの説明。
o: array o

グループが属する組織。
objectClass: array objectClass

グループに必要なオブジェクト・クラス。
ou: array ou

グループが属する組織単位。
owner: array owner

グループの所有者

{
    "type":"object",
    "properties":{
        "objectClass":{
            "type":"array",
            "description":"Objectclass(es) required for the Group.",
            "items":{
                "type":"string"
            }
        },
        "description":{
            "type":"array",
            "description":"Description of the Group.",
            "items":{
                "type":"string"
            }
        },
        "owner":{
            "type":"array",
            "description":"Owner of the group.",
            "items":{
                "type":"string"
            }
        },
        "ou":{
            "type":"array",
            "description":"Organizational Unit the Group is a part of.",
            "items":{
                "type":"string"
            }
        },
        "businessCategory":{
            "type":"array",
            "description":"Buisness Category of the Group.",
            "items":{
                "type":"string"
            }
        },
        "o":{
            "type":"array",
            "description":"Organiation the group is a part of.",
            "items":{
                "type":"string"
            }
        }
    }
}

ネストされたスキーマ: items

型: object

指定可能な値: [ "urn:ietf:params:scim:schemas:core:2.0:Group", "urn:ietf:params:scim:schemas:extension:oracle:2.0:OUD:Group" ]

ネストされたスキーマ: members

型: array

グループに属するメンバー。

ソースを表示

配列: 文字列

{
    "type":"array",
    "description":"Members belonging to the Group.",
    "items":{
        "type":"string"
    }
}

ネストされたスキーマ: businessCategory

型: array

グループのビジネス・カテゴリ。

ソースを表示

配列: 文字列

{
    "type":"array",
    "description":"Buisness Category of the Group.",
    "items":{
        "type":"string"
    }
}

ネストされたスキーマ: description

型: array

グループの説明。

ソースを表示

配列: 文字列

{
    "type":"array",
    "description":"Description of the Group.",
    "items":{
        "type":"string"
    }
}

ネストされたスキーマ: o

型: array

グループが属する組織。

ソースを表示

配列: 文字列

{
    "type":"array",
    "description":"Organiation the group is a part of.",
    "items":{
        "type":"string"
    }
}

ネストされたスキーマ: objectClass

型: array

グループに必要なオブジェクト・クラス。

ソースを表示

配列: 文字列

{
    "type":"array",
    "description":"Objectclass(es) required for the Group.",
    "items":{
        "type":"string"
    }
}

ネストされたスキーマ: ou

型: array

グループが属する組織単位。

ソースを表示

配列: 文字列

{
    "type":"array",
    "description":"Organizational Unit the Group is a part of.",
    "items":{
        "type":"string"
    }
}

ネストされたスキーマ: owner

型: array

グループの所有者

ソースを表示

配列: 文字列

{
    "type":"array",
    "description":"Owner of the group.",
    "items":{
        "type":"string"
    }
}

先頭に戻る

レスポンス

サポートされているメディア・タイプ

application/scim+json

201レスポンス

Created

ルート・スキーマ: GroupSuccessResponse

型: object

ソースを表示

Resources(required): array Resources

LDAP操作後に返される検索結果エントリの数。
schemas(required): string

デフォルト値: urn:ietf:params:scim:api:messages:2.0:ListResponse

RESTメッセージ・スキーマ
totalResults(required): integer(int32)

作成され、返されるエントリの数を指定します。

{
    "type":"object",
    "required":[
        "schemas",
        "totalResults",
        "Resources"
    ],
    "properties":{
        "schemas":{
            "description":"The REST message schema",
            "type":"string",
            "default":"urn:ietf:params:scim:api:messages:2.0:ListResponse"
        },
        "totalResults":{
            "type":"integer",
            "format":"int32",
            "description":"Specifies the number of entries created, and returned."
        },
        "Resources":{
            "type":"array",
            "description":"Number of search result entries returned after the LDAP operation.",
            "items":{
                "$ref":"#/definitions/GroupSearchResultEntry"
            }
        }
    }
}

ネストされたスキーマ: Resources

型: array

LDAP操作後に返される検索結果エントリの数。

ソースを表示

配列: オブジェクト GroupSearchResultEntry

{
    "type":"array",
    "description":"Number of search result entries returned after the LDAP operation.",
    "items":{
        "$ref":"#/definitions/GroupSearchResultEntry"
    }
}

ネストされたスキーマ: GroupSearchResultEntry

型: object

ソースを表示

schemas(required): string

指定可能な値: [ "urn:ietf:params:scim:schemas:core:2.0:Group", "urn:ietf:params:scim:schemas:extension:oracle:2.0:OUD:Group" ]

スキーマ・タイプに含めるスキーマ。
urn:ietf:params:scim:schemas:core:2.0:Group: object Core Group Properties
urn:ietf:params:scim:schemas:extension:oracle:2.0:OUD:Group: object Oracle specific Group Properties

{
    "type":"object",
    "required":[
        "schemas"
    ],
    "properties":{
        "schemas":{
            "description":"The Schemas to be included for the schema type.",
            "type":"string",
            "enum":[
                "urn:ietf:params:scim:schemas:core:2.0:Group",
                "urn:ietf:params:scim:schemas:extension:oracle:2.0:OUD:Group"
            ]
        },
        "urn:ietf:params:scim:schemas:core:2.0:Group":{
            "$ref":"#/definitions/Core Group Properties"
        },
        "urn:ietf:params:scim:schemas:extension:oracle:2.0:OUD:Group":{
            "$ref":"#/definitions/Oracle specific Group Properties"
        }
    }
}

ネストされたスキーマ: Core Group Properties

型: object

ソースを表示

displayName(required): string

グループの表示名。
members(required): array members

グループに属するメンバー。

{
    "type":"object",
    "required":[
        "members",
        "displayName"
    ],
    "properties":{
        "members":{
            "type":"array",
            "description":"Members belonging to the Group.",
            "items":{
                "type":"string"
            }
        },
        "displayName":{
            "type":"string",
            "description":"Display name for the group."
        }
    }
}

ネストされたスキーマ: Oracle specific Group Properties

型: object

ソースを表示

businessCategory: array businessCategory

グループのビジネス・カテゴリ。
description: array description

グループの説明。
o: array o

グループが属する組織。
objectClass: array objectClass

グループに必要なオブジェクト・クラス。
ou: array ou

グループが属する組織単位。
owner: array owner

グループの所有者

{
    "type":"object",
    "properties":{
        "objectClass":{
            "type":"array",
            "description":"Objectclass(es) required for the Group.",
            "items":{
                "type":"string"
            }
        },
        "description":{
            "type":"array",
            "description":"Description of the Group.",
            "items":{
                "type":"string"
            }
        },
        "owner":{
            "type":"array",
            "description":"Owner of the group.",
            "items":{
                "type":"string"
            }
        },
        "ou":{
            "type":"array",
            "description":"Organizational Unit the Group is a part of.",
            "items":{
                "type":"string"
            }
        },
        "businessCategory":{
            "type":"array",
            "description":"Buisness Category of the Group.",
            "items":{
                "type":"string"
            }
        },
        "o":{
            "type":"array",
            "description":"Organiation the group is a part of.",
            "items":{
                "type":"string"
            }
        }
    }
}

ネストされたスキーマ: members

型: array

グループに属するメンバー。

ソースを表示

配列: 文字列

{
    "type":"array",
    "description":"Members belonging to the Group.",
    "items":{
        "type":"string"
    }
}

ネストされたスキーマ: businessCategory

型: array

グループのビジネス・カテゴリ。

ソースを表示

配列: 文字列

{
    "type":"array",
    "description":"Buisness Category of the Group.",
    "items":{
        "type":"string"
    }
}

ネストされたスキーマ: description

型: array

グループの説明。

ソースを表示

配列: 文字列

{
    "type":"array",
    "description":"Description of the Group.",
    "items":{
        "type":"string"
    }
}

ネストされたスキーマ: o

型: array

グループが属する組織。

ソースを表示

配列: 文字列

{
    "type":"array",
    "description":"Organiation the group is a part of.",
    "items":{
        "type":"string"
    }
}

ネストされたスキーマ: objectClass

型: array

グループに必要なオブジェクト・クラス。

ソースを表示

配列: 文字列

{
    "type":"array",
    "description":"Objectclass(es) required for the Group.",
    "items":{
        "type":"string"
    }
}

ネストされたスキーマ: ou

型: array

グループが属する組織単位。

ソースを表示

配列: 文字列

{
    "type":"array",
    "description":"Organizational Unit the Group is a part of.",
    "items":{
        "type":"string"
    }
}

ネストされたスキーマ: owner

型: array

グループの所有者

ソースを表示

配列: 文字列

{
    "type":"array",
    "description":"Owner of the group.",
    "items":{
        "type":"string"
    }
}

400レスポンス

Bad Request

ルート・スキーマ: ErrorResponse

型: object

ソースを表示

detail(required): string

操作に対して返されるエラー・メッセージ。
schemas(required): string

デフォルト値: urn:ietf:params:scim:api:messages:2.0:Error

RESTメッセージ・タイプ
status(required): integer(int32)

操作に対して返されるHTTPステータス・エラー・コードを指定します。

{
    "type":"object",
    "required":[
        "schemas",
        "detail",
        "status"
    ],
    "properties":{
        "schemas":{
            "description":"The REST message type",
            "default":"urn:ietf:params:scim:api:messages:2.0:Error",
            "type":"string"
        },
        "detail":{
            "description":"Error message returned returned for the operation.",
            "type":"string"
        },
        "status":{
            "type":"integer",
            "format":"int32",
            "description":"Specifies the HTTP status error code returned for the operation."
        }
    }
}

406レスポンス

Not Acceptable

ルート・スキーマ: ErrorResponse

型: object

ソースを表示

detail(required): string

操作に対して返されるエラー・メッセージ。
schemas(required): string

デフォルト値: urn:ietf:params:scim:api:messages:2.0:Error

RESTメッセージ・タイプ
status(required): integer(int32)

操作に対して返されるHTTPステータス・エラー・コードを指定します。

{
    "type":"object",
    "required":[
        "schemas",
        "detail",
        "status"
    ],
    "properties":{
        "schemas":{
            "description":"The REST message type",
            "default":"urn:ietf:params:scim:api:messages:2.0:Error",
            "type":"string"
        },
        "detail":{
            "description":"Error message returned returned for the operation.",
            "type":"string"
        },
        "status":{
            "type":"integer",
            "format":"int32",
            "description":"Specifies the HTTP status error code returned for the operation."
        }
    }
}

409レスポンス

Conflict

ルート・スキーマ: ErrorResponse

型: object

ソースを表示

detail(required): string

操作に対して返されるエラー・メッセージ。
schemas(required): string

デフォルト値: urn:ietf:params:scim:api:messages:2.0:Error

RESTメッセージ・タイプ
status(required): integer(int32)

操作に対して返されるHTTPステータス・エラー・コードを指定します。

{
    "type":"object",
    "required":[
        "schemas",
        "detail",
        "status"
    ],
    "properties":{
        "schemas":{
            "description":"The REST message type",
            "default":"urn:ietf:params:scim:api:messages:2.0:Error",
            "type":"string"
        },
        "detail":{
            "description":"Error message returned returned for the operation.",
            "type":"string"
        },
        "status":{
            "type":"integer",
            "format":"int32",
            "description":"Specifies the HTTP status error code returned for the operation."
        }
    }
}

先頭に戻る