メインコンテンツへスキップ
PUT
ユーザーの請求先組織を設定
1回のリクエストで、最大100人のユーザーの請求先組織を設定します。変更されるのはリクエストで指定したユーザーのみで、エンタープライズ内のほかのユーザーには影響しません。ユーザーを1人ずつ設定する場合は、ベータ版のユーザー設定エンドポイントでも billing_org_id を指定できます。

部分成功

同じリクエスト内に無効な行が含まれていても、有効な割り当てはまとめて保存されます。そのため、200 レスポンスにも失敗が含まれる場合があります。必ず failed を確認してください。各項目には、ユーザー、リクエストされた組織、および reason が含まれます。これらのユーザーの請求先組織は変更されていないため、該当する行を修正して再送信してください。 reason の値は今後追加される可能性があるため、未知の値はエラーではなく失敗として扱ってください。 エラーレスポンス (4xx または 5xx) が返された場合、リクエストの内容は一切保存されていません。割り当てが含まれていないリクエスト、割り当てが 100 件を超えるリクエスト、または同じ user_id が複数回含まれるリクエストは、422 で拒否されます。 割り当てを再送信すると、ユーザーの現在の請求先組織が上書きされ、監査ログに新たな項目が記録されます。そのため、繰り返し呼び出しても問題はありませんが、影響がまったくないわけではありません。

権限

エンタープライズレベルで ManageBilling と ViewOrganizations の両方の権限を持つサービスユーザーまたは個人用アクセストークンが必要です。なお、ManageOrganizations には ViewOrganizations が含まれるため、ManageOrganizations を持っていれば ViewOrganizations の要件も満たされます。

承認

Authorization
string
header
必須

サービスユーザーの認証情報(接頭辞: cog_)

ボディ

application/json
assignments
UserBillingOrgAssignmentRequest · object[]
必須

各ユーザーに設定する請求先組織。同じユーザーを複数回指定することはできません。

Required array length: 1 - 100 elements

レスポンス

成功レスポンス

assigned
UserBillingOrgAssignmentResponse · object[]
必須

適用された割り当て。

failed
UserBillingOrgFailureResponse · object[]
必須

スキップされた割り当てとその理由。これらのユーザーの請求先組織は変更されていません。