オブジェクトFCアクセスポイントを作成します。
使用上の注意
デフォルトでは、Alibaba CloudアカウントにはオブジェクトFCアクセスポイントを作成する権限があります。 RAMユーザーまたはSecurity Token Service (STS) を使用してオブジェクトFCアクセスポイントを作成するには、
oss:CreateAccessPointForObjectProcess
権限が必要です。Alibaba Cloudアカウントに対して最大1,000のObject FCアクセスポイントを作成できます。
1つのバケットに対して最大100のオブジェクトFCアクセスポイントを作成できます。
リクエスト構文
PUT /?accessPointForObjectProcess HTTP/1.1
日付: GMT日付
コンテンツ-長さ: 785
Content-Type: application/xml
ホスト: BucketName.oss-cn-hangzhou.aliyuncs.com
x-oss-access-point-for-object-process-name: fc-ap-01
権限付与: SignatureValue
<?xml version="1.0" encoding="UTF-8"?>
<CreateAccessPointForObjectProcessConfiguration>
<AccessPointName>ap-01</AccessPointName>
<ObjectProcessConfiguration>
<AllowedFeatures>
<AllowedFeature>GetObject-Range</AllowedFeature>
</AllowedFeatures>
<TransformationConfigurations>
<TransformationConfiguration>
<アクション>
<Action>GetObject</Action>
</アクション>
<ContentTransformation>
<FunctionCompute>
<FunctionAssumeRoleArn> 文字列 </FunctionAssumeRoleArn>
<FunctionArn> 文字列 </FunctionArn>
</FunctionCompute>
</ContentTransformation>
</TransformationConfiguration>
</TransformationConfigurations>
</ObjectProcessConfiguration>
</CreateAccessPointForObjectProcessConfiguration>
リクエストヘッダー
ヘッダー | データ型 | 必須 | 例 | 説明 |
x-oss-access-point-for-object-process-name | String | 必須 | fc-ap-01 | オブジェクトFCアクセスポイントの名前。 オブジェクトFCアクセスポイントの名前は、次の要件を満たす必要があります。
|
CreateAccessPointForObjectProcessリクエストに含まれるその他の一般的なリクエストヘッダー (HostやDateなど) の詳細については、「一般的なHTTPヘッダー」をご参照ください。
リクエスト要素
要素 | データ型 | 必須 | 例 | 説明 |
CreateAccessPointForObjectProcessConfiguration | Container | 必須 | N/A | オブジェクトFCアクセスポイントに関する情報を格納するコンテナー。 親ノード: なし 子ノード: AccessPointNameとObjectProcessConfiguration |
AccessPointName | String | 必須 | ap-01 | オブジェクトFCアクセスポイントの名前。 詳細については、「オブジェクトFCアクセスポイントの作成」をご参照ください。 |
ObjectProcessConfiguration | Container | 任意 | N/A | オブジェクトFCアクセスポイントに関する処理情報を格納するコンテナー。 親ノード: CreateAccessPointForObjectProcessConfiguration 子ノード: AllowedFeatureとTransformationConfigurations |
AllowedFeatures | Container | 任意 | N/A | 許可された機能を格納するコンテナー。 親ノード: ObjectProcessConfiguration 子ノード: AllowedFeature |
AllowedFeature | String | 任意 | GetObject-Range | Function ComputeがRange GetObjectリクエストをサポートすることを指定します。 親ノード: AllowedFeatures 子ノード: なし |
TransformationConfigurations | Container | 任意 | N/A | 変換設定を格納するコンテナー。 親ノード: ObjectProcessConfiguration 子ノード: TransformationConfiguration |
TransformationConfiguration | Container | 任意 | N/A | 変換設定を格納するコンテナー。 親ノード: TransformationConfigurations 子ノード: アクションとContentTransformation |
操作 | Container | 任意 | N/A | 操作を格納するコンテナー。 親ノード: TransformationConfiguration 子ノード: アクション |
Action | String | 任意 | GetObject | サポートされているOSS API操作。 GetObject操作のみがサポートされています。 親ノード: アクション 子ノード: なし |
ContentTransformation | Container | 任意 | N/A | 変換設定の内容を格納するコンテナー。 親ノード: TransformationConfiguration 子ノード: FunctionCompute |
FunctionCompute | Container | 任意 | N/A | Function Computeに関する情報を格納するコンテナー。 親ノード: ContentTransformation 子ノード: FunctionAssumeRoleArnおよびFunctionArn |
FunctionAssumeRoleArn | String | 任意 | acs:ram::111933544165 ****:role/aliyunfcdefaultrole | Function Computeが他のクラウドサービスのリソースにアクセスするために使用するロールのAlibaba Cloud Resource Name (ARN) 。 デフォルトのロールは 親ノード: FunctionCompute 子ノード: なし |
FunctionArn | String | 任意 | acs:fc:cn-qingdao:111933544165 ****: サービス /test-oss-fc.LATEST /機能 /fc-01 | 関数のARN。The ARN of the function. 詳細については、「関数のARNの取得」をご参照ください。 |
レスポンスヘッダー
CreateAccessPointForObjectProcessリクエストに対するレスポンスには、共通のレスポンスヘッダーのみが含まれます。 詳細については、「共通HTTPヘッダー」をご参照ください。
レスポンス要素
要素 | データ型 | 例 | 説明 |
CreateAccessPointForObjectProcessResult | Container | N/A | オブジェクトFCアクセスポイントに関する情報を格納するコンテナー。 子ノード: AccessPointForObjectProcessArnとエイリアス |
AccessPointForObjectProcessArn | String | acs:oss:cn-qingdao:119335441657143:accesspointforobjectprocess/fc-ap-01 | オブジェクトFCアクセスポイントのARN。 |
AccessPointForObjectProcessAlias | String | fc-ap-01-3b00521f653d2b3223680ec39dbbe2 ****-opapalias | オブジェクトFCアクセスポイントのエイリアス。 |
例
リクエストの例
PUT /?accessPointForObjectProcess HTTP/1.1 日付: 10月30日月曜日2023 03:15:40 GMT コンテンツ-長さ: 785 Content-Type: application/xml ホスト: oss-example.oss-cn-qingdao.aliyuncs.com x-oss-access-point-for-object-process-name: fc-ap-01 権限付与: OSS qn6qrrqxo2oawuk53otf ****:ceOEyZavKY4QcjoUWYSpYbJ3 **** <?xml version="1.0" encoding="UTF-8"?> <CreateAccessPointForObjectProcessConfiguration> <AccessPointName>ap-01</AccessPointName> <ObjectProcessConfiguration> <AllowedFeatures> <AllowedFeature>GetObject-Range</AllowedFeature> </AllowedFeatures> <TransformationConfigurations> <TransformationConfiguration> <アクション> <Action>GetObject</Action> </アクション> <ContentTransformation> <FunctionCompute> <FunctionAssumeRoleArn>acs:ram::111933544165 ****:role/aliyunfcdefaultrole</FunctionAssumeRoleArn> <FunctionArn>acs:fc:cn-qingdao:111933544165 ****: サービス /test-oss-fc.LATEST /機能 /fc-01</FunctionArn> </FunctionCompute> </ContentTransformation> </TransformationConfiguration> </TransformationConfigurations> </ObjectProcessConfiguration> </CreateAccessPointForObjectProcessConfiguration>
レスポンスの例
HTTP/1.1 200 OK x-oss-request-id: 5C1B138A109F4E405B2D **** 日付: 10月30日月曜日2023 03:15:40 GMT <?xml version="1.0" encoding="UTF-8"?> <CreateAccessPointForObjectProcessResult> <AccessPointForObjectProcessArn>acs:oss:cn-qingdao:119335441657143:accesspointforobjectprocess/fc-ap-01</AccessPointForObjectProcessArn> <AccessPointForObjectProcessAlias>fc-ap-01-3b00521f653d2b3223680ec39dbbe2 ****-opapalias</AccessPointForObjectProcessAlias> </CreateAccessPointForObjectProcessResult>