移動

• リクエスト
• レスポンス

ユーザー・グループの作成

post

http://{host}:{port}/veridata/v1/services/admin/usergroups

必要なロール: Administrator、SuperUser、CommandLineOperator

ユーザー・グループの作成

リクエスト

この操作にはリクエスト・パラメータはありません。

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

• application/json

リクエスト本文 - application/json ()

ルート・スキーマ: schema

タイプ: object

ソースの表示

• accessIds: array accessIds
  ユーザー・グループにマップされるアクセスIDの配列。
• description: string
• name(必須): string

{
    "type":"object",
    "properties":{
        "name":{
            "type":"string"
        },
        "description":{
            "type":"string"
        },
        "accessIds":{
            "type":"array",
            "description":"Array of access ids to be mapped to User Group.",
            "items":{
                "type":"integer",
                "description":"access Ids.",
                "format":"int64"
            }
        }
    },
    "example":{
        "name":"AdminGroup",
        "description":"admin",
        "accessIds":[
            0
        ]
    },
    "required":[
        "name"
    ]
}

例:

{
    "name":"AdminGroup",
    "description":"admin",
    "accessIds":[
        0
    ]
}

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

タイプ: array

ユーザー・グループにマップされるアクセスIDの配列。

ソースの表示

• 配列: integer(int64)
  アクセスID。

{
    "type":"array",
    "description":"Array of access ids to be mapped to User Group.",
    "items":{
        "type":"integer",
        "description":"access Ids.",
        "format":"int64"
    }
}

先頭に戻る

レスポンス

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

• application/json

201 レスポンス

ユーザー・グループが正常に作成されました

本文()

ルート・スキーマ: UserGroupPostResponse

タイプ: object

ソースの表示

• createdOn: string (date-time)
  パターン: YYYY-MM-DDTHH:mm:ss.sssZ

  例: 2024-02-03T10:15:30Z
• description: string
• id: integer
• isModifiable: string
• name: string

{
    "type":"object",
    "properties":{
        "id":{
            "type":"integer"
        },
        "name":{
            "type":"string"
        },
        "description":{
            "type":"string"
        },
        "isModifiable":{
            "type":"string"
        },
        "createdOn":{
            "type":"string",
            "format":"date-time",
            "pattern":"YYYY-MM-DDTHH:mm:ss.sssZ",
            "example":"2024-02-03T10:15:30Z"
        }
    },
    "example":{
        "id":1001,
        "name":"UserGroup1",
        "description":"group1",
        "isModifiable":"true",
        "createdOn":"2024-02-03T10:15:30Z"
    }
}

例:

{
    "id":1001,
    "name":"UserGroup1",
    "description":"group1",
    "isModifiable":"true",
    "createdOn":"2024-02-03T10:15:30Z"
}

400 レスポンス

不正なリクエスト。

本文()

ルート・スキーマ: Error

タイプ: object

ソースの表示

• errCode: string
  Veridataのエラー・コード。
• errMsg: string
  Veridataのエラー・メッセージ。

{
    "type":"object",
    "properties":{
        "errCode":{
            "type":"string",
            "description":"Veridata Error Code."
        },
        "errMsg":{
            "type":"string",
            "description":"Veridata Error Message."
        }
    },
    "example":{
        "errCode":"OGGV-00001",
        "errMsg":"Error message"
    }
}

例:

{
    "errCode":"OGGV-00001",
    "errMsg":"Error message"
}

401 レスポンス

権限がありません。

本文()

ルート・スキーマ: Error

タイプ: object

ソースの表示

• errCode: string
  Veridataのエラー・コード。
• errMsg: string
  Veridataのエラー・メッセージ。

{
    "type":"object",
    "properties":{
        "errCode":{
            "type":"string",
            "description":"Veridata Error Code."
        },
        "errMsg":{
            "type":"string",
            "description":"Veridata Error Message."
        }
    },
    "example":{
        "errCode":"OGGV-00001",
        "errMsg":"Error message"
    }
}

例:

{
    "errCode":"OGGV-00001",
    "errMsg":"Error message"
}

404 レスポンス

見つかりません。

本文()

ルート・スキーマ: Error

タイプ: object

ソースの表示

• errCode: string
  Veridataのエラー・コード。
• errMsg: string
  Veridataのエラー・メッセージ。

{
    "type":"object",
    "properties":{
        "errCode":{
            "type":"string",
            "description":"Veridata Error Code."
        },
        "errMsg":{
            "type":"string",
            "description":"Veridata Error Message."
        }
    },
    "example":{
        "errCode":"OGGV-00001",
        "errMsg":"Error message"
    }
}

例:

{
    "errCode":"OGGV-00001",
    "errMsg":"Error message"
}

500 レスポンス

サーバー・エラー。

本文()

ルート・スキーマ: Error

タイプ: object

ソースの表示

• errCode: string
  Veridataのエラー・コード。
• errMsg: string
  Veridataのエラー・メッセージ。

{
    "type":"object",
    "properties":{
        "errCode":{
            "type":"string",
            "description":"Veridata Error Code."
        },
        "errMsg":{
            "type":"string",
            "description":"Veridata Error Message."
        }
    },
    "example":{
        "errCode":"OGGV-00001",
        "errMsg":"Error message"
    }
}

例:

{
    "errCode":"OGGV-00001",
    "errMsg":"Error message"
}

先頭に戻る