タイプの更新
put
/content/management/api/v1.1/types/{name}
指定されたペイロードでタイプを更新します。
タイプupdateでタイプのフィールドが削除されるか、マスターから継承としてフラグが設定されると、そのタイプのすべてのアイテムが更新され、削除されたフィールドおよび削除されたフィールドのアイテム・データがアーカイブされます。
また、フィールドの削除中またはマスター・フィールドからの継承へのフラグ付け中は、タイプの更新中にタイプのアイテムの公開、コピー、インポートは許可されません。 タイプのアイテムの公開、インポートまたはコピーが進行中の場合、マスターからの継承の削除またはフラグ付けを行うフィールドによるタイプ更新はブロックされます。
プロパティ: タイプにアセットがある場合、DigitalAssetタイプのcaas-translations.file.inheritFromMasterは変更できません。
タイプupdateでタイプのフィールドが削除されるか、マスターから継承としてフラグが設定されると、そのタイプのすべてのアイテムが更新され、削除されたフィールドおよび削除されたフィールドのアイテム・データがアーカイブされます。
また、フィールドの削除中またはマスター・フィールドからの継承へのフラグ付け中は、タイプの更新中にタイプのアイテムの公開、コピー、インポートは許可されません。 タイプのアイテムの公開、インポートまたはコピーが進行中の場合、マスターからの継承の削除またはフラグ付けを行うフィールドによるタイプ更新はブロックされます。
プロパティ: タイプにアセットがある場合、DigitalAssetタイプのcaas-translations.file.inheritFromMasterは変更できません。
リクエスト
サポートされているメディア・タイプ
- application/json
パス・パラメータ
- name: string
型名識別子は大/小文字が区別され、特殊文字はエンコードする必要があります。
問合せパラメータ
- links(optional): string
このパラメータは、リンク名のカンマ区切りのリストを受け入れます。 デフォルトでは、このパラメータによって、適用可能なすべてのリンクが指定されます。 可能な値は次のとおりです: self, canonical, describedby
ヘッダー・パラメータ
- X-Requested-With: string
CSRF攻撃を軽減するためのカスタム・ヘッダー。許容値:
[ "XMLHttpRequest" ]
ペイロード内の指定の情報でタイプを更新します。 ペイロード内に指定されている場合でも、createdBy, createdDate, updatedBy, updatedDateおよびlinksフィールドは無視されます。
ルート・スキーマ : タイプ
型:
objectAggregatedType
ソースを表示
- allowedActions(optional): array allowedActions
タイプのallowedActions。
- allowedFileTypes(optional): array allowedFileTypes
タイプでサポートされているファイル拡張子の許可されたリスト。 これはレスポンス取得の必須プロパティです。 ポスト/プット・リクエストではオプションで、typeCategoryがContentTypeの場合は[ContentItem]にデフォルト設定され、typeCategoryがDigitalAssetTypeの場合は空にデフォルト設定されます。
- apiName(optional): string
タイプのAPI名。
- archivedFields(optional): object ItemSubResourceListTypeField
アイテムSubResource。
- connectorInfos(optional): array connectorInfos
タイプのconnectorInfos。
- createdBy(optional): string
作成方法
- createdDate(optional): object date
date
- description(optional): string
タイプの説明。
- displayName(optional): string
タイプの表示名。 これはgetレスポンスの必須プロパティですが、post/putリクエストでは必要ありません。
- fields(optional): array fields
タイプで使用されるフィールド。
- id(optional): string
型のId。 これはレスポンス取得と送信リクエストの必須プロパティであり、リクエストの転送には必要ありません。
- inplacePreview(optional): object ItemSubResourceListInplacePreview
アイテムSubResource。
- jobToken(optional): string
タイプを更新するバックグラウンド・ジョブのジョブ・トークン。
- layoutMapping(optional): object ItemSubResourceListLayoutMapping
アイテムSubResource。
- links(optional): array links
- name(optional): string
タイプの名前。 これは、レスポンスの取得とリクエストのポスト/送信の必須プロパティです。
- properties(optional): object properties
許可される追加のプロパティ: additionalProperties特定のプロパティを入力します。
- relationships(optional): object ItemSubResourceTypeRelationships
アイテムSubResource。
- requiredTaxonomies(optional): object ItemSubResourceListRequiredTaxonomy
アイテムSubResource。
- roleName(optional): string
コンテンツ・タイプのユーザー・ロールの名前。
- typeCategory(optional): string
タイプのカテゴリ。 使用可能な値は[ContentType, DigitalAssetType]です。 これはレスポンス取得の必須プロパティです。 ポスト・リクエストではオプションで、ContentTypeにデフォルト設定されます。 Putリクエストでもオプションで、URLのtypeNameパス・パラメータに基づいて識別されます。
- updatedBy(optional): string
更新者
- updatedDate(optional): object date
date
ネストされたスキーマ : allowedActions
型:
arrayタイプのallowedActions。
ソースを表示
- Array of: string
許容値:
[ "preview", "read", "write", "update", "delete" ]
ネストされたスキーマ : allowedFileTypes
型:
arrayタイプでサポートされているファイル拡張子の許可されたリスト。 これはレスポンス取得の必須プロパティです。 ポスト/プット・リクエストではオプションで、typeCategoryがContentTypeの場合は[ContentItem]にデフォルト設定され、typeCategoryがDigitalAssetTypeの場合は空にデフォルト設定されます。
ソースを表示
ネストされたスキーマ : connectorInfos
型:
arrayタイプのconnectorInfos。
ソースを表示
- Array of: object ConnectorInfo
ConnectorInfo
ネストされたスキーマ : TypeField
型:
objectFieldInAggrType.
ソースを表示
- apiName(optional): string
フィールドのAPI名。
- archivedBy(optional): string
アーカイブしました。
- archivedDate(optional): object date
date
- datatype(optional): string
許容値:
[ "number", "long", "decimal", "text", "largetext", "reference", "datetime", "boolean" ]データ型列挙。 これは、レスポンスの取得とリクエストのポスト/送信の必須プロパティです。 - defaultValue(optional): object defaultValue
フィールドのdefaultValue。
- description(optional): string
フィールドの説明。
- id(optional): string
フィールドのid。 これはレスポンス取得と送信リクエストの必須プロパティであり、リクエストの転送には必要ありません。
- isSystemField(optional): boolean
システムによって提供されるフィールドです。
- name(optional): string
フィールドの名前。 これは、レスポンスの取得とリクエストのポスト/送信の必須プロパティです。
- properties(optional): object properties
許可される追加のプロパティ: additionalPropertiesフィールド固有のプロパティ。 publishingDependencyフィールドは、メディアおよび参照に固有です。
- required(optional): boolean
フィールドの必須またはオプションの値。 これは、レスポンスの取得とリクエストのポスト/送信の必須プロパティです。
- settings(optional): object settings
許可される追加のプロパティ: additionalPropertiesフィールド固有の設定。
- valuecount(optional): string
許容値:
[ "single", "list" ]値は単一またはリストとしてカウントされます。 これは、レスポンスの取得とリクエストのポスト/送信の必須プロパティです。
ネストされたスキーマ : defaultValue
型:
objectフィールドのdefaultValue。
ネストされたスキーマ: properties
型:
object使用可能なその他のプロパティ
ソースを表示
フィールド固有のプロパティ。 publishingDependencyフィールドは、メディアおよび参照に固有です。
例:
{caas-translation: {inheritFromMaster: false}, publishingDependency: optional}ネストされたスキーマ: additionalProperties
型:
objectネストされたスキーマ: additionalProperties
型:
objectネストされたスキーマ: Link
型:
objectリソースのリンク。
ソースを表示
- href(optional): string
ターゲット・リソースのURI それはテンプレートURIである可能性があります。 これはレスポンス取得の必須プロパティです。
- mediaType(optional): string
メディア・タイプ。
- method(optional): string
ターゲット・リソースへのアクセスに使用できるHTTPメソッド。
- profile(optional): string
ターゲット・リソースを記述するメタデータにリンクします。
- rel(optional): string
関連タイプ これはレスポンス取得の必須プロパティです。
- templated(optional): boolean
URIがテンプレートであるかどうか。
ネストされたスキーマ : ConnectorInfo
型:
objectConnectorInfo
ソースを表示
- connectorId(optional): string
コネクタのId。
- connectorSyncEnabled(optional): boolean
コネクタの同期ステータス。
ネストされたスキーマ : LayoutMapping
型:
objectLayoutMapping
ソースを表示
- apiName(optional): string
レイアウトの名前。
- formats(optional): object formats
許可される追加のプロパティ: additionalPropertiesレイアウト形式。
- generateRendition(optional): boolean
generateRendition.
- id(optional): integer(int64)
レイアウト・マッピングのID。
- label(optional): string
レイアウト・マッピングのカテゴリの名前です。
ネストされたスキーマ: additionalProperties
型:
objectネストされたスキーマ : TypeRelationships
型:
objectタイプ関連
ソースを表示
- references(optional): array references
一意のアイテムが必要:
true参照タイプ名/ID
ネストされたスキーマ : references
型:
array一意のアイテムが必要:
true参照タイプ名/ID
ソースを表示
- Array of: object TypeReferences
型参照Bean
ネストされたスキーマ : カテゴリ
型:
ソースを表示
object- apiName(optional): string
読取り専用:
true - id(optional): string
- name(optional): string
読取り専用:
true
レスポンス
サポートされているメディア・タイプ
- application/json
200レスポンス
OK。
ルート・スキーマ : タイプ
型:
objectAggregatedType
ソースを表示
- allowedActions(optional): array allowedActions
タイプのallowedActions。
- allowedFileTypes(optional): array allowedFileTypes
タイプでサポートされているファイル拡張子の許可されたリスト。 これはレスポンス取得の必須プロパティです。 ポスト/プット・リクエストではオプションで、typeCategoryがContentTypeの場合は[ContentItem]にデフォルト設定され、typeCategoryがDigitalAssetTypeの場合は空にデフォルト設定されます。
- apiName(optional): string
タイプのAPI名。
- archivedFields(optional): object ItemSubResourceListTypeField
アイテムSubResource。
- connectorInfos(optional): array connectorInfos
タイプのconnectorInfos。
- createdBy(optional): string
作成方法
- createdDate(optional): object date
date
- description(optional): string
タイプの説明。
- displayName(optional): string
タイプの表示名。 これはgetレスポンスの必須プロパティですが、post/putリクエストでは必要ありません。
- fields(optional): array fields
タイプで使用されるフィールド。
- id(optional): string
型のId。 これはレスポンス取得と送信リクエストの必須プロパティであり、リクエストの転送には必要ありません。
- inplacePreview(optional): object ItemSubResourceListInplacePreview
アイテムSubResource。
- jobToken(optional): string
タイプを更新するバックグラウンド・ジョブのジョブ・トークン。
- layoutMapping(optional): object ItemSubResourceListLayoutMapping
アイテムSubResource。
- links(optional): array links
- name(optional): string
タイプの名前。 これは、レスポンスの取得とリクエストのポスト/送信の必須プロパティです。
- properties(optional): object properties
許可される追加のプロパティ: additionalProperties特定のプロパティを入力します。
- relationships(optional): object ItemSubResourceTypeRelationships
アイテムSubResource。
- requiredTaxonomies(optional): object ItemSubResourceListRequiredTaxonomy
アイテムSubResource。
- roleName(optional): string
コンテンツ・タイプのユーザー・ロールの名前。
- typeCategory(optional): string
タイプのカテゴリ。 使用可能な値は[ContentType, DigitalAssetType]です。 これはレスポンス取得の必須プロパティです。 ポスト・リクエストではオプションで、ContentTypeにデフォルト設定されます。 Putリクエストでもオプションで、URLのtypeNameパス・パラメータに基づいて識別されます。
- updatedBy(optional): string
更新者
- updatedDate(optional): object date
date
ネストされたスキーマ : allowedActions
型:
arrayタイプのallowedActions。
ソースを表示
- Array of: string
許容値:
[ "preview", "read", "write", "update", "delete" ]
ネストされたスキーマ : allowedFileTypes
型:
arrayタイプでサポートされているファイル拡張子の許可されたリスト。 これはレスポンス取得の必須プロパティです。 ポスト/プット・リクエストではオプションで、typeCategoryがContentTypeの場合は[ContentItem]にデフォルト設定され、typeCategoryがDigitalAssetTypeの場合は空にデフォルト設定されます。
ソースを表示
ネストされたスキーマ : connectorInfos
型:
arrayタイプのconnectorInfos。
ソースを表示
- Array of: object ConnectorInfo
ConnectorInfo
ネストされたスキーマ : TypeField
型:
objectFieldInAggrType.
ソースを表示
- apiName(optional): string
フィールドのAPI名。
- archivedBy(optional): string
アーカイブしました。
- archivedDate(optional): object date
date
- datatype(optional): string
許容値:
[ "number", "long", "decimal", "text", "largetext", "reference", "datetime", "boolean" ]データ型列挙。 これは、レスポンスの取得とリクエストのポスト/送信の必須プロパティです。 - defaultValue(optional): object defaultValue
フィールドのdefaultValue。
- description(optional): string
フィールドの説明。
- id(optional): string
フィールドのid。 これはレスポンス取得と送信リクエストの必須プロパティであり、リクエストの転送には必要ありません。
- isSystemField(optional): boolean
システムによって提供されるフィールドです。
- name(optional): string
フィールドの名前。 これは、レスポンスの取得とリクエストのポスト/送信の必須プロパティです。
- properties(optional): object properties
許可される追加のプロパティ: additionalPropertiesフィールド固有のプロパティ。 publishingDependencyフィールドは、メディアおよび参照に固有です。
- required(optional): boolean
フィールドの必須またはオプションの値。 これは、レスポンスの取得とリクエストのポスト/送信の必須プロパティです。
- settings(optional): object settings
許可される追加のプロパティ: additionalPropertiesフィールド固有の設定。
- valuecount(optional): string
許容値:
[ "single", "list" ]値は単一またはリストとしてカウントされます。 これは、レスポンスの取得とリクエストのポスト/送信の必須プロパティです。
ネストされたスキーマ : defaultValue
型:
objectフィールドのdefaultValue。
ネストされたスキーマ: properties
型:
object使用可能なその他のプロパティ
ソースを表示
フィールド固有のプロパティ。 publishingDependencyフィールドは、メディアおよび参照に固有です。
例:
{caas-translation: {inheritFromMaster: false}, publishingDependency: optional}ネストされたスキーマ: additionalProperties
型:
objectネストされたスキーマ: additionalProperties
型:
objectネストされたスキーマ: Link
型:
objectリソースのリンク。
ソースを表示
- href(optional): string
ターゲット・リソースのURI それはテンプレートURIである可能性があります。 これはレスポンス取得の必須プロパティです。
- mediaType(optional): string
メディア・タイプ。
- method(optional): string
ターゲット・リソースへのアクセスに使用できるHTTPメソッド。
- profile(optional): string
ターゲット・リソースを記述するメタデータにリンクします。
- rel(optional): string
関連タイプ これはレスポンス取得の必須プロパティです。
- templated(optional): boolean
URIがテンプレートであるかどうか。
ネストされたスキーマ : ConnectorInfo
型:
objectConnectorInfo
ソースを表示
- connectorId(optional): string
コネクタのId。
- connectorSyncEnabled(optional): boolean
コネクタの同期ステータス。
ネストされたスキーマ : LayoutMapping
型:
objectLayoutMapping
ソースを表示
- apiName(optional): string
レイアウトの名前。
- formats(optional): object formats
許可される追加のプロパティ: additionalPropertiesレイアウト形式。
- generateRendition(optional): boolean
generateRendition.
- id(optional): integer(int64)
レイアウト・マッピングのID。
- label(optional): string
レイアウト・マッピングのカテゴリの名前です。
ネストされたスキーマ: additionalProperties
型:
objectネストされたスキーマ : TypeRelationships
型:
objectタイプ関連
ソースを表示
- references(optional): array references
一意のアイテムが必要:
true参照タイプ名/ID
ネストされたスキーマ : references
型:
array一意のアイテムが必要:
true参照タイプ名/ID
ソースを表示
- Array of: object TypeReferences
型参照Bean
ネストされたスキーマ : カテゴリ
型:
ソースを表示
object- apiName(optional): string
読取り専用:
true - id(optional): string
- name(optional): string
読取り専用:
true
202レスポンス
Accepted.
400レスポンス
不正リクエスト
403レスポンス
禁止。
404レスポンス
見つかりません。
409レスポンス
競合
500レスポンス
内部サーバー・エラー
例
次の例は、cURLを使用してRESTリソースに対するPUTリクエストを発行することによってフィールドを更新する方法を示しています。
curl -X PUT -H 'Content-Type: application/json' -H 'X-Requested-With: XMLHttpRequest' 'https://host:port/content/management/api/v1.1/types/{name}'
例1:
これにより、既存のタイプのブックが必須フィールドでオプション・フィールドに更新されます。 ペイロードを独自のデータで置換します。
/content/management/api/v1.1/types/Book
リクエスト本文
{
"name": "Book",
"description": "Description of the book",
"fields": [
{
"name": "volume",
"description": "Number Field",
"datatype": "number",
"required": false,
"valuecount": "single"
}
]
}
例2:
これにより、新しいオプション・フィールドが追加されて、既存の型typeNameが更新されます。 ペイロードを独自のデータで置換します。
/content/management/api/v1.1/types/typeName
リクエスト本文
{
"name": "Book",
"description": "some decription for Book",
"typeCategory": "ContentType",
"fields": [
{
"name": "volume",
"description": "Text field",
"datatype": "largetext",
"required": false,
"valuecount": "single"
},
{
"name": "abstract",
"description": "Text field",
"datatype": "largetext",
"required": false,
"valuecount": "single"
}
]
}
例3 :
これにより、参照のある既存の型について、publishingDependencyがオプションから必須に更新されます。 ペイロードを独自のデータで置換します。
/content/management/api/v1.1/types/referenceType-pubDep-required
リクエスト本文
{
"name": "referenceType-pubDep-required",
"description": "referenceType-pubDep-required description",
"fields": [
{
"name": "media",
"apiName": "media",
"datatype": "reference",
"required": true,
"valuecount": "single",
"properties": {
"publishingDependency": "optional"
}
}
]
}
例4 :
これにより、フィールドが削除され、コンテンツ・アイテムを含む既存のタイプのtypeNameが更新されます。 ペイロードを独自のデータで置換します。 レスポンス本文はなく、レスポンス・ヘッダーには非同期タイプ更新ジョブのステータス・リンクが含まれます。
/content/management/api/v1.1/types/typeName
リクエスト本文
{
"name": "typeName",
"description": "some decription for typeName",
"fields": [
{
"name": "volume",
"description": "Text field",
"datatype": "largetext",
"required": false,
"valuecount": "single"
}
]
}
例5 :
これにより、プロパティ' properties.caas-translations.file.inheritFromMaster 'をtrueからfalseにフリップすることで、アセットを持たない既存のデジタル・アセット・タイプ・ブックが更新され、共有されているタイプ・ファイルが非ファイル共有タイプに変換されます。 ペイロードを独自のデータで置換します。
/content/management/api/v1.1/types/typeName
リクエスト・ペイロード
{
"name": "Book",
"description": "some decription for Book",
"displayName": "BookDisplayName",
"typeCategory": "DigitalAssetType",
"fields": [
{
"name": "volume",
"description": "Text field",
"datatype": "largetext",
"required": false,
"valuecount": "single"
}
],
"caas-translations": {
"description": {
"inheritFromMaster": false,
"note": "",
"translate": true
},
"file": {
"inheritFromMaster": false,
"note": "",
"translate": true
},
"name": {
"inheritFromMaster": false,
"note": "",
"translate": true
},
"slug": {
"inheritFromMaster": false,
"note": "",
"translate": true
}
}
}
リクエスト・ヘッダー
{
"Content-Type": "application/json",
"X-Requested-With": "XMLHttpRequest"
}