Skip to main content

メンバー招待リンクの作成

TokenPlanメンバーの招待リンクを作成します。

前提条件

Alibaba Cloud アカウントまたは RAM ユーザーの AccessKey を取得しており、その ID にこの操作を呼び出すために必要な RAM 権限が付与されていること。AccessKey をハードコーディングするのではなく、環境変数 ALIBABA_CLOUD_ACCESS_KEY_ID および ALIBABA_CLOUD_ACCESS_KEY_SECRET として設定することを推奨します。

リクエストの説明

  • HTTP メソッド:POST
  • リクエスト URL

    リージョン

    エンドポイント

    シンガポール

    POST https://modelstudio.ap-southeast-1.aliyuncs.com/tokenplan/invite/link/create

  • 認証 この操作は、AccessKey ベースの署名(ACS3-HMAC-SHA256 アルゴリズム)を使用する Alibaba Cloud OpenAPI 操作です。Authorization: Bearer {API_KEY} スキームはサポートされていません。リクエストには共通ヘッダー x-acs-action: CreateTokenPlanInviteLink、x-acs-version: 2026-02-10、x-acs-date、x-acs-content-sha256、x-acs-signature-nonce、および Authorization を含める必要があります。 署名を自分で計算する必要がないよう、Alibaba Cloud SDK または OpenAPI Explorer を使用してこの操作を呼び出すことを推奨します。
各ユーザーが保持できる有効な招待リンクは1つのみです。
ユーザーがすでに有効な招待リンクを持っている場合、このAPIはそのリンクを返します。
新しいリンクを作成するには、RevokeTokenPlanInviteLink APIを呼び出して現在のリンクを無効化してください。
该接口只返回生成的 token,邀请链接的拼接格式为 https://{host}/accept-invite?token=[token]&orgId=[orgId]
中国サイトの場合、ホストはtokenplan-enterprise.bailian.aliyunportal.comです。
国際サイトの場合、ホストはtokenplan-enterprise.modelstudio.aliyunportal.comです。

リクエストパラメーター

すべてのパラメーターはクエリ文字列で渡されます。

パラメーター

タイプ

必須

説明

ExpireType

string

いいえ

有効期限の階層。デフォルト:DAYS_7。
DAYS_7
DAYS_30
MONTHS_6
YEAR_1

SsoSource

string

はい

招待リンクに紐づくSSOログイン方式:
SAML
DINGTALK

レスポンスパラメーター

パラメーター

タイプ

説明

Success

boolean

API呼び出しが成功したかどうか:
true:成功
false:失敗

Code

string

レスポンスステータスコード。

Message

string

レスポンスメッセージ。

Data

object

ビジネスパラメータ。

Token

string

生成されたトークン。

リクエスト例

この操作では Alibaba Cloud OpenAPI の署名を使用します。以下の例では、${SIGNATURE} を ACS3-HMAC-SHA256 アルゴリズムで計算する必要があり、x-acs-date および x-acs-signature-nonce を実際の値に置き換える必要があります。
curl -X POST "https://modelstudio.ap-southeast-1.aliyuncs.com/tokenplan/invite/link/create?ExpireType=DAYS_7&SsoSource=SAML" \
    --header "x-acs-action: CreateTokenPlanInviteLink" \
    --header "x-acs-version: 2026-02-10" \
    --header "x-acs-date: 2026-01-01T12:00:00Z" \
    --header "x-acs-content-sha256: e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855" \
    --header "x-acs-signature-nonce: ${SIGNATURE_NONCE}" \
    --header "Authorization: ACS3-HMAC-SHA256 Credential=${ALIBABA_CLOUD_ACCESS_KEY_ID},SignedHeaders=host;x-acs-action;x-acs-content-sha256;x-acs-date;x-acs-signature-nonce;x-acs-version,Signature=${SIGNATURE}"

レスポンス例

{
  "Success": true,
  "Data": {
    "Token": "sk-ws-D.****.*******"
  }
}

エラーコード

呼び出しに失敗した場合、エラーメッセージが返されます。その他のエラーコードと解決策については、エラーコードを参照してください。