パーミッション・セットの作成
post
/content/management/api/v1.1/repositories/{id}/permissionSets
指定されたペイロードを持つリポジトリの権限セットを作成します。
リクエスト
サポートされているメディア・タイプ
- application/json
パス・パラメータ
- id: string
権限セットのリポジトリIDパラメータ。
問合せパラメータ
- links(optional): string
このパラメータは、リンク名のカンマ区切りのリストを受け入れます。 デフォルトでは、このパラメータによって、適用可能なすべてのリンクが指定されます。 可能な値は次のとおりです: self, canonical, describedby
ヘッダー・パラメータ
- X-Requested-With: string
CSRF攻撃を軽減するためのカスタム・ヘッダー。許容値:
[ "XMLHttpRequest" ]
ペイロードに指定された情報で権限セットを作成します。 ペイロード内に指定されている場合でも、idおよびlinksフィールドは無視されます。
ルート・スキーマ : PermissionSet
型:
objectPermissionSet
ソースを表示
- contentPrivileges(optional): array contentPrivileges
コンテンツ・タイプの権限。
- id(optional): string
権限セットのID。
- links(optional): array links
リンク
- principal(optional): object Principal
プリンシパル
- taxonomyPrivileges(optional): array taxonomyPrivileges
タクソノミの権限。
ネストされたスキーマ : contentPrivileges
型:
arrayコンテンツ・タイプの権限。
ソースを表示
- Array of: object ContentPrivilege
ContentPrivilege
ネストされたスキーマ : プリンシパル
型:
objectプリンシパル
ソースを表示
- name(optional): string
- scope(optional): string
許容値:
[ "CEC", "IDP" ] - type(optional): string
許容値:
[ "user", "group" ]
ネストされたスキーマ : taxonomyPrivileges
型:
arrayタクソノミの権限。
ソースを表示
- Array of: object TaxonomyPrivilege
TaxonomyPrivilege
ネストされたスキーマ : ContentPrivilege
型:
objectContentPrivilege
ソースを表示
- isEnabled(optional): boolean
リポジトリのコンテキストで権限が有効かどうか。
- isValid(optional): boolean
特権の有効性。
- operations(optional): array operations
Operations
- typeDisplayName(optional): string
コンテンツ・タイプの表示名。
- typeId(optional): string
コンテンツ・タイプのID。
- typeName(optional): string
コンテンツ・タイプの名前。
ネストされたスキーマ: operations
型:
arrayOperations
ソースを表示
- Array of: string
許容値:
[ "view", "update", "create", "delete" ]
ネストされたスキーマ: Link
型:
objectリソースのリンク。
ソースを表示
- href(optional): string
ターゲット・リソースのURI それはテンプレートURIである可能性があります。 これはレスポンス取得の必須プロパティです。
- mediaType(optional): string
メディア・タイプ。
- method(optional): string
ターゲット・リソースへのアクセスに使用できるHTTPメソッド。
- profile(optional): string
ターゲット・リソースを記述するメタデータにリンクします。
- rel(optional): string
関連タイプ これはレスポンス取得の必須プロパティです。
- templated(optional): boolean
URIがテンプレートであるかどうか。
ネストされたスキーマ : TaxonomyPrivilege
型:
objectTaxonomyPrivilege
ソースを表示
- categoryId(optional): string
カテゴリのid。
- isEnabled(optional): boolean
リポジトリのコンテキストで権限が有効かどうか。
- isForSiteManagement(optional): boolean
タクソノミがサイト管理用かどうか。
- isSiteCategory(optional): boolean
カテゴリがサイト・カテゴリかどうか。
- isValid(optional): boolean
特権の有効性。
- nodes(optional): array nodes
カテゴリのパス。
- operations(optional): array operations
Operations
- taxonomyId(optional): string
タクソノミのId。
- taxonomyShortName(optional): string
タクソノミの短縮名。
ネストされたスキーマ: operations
型:
arrayOperations
ソースを表示
- Array of: string
許容値:
[ "view", "categorize", "createsite" ]
ネストされたスキーマ : CategoryNodeBean
型:
ソースを表示
object- apiName(optional): string
カテゴリ・ノードのapiName。
- id(optional): string
カテゴリ・ノードのid。
- name(optional): string
カテゴリ・ノードの名前。
レスポンス
サポートされているメディア・タイプ
- application/json
201レスポンス
作成されました。
ルート・スキーマ : PermissionSet
型:
objectPermissionSet
ソースを表示
- contentPrivileges(optional): array contentPrivileges
コンテンツ・タイプの権限。
- id(optional): string
権限セットのID。
- links(optional): array links
リンク
- principal(optional): object Principal
プリンシパル
- taxonomyPrivileges(optional): array taxonomyPrivileges
タクソノミの権限。
ネストされたスキーマ : contentPrivileges
型:
arrayコンテンツ・タイプの権限。
ソースを表示
- Array of: object ContentPrivilege
ContentPrivilege
ネストされたスキーマ : プリンシパル
型:
objectプリンシパル
ソースを表示
- name(optional): string
- scope(optional): string
許容値:
[ "CEC", "IDP" ] - type(optional): string
許容値:
[ "user", "group" ]
ネストされたスキーマ : taxonomyPrivileges
型:
arrayタクソノミの権限。
ソースを表示
- Array of: object TaxonomyPrivilege
TaxonomyPrivilege
ネストされたスキーマ : ContentPrivilege
型:
objectContentPrivilege
ソースを表示
- isEnabled(optional): boolean
リポジトリのコンテキストで権限が有効かどうか。
- isValid(optional): boolean
特権の有効性。
- operations(optional): array operations
Operations
- typeDisplayName(optional): string
コンテンツ・タイプの表示名。
- typeId(optional): string
コンテンツ・タイプのID。
- typeName(optional): string
コンテンツ・タイプの名前。
ネストされたスキーマ: operations
型:
arrayOperations
ソースを表示
- Array of: string
許容値:
[ "view", "update", "create", "delete" ]
ネストされたスキーマ: Link
型:
objectリソースのリンク。
ソースを表示
- href(optional): string
ターゲット・リソースのURI それはテンプレートURIである可能性があります。 これはレスポンス取得の必須プロパティです。
- mediaType(optional): string
メディア・タイプ。
- method(optional): string
ターゲット・リソースへのアクセスに使用できるHTTPメソッド。
- profile(optional): string
ターゲット・リソースを記述するメタデータにリンクします。
- rel(optional): string
関連タイプ これはレスポンス取得の必須プロパティです。
- templated(optional): boolean
URIがテンプレートであるかどうか。
ネストされたスキーマ : TaxonomyPrivilege
型:
objectTaxonomyPrivilege
ソースを表示
- categoryId(optional): string
カテゴリのid。
- isEnabled(optional): boolean
リポジトリのコンテキストで権限が有効かどうか。
- isForSiteManagement(optional): boolean
タクソノミがサイト管理用かどうか。
- isSiteCategory(optional): boolean
カテゴリがサイト・カテゴリかどうか。
- isValid(optional): boolean
特権の有効性。
- nodes(optional): array nodes
カテゴリのパス。
- operations(optional): array operations
Operations
- taxonomyId(optional): string
タクソノミのId。
- taxonomyShortName(optional): string
タクソノミの短縮名。
ネストされたスキーマ: operations
型:
arrayOperations
ソースを表示
- Array of: string
許容値:
[ "view", "categorize", "createsite" ]
ネストされたスキーマ : CategoryNodeBean
型:
ソースを表示
object- apiName(optional): string
カテゴリ・ノードのapiName。
- id(optional): string
カテゴリ・ノードのid。
- name(optional): string
カテゴリ・ノードの名前。
400レスポンス
不正リクエスト
403レスポンス
禁止。
404レスポンス
見つかりません。
500レスポンス
内部サーバー・エラー
例
次の例は、リポジトリに対する権限セットの作成方法を示しています。
curl -X POST -H 'Content-Type: application/json' -H 'X-Requested-With: XMLHttpRequest' 'https://host:port/content/management/api/v1.1/repositories/{id}/permissionSets'
例1
/content/management/api/v1.1/repositories/0A84F4683E51409C84C0D4AF0C23F4CF/permissionSets
これにより、IDが0A84F4683E51409C84C0D4AF0C23F4CFのリポジトリ上にユーザーの権限セットが作成されます。 ペイロードを独自のデータで置換します。
ノート:
どのタイプ・ルールも空のtypeIdで定義され、任意のカテゴリ・ルールは空のcategoryIdによって定義されます。リクエスト・ペイロード
{
"principal": {
"name": "cecusername",
"type": "user"
},
"contentPrivileges": [
{
"typeId": "",
"typeName": "",
"operations": [
"view"
]
},
{
"typeId": "49B267B515C84AD7903C5B9C34EDB09E",
"typeName": "TypeAAA",
"operations": [
"view",
"update",
"create",
"delete"
]
},
{
"typeId": "8CB7D974CBB74923BF40A6CA68BED145",
"typeName": "TypeBBB",
"operations": []
}
],
"taxonomyPrivileges": [
{
"taxonomyId": "",
"categoryId": "",
"operations": [
"view"
]
}
]
}
レスポンス本文
{
"id": "514E1A01602042FB992C74BB999F47A9",
"principal": {
"name": "cecusername",
"type": "user"
},
"contentPrivileges": [
{
"typeId": "",
"typeName": null,
"isValid": true,
"operations": [
"view"
]
},
{
"typeId": "49B267B515C84AD7903C5B9C34EDB09E",
"typeName": "TypeAAA",
"isValid": true,
"operations": [
"view",
"update",
"create",
"delete"
]
},
{
"typeId": "8CB7D974CBB74923BF40A6CA68BED145",
"typeName": "TypeBBB",
"isValid": true,
"operations": []
}
],
"taxonomyPrivileges": [
{
"taxonomyId": null,
"taxonomyShortName": null,
"isForSiteManagement": false,
"categoryId": "",
"nodes": null,
"isSiteCategory": false,
"isValid": true,
"operations": [
"view"
]
}
],
"links": [
{
"href": "http://<hostname>/content/management/api/v1.1/repositories/0A84F4683E51409C84C0D4AF0C23F4CF/permissionSets",
"rel": "self",
"method": "POST",
"mediaType": "application/json"
},
{
"href": "http://<hostname>/content/management/api/v1.1/repositories/0A84F4683E51409C84C0D4AF0C23F4CF/permissionSets",
"rel": "canonical",
"method": "POST",
"mediaType": "application/json"
},
{
"href": "http://<hostname>/content/management/api/v1.1/metadata-catalog/repositories/0A84F4683E51409C84C0D4AF0C23F4CF/permissionSets",
"rel": "describedby",
"method": "GET",
"mediaType": "application/schema+json"
}
]
}
例2
/content/management/api/v1.1/repositories/0A84F4683E51409C84C0D4AF0C23F4CF/permissionSets
これにより、IDが0A84F4683E51409C84C0D4AF0C23F4CFのリポジトリ上にグループを含む権限セットが作成されます。 ペイロードを独自のデータで置換します。
ノート:
どのタイプ・ルールも空のtypeIdで定義され、任意のカテゴリ・ルールは空のcategoryIdによって定義されます。リクエスト・ペイロード
{
"principal": {
"name": "cecgroupname",
"type": "group",
"scope": "CEC"
},
"contentPrivileges": [
{
"typeId": "",
"typeName": "",
"operations": [
"view"
]
},
{
"typeId": "EF4C64E6BF81419F9743A8A4348A69EB",
"typeName": "Image",
"operations": [
"view",
"update",
"create",
"delete"
]
}
],
"taxonomyPrivileges": [
{
"taxonomyId": "",
"categoryId": "",
"operations": []
},
{
"taxonomyId": "691B31CFB0F14381ACDF9E0CE0B63CD1",
"categoryId": "CEFC8C6C2AA245AB9F719FBE9C45D88A",
"operations": [
"view"
]
},
{
"taxonomyId": "691B31CFB0F14381ACDF9E0CE0B63CD1",
"categoryId": "0EAC9A777E73415AA4BC3CDB61FBD59C",
"operations": [
"view",
"categorize"
]
}
]
}
レスポンス本文
{
"id": "3C1B236C10C54C80AA2ADDACCAFB1B4A",
"principal": {
"name": "cecgroupname",
"type": "group",
"scope": "CEC"
},
"contentPrivileges": [
{
"typeId": "",
"typeName": null,
"isValid": true,
"operations": [
"view"
]
},
{
"typeId": "EF4C64E6BF81419F9743A8A4348A69EB",
"typeName": "Image",
"isValid": true,
"operations": [
"view",
"update",
"create",
"delete"
]
}
],
"taxonomyPrivileges": [
{
"taxonomyId": null,
"taxonomyShortName": null,
"isForSiteManagement": false,
"categoryId": "",
"nodes": null,
"isSiteCategory": false,
"isValid": true,
"operations": []
},
{
"taxonomyId": "691B31CFB0F14381ACDF9E0CE0B63CD1",
"taxonomyShortName": "TXM",
"isForSiteManagement": false,
"categoryId": "CEFC8C6C2AA245AB9F719FBE9C45D88A",
"nodes": [
{
"id": "CEFC8C6C2AA245AB9F719FBE9C45D88A",
"name": "Cat1",
"apiName": "txm-c"
}
],
"isSiteCategory": false,
"isValid": true,
"operations": [
"view"
]
},
{
"taxonomyId": "691B31CFB0F14381ACDF9E0CE0B63CD1",
"taxonomyShortName": "TXM",
"isForSiteManagement": false,
"categoryId": "0EAC9A777E73415AA4BC3CDB61FBD59C",
"nodes": [
{
"id": "0EAC9A777E73415AA4BC3CDB61FBD59C",
"name": "Cat2",
"apiName": "txm-c1"
}
],
"isSiteCategory": false,
"isValid": true,
"operations": [
"view",
"categorize"
]
}
],
"links": [
{
"href": "http://<hostname>/content/management/api/v1.1/repositories/0A84F4683E51409C84C0D4AF0C23F4CF/permissionSets",
"rel": "self",
"method": "POST",
"mediaType": "application/json"
},
{
"href": "http://<hostname>/content/management/api/v1.1/repositories/0A84F4683E51409C84C0D4AF0C23F4CF/permissionSets",
"rel": "canonical",
"method": "POST",
"mediaType": "application/json"
},
{
"href": "http://<hostname>/content/management/api/v1.1/metadata-catalog/repositories/0A84F4683E51409C84C0D4AF0C23F4CF/permissionSets",
"rel": "describedby",
"method": "GET",
"mediaType": "application/schema+json"
}
]
}
例3
/content/management/api/v1.1/repositories/50109217E930462096BC76722F0AD739/permissionSets
これにより、IDが50109217E930462096BC76722F0AD739のリポジトリにユーザーの権限セットが作成され、これにはcreateSite権限を持つタクソノミ・ルールが含まれます。 ペイロードを独自のデータで置換します。
ノート:
任意のタイプ・ルールは空のtypeIdで定義され、任意のカテゴリ・ルールは空のcategoryIdで定義されます。
リクエスト・ペイロード
{
"principal": {
"name": "cecuser2",
"type": "user"
},
"contentPrivileges": [
{
"typeId": "",
"typeName": "",
"isValid": true,
"operations": [
"view",
"update",
"create",
"delete"
]
}
],
"taxonomyPrivileges": [
{
"taxonomyId": "",
"categoryId": "",
"isValid": true,
"operations": [
"view",
"categorize"
]
},
{
"taxonomyId": "AF6B75DBBCA244FC93166610EA2BA62A",
"categoryId": "F54C934D081B4768B3A93A45C0E6955C",
"isValid": true,
"operations": [
"view",
"categorize",
"createSite"
]
}
]
}
リクエスト・ヘッダー
{
"Content-Type": "application/json",
"X-Requested-With": "XMLHttpRequest"
}
レスポンス本文
{
"id": "68CE607F31614F2B84C542D87518F4D3",
"principal": {
"name": "cecuser2",
"type": "user"
},
"contentPrivileges": [
{
"typeId": "",
"typeName": null,
"typeDisplayName": null,
"isValid": true,
"operations": [
"view",
"update",
"create",
"delete"
]
}
],
"taxonomyPrivileges": [
{
"taxonomyId": null,
"taxonomyShortName": null,
"isForSiteManagement": false,
"categoryId": "",
"nodes": null,
"isSiteCategory": false,
"isValid": true,
"operations": [
"view",
"categorize"
]
},
{
"taxonomyId": "AF6B75DBBCA244FC93166610EA2BA62A",
"taxonomyShortName": "SST",
"isForSiteManagement": true,
"categoryId": "F54C934D081B4768B3A93A45C0E6955C",
"nodes": [
{
"id": "BE58B209A968480480AA2AFBCE9C2D64",
"name": "org1",
"apiName": "sst-o"
},
{
"id": "F54C934D081B4768B3A93A45C0E6955C",
"name": "team1",
"apiName": "sst-o-d"
}
],
"isSiteCategory": false,
"isValid": true,
"operations": [
"view",
"categorize",
"createSite"
]
}
],
"links": [
{
"href": "http://<hostname>/content/management/api/v1.1/repositories/50109217E930462096BC76722F0AD739/permissionSets",
"rel": "self",
"method": "POST",
"mediaType": "application/json"
},
{
"href": "http://<hostname>/content/management/api/v1.1/repositories/50109217E930462096BC76722F0AD739/permissionSets",
"rel": "canonical",
"method": "POST",
"mediaType": "application/json"
},
{
"href": "http://<hostname>/content/management/api/v1.1/metadata-catalog/repositories/50109217E930462096BC76722F0AD739/permissionSets",
"rel": "describedby",
"method": "GET",
"mediaType": "application/json"
}
]
}