跳到主要内容

生成 Storage Integration 授权材料 (V2)

This operation generates provider-specific authorization materials that are required before creating or validating a storage integration.

POST/v2/storageIntegrations/authorizationMaterials
连接端点

该 API 的 Base URL 格式如下：

https://api.cloud.zilliz.com

📘说明

控制面接口速率限制为单用户单接口每秒最多 20 个请求。

shell
export BASE_URL="https://api.cloud.zilliz.com"
参数
Authorizationstringheader必填项

认证令牌，应为具备适当权限的 API 密钥。

示例值：Bearer {{TOKEN}}
请求体application/json
projectIdstring必填项

项目 ID。

regionIdstring必填项

地域 ID。服务器会根据该字段推断云厂商。

bucketNamestring必填项

用于生成策略或凭证的 bucket、容器或存储名称。

bash
export TOKEN="YOUR_API_KEY"

curl --request POST \
--url "${BASE_URL}/v2/storageIntegrations/authorizationMaterials" \
--header "Authorization: Bearer ${TOKEN}" \
--header "Request-Timeout: 5" \
--header "Content-Type: application/json" \
-d '{
    "projectId": "proj-xxxxxxxxxxxxxxxxxxxxxx",
    "regionId": "aws-cn-northwest-1",
    "bucketName": "my-bucket"
}'
bash
export TOKEN="YOUR_API_KEY"

curl --request POST \
--url "${BASE_URL}/v2/storageIntegrations/authorizationMaterials" \
--header "Authorization: Bearer ${TOKEN}" \
--header "Request-Timeout: 5" \
--header "Content-Type: application/json" \
-d '{
    "projectId": "proj-xxxxxxxxxxxxxxxxxxxxxx",
    "regionId": "ali-cn-hangzhou",
    "bucketName": "my-oss-bucket"
}'
响应200 OK - application/json

返回云厂商相关的授权材料。

AWS S3 成功响应。

codeinteger

响应码。

示例值：0
dataobject

返回 AWS S3 授权材料。

readonlystring

只读 AWS S3 策略。可能的值为 s3:GetObject、s3:ListBucket 和 s3:GetBucketLocation。

readwritestring

读写 AWS S3 策略。可能的值为 s3:GetObject、s3:ListBucket、s3:GetBucketLocation 和 s3:PutObject。

iamPolicystring

创建流程使用的 AWS IAM 策略。可能的值为 s3:GetObject、s3:ListBucket、s3:GetBucketLocation 和 s3:PutObject。

trustPolicystring

云厂商信任策略。

zillizAccountstring

需要授权的 Zilliz 云账号或 RAM 主体。

externalIdstring

生成的 external ID。

Alibaba Cloud OSS 成功响应。

codeinteger

响应码。

示例值：0
dataobject

返回 Alibaba Cloud OSS 授权材料。

readonlystring

只读阿里云 OSS 策略。可能的值为 oss:GetObject、oss:ListObjects、oss:GetBucketLocation 和 oss:HeadBucket。

readwritestring

读写阿里云 OSS 策略。可能的值为 oss:GetObject、oss:ListObjects、oss:GetBucketLocation、oss:HeadBucket 和 oss:PutObject。

ramPolicystring

创建流程使用的阿里云 RAM 策略。可能的值为 oss:GetObject、oss:ListObjects、oss:GetBucketLocation、oss:HeadBucket 和 oss:PutObject。

trustPolicystring

云厂商信任策略。

zillizAccountstring

需要授权的 Zilliz 云账号或 RAM 主体。

externalIdstring

生成的 external ID。

失败响应。

codeinteger

响应码。

示例值：1800
messagestring

错误信息。

示例值：User hasn't authenticated
AWS S3json
{
    "code": 0,
    "data": {
        "readonly": "{...}",
        "readwrite": "{...}",
        "iamPolicy": "{...}",
        "trustPolicy": "{...}",
        "zillizAccount": "306787409409",
        "externalId": "zilliz-external-AbCdEf12345678"
    }
}
Ctrl I