機能説明
このAPIは、現在の組織内でラベルを一括作成するために使用されます。同じラベルキーに対して複数のラベル値を一度に作成できます。
呼び出し説明
インターフェース制約
呼び出し元はマルチクラウドAPIにアクセスするためのキーを保有している必要があります。AccessKey IDとAccessKey Secretの取得方法の詳細については、アクセスキーの管理を参照してください。
リクエストパス
POST /api/v2/tags
リクエストパラメータ
Query
パラメータ名 |
型 |
必須 |
説明 |
サンプル値 |
|---|---|---|---|---|
| Action | String | はい | APIアクション。CreateIamTagsに固定 | CreateIamTags |
Body
パラメータ名 |
型 |
必須 |
説明 |
サンプル値 |
|---|---|---|---|---|
| orgId | String | はい | 組織ID | uk******** |
| tagValueList | Array | はい | 作成するタグのリスト | - |
| tagValueList[].tagKey | String | はい | タグキー | bxtest-key |
| tagValueList[].tagValue | String | はい | タグ値 | bxtest-value |
戻り結果
プロパティ |
型 |
説明 |
サンプル値 |
|---|---|---|---|
| requestId | String | リクエストID | - |
| data | Array | 作成後のタグリスト | - |
| data[].id | Integer | タグkey ID（外側） | 217 |
| data[].tagKey | String | タグkeyの値 | bxtest-key |
| data[].tagValueList | Array | そのタグkeyに対応するvalueの集合 | - |
| data[].tagValueList[].id | Integer | タグ値のID（内側）、完全なタグで使用されるIDを表す | 244 |
| data[].tagValueList[].tagKey | String | タグkey | bxtest-key |
| data[].tagValueList[].tagValue | String | タグvalue | bxtest-value |
| success | Boolean | 成功かどうか | true |
例
リクエスト例
curl --digest -u 'ak:sk' \
-X POST \
'https://api-cloud.oceanbase.com/api/v2/tags?Action=CreateIamTags' \
-H "Content-Type: application/json" \
-d '{
"orgId": "uk********",
"tagValueList": [
{
"tagKey": "bxtest-key",
"tagValue": "bxtest-value"
}
]
}'
戻り値例
JSON形式
{
"data": [
{
"id": 217,
"tagKey": "bxtest-key",
"tagValueList": [
{
"id": 244,
"tagKey": "bxtest-key",
"tagValue": "bxtest-value"
}
]
}
],
"requestId": "",
"success": true
}