如何通过API正确为LaunchDarkly功能标志变体添加用户分段？

我正尝试通过LaunchDarkly API管理面向用户组的功能标志变体，目标是按组迁移用户，为特定分段切换标志变体，从而针对特定用户更改应用行为，并可逐步来回迁移。

已完成以下操作：

• 创建分段

curl -X POST https://app.launchdarkly.com/api/v2/segments/someproject/someenv \
 -H "Authorization: api-XXXX" \
 -H "Content-Type: application/json; domain-model=launchdarkly.semanticpatch" \
 -d '{
       "name": "Group 1",
       "key": "group-1"
     }'

• 为分段添加用户

curl -X PATCH https://app.launchdarkly.com/api/v2/segments/someproject/someenv/group-1 \
 -H "Authorization: api-XXXX" \
 -H "Content-Type: application/json; domain-model=launchdarkly.semanticpatch" \
 -d '{
       "instructions": [{
         "kind": "addIncludedUsers",
         "values": [ "user-key-123abc", "user-key-456def" ]
       }]
     }'

• 尝试将分段作为目标添加到标志变体（此步骤出错）

curl -X PATCH "https://app.launchdarkly.com/api/v2/flags/someproject/Migrations.someflag" \
 -H "Authorization: api-XXXX" \
 -H "Content-Type: application/json; domain-model=launchdarkly.semanticpatch" \
 -d '{
       "environmentKey": "someenv",
       "instructions": [{
         "kind": "addTargets",
         "variationId": "123123",
         "values": ["group-1"],
         "contextKind": "segment"
       }]
     }'

问题：可以创建分段并添加用户，但尝试将其分配给标志变体时，LaunchDarkly会添加一个键为"italy-group-1"的单个用户，而非应用该分段。

目标：

• 定义多个用户组（分段）
• 将标志变体分配给分段而非单个用户
• 逐步将用户迁移到不同变体，并在需要时回退

你出错的核心原因是用错了语义补丁指令：addTargets是用于添加单个用户/上下文目标的，无法关联分段。要将分段绑定到标志变体，必须使用addSegmentTarget指令。

修正后的关联分段请求 #

curl -X PATCH "https://app.launchdarkly.com/api/v2/flags/someproject/Migrations.someflag" \
 -H "Authorization: api-XXXX" \
 -H "Content-Type: application/json; domain-model=launchdarkly.semanticpatch" \
 -d '{
       "environmentKey": "someenv",
       "instructions": [{
         "kind": "addSegmentTarget",
         "variationId": "123123",
         "segmentKey": "group-1",
         "contextKind": "user"
       }]
     }'

关键参数说明 #

• kind: 必须设为addSegmentTarget，明确告知API要关联分段而非单个用户
• segmentKey: 指定要绑定的分段键（即你创建的group-1），替代原来的values参数
• contextKind: 这里设为user（因为你的分段是用户分段），如果是其他类型上下文可对应调整

迁移与回退操作 #

1. 迁移用户到新变体：
   先移除原变体的分段绑定，再添加到目标变体：

   curl -X PATCH "https://app.launchdarkly.com/api/v2/flags/someproject/Migrations.someflag" \
    -H "Authorization: api-XXXX" \
    -H "Content-Type: application/json; domain-model=launchdarkly.semanticpatch" \
    -d '{
          "environmentKey": "someenv",
          "instructions": [
            {
              "kind": "removeSegmentTarget",
              "variationId": "123123",
              "segmentKey": "group-1",
              "contextKind": "user"
            },
            {
              "kind": "addSegmentTarget",
              "variationId": "456456",
              "segmentKey": "group-1",
              "contextKind": "user"
            }
          ]
        }'
   

2. 回退操作：
   重复上述步骤，将分段重新绑定回原来的变体即可。

验证效果 #

执行完关联请求后，进入LaunchDarkly控制台查看该标志的目标设置，应该能看到Group 1分段被绑定到指定变体，分段内的所有用户都会继承该变体的行为。

内容的提问来源于stack exchange，提问作者Ilia