移動先

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

グローバル・ターゲット・プロパティの新規作成

post

https://EM_HOST:8080/em/api/globalTargetProperties

このAPIは、指定されたデータで新しいグローバル・ターゲット・プロパティ・リソースを作成します。そのリソースがすでに存在する場合は、エラーが返されます。ノート - ユーザー定義のプロパティの場合、nameとdisplayNameは同じです。

リクエスト

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

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

• application/json

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

ルート・スキーマ: schema

型: object

ターゲット作成リクエストに必要なペイロード。

ソースの表示

• hasValidValuesEnabled: boolean
  ターゲットに追加されたターゲット・プロパティ値を有効値リストと照合するかどうかを示します。

  例: true
• id(必須): string
  ターゲット・プロパティID

  例: my_prop
• name(必須): string
  ターゲット・プロパティ名

  例: My Property
• validValues: array validValues
  このプロパティの有効値

{
    "x-em-sdk-level":"emSDK",
    "description":"Payload needed for a target creation request.",
    "type":"object",
    "required":[
        "id",
        "name"
    ],
    "properties":{
        "id":{
            "description":"the target property id",
            "type":"string",
            "example":"my_prop"
        },
        "name":{
            "description":"the target property name",
            "type":"string",
            "example":"My Property"
        },
        "hasValidValuesEnabled":{
            "description":"Indicates if target property values added to targets should be checked against the valid values list.",
            "type":"boolean",
            "example":true
        },
        "validValues":{
            "type":"array",
            "description":"the valid values for this property",
            "items":{
                "type":"string"
            },
            "example":[
                "My Value",
                "My Other Value"
            ]
        }
    }
}

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

型: array

このプロパティの有効値

ソースの表示

• 配列: string

{
    "type":"array",
    "description":"the valid values for this property",
    "items":{
        "type":"string"
    },
    "example":[
        "My Value",
        "My Other Value"
    ]
}

例:

[
    "My Value",
    "My Other Value"
]

先頭に戻る

レスポンス

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

• application/json

201レスポンス

作成されました

本文()

ルート・スキーマ: GlobalTargetProperty

型: object

これはEMターゲット・リソースを表すものです。

ソースの表示

• displayName(必須): string
  クライアント・ロケールでのプロパティ表示名

  例: Location
• hasValidValuesEnabled: boolean
  ターゲットに追加されたターゲット・プロパティ値を有効値リストと照合するかどうかを示します。

  例: true
• id(必須): string
  ターゲット・プロパティID

  例: orcl_gtp_location
• links: object links
  ターゲット関連リンク
• name(必須): string
  ターゲット・プロパティ名

  例: Location
• validValues: array validValues
  このプロパティの有効値

{
    "x-em-sdk-level":"emSDK",
    "description":"This is the representation of an EM target resource.",
    "type":"object",
    "required":[
        "id",
        "name",
        "displayName"
    ],
    "properties":{
        "id":{
            "type":"string",
            "description":"the target property id",
            "example":"orcl_gtp_location"
        },
        "name":{
            "type":"string",
            "description":"the target property name",
            "example":"Location"
        },
        "displayName":{
            "type":"string",
            "description":"the property display name in the client locale",
            "example":"Location"
        },
        "hasValidValuesEnabled":{
            "type":"boolean",
            "description":"Indicates if target property values added to targets should be checked against the valid values list.",
            "example":true
        },
        "validValues":{
            "type":"array",
            "description":"the valid values for this property",
            "items":{
                "type":"string"
            },
            "example":[
                "London",
                "Paris",
                "Rome"
            ]
        },
        "links":{
            "type":"object",
            "description":"the target related links",
            "properties":{
                "self":{
                    "allOf":[
                        {
                            "$ref":"#/components/schemas/Link"
                        },
                        {
                            "description":"The link to the target property"
                        },
                        {
                            "example":{
                                "href":"/em/api/targetProperties/orcl_gtp_location"
                            }
                        }
                    ]
                }
            }
        }
    }
}

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

型: object

ターゲット関連リンク

ソースの表示

• self: self

{
    "type":"object",
    "description":"the target related links",
    "properties":{
        "self":{
            "allOf":[
                {
                    "$ref":"#/components/schemas/Link"
                },
                {
                    "description":"The link to the target property"
                },
                {
                    "example":{
                        "href":"/em/api/targetProperties/orcl_gtp_location"
                    }
                }
            ]
        }
    }
}

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

型: array

このプロパティの有効値

ソースの表示

• 配列: string

{
    "type":"array",
    "description":"the valid values for this property",
    "items":{
        "type":"string"
    },
    "example":[
        "London",
        "Paris",
        "Rome"
    ]
}

例:

[
    "London",
    "Paris",
    "Rome"
]

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

すべてに一致

ソースの表示

• object Link
  リンクを表します(self、previous、nextのいずれか)
• ターゲット・プロパティへのリンク
• 例: { "href":"/em/api/targetProperties/orcl_gtp_location" }

{
    "allOf":[
        {
            "$ref":"#/components/schemas/Link"
        },
        {
            "description":"The link to the target property"
        },
        {
            "example":{
                "href":"/em/api/targetProperties/orcl_gtp_location"
            }
        }
    ]
}

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

型: object

リンクを表します(self、previous、nextのいずれか)

ソースの表示

• href: string
  リンクのためのURL

  例: /em/api/<resources>?page=b2Zmc2V0OjA&limit=0

{
    "type":"object",
    "description":"Represents a link(could be self, previous or next)",
    "properties":{
        "href":{
            "type":"string",
            "description":"URL for Link",
            "example":"/em/api/<resources>?page=b2Zmc2V0OjA&limit=0"
        }
    }
}

400レスポンス

引数が無効かリソース定義が不完全です

本文()

ルート・スキーマ: ErrorResponse

型: object

エラー・レスポンス

ソースの表示

• code(必須): string
  プログラムによる解析を目的とした、エラーを定義する短いエラー・コード。
• message(必須): string
  判読可能なエラー文字列

{
    "description":"Error response",
    "type":"object",
    "required":[
        "code",
        "message"
    ],
    "properties":{
        "code":{
            "description":"A short error code that defines the error, meant for programmatic parsing",
            "type":"string"
        },
        "message":{
            "description":"A human-readable error string",
            "type":"string"
        }
    }
}

401レスポンス

クライアントが認証されていません

本文()

ルート・スキーマ: ErrorResponse

型: object

エラー・レスポンス

ソースの表示

• code(必須): string
  プログラムによる解析を目的とした、エラーを定義する短いエラー・コード。
• message(必須): string
  判読可能なエラー文字列

{
    "description":"Error response",
    "type":"object",
    "required":[
        "code",
        "message"
    ],
    "properties":{
        "code":{
            "description":"A short error code that defines the error, meant for programmatic parsing",
            "type":"string"
        },
        "message":{
            "description":"A human-readable error string",
            "type":"string"
        }
    }
}

409レスポンス

認可されていないかターゲットがすでに存在します

本文()

ルート・スキーマ: ErrorResponse

型: object

エラー・レスポンス

ソースの表示

• code(必須): string
  プログラムによる解析を目的とした、エラーを定義する短いエラー・コード。
• message(必須): string
  判読可能なエラー文字列

{
    "description":"Error response",
    "type":"object",
    "required":[
        "code",
        "message"
    ],
    "properties":{
        "code":{
            "description":"A short error code that defines the error, meant for programmatic parsing",
            "type":"string"
        },
        "message":{
            "description":"A human-readable error string",
            "type":"string"
        }
    }
}

500レスポンス

リクエスト処理中の内部エラー

本文()

ルート・スキーマ: ErrorResponse

型: object

エラー・レスポンス

ソースの表示

• code(必須): string
  プログラムによる解析を目的とした、エラーを定義する短いエラー・コード。
• message(必須): string
  判読可能なエラー文字列

{
    "description":"Error response",
    "type":"object",
    "required":[
        "code",
        "message"
    ],
    "properties":{
        "code":{
            "description":"A short error code that defines the error, meant for programmatic parsing",
            "type":"string"
        },
        "message":{
            "description":"A human-readable error string",
            "type":"string"
        }
    }
}

503レスポンス

必要なサービスが使用不可であることを示しています。

本文()

ルート・スキーマ: ErrorResponse

型: object

エラー・レスポンス

ソースの表示

• code(必須): string
  プログラムによる解析を目的とした、エラーを定義する短いエラー・コード。
• message(必須): string
  判読可能なエラー文字列

{
    "description":"Error response",
    "type":"object",
    "required":[
        "code",
        "message"
    ],
    "properties":{
        "code":{
            "description":"A short error code that defines the error, meant for programmatic parsing",
            "type":"string"
        },
        "message":{
            "description":"A human-readable error string",
            "type":"string"
        }
    }
}

先頭に戻る